1adc1d27ee1b0861a6b690d37d054ec1482ef4497Scott Main<html><body><pre>Android NDK Installation
248ef1859ef0bb25547e5aceeedb9b175c6193bc5David 'Digit' Turner
348ef1859ef0bb25547e5aceeedb9b175c6193bc5David 'Digit' TurnerIntroduction:
448ef1859ef0bb25547e5aceeedb9b175c6193bc5David 'Digit' Turner-------------
548ef1859ef0bb25547e5aceeedb9b175c6193bc5David 'Digit' Turner
6adc1d27ee1b0861a6b690d37d054ec1482ef4497Scott MainPlease read docs/OVERVIEW.html to understand what the Android NDK is and is not.
748ef1859ef0bb25547e5aceeedb9b175c6193bc5David 'Digit' TurnerThis file gives instructions on how to properly setup your NDK.
848ef1859ef0bb25547e5aceeedb9b175c6193bc5David 'Digit' Turner
948ef1859ef0bb25547e5aceeedb9b175c6193bc5David 'Digit' Turner
1048ef1859ef0bb25547e5aceeedb9b175c6193bc5David 'Digit' TurnerI. Requirements:
1148ef1859ef0bb25547e5aceeedb9b175c6193bc5David 'Digit' Turner----------------
1248ef1859ef0bb25547e5aceeedb9b175c6193bc5David 'Digit' Turner
1348ef1859ef0bb25547e5aceeedb9b175c6193bc5David 'Digit' TurnerThe Android NDK currently requires a Linux, OS X or Windows host operating system.
14f78e926710927bb3f90b9ac3f97b6acec9357041David 'Digit' Turner
15f78e926710927bb3f90b9ac3f97b6acec9357041David 'Digit' TurnerWindows users will need to install Cygwin 1.7 or later (http://www.cygwin.com) to
1676370ba56008e8d7fccd217bb6ca5cf02867d1b7David 'Digit' Turneruse the NDK. Note that running it under MSys or Cygwin 1.5 is not supported.
1748ef1859ef0bb25547e5aceeedb9b175c6193bc5David 'Digit' Turner
1848ef1859ef0bb25547e5aceeedb9b175c6193bc5David 'Digit' TurnerYou will need to have the Android SDK and its dependencies installed. The NDK
1948ef1859ef0bb25547e5aceeedb9b175c6193bc5David 'Digit' Turnercannot generate final application packages (.apk files), only the shared library
2048ef1859ef0bb25547e5aceeedb9b175c6193bc5David 'Digit' Turnerfiles that can go into them.
2148ef1859ef0bb25547e5aceeedb9b175c6193bc5David 'Digit' Turner
2248ef1859ef0bb25547e5aceeedb9b175c6193bc5David 'Digit' Turner
2348ef1859ef0bb25547e5aceeedb9b175c6193bc5David 'Digit' TurnerIMPORTANT:
2448ef1859ef0bb25547e5aceeedb9b175c6193bc5David 'Digit' Turner    The Android NDK can only be used to target system images using
2548ef1859ef0bb25547e5aceeedb9b175c6193bc5David 'Digit' Turner    the Cupcake (1.5) or later releases of the platform.
2648ef1859ef0bb25547e5aceeedb9b175c6193bc5David 'Digit' Turner
2748ef1859ef0bb25547e5aceeedb9b175c6193bc5David 'Digit' Turner    This is due to subtle toolchain and ABI related changed that make
2848ef1859ef0bb25547e5aceeedb9b175c6193bc5David 'Digit' Turner    it incompatible with 1.0 and 1.1 system images.
2948ef1859ef0bb25547e5aceeedb9b175c6193bc5David 'Digit' Turner
3025f47bc03dbe536d2fb4a231316a38a2d0a8ee59David 'Digit' TurnerThe NDK requires GNU Make 3.81 or later being available on your development
3148ef1859ef0bb25547e5aceeedb9b175c6193bc5David 'Digit' Turnersystem. Earlier versions of GNU Make might work but have not been tested.
3248ef1859ef0bb25547e5aceeedb9b175c6193bc5David 'Digit' Turner
3348ef1859ef0bb25547e5aceeedb9b175c6193bc5David 'Digit' TurnerYou can check this by running 'make -v' from the command-line. The output
3448ef1859ef0bb25547e5aceeedb9b175c6193bc5David 'Digit' Turnershould look like:
3548ef1859ef0bb25547e5aceeedb9b175c6193bc5David 'Digit' Turner
3648ef1859ef0bb25547e5aceeedb9b175c6193bc5David 'Digit' Turner    GNU Make 3.81
3748ef1859ef0bb25547e5aceeedb9b175c6193bc5David 'Digit' Turner    Copyright (C) 2006  Free Software Foundation, Inc.
3848ef1859ef0bb25547e5aceeedb9b175c6193bc5David 'Digit' Turner    ...
3948ef1859ef0bb25547e5aceeedb9b175c6193bc5David 'Digit' Turner
4048ef1859ef0bb25547e5aceeedb9b175c6193bc5David 'Digit' TurnerOn certain systems, GNU Make might be available through a different command like
4148ef1859ef0bb25547e5aceeedb9b175c6193bc5David 'Digit' Turner'gmake' or 'gnumake'. For these systems, replace 'make' by the appropriate command
42f78e926710927bb3f90b9ac3f97b6acec9357041David 'Digit' Turnerwhen invoking the NDK build system as described in the documentation. You might
43f78e926710927bb3f90b9ac3f97b6acec9357041David 'Digit' Turneralso want to define the GNUMAKE environment variable to point to it.
4448ef1859ef0bb25547e5aceeedb9b175c6193bc5David 'Digit' Turner
4525f47bc03dbe536d2fb4a231316a38a2d0a8ee59David 'Digit' TurnerThe NDK also requires a Nawk or GNU Awk executable being available on your
4625f47bc03dbe536d2fb4a231316a38a2d0a8ee59David 'Digit' Turnerdevelopment system. Note that the original 'awk' program doesn't implement
4725f47bc03dbe536d2fb4a231316a38a2d0a8ee59David 'Digit' Turnerthe 'match' and 'substr' functions used by the NDK build system.
4825f47bc03dbe536d2fb4a231316a38a2d0a8ee59David 'Digit' Turner
4948ef1859ef0bb25547e5aceeedb9b175c6193bc5David 'Digit' Turner
503ffa683dea8b68c97be013c1a7061888f49c1c72Xavier DucrohetII. Preparing your installation prebuilt cross-toolchain binaries:
510e3db4dad04bba1a6aed5ad15489999078d0361dDavid 'Digit' Turner------------------------------------------------------------------
5248ef1859ef0bb25547e5aceeedb9b175c6193bc5David 'Digit' Turner
5335f944d26f33fff3e59ab449c991b18260a5fa0bDavid 'Digit' TurnerPrevious releases required you to run the 'build/host-setup.sh' script to
5435f944d26f33fff3e59ab449c991b18260a5fa0bDavid 'Digit' Turnerconfigure the NDK. However, this step has been removed in release 4 (a.k.a. r4).
5548ef1859ef0bb25547e5aceeedb9b175c6193bc5David 'Digit' Turner
5635f944d26f33fff3e59ab449c991b18260a5fa0bDavid 'Digit' TurnerThe auto-detection and sanity checks that were performed by the script have
5735f944d26f33fff3e59ab449c991b18260a5fa0bDavid 'Digit' Turnerbeen moved into the NDK makefiles (and are now performed each time you invoke
5835f944d26f33fff3e59ab449c991b18260a5fa0bDavid 'Digit' TurnerGNU Make).
59adc1d27ee1b0861a6b690d37d054ec1482ef4497Scott Main</pre></body></html>