OLD | NEW |
1 Native Client is now built into the Dev channel of Google Chrome. This page | 1 Native Client is now built into the Dev channel of Google Chrome. This page |
2 tells you how to enable and use the integrated version of Native Client. | 2 tells you how to enable and use the integrated version of Native Client. |
3 | 3 |
4 **Note:** For now, the integrated version of Native Client has less | 4 **Note:** For now, the integrated version of Native Client has less |
5 functionality than the plug-in. If you want to see everything that Native Client | 5 functionality than the plug-in. If you want to see everything that Native Client |
6 can do, [download the tarball](downloads.md) and install the plug-in. For | 6 can do, [download the tarball](downloads.md) and install the plug-in. For |
7 details of what's different about the integrated version, see [Known issues] | 7 details of what's different about the integrated version, see [Known issues] |
8 (NativeClientInGoogleChrome#Known_issues.md). | 8 (NativeClientInGoogleChrome#Known_issues.md). |
9 | 9 |
10 **Contents:** | |
11 | |
12 # How to enable Native Client in Google Chrome | 10 # How to enable Native Client in Google Chrome |
13 | 11 |
14 1. [Download Google Chrome](http://www.google.com/chrome), if you don't already | 12 1. [Download Google Chrome](http://www.google.com/chrome), if you don't already |
15 have it. | 13 have it. |
16 2. Subscribe to the [Dev channel] | 14 2. Subscribe to the [Dev channel](http://dev.chromium.org/getting-involved/dev-c
hannel). |
17 (http://dev.chromium.org/getting-involved/dev-channel). | 15 3. Launch Google Chrome from the command line, adding **--enable-nacl**. On Mac |
18 3. Launch Google Chrome from the command line, adding **--enable-nacl**. On Mac | 16 and Linux, if you're using dev channel release 5.0.375.9 or 5.0.371.0, |
19 and Linux, if you're using dev channel release 5.0.375.9 or 5.0.371.0, | 17 respectively (or an earlier version), also add **--no-sandbox**. On Windows, |
20 respectively (or an earlier version), also add **--no-sandbox**. On Windows, | 18 your command should look like this: |
21 your command should look like this: | |
22 | 19 |
23 <blockquote><b><pre><code>chrome.exe --enable-nacl</code></pre></b></blockquote> | 20 chrome.exe --enable-nacl |
24 | 21 |
25 **Warning:** We recommend running Google Chrome with the --no-sandbox or | 22 **Warning:** We recommend running Google Chrome with the --no-sandbox or |
26 --enable-nacl flag **only** for testing Native Client and **not for regular web | 23 --enable-nacl flag **only** for testing Native Client and **not for regular web |
27 browsing**. | 24 browsing**. |
28 | 25 |
29 # How to find and run examples and tests | 26 # How to find and run examples and tests |
30 | 27 |
31 1. In any browser, bring up the [Getting Started] | 28 1. In any browser, bring up the [Getting Started] |
32 (http://nativeclient.googlecode.com/svn/trunk/src/native_client/documentatio
n/getting_started.html) | 29 (http://nativeclient.googlecode.com/svn/trunk/src/native_client/documentatio
n/getting_started.html) |
33 document. You'll follow some—but not all—of its instructions. Specifically: | 30 document. You'll follow some—but not all—of its instructions. Specifically: |
34 1. [Get the software] | 31 1. [Get the software] |
35 (http://nativeclient.googlecode.com/svn/trunk/src/native_client/document
ation/getting_started.html#software). | 32 (http://nativeclient.googlecode.com/svn/trunk/src/native_client/document
ation/getting_started.html#software). |
36 (Download the tarball, extract the files, and make sure you have the | 33 (Download the tarball, extract the files, and make sure you have the |
37 right version of Python.) | 34 right version of Python.) |
38 2. [Start a local HTTP server] | 35 2. [Start a local HTTP server] |
39 (http://nativeclient.googlecode.com/svn/trunk/src/native_client/document
ation/getting_started.html#httpd), | 36 (http://nativeclient.googlecode.com/svn/trunk/src/native_client/document
ation/getting_started.html#httpd), |
40 if one isn't already running on your computer. <br /><br /> | 37 if one isn't already running on your computer. |
41 2. In Google Chrome, view the Browser Test Page, using **localhost** for the | 38 2. In Google Chrome, view the Browser Test Page, using **localhost** for the |
42 hostname. For example: <br /> <br /><a | 39 hostname. For example: [http://localhost:5103/scons-out/nacl-x86-32/staging/
examples.html](http://localhost:5103/scons-out/nacl-x86-32/staging/examples.html
) |
43 href='http://localhost:5103/scons-out/nacl-x86-32/staging/examples.html'><a | |
44 href='http://localhost:5103/scons-out/nacl-x86-32/staging/examples.html'>htt
p://localhost:5103/scons-out/nacl-x86-32/staging/examples.html</a></a><br | |
45 /><br /> | |
46 3. Click links to examples and tests to run them. | 40 3. Click links to examples and tests to run them. |
47 | 41 |
48 When Google Chrome is launched with the **--enable-nacl** flag, the integrated | 42 When Google Chrome is launched with the **--enable-nacl** flag, the integrated |
49 version of Native Client is used to run the examples and tests. Otherwise, the | 43 version of Native Client is used to run the examples and tests. Otherwise, the |
50 Native Client plug-in (if installed) is used to run them. | 44 Native Client plug-in (if installed) is used to run them. |
51 | 45 |
52 The following tests should work in the integrated version of Native Client: | 46 The following tests should work in the integrated version of Native Client: |
53 | 47 |
54 * Tests that have no audio or graphics<br /> The results of these tests should | 48 * Tests that have no audio or graphics: |
55 be the same as if you executed them in Google Chrome using the Native Client | 49 The results of these tests should be the same as if you executed them in |
56 plug-in. | 50 Google Chrome using the Native Client plug-in. |
57 | 51 |
58 * Mandelbrot performance test<br /> This works because all drawing is from | 52 * Mandelbrot performance test: |
59 JavaScript; Native Client is used only for calculations. | 53 This works because all drawing is from JavaScript; Native Client is used only |
| 54 for calculations. |
60 | 55 |
61 The following examples don't currently work: | 56 The following examples don't currently work: |
62 | 57 |
63 * Examples with graphics (except for the Mandelbrot performance test) <br | 58 * Examples with graphics (except for the Mandelbrot performance test): |
64 />This includes everything in the Examples column except the SRPC hello | 59 This includes everything in the Examples column except the SRPC hello |
65 world example. | 60 world example. |
66 | 61 |
67 For details about what each example and test contains, see the [Examples and | 62 For details about what each example and test contains, see the [Examples and |
68 Tests] | 63 Tests](http://nativeclient.googlecode.com/svn/trunk/src/native_client/documentat
ion/examples.html) |
69 (http://nativeclient.googlecode.com/svn/trunk/src/native_client/documentation/ex
amples.html) | |
70 page and the README files in the source code. | 64 page and the README files in the source code. |
71 | 65 |
72 # Known issues | 66 # Known issues |
73 | 67 |
74 * Graphics and audio from native code don't work unless you're using the | 68 * Graphics and audio from native code don't work unless you're using the |
75 proposed NPAPI improvements ([announcement] | 69 proposed NPAPI improvements ([announcement] |
76 (http://groups.google.com/group/native-client-announce/browse_thread/thread/
3607403cbc165499), | 70 (http://groups.google.com/group/native-client-announce/browse_thread/thread/36
07403cbc165499), |
77 [spec](https://wiki.mozilla.org/Plugins:PlatformIndependentNPAPI)). These | 71 [spec](https://wiki.mozilla.org/Plugins:PlatformIndependentNPAPI)). These |
78 new 2D and 3D APIs provide access to video and audio. | 72 new 2D and 3D APIs provide access to video and audio. |
79 * In some Dev-channel builds of Google Chrome, enabling Native Client requires | 73 * In some Dev-channel builds of Google Chrome, enabling Native Client requires |
80 disabling the Google Chrome sandbox. | 74 disabling the Google Chrome sandbox. |
81 | 75 |
82 # More information | 76 # More information |
83 | 77 |
84 For information about the design and implementation of Google Chrome, see the | 78 For information about the design and implementation of Google Chrome, see the |
85 [Chromium project website](http://dev.chromium.org). | 79 [Chromium project website](http://dev.chromium.org). |
OLD | NEW |