• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1GoNaCl App Engine
2=================
3
4This is a new App Engine Python 2.7 application for http://gonacl.com
5
6At this time it presents the existing functionality of redirecting
7to http://developers.google.com/native-client/
8
9Also, there are PNaCl demos added at ``/demo/<name>``
10
11
12To Run Locally
13--------------
14
151. Download the App Engine SDK (https://developers.google.com/appengine/downloads#Google_App_Engine_SDK_for_Python)
16
172. Run ``<path/to/app/engine>/dev_appserver.py app.yaml``
18
193. Navigate in your browser to http://localhost:8080/demo/
20
21
22To Update App Engine (HTML/JS)
23------------------------------
24
25To upload, run this from the root directory of the App Engine SDK::
26
27  $ ./appcfg.py update <path-to-this-dir>
28
29It probably makes sense to bump the application version in app.yaml for each
30upload, as it lets us use App Engine's versioning. The newly uploaded version
31can be tried before actually being activated, by going to the "Versions"
32section on the App Engine dashboard. Note that the newly uploaded version only
33becomes active when it's set as the "default" version in the dashboard.
34
35
36To Update the Binary files (.pexe/.nmf)
37---------------------------------------
38
39The build outputs are automatically uploaded to Google Cloud Storage
40(``storage.googleapis.com``) by the linux SDK builder (linux-sdk-multi).
41To publish a new version:
42
431. Make and land your change to the demo, found in ``src/<demo-name>``.
44
452. 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
543. Use 'make publish REVISION=<REV>' in the ``src`` directory to publish the
55   revision.
56
574. 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
735. Land a CL with these changes.
74
756. Update App Engine, using the instructions above.
76