Home | History | Annotate | only in /external/chromium_org/native_client_sdk/src/gonacl_appengine
Up to higher level directory
NameDateSize
app.yaml16-Dec-2014523
gonacl.py16-Dec-2014353
Makefile16-Dec-2014377
README16-Dec-20142.5K
src/16-Dec-2014
static/10-Mar-2015

README

      1 GoNaCl App Engine
      2 =================
      3 
      4 This is a new App Engine Python 2.7 application for http://gonacl.com
      5 
      6 At this time it presents the existing functionality of redirecting
      7 to http://developers.google.com/native-client/
      8 
      9 Also, there are PNaCl demos added at ``/demo/<name>``
     10 
     11 
     12 To Run Locally
     13 --------------
     14 
     15 1. Download the App Engine SDK (https://developers.google.com/appengine/downloads#Google_App_Engine_SDK_for_Python)
     16 
     17 2. Run ``<path/to/app/engine>/dev_appserver.py app.yaml``
     18 
     19 3. Navigate in your browser to http://localhost:8080/demo/
     20 
     21 
     22 To Update App Engine (HTML/JS)
     23 ------------------------------
     24 
     25 To upload, run this from the root directory of the App Engine SDK::
     26 
     27   $ ./appcfg.py update <path-to-this-dir>
     28 
     29 It probably makes sense to bump the application version in app.yaml for each
     30 upload, as it lets us use App Engine's versioning. The newly uploaded version
     31 can be tried before actually being activated, by going to the "Versions"
     32 section on the App Engine dashboard. Note that the newly uploaded version only
     33 becomes active when it's set as the "default" version in the dashboard.
     34 
     35 
     36 To Update the Binary files (.pexe/.nmf)
     37 ---------------------------------------
     38 
     39 The build outputs are automatically uploaded to Google Cloud Storage
     40 (``storage.googleapis.com``) by the linux SDK builder (linux-sdk-multi).
     41 To publish a new version:
     42 
     43 1. Make and land your change to the demo, found in ``src/<demo-name>``.
     44 
     45 2. Wait for the linux SDK builder to build and upload your change. You can see
     46    what's available in the browser at::
     47 
     48      http://gsdview.appspot.com/gonacl/demos/continuous/
     49 
     50    Or by using gsutil::
     51 
     52      $ gsutil ls gs://gonacl/demos/continuous/
     53 
     54 3. Use 'make publish REVISION=<REV>' in the ``src`` directory to publish the
     55    revision.
     56 
     57 4. Update the URLs to use this new revision in each demo's JavaScript files:
     58 
     59    Please see the following table for the location of the revision number to
     60    modify.
     61 
     62    ==========  =============================  ===========
     63    Demo        File                           Function
     64    ==========  =============================  ===========
     65    bullet      /static/bullet/main.js         pageDidLoad
     66    cube        /static/cube/example.js        getDataURL
     67    earth       /static/earth/example.js       getDataURL
     68    life        /static/life/example.js        getDataURL
     69    lua         /static/lua/lua.js
     70    smoothlife  /static/smoothlife/example.js  getDataURL
     71    voronoi     /static/voronoi/example.js     getDataURL
     72 
     73 5. Land a CL with these changes.
     74 
     75 6. Update App Engine, using the instructions above.
     76