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