INSTALL.html revision 76370ba56008e8d7fccd217bb6ca5cf02867d1b7 
1Android NDK Installation
2
3Introduction:
4-------------
5
6Please read docs/OVERVIEW.TXT to understand what the Android NDK is and is not.
7This file gives instructions on how to properly setup your NDK.
8
9
10I. Requirements:
11----------------
12
13The Android NDK currently requires a Linux, OS X or Windows host operating system.
14
15Windows users will need to install Cygwin 1.7 or later (http://www.cygwin.com) to
16use the NDK. Note that running it under MSys or Cygwin 1.5 is not supported.
17
18You will need to have the Android SDK and its dependencies installed. The NDK
19cannot generate final application packages (.apk files), only the shared library
20files that can go into them.
21
22
23IMPORTANT:
24    The Android NDK can only be used to target system images using
25    the Cupcake (1.5) or later releases of the platform.
26
27    This is due to subtle toolchain and ABI related changed that make
28    it incompatible with 1.0 and 1.1 system images.
29
30The NDK requires GNU Make 3.81 or later being available on your development
31system. Earlier versions of GNU Make might work but have not been tested.
32
33You can check this by running 'make -v' from the command-line. The output
34should look like:
35
36    GNU Make 3.81
37    Copyright (C) 2006  Free Software Foundation, Inc.
38    ...
39
40On certain systems, GNU Make might be available through a different command like
41'gmake' or 'gnumake'. For these systems, replace 'make' by the appropriate command
42when invoking the NDK build system as described in the documentation. You might
43also want to define the GNUMAKE environment variable to point to it.
44
45The NDK also requires a Nawk or GNU Awk executable being available on your
46development system. Note that the original 'awk' program doesn't implement
47the 'match' and 'substr' functions used by the NDK build system.
48
49
50II. Preparing your installation prebuilt cross-toolchain binaries:
51------------------------------------------------------------------
52
53Previous releases required you to run the 'build/host-setup.sh' script to
54configure the NDK. However, this step has been removed in release 4 (a.k.a. r4).
55
56The auto-detection and sanity checks that were performed by the script have
57been moved into the NDK makefiles (and are now performed each time you invoke
58GNU Make).
59