documentation/platform-windows.html

   1 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
   2 <html xmlns="http://www.w3.org/1999/xhtml">
   3 <head>
   4 <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
   5 <title>Platform Details: Windows</title>
   6 <link href="stylesheet.css" type="text/css" rel="stylesheet"></link>
   7 </head>
   8
   9 <body>
  10
  11 <div id="toplink">
  12 <a href="../README.html">Back to README</a>
  13 </div>
  14
  15 <h1>Platform Details: Windows</h1>
  16
  17 <p>
  18 Although Native Client modules are platform independent,
  19 the instructions for installing and building Native Client
  20 differ a bit between platforms.
  21 This page has details about the Windows environment.
  22 </p>
  23
  24 <p>
  25 For instructions on installing and using Native Client,
  26 see <a href="getting_started.html">Getting Started</a>.
  27 That page and others,
  28 such as <a href="building.html">Building Native Client</a>,
  29 link to this page as needed.
  30 </p>
  31
  32 <h3>
  33 Contents:
  34 </h3>
  35
  36 <ul>
  37 <li><a href="#testedconfigs">Tested configurations</a> </li>
  38 <li> <a href="#run">Running on Windows</a>
  39   <ul>
  40   <li><a href="#run-python">Getting Python</a> </li>
  41   <li><a href="#run-pythonpath">Checking the Python path</a> </li>
  42   <li><a href="#run-cygwin">Avoiding Cygwin Python</a> </li>
  43   <li><a href="#run-vista">Vista: Installing when UAC is enabled</a> </li>
  44   </ul></li>
  45 <li> <a href="#dev">Developing on Windows</a>
  46   <ul>
  47   <li><a href="#dev-env">Setting up your development environment</a></li>
  48   </ul></li>
  49 </ul>
  50
  51 <h2> <a name="testedconfigs" id="testedconfigs"> </a> Tested configurations </h2>
  52
  53 <p>
  54 Native Client has been tested with the following Windows configurations:
  55 </p>
  56
  57 <ul>
  58 <li> OS
  59   <ul>
  60   <li> Windows XP (32-bit only) </li>
  61   <li> Windows Vista (32-bit only) </li>
  62   </ul></li>
  63 <li> Browser
  64   <ul>
  65   <li> Firefox 3 </li>
  66   <li> Chrome </li>
  67   <li> Safari </li>
  68   <li> Opera </li>
  69   </ul> </li>
  70 <li> Python
  71   <ul>
  72   <li> 2.4 </li>
  73   </ul> </li>
  74 <li> Development environment
  75   <ul>
  76   <li> Visual Studio 2005 (8.0) </li>
  77   </ul> </li>
  78 </ul>
  79
  80 <p>
  81 Support for Internet Explorer is not available at this time.
  82 </p>
  83
  84 <p>
  85 <b>Note:</b>
  86 Native Client does <em>not</em> currently support 64-bit Windows.
  87 </p>
  88
  89 <h2><a name="run" id="run"> </a> Running on Windows </h2>
  90
  91 <h3><a name="run-python" id="run-python"> </a> Getting Python </h3>
  92
  93 <p>
  94 You can download Python for free. See
  95 <a href="http://www.python.org/download/">http://www.python.org/download/</a>
  96 for details.
  97 </p>
  98
  99 <h3><a name="run-pythonpath" id="run-pythonpath"> </a> Checking the Python path </h3>
 100
 101 <p>
 102 The path to <code>python</code> must have <b>no spaces</b>.
 103 You can use the <code>where</code> command
 104 to see the path:
 105 </p>
 106
 107 <pre>
 108 C:\><kbd>where python</kbd>
 109 C:\Python24\python.exe
 110 </pre>
 111
 112 <h3><a name="run-cygwin" id="run-cygwin"> </a> Avoiding Cygwin Python </h3>
 113
 114 <p>
 115 If you have Cygwin,
 116 make sure your <code>python</code> command
 117 is from the standard Python distribution,
 118 not from Cygwin.
 119 You can test using the following command:
 120 </p>
 121
 122 <pre>
 123 <kbd>python -c "import sys; print sys.platform"</kbd>
 124 </pre>
 125
 126 <p>
 127 If the output is <code>cygwin</code>,
 128 then you're using the Cygwin version of Python
 129 and need to find the standard version.
 130 Once you have the standard version,
 131 put its directory at the front of your PATH:
 132 </p>
 133
 134 <pre>
 135 <kbd>set PATH=c:\<em>python_install_dir</em>;%PATH%</kbd>
 136 </pre>
 137
 138 <h3><a name="run-vista" id="run-vista"> </a> Vista: Installing when UAC is enabled </h3>
 139
 140 <p>
 141 If <a href="http://en.wikipedia.org/wiki/User_Account_Control">User
 142 Account Control</a> (UAC) is enabled,
 143 you can't use SCons to install the plug-in on Vista.
 144 Instead, you need to copy three files into
 145 <code>C:\Program Files\Mozilla Firefox\plugins</code>:
 146 </p>
 147
 148 <ul>
 149 <li> <code><em>install_dir</em>\nacl\googleclient\native_client\scons-out\opt-win\staging\<b>npGoogleNaClPlugin.dll</b></code> </li>
 150 <li> <code><em>install_dir</em>\nacl\googleclient\native_client\scons-out\opt-win\staging\<b>SDL.dll</b></code> </li>
 151 <li> <code><em>install_dir</em>\nacl\googleclient\native_client\scons-out\opt-win\staging\<b>sel_ldr.exe</b></code> </li>
 152 </ul>
 153
 154 <h2><a name="dev"> </a> Developing on Windows </h2>
 155
 156 <p>
 157 You need Visual Studio 2005 (8.0) and possibly Cygwin
 158 to build Native Client on Windows.
 159 Cygwin is required only if you need to run <code>make</code> &mdash;
 160 for example, if you need to build the SDK.
 161 </p>
 162
 163 <p>
 164 <b>Note:</b> If you have Cygwin,
 165 use the <b>xterm</b> shell window instead of <code>cygwin.bat</code>.
 166 </p>
 167
 168
 169 <p id="license">
 170 Except as otherwise
 171 <a href="http://code.google.com/policies.html#restrictions">noted</a>,
 172 the content of this page is licensed under a
 173 <a href="http://creativecommons.org/licenses/by/2.5/">Creative Commons
 174 Attribution 2.5 license</a>.
 175 </p>
 176
 177 </body>
 178 </html>