diff options
Diffstat (limited to 'docs/html/ndk/guides/setup.jd')
| -rw-r--r-- | docs/html/ndk/guides/setup.jd | 94 |
1 files changed, 94 insertions, 0 deletions
diff --git a/docs/html/ndk/guides/setup.jd b/docs/html/ndk/guides/setup.jd new file mode 100644 index 0000000..81a33c0 --- /dev/null +++ b/docs/html/ndk/guides/setup.jd @@ -0,0 +1,94 @@ +page.title=Setup +@jd:body + + +<div id="qv-wrapper"> + <div id="qv"> + <h2>On this page</h2> + + <ol> + <li><a href="#install">Installation</a></li> + <li><a href="#configure">Configuring Eclipse</a></li> + <li><a href="#verify">Verification</a></li> + </ol> + </li> + </ol> + </div> + </div> + + +<div class="contents"> +<div class="textblock"><p>This document explains how to:</p> +<ul> +<li><a href="#install">Get</a> and install the NDK.</li> +<li><a href="#configure">Configure</a> your system and the Eclipse and the Android Development Tool +(ADT) for use with it.</li> +<li><a href="#verify">Verify</a>, using a simple sample, that everything is working as expected. +</li> +</ul> +<p>This document assumes that you are already familiar with Java-based Android development. For more +information on that topic, see the +<a href="{@docRoot}">Android developer site</a>.</p> + +<h2 id="install">Installation</h2> +<p>To install and configure the NDK, follow these steps:</p> +<ol type="1"> +<li>Get and install the <a href="{@docRoot}sdk/index.html">Android SDK</a>.</li> +<li><a href="{@docRoot}ndk/downloads/index.html">Download</a> and +<a href="{@docRoot}ndk/downloads/index.html#extract">extract</a> the NDK, +making sure to download the correct version for your development platform. You may place the +unzipped directory anywhere on your local drive.</li> +<li>Update your {@code PATH} environment variable with the location of the directory that +contains the NDK.</li> +</ol> + + +<h2 id="configure">Configuring Eclipse</h2> +<p>Eclipse must know where the NDK is in order to use it when building your app. Follow these steps +to set the location of the NDK.</p> +<ol type="1"> +<li>Launch Eclipse, which is installed as part of the Android SDK.</li> +<li>Open <b>Window</b> > <b>Preferences</b>.</li> +<li>In the pane on the left side of the <i>Preferences</i> window, select <i>Android</i>. +The <i>Android</i> section expands, revealing a number of subsections.</li> +<li>Select <b>NDK</b>. In the pane on the right side of the <i>Preferences</i> window, browse to +the directory that contains the NDK.</li> +<li>Click <b>OK</b> to return to the <i>Package Explorer</i> display.</li> +</ol> + +<h2 id="verify">Verification</h2> +<h3>Eclipse</h3> +<p>To confirm that you have installed the NDK, set it up correctly, and properly configured Eclipse, +follow these steps:</p> +<ol type="1"> +<li>Import the hello-jni sample from {@code <ndk>/samples/}, as you would any other Android +project.</li> +<li>In the <i>Project Explorer</i> pane, right-click the project name (<i>HelloJni</i>). A +context menu appears.</li> +<li>From the context menu, select <b>Android Tools</b> > <b>Add Native Support</b>. The +<i>Add Android Native Support</i> window appears.</li> +<li>Accept the default library name (“hello-jni”), and click <b>Finish</b>.</li> +<li>Build and execute the application.</li> +</ol> +<h3>Command line</h3> +<p>Follow these steps to build from the command line:</p> +<ol type="1"> +<li>Change to the root directory of your project.</li> +<li>Execute ndk-build to build the native component of your app. do this by +typing {@code ndk-build} at the command prompt.</li> +<li>Build and install your project as you would a regular Android app written in Java. For more +information, see +<a href="{@docRoot}tools/building/index.html">Building and Running</a> and +<a href="{@docRoot}tools/building/building-cmdline.html">Building and Running +from the Command Line</a>.</li> +</ol> + +<p>If you have successfully installed and configured the NDK, the screen on your target device looks +as shown in Figure 1.</p> + +<img src="./images/verification_screen.png" srcset="./images/verification_screen@2x.png 2x" +alt="Output: Hello from JNI!" id="figure1" /> + +<p class="img-caption"> +<strong>Figure 1.</strong> Target-device screen after successful launch. +</p> |