The sections below provide information and notes about successive releases of the NDK, as denoted by revision number.
This release of the NDK includes many new APIs, most of which are introduced to
support the development of games and similar applications that make extensive use
of native code. Using the APIs, developers have direct native access to events, audio,
graphics and window management, assets, and storage. Developers can also implement the
Android application lifecycle in native code with help from the new
NativeActivity
class. For detailed information describing the changes in this
release, read the CHANGES.HTML document included in the downloaded NDK package.
.apk
file../configure && make
. See
docs/STANDALONE-TOOLCHAIN.html for the details. The binaries for GCC 4.4.0 are still provided,
but the 4.2.1 binaries were removed.cpufeatures
helper library that improves reporting
of the CPU type (some devices previously reported ARMv7 CPU when the device really was an ARMv6). We
recommend developers that use this library to rebuild their applications then
upload to Market to benefit from the improvements.native-plasma
and native-activity
,
to demonstrate how to write a native activity.Includes fixes for several issues in the NDK build and debugging scripts — if you are using NDK r4, we recommend downloading the NDK r4b build. For detailed information describing the changes in this release, read the CHANGES.TXT document included in the downloaded NDK package.
ndk-build
build
command.ndk-gdb
command.armeabi-v7a
. The new ABI extends the existing armeabi
ABI to
include these CPU instruction set extensions:
cpufeatures
static library (with sources) that lets your
app detect the host device's CPU features at runtime. Specifically, applications can
check for ARMv7-A support, as well as VFPv3-D32 and NEON support, then provide separate
code paths as needed.hello-neon
, that illustrates how to use the
cpufeatures
library to check CPU features and then provide an optimized
code path using NEON instrinsics, if supported by the CPU..apk
.Bitmap
objects from native code.hello-gl2
, that illustrates the use of
OpenGL ES 2.0 vertex and fragment shaders.Originally released as "Android 1.6 NDK, Release 1".
san-angeles
, that renders 3D graphics
through the native OpenGL ES APIs, while managing activity lifecycle with a GLSurfaceView
object.Originally released as "Android 1.5 NDK, Release 1".
Installing the NDK on your development computer is straightforward and involves extracting the NDK from its download package.
Before you get started make sure that you have downloaded the latest Android SDK and upgraded your applications and environment as needed. The NDK is compatible with older platform versions but not older versions of the SDK tools. Also, take a moment to review the System and Software Requirements for the NDK, if you haven't already.
To install the NDK, follow these steps:
android-ndk-<version>
. You can rename the NDK directory if necessary and you
can move it to any location on your computer. This documentation refers to the NDK directory as
<ndk>
.You are now ready to start working with the NDK.
Once you've installed the NDK successfully, take a few minutes to read the documentation
included in the NDK. You can find the documentation in the <ndk>/docs/
directory. In particular, please read the OVERVIEW.HTML document completely, so that you
understand the intent of the NDK and how to use it.
If you used a previous version of the NDK, take a moment to review the list of NDK changes in the CHANGES.HTML document.
Here's the general outline of how you work with the NDK tools:
<project>/jni/...
<project>/jni/Android.mk
to describe your native sources to the
NDK build system<project>/jni/Application.mk
.cd <project> <ndk>/ndk-build
The build tools copy the stripped, shared libraries needed by your application to the proper location in the application's project directory.
.apk
file.For complete information on all of the steps listed above, please see the documentation included with the NDK package.
The NDK includes sample Android applications that illustrate how to use native code in your Android applications. For more information, see Sample Applications.
If you have questions about the NDK or would like to read or contribute to discussions about it, please visit the android-ndk group and mailing list.