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/xhtml;charset=UTF-8"/> 5 <meta http-equiv="X-UA-Compatible" content="IE=9"/> 6 <meta name="generator" content="Doxygen 1.8.5"/> 7 <title>NDK Programmer's Guide: Main Page</title> 8 <link href="tabs.css" rel="stylesheet" type="text/css"/> 9 <script type="text/javascript" src="jquery.js"></script> 10 <script type="text/javascript" src="dynsections.js"></script> 11 <link href="doxygen.css" rel="stylesheet" type="text/css" /> 12 </head> 13 <body> 14 <div id="top"><!-- do not remove this div, it is closed by doxygen! --> 15 <div id="titlearea"> 16 <table cellspacing="0" cellpadding="0"> 17 <tbody> 18 <tr style="height: 56px;"> 19 <td style="padding-left: 0.5em;"> 20 <div id="projectname">Native Development Kit ("NDK") 21 </div> 22 </td> 23 </tr> 24 </tbody> 25 </table> 26 </div> 27 <!-- end header part --> 28 <!-- Generated by Doxygen 1.8.5 --> 29 </div><!-- top --> 30 <div class="header"> 31 <div class="headertitle"> 32 <div class="title">Getting Started with the NDK</div> </div> 33 </div><!--header--> 34 <div class="contents"> 35 <div class="textblock"><p>This document explains how to:</p> 36 <ul> 37 <li><a href=#install>Get and install the NDK.</a></li> 38 <li><a href=#configure>Configure your system and the Eclipse and the Android Development Tools (ADT) for use with it.</a></li> 39 <li><a href=#verify>Verify, using a simple sample, that everything is working as expected.</a></li> 40 </ul> 41 <p>Note that this document assumes that you are already familiar with Java-based Android development. For more information on that topic, see the <a href="http://developer.android.com">Android developer site</a>.</p> 42 <a id=install></a> 43 <h2>Installation</h2> 44 <p>To install and configure the NDK, follow the steps below: 45 <ol type="1"> 46 <li>To use the NDK, you must first have the <a href="http://developer.android.com/sdk/index.html">Android SDK</a> installed.</li> 47 <li>Next, <a href="http://developer.android.com/tools/sdk/ndk/index.html">download</a> and unzip 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> 48 <li><b>If you are building from the command line,</b> open a terminal window, and update your <code>PATH</code> environment variable with the location of the directory that contains the NDK.</li> 49 </ol> 50 <ul style="list-style: none; "> 51 <li> 52 <p class="startli">For example, in bash:</p> 53 <p class="endli"></p> 54 </li> 55 <li> 56 <p class="startli"></p> 57 <pre class="fragment">export PATH=$PATH:~/Android_SDK/NDK/<android-ndk-version> 58 </pre><p class="endli"></p> 59 </li> 60 <li> 61 <p class="startli">Or, in Windows:</p> 62 <p class="endli"></p> 63 </li> 64 <li> 65 <p class="startli"></p> 66 <pre class="fragment">set PATH=%PATH%;C:/Android_SDK/NDK/android-ndk-r10 67 </pre> </li> 68 </ul> 69 <a id=configure></a> 70 <h2>Configuring Eclipse</h2> 71 <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> 72 <ol type="1"> 73 <li>Launch Eclipse, which is installed as part of the Android SDK.</li> 74 <li>Open <b>Preferences</b>.</li> 75 <li>In the pane on the left side of the <em>Preferences</em> window, select <strong>Android > NDK</strong>. The <em>Android</em> section expands, revealing a number of subsections.</li> 76 <li>Select <b>NDK</b>. In the pane on the right side of the <em>Preferences</em> window, browse to the directory that contains the NDK. 77 78 <li>Click <b>OK</b> to return to the <em>Package Explorer</em> display.</li> 79 </ol> 80 <a id=verify></a> 81 <h2>Verification</h2> 82 <h3>Eclipse</h3> 83 <p> To confirm that you have installed the NDK, set it up correctly, and properly configure Eclipse, follow these steps:</p> 84 <ol type="1"> 85 <li>Import the hello-jni sample from `<ndk>/samples/, as you would any other Android project.</li> 86 <li>In the <em>Project Explorer</em> pane, right-click the project name (<em>HelloJni</em>). A context menu appears.</li> 87 <li>From the context menu, select <b>Android Tools</b> > <b>Add Native Support</b>, as shown in Figure 2. The <em>Add Android Native Support</em> window appears.</li> 88 89 <div class="image"> 90 <img src="./images/Figure_2.png" alt="Adding native support" align="left" width="660"/> 91 </div> 92 <p style="clear:both"><b>Figure 1.</b> Adding native support to your project</p> 93 94 <li>Accept the default library name (hello-jni), and click <b>Finish</b>.</li> 95 <li>Build and execute the application.</li> 96 </ol> 97 <h3>Command line</h3> 98 Follow these steps to build from the command line: 99 100 <ol type="1"> 101 <li>Change to the root directory of your project.</li> 102 <li>Execute ndk-build to build the native component of your app.<br/> 103 </li> 104 105 <pre class="fragment">$ ndk-build 106 </pre> 107 </code></p> 108 109 <li>Build and install your project as you would a regular Android app written in Java. For more information, see <a href="http://developer.android.com/tools/building/index.html">Building and Running</a> and <a href="http://developer.android.com/tools/building/building-cmdline.html">Building and Running from the Command Line</a>.</li> 110 </ol> 111 <p>If you have successfully installed and configured the NDK, the screen on your target device looks as shown in Figure 3.</p> 112 <div class="image"> 113 <img src="./images/Figure_3.png" alt="successful launch screen" align="left" width="220"/> 114 </div> 115 <p style="clear:both"><b>Figure 2.</b> Target-device screen after successful launch </p> 116 </div></div><!-- contents --> 117 <!-- start footer part --> 118 <hr class="footer"/><address class="footer"><small> 119 Generated on Mon Jun 16 2014 21:28:06 for Native Development Kit ("NDK") by  <a href="http://www.doxygen.org/index.html"> 120 <img class="footer" src="doxygen.png" alt="doxygen"/> 121 </a> 1.8.5 122 </small></address> 123 </body> 124 </html> 125
