| Platform | Package | Size (Bytes) | MD5 Checksum |
|---|---|---|---|
| Windows 32-bit | android-ndk-r10d-windows-x86.exe | 455427281 | c0930abfae0c990c4d191cc4ebd46b68 |
| Windows 64-bit | android-ndk-r10d-windows-x86_64.exe | 472613732 | 9a33f96da58a7e0b70e47d27b4a880b4 |
| Mac OS X 32-bit | android-ndk-r10d-darwin-x86.bin | 441545213 | 0aeb3dc062dc457a4cd01e72eadb2379 | Mac OS X 64-bit | android-ndk-r10d-darwin-x86_64.bin | 442691567 | cb101e1e62d56ea75b215f6bc6c27fae |
| Linux 32-bit (x86) | android-ndk-r10d-linux-x86.bin | 449997190 | 47dead9b10b647099f423b9b5dbb5d5f |
| Linux 64-bit (x86) | android-ndk-r10d-linux-x86_64.bin | 459151600 | 3ebcd92b48ebf9b59037836e2cb9b028 |
The NDK is a toolset that allows you to implement parts of your app using native-code languages such as C and C++. For certain types of apps, this can be helpful so you can reuse existing code libraries written in these languages, but most apps do not need the Android NDK.
Before downloading the NDK, you should understand that the NDK will not benefit most apps. As a developer, you need to balance its benefits against its drawbacks. Notably, using native code on Android generally does not result in a noticable performance improvement, but it always increases your app complexity. In general, you should only use the NDK if it is essential to your app—never because you simply prefer to program in C/C++.
Typical good candidates for the NDK are CPU-intensive workloads such as game engines, signal processing, physics simulation, and so on. When examining whether or not you should develop in native code, think about your requirements and see if the Android framework APIs provide the functionality that you need.
The following sections provide information about releases of the NDK.
Android NDK, Revision 10d (December 2014)
NDK_TOOLCHAIN_VERSION=4.6 to ndk-build, or
add --toolchain=arm-linux-androideabi-4.6 when executing
make-standalone-toolchain.sh on the command line. GCC 4.9 remains the
default for 64-bit ABIs.-mstackrealign by default. The
NDK toolchain assumes a 16-byte stack alignment. The tools and options used by default
enforce this rule. A user writing assembly code must make sure to preserve stack
alignment, and ensure that other compilers also comply with this rule.
(GCC bug 38496)-fPIE -pie
when building. In API levels 16 and higher, ndk-build uses PIE
when building. This change has a number of implications, which are discussed in
Developer Preview Issue 888.
These implications do not apply to shared libraries.--fix-cortex-a53-835769, when
-mfix-cortex-a53-835769 (enabled by default) is specified.
For more information, see this
binutils message
and this
binutils message.
sscanf/vsscanf hang that occurred in API level
21. The fix itself had been implemented in r10c.
(Issue 77988)-fauto-profile) crash that occurred with GCC 4.9 when
-Os was specified. (Issue 77571)posix_memalign to API level 16. Also, added a prototype in
stdlib.h to API levels 16 to 19.
(Issue 77861)stdatomic.h so that it includes <atomic> only for
C++11.sys/user.h, and
gl2ext.h, dlext.h, fts.h, sgidefs.h
for API level 21.sys/user.h to rename mxcsr_mask as mxcr_mask,
and to change the data type for u_ar0unsigned long
to struct user_regs_struct*.
sysconf() return value type from int to
long.thumb for LOCAL_ARM_MODE: In
r10d, ndk-build adds LOCAL_LDFLAGS+=-mthumb by default, unless one of the
following conditions applies:LOCAL_ARM_MODE equal to arm.APP_OPTIM=debug and
AndroidManifest.xml containing android:debuggable="true"),
where ARM mode is the default in order to retain compatibility with earlier toolchains.
(Issue 74040)LOCAL_SRC_FILES in ndk-build to use Windows absolute paths.
(Issue 74333)make-standalone-toolchain.sh.
(Issue 74145)System.loadLibrary() transitive
dependencies. (Issue 41790)LOCAL_PCH to improve Clang support. (Issue
77575)
Android NDK, Revision 10c (October 2014)
Android-L to the official release
designation: android-21.google branch
of the GCC repository. Major differences from the upstream version of GCC 4.9 include:-O2 option now turns on vectorization, without loop peeling but with more
aggressive unrolling.For more detailed information, see Important bug fixes below.
NDK_TOOLCHAIN_VERSION=clang
now picks Clang 3.5. Note that:-fno-integrated-as as a workaround.
-finline-functions
option that GCC supports.When migrating from projects using GCC, you can use
-Wno-invalid-command-line-argument and -Wno-unused-command-line-argument
to ignore the unused flags until you're able decide on what to do with them longer-term.
art-on option. For more information,
see prebuilt/common/gdb/common.setup in the directory containing the NDK.--icf option.arm_neon.h support in x86 and x86_64, attaining coverage of ~93% of
NEON intrinsics. For more information about NEON support:
docs/Programmers_Guide/html/), and see
Architectures and CPUs > Neon.hello-neon sample in samples/.
_FORTIFY_SOURCE in headers/libs/android-21,
which appeared in r10 (when android-21 was still called Android-L),
but had no documentation.internal compiler error: in simplify_const_unary_operation, at simplify-rtx.c:1539
x = (cond) ? y : x.
(Issue 77569)-mno-fix-cortex-a53-835769.android-21:
android/keycodes.handroid/sensor.h:
ASensorManager_getDefaultSensorEx, ASensor_getFifoMaxEventCount,
ASensor_getFifoReservedEventCount, ASensor_getStringType,
ASensor_getReportingMode, and ASensor_isWakeUpSensor.stdatomic.h to improve compatibility with GCC 4.6, and provide support
for the <atomic> header.sys/ucontext.h and sys/user.h to all API levels. The
signal.h header now includes <sys/ucontext.h>. You may
remove any existing definition of struct ucontext.posix_memalign to API levels 17, 18, and 19.android_set_abort_message, posix_fadvise,
posix_fadvise64, pthread_gettid_np.native-media/AndroidManifest.xml
sample.
(Issue 106640)clock_nanosleep and clock_settime to API level 21. (Issue
77372)
get_malloc_leak_info, free_malloc_leak_info,
__srget, __swbuf, __srefill, __swsetup,
__sdidinit, __sflags, __sfp,
__sinit, __smakebuf, __sflush, __sread,
__swrite, __sseek, __sclose,
_fwalk, __sglue, __get_thread, __wait4,
__futex_wake, __open, __get_tls,
__getdents64, and dlmalloc.basename_r,
dirname_r, __isthreaded, _flush_cache (mips64).__signalfd4.size_t to int in
the following functions: strtoll_l, strtoull_l,
wcstoll_l, and wcstoull_l.arc4random,
arc4random_buf, and arc4random_uniform.cxa_* and the new and delete operators back
to libstdc++.so. This change restores r9d behavior; previous versions of r10
contained dummy files.--toolchain= in make-standalone-toolchain.sh so that it
now properly supports use of a suffix specifying a version of Clang.strtod() functions.docs/.cpu-features to detect ARMv8 support for the following
instruction sets: AES, CRC32, SHA2, SHA1, and 64-bit PMULL/PMULL2. (Issue
106360)*-gcc-ar, which is available in GCC 4.8, GCC 4.9, and
Clang. Clang specifies it, instead of *-ar. This setting brings improved LTO
support.include-fixed/linux/a.out.h and
include-fixed/linux/compiler.h headers from the GCC compiler.
(Issue 73728)-flto with GCC 4.8 on Mac OS X. The error message
read:.../ld: error: .../libexec/gcc/arm-linux-androideabi/4.9/liblto_plugin.so Symbol not found: _environ
build-binary.mk. (Issue
76992)-fauto-profile) in GCC4.9 may cause crashing.
(Issue 77571)
Android NDK, Revision 10b (September 2014)
stdio.h from the include-fixed/ directories of all versions of GCC. (Issue 73728.)platforms/android-L/arch-*/usr/include/linux/netfilter*/ directories. (Issue 73704.)docs/ and sources/third_party/googletest/README.NDK. (Issue 74069.)ctype.h and wchar.h: dn_expand(), grantpt(), inet_nsap_addr(), inet_nsap_ntoa(), insque(), nsdispatch(), posix_openpt(), __pthread_cleanup_pop(), __pthread_cleanup_push(), remque(), setfsgid(), setfsuid(), splice(), tee(), twalk() (Issue 73719), and 42 *_l() functions.cmsg_nxthdr to __cmsg_nxthdr.__libc_malloc_dispatch.ptrace() prototype to long ptrace(int, ...);.sha1.h.android_dlextinfo in android/dlext.h.__NDK_FPABI__ for functions receiving or returning float- or double-type values in stdlib.h, time.h, wchar.h, and complex.h.mipsel-linux-android-4.9 and mips64el-linux-android-4.9, implementing a new multilib directory layout, and providing support for gdb-7.7cpu-features to detect more arm64 features. (Change list 100339.)
Android NDK, Revision 10 (July 2014)
NDK_TOOLCHAIN_VERSION=clang
may not work for arm64-v8a and mips64.all32 and all64
settings for APP_ABI.
APP_ABI=all32 is equivalent to
APP_ABI=armeabi,armeabi-v7a,x86,mips.APP_ABI=all64 is equivalent to
APP_ABI=arm64-v8a,x86_64,mips64.APP_ABI=all selects all ABIs.<tr1/cmath>
Before defining your own math function, check _GLIBCXX_USE_C99_MATH_TR1 to see a
function with that name already exists, in order to avoid "multiple definition" errors from the
linker.platforms/android-L/ API directory. It includes:Android.h header for SLES/OpenSLES, enabling support for
single-precision, floating-point audio format in AudioPlayer.libGLESv3.so.NDK_TOOLCHAIN_VERSION=4.9 to Application.mk, or exporting it as an
environment variable from the command line.--toolchain= option in the
make-standalone-toolchain.sh script. For example: --toolchain=arm-linux-androideabi-4.9.NDK_TOOLCHAIN_VERSION=4.8 or 4.9 to enable ndk-gdb to select GDB 7.6.-mssse3 build option to provide SSSE3 support, and made it the default for ABI x86
(upgrading from SSE3). The image released by Google does not contain SSSE3 instructions.-fno-strict-aliasing if you use <list>, because __list_imp::_end_ breaks
TBAA rules. (Issue 61571.)LOCAL_PCH. (Issue 25412).std::feof, etc. (Issue 66668).-O3 assert on:llvm-3.2/llvm/include/llvm/MDBuilder.h:64: llvm::MDNode*
llvm::MDBuilder::createBranchWeights(llvm::ArrayRef): Assertion Weights.size() >= 2
&& "Need at least two branch weights!" (Issue 57381).
Assertion failed: (!Fn && "cast failed but able to resolve overload expression!!"), function CheckCXXCStyleCast, file
Volumes/data/ndk-toolchain/src/llvm-3.3/llvm/tools/clang/lib/Sema/SemaCast.cpp, line 2018.
(Issue 66950).
ssize_t to be int instead of long
int.WCHAR_MIN and WCHAR_MAX so that they they take
appropriate signs according to the architecture they're running on:-D__WCHAR_UNSIGNED__.wchar_t to be 16 bits, use -fshort-wchar.libc.so, and added pread64,
pwrite64, ftruncate64 for
Android API level 12 and higher. (Issue 69319). For more
information, see the commit message accompanying AOSP change list
94137.putchar. Warning message reads:include/stdio.h:236:5: warning: conflicts with previous declaration here
[-Wattributes] int putchar(int); (Change list 91185).
make-standalone-toolchain.sh --stl=libc++ so that it:cxxabi.h. (Issue 68001).APP_PLATFORM
environment variable.IsSystemLibrary() in crazy_linker so that it
uses strrchr()
instead of strchr() to find the library path's true basename.-Wl,-shared (as opposed to
-shared, which
had no compilation issues). The problem was that Clang added -pie for Android
targets if neither -shared nor -static existed. This behavior, which was
incorrect, caused the linker to complain that -shared and -pie could not
co-exist.arm_neon.h to the x86 toolchain so that it now emulates ~47% of
Neon. There is currently no support for 64-bit types. For more information, see the section on ARM
Neon intrinsics support in the x86 documentation.$NDK/tests/build/b14811006-GOT_PREL-optimization/.--toolchain=x86_64-linux-android-4.9, which is equivalent to
--toolchain=x86_64-4.9.
Android NDK, Revision 9d (March 2014)
NDK_TOOLCHAIN_VERSION=clang option now picks Clang 3.4. GCC 4.6 is
still the default compiler.APP_ABI=armeabi-v7a-hard, with
additional multilib option -mfloat-abi=hard. These options are for
use with ARM GCC 4.6/4.8 and Clang 3.3/3.4 (which use 4.8's assembler, linker,
and libs). When using these options, note the following changes:ndk-build script, add the
following options for armeabi-v7a target:
TARGET_CFLAGS += -mhard-float -D_NDK_MATH_NO_SOFTFP=1 TARGET_LDFLAGS += -Wl,--no-warn-mismatch -lm_hardThe built library is copied to
libs/armeabi-v7a. For make to
behave as expected, you cannot specify both armeabi-v7a and
armeabi-v7a-hard as make targets (i.e., on the APP_ABI= line).
Doing so causes one of them to be ignored. Note that APP_ABI=all
is still equivalent to
armeabi armeabi-v7a x86 mips.make-standalone-toolchain.sh script copies
additional libaries under /hard directories.
Add the above CFLAGS and LFLAGS to your
makefile to enable GCC or Clang to link with
libraries in /hard.LOCAL_ASMFLAGS
and EXPORT_ASMFLAGS flags for x86
targets. The ndk-build script uses
prebuilts/*/bin/yasm* to build LOCAL_SRC_FILES that
have the .asm extension.-gc-sections
support.APP_STL := c++_static or APP_STL :=
c++_shared in Application.mk.
You may rebuild from source via LIBCXX_FORCE_REBUILD :=
truemake-standalone-toolchain.sh --stl=libc++
to create a standalone toolchain with libc++ headers/lib.CPLUSPLUS-SUPPORT.html.
(Issue 36496)zlib, bz2,
_curses, _curses_panel, _hashlib,
_sslzlib, nis,
crypt, _curses, and _curses_panelevent_getmsg_helper.#include <sys/types.h> in
android/asset_manager.h for Android API level 13 and higher.
(Issue 64988)#include in
android/rect_manager.h for Android API level 14 and higher.JNICALL to JNI_OnLoad and
JNI_OnUnload in jni.h. Note that JNICALL
is defined as __NDK_FPABI__ For more information, see
sys/cdefs.h.android/tts.h EGL/eglext.h fts.h GLES/glext.h GLES2/gl2ext.h OMXAL/OpenMAXSL_Android.h SLES/OpenSLES_Android.h sys/prctl.h sys/utime.h
sys/cachectl.h for all architectures. MIPS
developers can now include this header instead of writing #ifdef
__mips__.platforms/android-18/include/android/input.h
by adding __NDK_FPABI__ to functions taking or returning
float or double values.struct stat, which was incorrectly set
to its 64-bit counterpart for Android API level 12 and later. This wrong
setting was a
regression introduced in release r9c.__PTHREAD_MUTEX_INIT_VALUE,
__PTHREAD_RECURSIVE_MUTEX_INIT_VALUE,
and __PTHREAD_ERRORCHECK_MUTEX_INIT_VALUE for Android API
level 9 and lower.scalbln, scalblnf, and
scalblnl to x86 libm.so for APIs 18 and later.sources/android/support/include/iconv.h.
(Issue 63806)std::unexpected() to call
std::terminate() so that
a user-defined std::terminate() handler has a chance to run.
std::nullptr.SYSTEM_UI_FLAG_IMMERSIVE_STICKY. Screen rotation does not
trigger onSystemUiVisibilityChange, and so does not restore
immersive mode.ndk-build script to add
-rpath-link=$SYSROOT/usr/lib and
-rpath-link=$TARGET_OUT in order to use ld.bfd to
link executables. (Issue 64266)-Bsymbolic from all STL builds.ndk-gdb-py.cmd by setting SHELL as
an environment variable
instead of passing it to
python.exe, which ignores the setting.
(Issue 63054)make-standalone-toolchain.sh script so that
the --stl=stlport option copies the gabi++ headers instead of
symlinking them; the cmd.exe and MinGW shells do not understand
symlinks created by cygwin.*cmd scripts
previously intended for use only in the cmd.exe shell, in case
developers prefer to use ndk-build.cmd in cygwin instead of the
recommended ndk-build script.make-standalone-toolchain.sh
script by moving instead of copying if the specified destination directory does
not exist.
Android NDK, Revision 9c (December 2013)
This is a bug-fix-only release.
-fuse-ld=mcld, so that the following error no longer occurs:
cc1: internal compiler error: in common_handle_option, at opts.c:1774
-mhard-float support for
__builtin math functions. For ongoing information on fixes for
-mhard-float with STL, please follow Issue 61784.poll to poll(struct
pollfd *, nfds_t, int); in poll.h.utimensat to libc.so for Android
API levels 12 and 19. These libraries are now included for all Android API
levels 12 through 19.futimens into libc.so, for Android API
level 19.clock_settime() and
clock_nanosleep() to time.h for Android API level 8
and higher.CLOCK_MONOTONIC_RAW, CLOCK_REALTIME_COARSE,
CLOCK_MONOTONIC_COARSE, CLOCK_BOOTTIME, CLOCK_REALTIME_ALARM, and
CLOCK_BOOTTIME_ALARM in time.h.CLOCK_REALTIME_HR and
CLOCK_MONOTONIC_HR.source/android/ndk_helper:
Check_ReleaseStringUTFChars in
/system/lib/libdvm.so that was causing crashes on x86 devices.ndk-build fails that happen in cygwin when the NDK
package is
referenced via symlink.ndk-build.cmd fails that happen in windows
cmd.exe when
LOCAL_SRC_FILES contains absolute paths. (Issue 69992)ndk-stack script to proceed even when it can't parse
a frame due to inability to find a routine, filename, or line number. In any of
these cases, it prints ??.ndk-stack stack for windows-x64_64 targets so that
it no longer erroneously matches a frame line with a line in the
stack: section that doesn't contain pc,
eip, or ip. For example:
I/DEBUG ( 1151): #00 5f09db68 401f01c4 /system/lib/libc.so
LOCAL_EXPORT_LDFLAGS.NDK_PROJECT_PATH=null setting for use in an
integrated build system where options are explicitly passed to
ndk-build. With this setting, ndk-build makes no
attempt to look for NDK_PROJECT_PATH. This setting also prevents
variables from deriving default settings from NDK_PROJECT_PATH. As a result,
the following variables must now be explicitly specified (with their default
values if such exist): NDK_OUT, NDK_LIBS_OUT, APP_BUILD_SCRIPT,
NDK_DEBUG (optional, default to 0), and other APP_*'s
contained in Application.mk.APP_ABI can now be enumerated in a comma-delimited list. For
example:
APP_ABI := "armeabi,armeabi-v7a"
android-ndk-r9c-cxx-stl-libs-with-debugging-info.zip, using the
-g option. This option
helps the ndk-stack script provide better a stack dump across STL.
This change should not affect the code/size of the final, stripped file.hello-jni samples to report APP_ABI at
compilation.ar tool in Deterministic mode (option
-D) to build static libraries. (Issue 60705)
Android NDK, Revision 9b (October 2013)
include/android/*h and math.h for all Android API levels up to
18, including the addition of levels 13, 15, 16 and 17.
For information on added APIs, see commit messages for Changes
68012 and
68014.
(Issues 47150,
58528, and
38423)-mhard-float in the existing armeabi-v7a ABI. For more
information and current restrictions on Clang, see
tests/device/hard-float/jni/Android.mk.-fdiagnostics-color=auto,
-fdiagnostics-color=always, or export GCC_COLORS as shown below:
GCC_COLORS='error=01;31:warning=01;35:note=01;36:caret=01;32:locus=01:quote=01'For more information, see GCC Language Independent Options.
thumb2 failing to generate 16-bit relative jump
tables. (GCC Issue)g++.dg/cpp0x/lambda/lambda-defarg3.C.
(Change 62770,
GCC Issue)*-gdb.exe executables failing to launch.
(Issue 58975)internal compiler error: verify_flow_info failed(Issue 58916, GCC Issue)
ARM.exidx data for unwinding in prologue code and
added a command (set arm exidx-unwinding) to control exidx-based stack unwinding.
(Issue 55826)dbx_reg_number. The error message is as
follows:
external/icu4c/i18n/decimfmt.cpp:1322:1: internal compiler error: in dbx_reg_number, at dwarf2out.c:10185(GCC Patch)
WCHAR_MIN and WCHAR_MAX to be unsigned according to
spec (the X86/MIPS versions are signed). Define _WCHAR_IS_ALWAYS_SIGNED to
restore old behavior. (Issue 57749)include/netinet/tcp.h to contain TCP_INFO state enum.
(Issue 38881)cdefs_elh.h macro _C_LABEL_STRING to stop generating
warnings in the GCC 4.8 toolchain when using c++11 mode.
(Issue 58135,
Issue 58652)imaxabs and imaxdiv from header
inttypes.h.pthread_exit() return values and pthread_self().
(Issue 60686)mkdtemp() function, which already exists in bionic
header stdlib.h.samples/gles3jni with Clang on Android API level 11.-gc-sections and --eh-frame-hdr.--no-warn-mismatch option.cpu-features option to not assume all VFPv4 devices support IDIV.
Now this option only adds IDIV to white-listed devices, including Nexus 4.
(Issue 57637)android_native_app_glue.c erroneously logging errors on event
predispatch operations.gabi++ terminate and unexpected_handler to be
thread-safe.-integrated-as option so it can pass
tests for ssax-instructions and fenv.--eh-frame-hdr even
for static executables. For more information, see the
GCC patch.CPU-ARCH-ABIS.html. For more information, see
NDK-DEPENDS.html. (Issue 60142)__atomic_fetch_add, __atomic_fetch_sub, and __atomic_fetch_or.
vfprintf.
(Clang issue)
LOCAL_CFLAGS += -fopenmp LOCAL_LDFLAGS += -fopenmpFor code examples, see
tests/device/test-openmpld.mcld significantly (1.5MB vs. ld.bfd 3.5MB and
ld.gold 7.5MB), resulting in a speed improvement of approximately 20%.LOCAL_CONLYFLAGS and APP_CONLYFLAGS to specify
options applicable to C only but not C++. The existing LOCAL_CFLAGS
and APP_CFLAGS are also used for C++ compilation (to save trouble of
specifying most options twice), so options such as -std=gnu99 may fail in
g++ builds with a warning and clang++ builds with an error.gabi++ array helper functions.libgcc.a files are built with
-funwind-tables to allow the stack to be unwound past previously blocked
points, such as __aeabi_idiv0.-mmxu
option.-mldc1-sdc1 to control ldxc1/sdxc1 toosources/android/crazy_linker/README.TXT.bitmap-plasma to draw to full screen rather than a 200x200 pixel
area.
Android NDK, Revision 9 (July 2013)
STABLE-APIS.html and new code examples in samples/gles3jni/README.
ndk-build builds, export NDK_TOOLCHAIN_VERSION=4.8 or
add it in Application.mk.--toolchain= option in
make-standalone-toolchain.sh, for example:--toolchain=arm-linux-androideabi-4.8Note:
The -Wunused-local-typedefs option is enabled by -Wall. Be
sure to add __attribute__((unused)) if you use compile-time asserts like
sources/cxx-stl/stlport/stlport/stl/config/features.h, line #311. For more
information, see
Change 55460
Note:
In the GCC 4.7 release and later, ARM compilers generate unaligned access code by
default for ARMv6 and higher build targets. You may need to add the
-mno-unaligned-access build option when building for kernels that do not support
this feature.
NDK_TOOLCHAIN_VERSION=clang build option
now picks Clang 3.3 by default.
Note: Both GCC 4.4.3 and Clang 3.1 are deprecated, and will be removed from the next NDK release.
ld.gold
is the default where available, you must add -fuse-ld=mcld in
LOCAL_LDFLAGS or APP_LDFLAGS to enable MCLinker.ndk-depends tool which prints ELF library dependencies.
For more information, see NDK-DEPENDS.html.
(Issue 53486)android_native_app_glue.
(Issue 41755)-O values when using Boost
1.52.0. (Issue 42891)
libc.so and libc.a to support the wait4() function.
(Issue 19854)clone()
function.LOCAL_SHORT_COMMANDS bug where the linker.list file is
empty or not used.ld.mcld --eh-frame-hdr fails frequently.llvm/lib/VMCore/Value.cpp.
(Change 59021)out of memory allocating
4294967280 bytes).ndk-gdb script so that the --start or --launch actions
now wait for the GNU Debug Server, so that it can more reliably hit breakpoints set
early in the execution path (such as breakpoints in JNI code).
(Issue 41278)
Note:
This feature requires jdb and produces warning about pending breakpoints.
Specify the --nowait option to restore previous behavior.
stepi command past a bx pc or
blx pc Thumb instruction.
(Issue 56962,
Issue 36149)gdbserver to look for DT_MIPS_RLD_MAP instead of
DT_DEBUG. (Issue 56586)ndk-build script to enable you to specify a version of Clang as a
command line option (e.g., NDK_TOOLCHAIN_VERSION=clang3.2). Previously, only
specifying the version as an environment variable worked._Unwind_Exception to be 24 for MIPS build targets when
using the Clang compiler.
(Change 54141)ndk-build script to ensure that built libraries are actually
removed from projects that include prebuilt static libraries when using the
ndk-build clean command.
(Change 54461,
Change 54480)NDK_ANALYZE=1 option to be less verbose.gnu-libstdc++/Android.mk to include a backward/ path for builds
that use backward compability.
(Issue 53404)stlport new sometimes returned random values.ndk-gdb to match the order of CPU_ABIS, not APP_ABIS.
(Issue 54033)ntonl/swap32 error: invalid 'asm': operand number
out of range.
(Issue 54465,
Change 57242)ld.gold to merge string literals.ld.gold to handle large symbol alignment.ld.gold to enable the --sort-section=name option.-export-dynamic option for
statically linked programs. GCC no longer adds an .interp section for statically
linked programs.stlport compilation error about inconsistent typedef
of _Unwind_Control_Block.
(Issue 54426)awk scripts to handle AndroidManifest.xml files created on
Windows which may contain trailing \r characters and cause build errors.
(Issue 42548)make-standalone-toolchain.sh to probe the prebuilts/
directory to detect if the host is 32 bit or 64 bit.-integrated-as option.pr1 and pr2 handler data.
-mllvm -arm-enable-ehabi option to fix the following Clang error:
clang: for the -arm-enable-ehabi option: may only occur zero or one times!
uses-sdk element in application
manifest. (Issue 57015)__set_errno an inlined function, since
__set_errno in errno.h is deprecated, and libc.so no longer
exports it.elf.h to include stdint.h.
(Issue 55443)sys/un.h to be included independently of other headers.
(Issue 53646)MotionEvent_getHistorical API family to take the
const AInputEvent* motion_event.
(Issue 55873)malloc_usable_size to take const void*.
(Issue 55725)wchar.h to not redefine WCHAR_MAX and
WCHAR_MIN<inttypes.h> declaration for pointer-related PRI and
SCN macros. (Issue 57218)sys/cdefs.h header so that __WCHAR_TYPE__ is 32-bit
for API levels less than 9, which means that wchat_t is 32-bit for all
API levels. To restore the previous behavior, define the _WCHAR_IS_8BIT
boolean variable. (Issue 57267)docs/ and miscellaneous documentation fixes.
make-standalone-toolchain.sh to support the stlport
library in addition to gnustl, when you specify the option
--stl=stlport. For more information, see STANDALONE-TOOLCHAIN.html.make-standalone-toolchain.sh script so that the
--llvm-version= option creates the $TOOLCHAIN_PREFIX-clang and
$TOOLCHAIN_PREFIX-clang++ scripts in addition to clang and
clang++, to avoid using the host's clang and clang++ definitions by accident.
-fcxx-missing-return-semantics flag to re-enable missing
return
semantics in Clang 3.2+. Normally, all paths should terminate with a return
statement for a value-returning function. If this is not the case, clang inserts
an undefined instruction (or trap in debug mode) at the path without a return
statement. If you are sure your code is correct, use this flag to allow the
optimizer to take advantage of the undefined behavior. If you are not sure, do not
use this flag. The caller may still receive a random incorrect value, but the
optimizer will not exploit it and make your code harder to debug.-fglobal-ctor-const-promotion flag to re-enable
promoting global variables with static constructor to be constants. With this flag,
the global variable optimization pass of LLVM tries to evaluate the global
variables with static constructors and promote them to global constants. Although
this optimization is correct, it may cause some incompatability with code compiled
by GCC. For example, code may do const_cast to cast the constant to mutable
and modify it. In GCC, the variable is in read-write and the code is run by
accident. In Clang, the const variable is in read-only memory and may cause your
application to crash.-mldc1-sdc1 to the MIPS GCC and Clang compilers. By default, compilers
align 8-byte objects properly and emit the ldc1 and sdc1 instructions
to move them around. If your app uses a custom allocator that does not always align
with a new object's 8-byte boundary in the same way as the default allocator, your app
may crash due to ldc1 and sdc1 operations on unaligned memory. In this
case, use the -mno-ldc1-sdc1 flag to workaround the problem.APP_PLATFORM_LEVEL is
larger than APP_MIN_PLATFORM_LEVEL. The APP_PLATFORM_LEVEL may be lower
than APP_PLATFORM in jni/Application.mk because the NDK does not have
headers for all levels. In this case, the actual level is shifted downwards. The
APP_MIN_PLATFORM_LEVEL is specified by the android:minSdkVersion in
your application's manifest.
(Issue 39752)android_getCpuIdArm() and android_setCpuArm() methods to
cpu-features.c. This addition enables easier retrieval of the ARM CPUID
information. (Issue 53689)ndk-build to use GCC 4.7's as/ld for Clang compiling.
Note:
In GCC 4.7, monotonic_clock and is_monotonic have been renamed to
steady_clock and is_steady, respectively.
ndk-build script:
LOCAL_LDLIBS/LDFLAGS are used in static library
modules.LOCAL_LDLIBS/LDFLAGS of a shared library or executable modules.APP_MODULES is not defined and only static
libraries are listed in Android.mk, the script force-builds all of them.
(Issue 53502)ndk-build to support absolute paths in LOCAL_SRC_FILES.*-gdbtui executables, which are duplicates of the *-gdb
executables with the -tui option enabled._STLP_HAS_INCLUDE_NEXT back on.
(Issue 53646)NDK_LIBS_OUT to allow overriding of the
path for libraries/gdbserver from the default $PROJECT/libs.
For more information, see OVERVIEW.html.-Wformat -Werror=format-security. You may set
LOCAL_DISABLE_FORMAT_STRING_CHECKS=true to disable it.
For more information, see ANDROID-MK.htmlndk-gdb-py. For more information, see
NDK-GDB.html.bash.
Android NDK, Revision 8e (March 2013)
*-x86_64.*). For more
information, see CHANGES.HTML and NDK-BUILD.html.CHANGES.HTML.CHANGES.HTML.ld.gold
linker is the default where available, so you must explicitly enable it. For more
information, see CHANGES.HTML.LOCAL_STATIC_LIBRARIES, LOCAL_WHOLE_STATIC_LIBRARIES and
LOCAL_SHARED_LIBRARIES. For more information, see CHANGES.HTML.
(Issue 39378)-O2. Toolchains in previous
releases were incorrectly built without optimization.gen_thumb_movhi_clobber at config/arm/arm.md:5832.
(Issue 52732)build_data_member_initialization, at
cp/semantics.c:5790.redirect_eh_edge_1, at tree-eh.c:2214.
(Issue 52909)<chrono> clock resolution and enabled steady_clock.
(Issue 39680)_GLIBCXX_HAS_GTHREADS for GCC 4.7 libstdc++.
(Issue 41770,
Issue 41859)posix_memalign.
(Change 51872)i386.c, function
distance_non_agu_define_in_bb().
(Change 50383)cmov behavior.
(GCC Issue)setlocale() in libstdc++/GCC4.7.
(Issue 46718)
ld.gold runtime undefined reference to __exidx_start and
__exidx_start_end.
(Change 52134)<chrono> in C++11
mode.
(Issue 39600)rvalue.
(Issue 41387)source:line breakpoints when symbols
contain
long, indirect file paths.
(Issue 42448)read_program_header for MIPS PIE executables.
(Change 49592)STLport segmentation fault in uncaught_exception().
(Change 50236)STLport bus error in exception handling due to unaligned access of
DW_EH_PE_udata2, DW_EH_PE_udata4, and DW_EH_PE_udata8.nothrow new[] operator.
(Issue 52833)size_t, ssize_t, and
ptrdiff_t.fenv.h header.stddef.h to not redefine offsetof since it already exists
in the toolchain.elf.h to contain Elf32_auxv_t and Elf64_auxv_t.
(Issue 38441)
#ifdef C++ definitions in the
OpenSLES_AndroidConfiguration.h header file.
(Issue 53163)
STLport to abort after out of memory error instead of silently exiting.
cpufeatures to not parse /proc/self/auxv.
(Issue 43055)ld.gold to not depend on host libstdc++ and on Windows platforms,
to not depend on the libgcc_sjlj_1.dll library..vsave and fails
assembler.
(Change 49930)test-stlport
tests for MIPS build targets.
(Change 51961)clang and clang++ in standalone NDK compiler to detect
-cc1 and to not specify -target when found.ndk-build to observe NDK_APP_OUT set in Application.mk.
libc.so and lib.a which were missing the sigsetjmp
and siglongjmp functions already declared in setjmp.h.
(Issue 19851)HOST_AWK.ndk-build script warning in windows when running from project's JNI
directory.
(Issue 40192)ndk-build script does not build if makefile has
trailing whitespace in the LOCAL_PATH definition.
(Issue 42841)__cxa_begin_cleanup and
__cxa_type_match to have default visibility from the previous
hidden visibility in GNU libstdc++. For more information, see
CHANGES.HTML.STLport is built for ARM in Thumb mode.std::set_new_handler in Gabi++.
(Issue 52805)FUTEX system call in GNU libstdc++.ndk-build so that it no longer copies prebuilt static library to
a project's obj/local/<abi>/ directory.
(Issue 40302)__ARM_ARCH_5*__ from ARM toolchains/*/setup.mk script.
(Issue 21132)madd/msub/nmadd/nmsub/recip/rsqrt
instructions with 32-bit FPU.-fgraphite, -fgraphite-identity, -floop-block, -floop-flatten,
-floop-interchange, -floop-strip-mine, -floop-parallelize-all,
and -ftree-loop-linear.
(info)polly for Clang 3.1 on Linux and Max OS X 32-bit hosts which analyzes
and optimizes memory access. (info)-flto in GCC 4.7, 4.6, Clang 3.2 and Clang 3.1 on linux (Clang LTO
via LLVMgold.so). MIPS compiler targets are not supported because ld.gold
is not available.--plugin and --plugin-opt for ld.gold in GCC 4.6/4.7.
--text-reorder for ld.gold in GCC 4.7._GLIBCXX_USE_C99_MATH which undefines the
isinf script in the bionic header. For more information, see
CHANGES.html.APP_LDFLAGS to the build scripts. For more information, see
ANDROID-MK.html.NDK_LOG=0 to disable the NDK_LOG.NDK_HOST_32BIT=0 to disable the host developer
environment 32-bit toolchain.-march= and -mtune= from
pentiumpro and generic to i686 and atom.build-gcc.sh for the mingw build type
which was preventing a significant amount of parallel build processing.build-gabi++.sh and build-stlport.sh so they can now run
from the NDK package.
(Issue 52835)
run-tests.sh in the MSys utilities collection.build-mingw64-toolchain.sh script to more recent version.libgnustl_static.a and stlport_static.a
without hidden visibility.
Android NDK, Revision 8d (December 2012)
ndk-build, export the NDK_TOOLCHAIN_VERSION=4.7 variable
or add it to Application.mk.--toolchain= option to
make-standalone-toolchain.sh, for example:
--toolchain=arm-linux-androideabi-4.7
Note: This feature is experimental. Please try it and report any issues.
stlport exception support via gabi++. Note that the new gabi++
depends on dlopen and related code, meaning that:
-static
option or include libstlport_static.a using
APP_STL := stlport_static. (You can still use the -static option
with a standalone toolchain.) Compiling a dynamic executable using
include $(BUILD_EXECUTABLE) continues to work because the compiler
automatically adds the -ldl option.-nostdlib and {-Wl,--no-undefined}, you
must manually include the -ldl option.CPLUSPLUS-SUPPORT.html.
Note: This feature is experimental and works better with the GCC 4.6/4.7 compilers than with GCC 4.4.3 or Clang 3.1. Please try it and report any issues.
-mstack-protector-guard= option for x86 to choose between a
global default path which is compatible with older Android C library (bionic)
and a new tls path (%gs:20) for -fstack-protector,
-fstack-protector-all and -fstack-protector-strong using the GCC 4.6
and higher compilers.
Note: The -mstack-protector-guard setting itself does not
enable any -fstack-protector* options.
android_setCpu() function to
sources/android/cpufeatures/cpu-features.c for use when auto-detection via
/proc is not possible in Android 4.1 and higher.
(Chromium Issue
164154)ndk-build script.
(Issue 39810)dyld: lazy symbol binding failed: Symbol not found: _memmem Referenced from: ...../arm-linux-androideabi/bin/ld Expected in: /usr/lib/libSystem.B.dylibThis problem was caused by building on Mac OS X 10.7, which produced binaries that were not compatible with Mac OS 10.6.x and the NDK.
-x c++ options from the Clang++ standalone build script.
(Issue 39089)NDK_TOOLCHAIN_VERSION=clang3.1 option in Cygwin.
(Issue 39585)make-standalone-toolchain.sh script to allow generation of a
standalone toolchain using the Cygwin or MinGW environments. The resulting toolchain
can be used in Cygwin, MingGW or CMD.exe environments.
(Issue 39915,
Issue 39585)SL_IID_ANDROIDBUFFERQUEUESOURCE option in android-14 builds for
ARM and X86.
(Issue 40625)ANDROID_CPU_X86_FEATURE_MOVBE feature.
(Issue 39317).cpp file extension.__WINT_TYPE__ and wint_t to be the same type.android/bitmap.h.
(Issue 15134)
errno.h.__STDC_VERSION__ in sys/cdefs.h.
(Issue 14627)
byteswap.h and dirent.h.limits.h to include page.h which provides PAGE_SIZE
settings.
(Issue 39983)
glGetAttribLocation() and
glGetUniformLocation() from int to GLint.__BYTE_ORDER constant for x86 builds.
(Issue 39824)
ndk-build script to not overwrite -Os with -O2 for ARM
builds.HOST_AWK, HOST_SED, and
HOST_MAKE settings.ld.gold on fsck_msdos builds linking objects built by
the Intel C/C++ compiler (ICC).solib events.
(Issue 38402)libgcc.a file when linking shared libraries.SIGILL
signal for paths without a return statement.make-standalone-toolchain.sh to accept the suffix -clang3.1
which is equivalent to adding --llvm-version=3.1 to the GCC 4.6 toolchain.llvm-objdump.libiberty.a is built and
placed in lib32/.
Android NDK, Revision 8c (November 2012)
ndk-build, export NDK_TOOLCHAIN_VERSION=clang3.1 or
add this environment variable setting to Application.mk.--llvm-version=3.1 to
make-standalone-toolchain.sh and replace CC and CXX in your
makefile with <tool-path>/bin/clang and
<tool-path>/bin/clang++. See STANDALONE-TOOLCHAIN.html for
details.Note: This feature is experimental. Please try it and report any issues.
ld.gold for the Windows toolchain. Gold linker is also the
default for ARM and X86 on all hosts. You may override it to use the ld.bfd
linker by adding LOCAL_LDFLAGS += -fuse-ld=bfd to Android.mk, or by
passing
-fuse-ld=bfd to the g++/clang++ command line that does the linking.ndk-build[.cmd] and
ndk-gdb scripts, to prevent build errors that are difficult to diagnose.android-10 through
android-13 in APP_PLATFORM, project.properties or
default.properties link against android-9 instead of
android-14.
-fPIE option for position-independent executables (PIE).
A new APP_PIE option allows you to control this behavior. See APPLICATION-MK.html for details.
Note: All API levels above 14 still link against platforms/android-14 and no new platforms/android-N have been added.
ndk-build to provide warnings if the adjusted API level is larger
than android:minSdkVersion in the project's AndroidManifest.xml.cpu-features helper library to include more ARM-specific features.
See sources/android/cpufeatures/cpu-features.h for details.APP_ABI=armeabi-v7a:
-march=armv7-a parameter
to the linker. This change ensures that v7-specific libraries and crt*.o are
linked correctly.-mfpu=vfpv3-d16 to ndk-build instead of the
-mfpu=vfp option used in previous releases.make-standalone-toolchain.sh with root privileges
resulted in the stand alone tool chain being inaccessible to some users.
(Issue 35279)
libstdc++.a is now preserved when copied.\r from Windows prebuilt echo.exe. The redundant
\r caused gdb.setup to fail in the GNU Debugger (GDB) because it
incorrectly became part of the path.
(Issue 36054)host-mkdir implementation.
(Issue 25875)libstdc++ to not merge typeinfo names by
default. For more details, see
toolchain repo gcc/gcc-4.4.3/libstdc++-v3/libsupc++/typeinfo.
(Issue 22165)null context in GCC 4.6
cp/mangle.c::write_unscoped_name, where GCC may crash when the context is
null and dereferenced in TREE_CODE.STLport internal _IteWrapper::operator*() implementation
where a stale stack location holding the dereferenced value was returned and caused
runtime crashes.
(Issue 38630)g++ to not warn that the mangling of
<va_list> was changed in GCC 4.4. The workaround using the
-Wno-psabi switch to avoid this warning is no longer required..arm or .neon suffixes in
LOCAL_SRC_FILES also used APP_STL. With APP_STL, the
ndk-build script searches for C++ files in LOCAL_SRC_FILES before
adding STL header/lib paths to compilation. Modified ndk-build to
filter out .arm and .neon suffixes before the search, otherwise items
in LOCAL_SRC_FILES like myfile.cpp.arm.neon won't be compiled as C++
code.binutils-2.21/ld.bfd to be capable of linking object from older
binutils without tag_FP_arch, which was producing assertion fail
error messages in GNU Binutils.
(Issue 35209)
binutils-2.19/ld links prebuilt object by newer binutils-2.21stdc++ compilation with both -mthumb and
-march=armv7-a, by modifying make-standalone-toolchain.sh to populate
headers/libs in sub-directory armv7-a/thumb.
(Issue 35616)
reload1.c:3633, caused by the ARM
back-end expecting the wrong operand type when sign-extend from char.
(GCC Issue 50099)-fstack-protector for X86, which is also the default for the
ndk-build x86 ABI target.STLport endian-ness by setting _STLP_LITTLE_ENDIAN to 1 when
compiling MIPS libstlport_*.__builtin_unreachable issue when compiling LLVM.
(GCC Issue 54369)cc1 compile process consuming 100% CPU.
(GCC Issue 50380)gdb with a hard-wired dependency on a specific version of Python.
(Issue 36120)
ndk-gdb when APP_ABI contains all and matchs none
of the known architectures.
(Issue 35392)
: character if it looks
like it could be part of a Windows path starting with a drive letter.
(GDB Issue 12843)
gdbserver.
(GDB Issue)
solibs when the linker is consistent.
This change speeds up solib event handling.
(Issue 37677)
solib breakpoints. GDB now
retries enable_break() during every call to svr4_current_sos() until
it succeeds.
(Change 43563)gdb would not stop on breakpoints placed in
dlopen-ed libraries.
(Issue 34856)
SIGILL in dynamic linker when calling dlopen(), on system
where /system/bin/linker is stripped of symbols and
rtld_db_dlactivity() is implemented as Thumb, due to not preserving
LSB of sym_addr.
(Issue 37147)
arch-mips/include/asm/* code that was incorrectly removed from
original kernel. (Change
43335)__unused with __linux_unused in
linux/sysctl.h and linux/icmp.h to avoid conflict with
#define __unused in sys/cdefs.h.fenv.h for enclosed C functions with __BEGIN_DECLS and
__END_DECLS.malloc.h.stdint.h defintion of uint64_t for ANSI compilers.
(Issue 1952)<arch>/include/machine/*.link.h for MIPS with new version supporting all platforms.linux-unistd.hLONG_LONG_MIN, LONG_LONG_MAX and
ULONG_LONG_MAX from <pthread.h> to <limits.h>.ndk-stack-parser._STLP_USE_EXCEPTIONS, when not defined, to omit all declarations
and uses of __Named_exception. Compiling and use of __Named_exception
settings only occurs when STLport is allowed to use exceptions../build/tools/make-release.sh --force --systems=linux-x86
libc.so so it does not export atexit() and __do_handler.
These symbols are exported for ARM builds by the system version of the C library to
support legacy native libraries. NDK-generated should never reference them directly.
Instead, each shared library or executable should embed its own version of these symbols,
provided by crtbegin_*.o.
If your project is linked with the -nostdlib -Wl,--no-undefined options, you
must provide your own __dso_handle because crtbegin_so.o is not linked in
this case. The content of __dso_handle does not matter, as shown in the following
example code:
extern "C" {
extern void *__dso_handle __attribute__((__visibility__ ("hidden")));
void *__dso_handle;
}
objdump for plt entries to
generate a more readable form function@plt.libgcc.a, from
the X86 platform libc.so library: __aeabi_idiv0, __aeabi_ldiv0,
__aeabi_unwind_cpp_pr1, and __aeabi_unwind_cpp_pr2..ctors, .dtors, and .eh_frame in MIPS
crt*_so.S.ndk-gdb so that it only takes the last line of output for
ndk-build DUMP_XXXX. This change ensures that if Application.mk or
Android.mk print something with $(info ...) syntax, it does not get
injected into the result of DUMP_XXXX.
(More info)arch-x86 and arch-mips headers from
platforms/android-[3,4,5,8]. Those headers were incomplete, since both X86 and
MIPS ABIs are only supported at API 9 or higher.<path>/arm-linux-androideabi/include/c++/4.6.x-google to: <path>/include/c++/4.6/
ndk-build to recognize more C++ file extensions by default:
.cc .cp .cxx .cpp .CPP .c++ .C. You may still use LOCAL_CPP_EXTENSION to
overwrite these extension settings.samples/san-angeles that caused a black screen or freeze
frame on re-launch.hello-gl2 from android-5 to android-7native-activity from android-9 to android-10native-audio from android-9 to android-10native-plasma from android-9 to android-10.note.android.ident (defined in crtbegin_static/dynamic.o) so that
debugging tools can act accordingly. The structure member and values are defined as
follows:
static const struct {
int32_t namesz; /* = 8, sizeof ("Android") */
int32_t descsz; /* = 1 * sizeof(int32_t) */
int32_t type; /* = 1, ABI_NOTETYPE */
char name[sizeof "Android"]; /* = "Android" */
int32_t android_api; /* = 3, 4, 5, 8, 9, 14 */
}
The previous branding options in section .note.ABI-tag are deprecated.
run-tests-all.sh which calls run-tests.sh and
standalone/run.sh with various conditions. The script run-tests.sh runs
without the --abi option, and is enhanced to compile most of the tests for all
supported ABIs and run on all attached devices
Android NDK, Revision 8b (July 2012)
The main features of this release are a new GNU Compiler Collection (GCC) 4.6 toolchain and GNU Debugger (GDB) 7.3.x which adds debugging support for the Android 4.1 (API Level 16) system image.
LOCAL_SHORT_COMMANDS issues on Mac OS, Windows Cygwin environments for
static libraries. List file generation is faster, and it is not regenerated to avoid repeated
project rebuilds.ndk-gdb:
-e, -d and -s to adb more
consistently./system/bin/link information, so gdb on
the host can set a breakpoint in __dl_rtld_db_dlactivity and be aware of linker activity
(e.g., rescan solib symbols when dlopen() is called).ndk-build clean on Windows, which was failing to remove
./libs/*/lib*.so.ndk-build.cmd to return a non-zero ERRORLEVEL when make
fails.libc.so to stop incorrectly exporting the __exidx_start and
__exidx_end symbols.SEGV when unwinding the stack past __libc_init for ARM and
MIPS.binutils 2.21 with gold and GDB 7.3.x) to
co-exist with the original GCC 4.4.3 toolchain (binutils 2.19 and GDB 6.6).
NDK_TOOLCHAIN_VERSION=4.4.3 in Application.mk to select the original one.gold linker is only available for ARM and x86
architectures on Linux and Mac OS hosts. This support is disabled by default. Add LOCAL_LDLIBS += -fuse-ld=gold in Android.mk to enable it.-fPIE require the new GDB for debugging,
including binaries in Android 4.1 (API Level 16) system images.binutils 2.21 ld tool contains back-ported fixes from
version 2.22:
ld --gc-sections, which incorrectly retains zombie references to
external libraries. (more
info).strip command to preserve the original p_align and
p_flags in GNU_RELRO section if they are valid. Without this fix, programs
built with -fPIE could not be debugged. (mor
e info)sincos() optimization for compatibility with older
platforms.relro/bind_now protections by default:
--noexecstack to assembler and -z noexecstack to linker
that provides NX protection against buffer overflow attacks by enabling NX bit on stack and
heap.-z relro and -z now to linker for hardening of internal
data sections after linking to guard against security vulnerabilities caused by memory corruption.
(more info: 1,
2)--execstack option for the
assembler and -z execstack for the linker.-z norelro and
-z lazy options for the linker.jni/Android.mk by setting the
following options:
LOCAL_DISABLE_NO_EXECUTE=true # disable "--noexecstack" and "-z noexecstack" DISABLE_RELRO=true # disable "-z relro" and "-z now"
See docs/ANDROID-MK.html for more details.
.note.ABI-tag section (in
crtbegin_static/dynamic.o) so that debugging tools can act accordingly. The structure
member and values are defined as follows:
static const struct {
int32_t namesz; /* = 4, sizeof ("GNU") */
int32_t descsz; /* = 6 * sizeof(int32_t) */
int32_t type; /* = 1 */
char name[sizeof "GNU"]; /* = "GNU" */
int32_t os; /* = 0 */
int32_t major; /* = 2 */
int32_t minor; /* = 6 */
int32_t teeny; /* = 15 */
int32_t os_variant; /* = 1 */
int32_t android_api; /* = 3, 4, 5, 8, 9, 14 */
}
mips-linux-gnu relocation truncated to fit R_MIPS_TLS_LDM issue.
(more info)ld tool segfaults when using --gc-sections.
(more info)
GOT_PAGE counting issue.
(more info)mips_elf_count_got_symbols.mips_elf_allocate_lazy_stub..dynamic to the data segment, so that it is writable.-mno-shared option from the defaults in the MIPS toolchain.
The default for Android toolchain is -fPIC (or -fpic if supported). If you do not
explicitly specify -mshared, -fpic, -fPIC, -fpie, or -fPIE,
the MIPS compiler adds -mno-shared that turns off PIC. Fixed compiler not to add
-mno-shared in this case.hello-jni and two-libs so that
the tests project underneath it can compile.gdbserver from
toolchain/<arch-os-ver>/prebuilt/gdbserver to
prebuilt/android-<arch>/gdbserver/gdbserver.i686-android-linux- to
i686-linux-android-.sources/cxx-stl/gnu-libstdc++/include and lib to
sources/cxx-stl/gnu-libstdc++/4.6 when compiled with GCC 4.6, or
sources/cxx-stl/gnu-libstdc++/4.4.3 when compiled with GCC 4.4.3.libbfd.a and libintl.a from lib/ to lib32/.build-mingw64-toolchain.sh to generate a new Linux-hosted toolchain
that generates Win32 and Win64 executables.download-toolchain-sources.sh by using the clone command and only using checkout for the directories that are needed to build the NDK
toolchain binaries.build-host-gcc.sh and build-host-gdb.sh scripts.tests/check-release.sh to check the content of a given NDK
installation directory, or an existing NDK package.tests/standalone/run.sh standalone tests .if_dl.h header from all platforms and architectures. The AF_LINK and sockaddr_dl elements it describes are specific to BSD (i.e., they don't exist
in Linux).
Android NDK, Revision 8 (May 2012)
This release of the NDK includes support for MIPS ABI and a few additional fixes.
docs/CPU-MIPS.html in the NDK package.
By default, code is generated for ARM-based devices. You can add mips to
your APP_ABI definition in your Application.mk file to build
for MIPS platforms. For example, the following line instructs ndk-build
to build your code for three distinct ABIs:
APP_ABI := armeabi armeabi-v7a mips
Unless you rely on architecture-specific assembly sources, such as ARM assembly
code, you should not need to touch your Android.mk files to build MIPS
machine code.
--arch=mips
option when calling make-standalone-toolchain.sh. See
docs/STANDALONE-TOOLCHAIN.html for more details.
Note: To ensure that your applications are available to users only if their devices are capable of running them, Google Play filters applications based on the instruction set information included in your application ? no action is needed on your part to enable the filtering. Additionally, the Android system itself also checks your application at install time and allows the installation to continue only if the application provides a library that is compiled for the device's CPU architecture.
dynamic_cast<D>(b) of base class object b to derived class D is
incorrectly adjusted in the opposite direction from the base class.
(Issue 28721)
make-standalone-toolchain.sh fails to copy
libsupc++.*.ndk-build.cmd to ensure that ndk-build.cmd works correctly even
if the user has redefined the SHELL environment variable, which may be changed
when installing a variety of development tools in Windows environments.
Android NDK, Revision 7c (April 2012)
This release of the NDK includes an important fix for Tegra2-based devices, and a few additional fixes and improvements:
cosf, sinf, expf).NDK_OUT
environment variable. When defined, this variable is used to store all
intermediate generated files, instead of $PROJECT_PATH/obj. The variable is
also recognized by ndk-gdb. LOCAL_SHORT_COMMANDS to true in your Android.mk.
This change forces the NDK build system to put most linker or archiver options
into list files, as a work-around for command-line length limitations.
See docs/ANDROID-MK.html for details.
android_getCpuCount() implementation in the cpufeatures
helper library. On certain devices, where cores are enabled dynamically by the system, the previous
implementation would report the total number of active cores the first time the function
was called, rather than the total number of physically available cores.
Android NDK, Revision 7b (February 2012)
This release of the NDK includes fixes for native Windows builds, Cygwin and many other improvements:
sys/atomics.h to avoid correctness issues
on some multi-core ARM-based devices. Rebuild your unmodified sources with this
version of the NDK and this problem should be completely eliminated.
For more details, read docs/ANDROID-ATOMICS.html.binutils 2.19 to fix debugging issues that
appeared in NDK r7 (which switched to binutils 2.20.1).ndk-build on 32-bit Linux. A packaging error put a 64-bit version
of the awk executable under prebuilt/linux-x86/bin in NDK r7.ndk-build.cmd). Other build modes were not
affected. The fixes include:
ndk-build.cmd from a directory that was not the top of
your project path (e.g., in any sub-directory of it).-lstdc++ (i.e., linking against the GNU libstdc++ C++ runtime). You
should use -lgnustl_shared if you want to link against the shared library
version or -lstdc++ for the static version.
See docs/STANDALONE-TOOLCHAIN.html for more details about this fix.
gnustl_shared on Cygwin. The linker complained that it couldn't find
libsupc++.a even though the file was at the right location.APP_STL.libstdc++ runtime, the compiler will
no longer forcibly enable exceptions and RTTI. This change results in smaller code.
If you need these features, you must do one of the following:
Application.mk. (recommended)APP_GNUSTL_FORCE_CPP_FEATURES to 'exceptions',
'rtti' or both in your Application.mk. See
docs/APPLICATION-MK.html for more details.ndk-gdb now works properly when your application has private services
running in independent processes. It debugs the main application process, instead of the
first process listed by ps, which is usually a service process.LOCAL_ARM_MODE value
and always compile certain source files (but not all) to 32-bit instructions.STLport: Refresh the sources to match the Android platform version. This
update fixes a few minor bugs:
memmove instead of memcpy in string::assignIsNANorINF, IsINF, IsNegNAN,
etc.For complete details, see the commit log.
STLport: Removed 5 unnecessary static initializers from the library.cpu-features helper library was updated to report three optional
x86 CPU features (SSSE3, MOVBE and POPCNT). See
docs/CPU-FEATURES.html for more details.docs/NDK-BUILD.html was updated to mention NDK_APPLICATION_MK instead
of NDK_APP_APPLICATION_MK to select a custom Application.mk file.ndk-build no longer creates an empty "NUL" file in the current
directory when invoked./cygdrive./home to \\server\subdir instead of C:\Some\Dir.ndk-build does not try to use the native Windows tools under
$NDK/prebuilt/windows/bin with certain versions of Cygwin and/or GNU Make.
Android NDK, Revision 7 (November 2011)
This release of the NDK includes new features to support the Android 4.0 platform as well as many other additions and improvements:
<OMXAL/OpenMAXAL.h> and
<OMXAL/OpenMAXAL_Android.h> headers allow applications targeting
API level 14 to perform multimedia output directly from native code by using a new
Android-specific buffer queue interface. For more details, see
docs/openmaxal/index.html and http://www.khronos.org/openmax/.docs/opensles/index.html and
http://www.khronos.org/opensles/.NDK_CCACHE environment variable to ccache (or the path to
your ccache binary). When declared, the NDK build system automatically
uses CCache when compiling any source file. For example:
export NDK_CCACHE=ccache
Note: CCache is not included in the NDK release so you must have it installed prior to using it. For more information about CCache, see http://ccache.samba.org.
APP_ABI to all to indicate that
you want to build your NDK modules for all the ABIs supported by your given NDK
release. This means that either one of the following two lines in your
Application.mk are equivalent with this release:
APP_ABI := all APP_ABI := armeabi armeabi-v7a x86
This also works if you define APP_ABI when calling
ndk-build from the command-line, which is a quick way to check that your
project builds for all supported ABIs without changing the project's
Application.mk file. For example:
ndk-build APP_ABI=all
LOCAL_CPP_FEATURES variable in Android.mk that
allows you to declare which C++ features (RTTI or Exceptions) your module uses. This
ensures that the final linking works correctly if you have prebuilt modules that depend
on these features. See docs/ANDROID-MK.html and
docs/CPLUSPLUS-SUPPORT.html for more details.$NDK/ndk-build from your project path, the paths to the source,
object, and binary files that are passed to the build commands are significantly
shorter now, because they are passed relative to the current directory. This is useful
when building projects with a lot of source files, to avoid limits on the maximum
command line length supported by your host operating system. The behavior is unchanged
if you invoke ndk-build from a sub-directory of your project tree, or if
you define NDK_PROJECT_PATH to point to a specific directory.ndk-build.cmd script from the command line from your project path. The
script takes exactly the same arguments as the original ndk-build script.
The Windows NDK package comes with its own prebuilt binaries for GNU Make, Awk and other
tools required by the build. You should not need to install anything else to get a
working build system.
Important: ndk-gdb does not work on
Windows, so you still need Cygwin to debug.
This feature is still experimental, so feel free to try it and report issues on the public bug database or public forum. All samples and unit tests shipped with the NDK succesfully compile with this feature.
libs/<abi>) if APP_MODULES is not defined in
your Application.mk. For example, if a top-level module foo
imports a module bar, then both libfoo.so and
libbar.so are copied to the install location. Previously, only
libfoo.so was copied, unless you listed bar in your
APP_MODULES too. If you define APP_MODULES explicitly, the
behavior is unchanged.ndk-gdb now works correctly for activities with multiple categories in
their MAIN intent filters.foo imports static library bar that imports static
library zoo, the libfoo.so will now be linked against both
libbar.a and libzoo.a.docs/NATIVE-ACTIVITY.HTML: Fixed typo. The minimum API level should be
9, not 8 for native activities.docs/STABLE-APIS.html: Added missing documentation listing EGL as a
supported stable API, starting from API level 9.download-toolchain-sources.sh: Updated to download the toolchain
sources from android.googlesource.com,
which is the new location for the AOSP servers.gabi++. More details about it
are available in the updated docs/CPLUSPLUS-SUPPORT.html.gnustl_shared that corresponds
to the shared library version of GNU libstdc++ v3 (GPLv3 license). See more info at
docs/CPLUSPLUS-SUPPORT.htmlLOCAL_CPP_EXTENSION. For
example, to compile both foo.cpp and bar.cxx as C++ sources,
declare the following:
LOCAL_CPP_EXTENSION := .cpp .cxx
The extensions that are available depend on your actual device and GPU drivers,
not the platform version the device runs on. The header changes simply add new
constants and types to make it easier to use the extensions when they have been
probed with eglGetProcAddress() or glGetProcAddress(). The
following list describes the newly supported extensions:
GL_OES_vertex_array_objectGL_OES_EGL_image_externalGL_APPLE_texture_2D_limited_npotGL_EXT_blend_minmaxGL_EXT_discard_framebufferGL_EXT_multi_draw_arraysGL_EXT_read_format_bgraGL_EXT_texture_filter_anisotropicGL_EXT_texture_format_BGRA8888GL_EXT_texture_lod_biasGL_IMG_read_formatGL_IMG_texture_compression_pvrtcGL_IMG_texture_env_enhanced_fixed_functionGL_IMG_user_clip_planeGL_IMG_multisampled_render_to_textureGL_NV_fenceGL_QCOM_driver_controlGL_QCOM_extended_getGL_QCOM_extended_get2GL_QCOM_perfmon_global_modeGL_QCOM_writeonly_renderingGL_QCOM_tiled_renderingGL_OES_element_index_uintGL_OES_get_program_binaryGL_OES_mapbufferGL_OES_packed_depth_stencilGL_OES_texture_3DGL_OES_texture_floatGL_OES_texture_float_linearGL_OES_texture_half_float_linearGL_OES_texture_npotGL_OES_vertex_array_objectGL_OES_EGL_image_externalGL_AMD_program_binary_Z400GL_EXT_blend_minmaxGL_EXT_discard_framebufferGL_EXT_multi_draw_arraysGL_EXT_read_format_bgraGL_EXT_texture_format_BGRA8888GL_EXT_texture_compression_dxt1GL_IMG_program_binaryGL_IMG_read_formatGL_IMG_shader_binaryGL_IMG_texture_compression_pvrtcGL_IMG_multisampled_render_to_textureGL_NV_coverage_sampleGL_NV_depth_nonlinearGL_QCOM_extended_getGL_QCOM_extended_get2GL_QCOM_writeonly_renderingGL_QCOM_tiled_renderingEGL_ANDROID_recordableEGL_NV_system_time
Android NDK, Revision 6b (August 2011)
This release of the NDK does not include any new features compared to r6. The r6b release addresses the following issues in the r6 release:
APP_ABI="armeabi x86" is used for
multi-architecture builds.atexit() usage in shared libraries with the x86standalone
toolchain.make-standalone-toolchain.sh --arch=x86. It used to fail
to copy the proper GNU libstdc++ binaries to the right location.__dso_handle symbol (ARM only).$(SYSROOT)/usr/include for x86 builds.
See the bug for
more information.ptrdiff_t and size_t in
x86-specific systems when they are used with the x86 standalone toolchain.
Android NDK, Revision 6 (July 2011)
This release of the NDK includes support for the x86 ABI and other minor changes.
For detailed information describing the changes in this release, read the
CHANGES.HTML document included in the NDK package.
docs/CPU-X86.html in the NDK package.
By default, code is generated for ARM-based devices, but you can add x86 to your
APP_ABI definition in your Application.mk file to build
for x86 platforms. For example, the following line instructs ndk-build
to build your code for three distinct ABIs:
APP_ABI := armeabi armeabi-v7a x86
Unless you rely on ARM-based assembly sources, you shouldn't need to touch
your Android.mk files to build x86 machine code.
--toolchain=x86-4.4.3
option when calling make-standalone-toolchain.sh. See
docs/STANDALONE-TOOLCHAIN.html for more details.
ndk-stack tool lets you translate stack traces in
logcat that are generated by native code. The tool translates
instruction addresses into a readable format that contains things such
as the function, source file, and line number corresponding to each stack frame.
For more information and a usage example, see docs/NDK-STACK.html.
arm-eabi-4.4.0, which had been deprecated since NDK r5, has been
removed from the NDK distribution.
Android NDK, Revision 5c (June 2011)
This release of the NDK does not include any new features compared to r5b. The r5c release addresses the following problems in the r5b release:
ndk-build: Fixed a rare bug that appeared when trying to perform parallel
builds of debuggable projects.LOCAL_WHOLE_STATIC_LIBRARIES to work
correctly with the new toolchain and added documentation for this in
docs/ANDROID-MK.html.gnustl_static crashed when run on
platform releases older than API level 8 (Android 2.2).ndk-gdb: Fixed a bug that caused a segmentation fault when debugging
Android 3.0
or newer devices.<android/input.h>: Two functions that were introduced in API level
9 (Android 2.3) were incorrect and are fixed. While this breaks the source API, the
binary interface to the system is unchanged. The incorrect functions were missing a
history_index parameter, and the correct definitions are shown below:
float AMotionEvent_getHistoricalRawX(const AInputEvent* motion_event,
size_t pointer_index,
size_t history_index);
float AMotionEvent_getHistoricalRawY(const AInputEvent* motion_event,
size_t pointer_index,
size_t history_index);
pthread_rwlock_init).LOCAL_SRC_FILES. This was not the case previously because the files were
grouped by source extensions instead.import-module fails, it now prints the list of directories that
were searched. This is useful to check that the NDK_MODULE_PATH definition
used by the build system is correct.import-module succeeds, it now prints the directory where the
module was found to the log (visible with NDK_LOG=1).ndk-gdb: Better detection of adb shell failures and improved
error messages.<pthread.h>: Fixed the definition of
PTHREAD_RWLOCK_INITIALIZER for API level 9 (Android 2.3) and higher.LOCAL_ARM_NEON was set to
true (typo in build/core/build-binary.mk)..s assembly files
(.S files were okay).
Android NDK, Revision 5b (January 2011)
This release of the NDK does not include any new features compared to r5. The r5b release addresses the following problems in the r5 release:
ndk-build issues:
cygpath -m
from GNU Make for every source or object file, which caused problems
with very large source trees. In case this doesn't work properly, define
NDK_USE_CYGPATH=1 in your
environment to use cygpath -m again.NDK_MODULE_PATH environment variable from
working properly when
it contained multiple directories separated with a colon. prebuilt-common.sh script contains fixes to check the compiler for 64-bit
generated machine code, instead of relying on the host tag, which
allows the 32-bit toolchain to rebuild properly on Snow Leopard. The toolchain rebuild scripts
now also support
using a 32-bit host toolchain.INET_ADDRSTRLEN was added to
<netinet/in.h>.IN6_IS_ADDR_MC_NODELOCAL and
IN6_IS_ADDR_MC_GLOBAL were added to <netinet/in6.h>.<asm/byteorder.h> to allow
compilation with -std=c99.
Android NDK, Revision 5 (December 2010)
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 Google Play to benefit from the improvements.native-plasma and
native-activity,
to demonstrate how to write a native activity.
Android NDK, Revision 4b (June 2010)
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.
Android NDK, Revision 3 (March 2010)
hello-gl2, that illustrates the use of
OpenGL ES 2.0 vertex and fragment shaders.
Android NDK, Revision 2 (September 2009)
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.
Android NDK, Revision 1 (June 2009)
Originally released as "Android 1.5 NDK, Release 1".
The sections below describe the system and software requirements for using the Android NDK, as well as platform compatibility considerations that affect appplications using libraries produced with the NDK.
| Native Code CPU Architecture Used | Compatible Android Platform(s) |
|---|---|
| ARM, ARM-NEON | Android 1.5 (API Level 3) and higher |
| x86 | Android 2.3 (API Level 9) and higher |
| MIPS | Android 2.3 (API Level 9) and higher |
These requirements mean you can use native libraries produced with the NDK in applications that are deployable to ARM-based devices running Android 1.5 or later. If you are deploying native libraries to x86 and MIPS-based devices, your application must target Android 2.3 or later.
<uses-sdk> element in its manifest file, with an
android:minSdkVersion attribute value of "3" or higher. For example:
<manifest> <uses-sdk android:minSdkVersion="3" /> ... </manifest>
android:minSdkVersion attribute value, as shown in the
following table.| OpenGL ES Version Used | Compatible Android Platform(s) | Required uses-sdk Attribute |
|---|---|---|
| OpenGL ES 1.1 | Android 1.6 (API Level 4) and higher | android:minSdkVersion="4" |
| OpenGL ES 2.0 | Android 2.0 (API Level 5) and higher | android:minSdkVersion="5" |
For more information about API Level and its relationship to Android platform versions, see Android API Levels.
<uses-feature> element in its manifest, with an
android:glEsVersion attribute that specifies the minimum OpenGl ES version
required by the application. This ensures that Google Play will show your application only
to users whose devices are capable of supporting your application. For example:
<manifest> <uses-feature android:glEsVersion="0x00020000" /> ... </manifest>
For more information, see the <uses-feature>
documentation.
Bitmap pixel buffers or utilizes native activities, the application
containing the library can be deployed only to devices running Android 2.2 (API level 8) or
higher. To ensure compatibility, make sure that your application declares <uses-sdk
android:minSdkVersion="8" /> attribute value in its manifest.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, first download the appropriate package from the table at the top of this page. Then, follow the procedure for your development platform:
chmod a+x on the downloaded package.
ndk$ chmod a+x android-ndk-r10c-darwin-x86_64.bin
ndk$ ./android-ndk-r10c-darwin-x86_64.bin
The folder containing the NDK extracts itself.
Note that you can also use a program like 7z to extract the package.
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 Android framework provides two ways to use native code:
Write a native activity, which allows you to implement the lifecycle callbacks in native
code. The Android SDK provides the NativeActivity class, which is a
convenience class that notifies your
native code of any activity lifecycle callbacks (onCreate(),
onPause(),
onResume(), etc). You can implement the callbacks in your native code to handle
these events when they occur. Applications that use native activities must be run on Android
2.3 (API Level 9) or later.
You cannot access features such as Services and Content Providers natively, so if you want to use them or any other framework API, you can still write JNI code to do so.
The NDK contains the APIs, documentation, and sample applications that help you write your native code. Specifically:
.apk) that can be deployed on Android devicesThe latest release of the NDK supports the following instruction sets:
docs/CPU-ARCH-ABIS.html for more
information)docs/CPU-ARM-NEON.html for more information)docs/CPU-X86.html for more information)docs/CPU-MIPS.html for more information)ARMv5TE machine code will run on all ARM-based Android devices. ARMv7-A will run only on
devices such as the Verizon Droid or Google Nexus One that have a compatible CPU. The main
difference between the two instruction sets is that ARMv7-A supports hardware FPU, Thumb-2, and
NEON instructions. You can target either or both of the instruction sets — ARMv5TE is the
default, but switching to ARMv7-A is as easy as adding a single line to the application's
Application.mk file, without needing to change anything else in the file. You can
also build for
both architectures at the same time and have everything stored in the final .apk.
Complete information is provided in the CPU-ARCH-ABIS.HTML in the NDK package.
The NDK provides stable headers for libc (the C library), libm (the Math library), OpenGL ES (3D graphics library), the JNI interface, and other libraries, as listed in the Development tools section.
The NDK includes a set of cross-toolchains (compilers, linkers, etc.) that can generate native ARM binaries on Linux, OS X, and Windows (with Cygwin) platforms.
It provides a set of system headers for stable native APIs that are guaranteed to be supported in all later releases of the platform:
The NDK also provides a build system that lets you work efficiently with your sources, without having to handle the toolchain/platform/CPU/ABI details. You create very short build files to describe which sources to compile and which Android application will use them — the build system compiles the sources and places the shared libraries directly in your application project.
Important: With the exception of the libraries listed above, native system libraries in the Android platform are not stable and may change in future platform versions. Your applications should only make use of the stable native system libraries provided in this NDK.
The NDK package includes a set of documentation that describes the capabilities of the NDK and
how to use it to create shared libraries for your Android applications. In this release, the
documentation is provided only in the downloadable NDK package. You can find the documentation in
the <ndk>/docs/ directory. Included are these files (partial listing):
cpufeatures static library that
lets your application code detect the target device's CPU family and the optional features at
runtime.Additionally, the package includes detailed information about the "bionic" C library provided
with the Android platform that you should be aware of, if you are developing using the NDK. You
can find the documentation in the <ndk>/docs/system/libc/ directory:
The NDK includes sample applications that illustrate how to use native code in your Android applications:
hello-jni — a simple application that loads a string from a native
method implemented in a shared library and then displays it in the application UI.two-libs — a simple application that loads a shared library dynamically
and calls a native method provided by the library. In this case, the method is implemented in a
static library imported by the shared library.san-angeles — a simple application that renders 3D graphics through the
native OpenGL ES APIs, while managing activity lifecycle with a GLSurfaceView object.hello-gl2 — a simple application that renders a triangle using OpenGL ES
2.0 vertex and fragment shaders.hello-neon — a simple application that shows how to use the
cpufeatures library to check CPU capabilities at runtime, then use NEON intrinsics
if supported by the CPU. Specifically, the application implements two versions of a tiny
benchmark for a FIR filter loop, a C version and a NEON-optimized version for devices that
support it.bitmap-plasma — a simple application that demonstrates how to access the
pixel buffers of Android Bitmap objects from native code, and uses
this to generate an old-school "plasma" effect.native-activity — a simple application that demonstrates how to use the
native-app-glue static library to create a native activitynative-plasma — a version of bitmap-plasma implemented with a native
activity.For each sample, the NDK includes the corresponding C source code and the necessary Android.mk
and Application.mk files. There are located under <ndk>/samples/<name>/
and their source code can be found under <ndk>/samples/<name>/jni/.
You can build the shared libraries for the sample apps by going into
<ndk>/samples/<name>/ then calling the ndk-build command.
The generated shared libraries will be located under
<ndk>/samples/<name>/libs/armeabi/ for (ARMv5TE machine code) and/or
<ndk>/samples/<name>/libs/armeabi-v7a/ for (ARMv7 machine code).
Next, build the sample Android applications that use the shared libraries:
<ndk>/samples/<name>/. Then, set up an AVD,
if necessary, and build/run the application in the emulator.android tool to create the build file
for each of the sample projects at <ndk>/samples/<name>/.
Then set up an AVD, if necessary, build your project in the usual way, and run it in the
emulator.For more information about developing with the Android SDK tools and what you need to do to create, build, and run your applications, see the Overview section for developing on Android.
The hello-jni sample is a simple demonstration on how to use JNI from an Android application. The HelloJni activity receives a string from a simple C function and displays it in a TextView.
The main components of the sample include:
AndroidManifest.xml
file, a src/ and res directories, and a main activity)jni/ directory that includes the implemented source file for the native code
as well as the Android.mk filetests/ directory that contains unit test code.android tool to update the project so it generates a build.xml file that you can
use to build the sample.
<ndk-root>/samples/hello-jni directory.<ndk-root>/samples/hello-jni directory.android update project -p . -s
ndk-build command.
cd <ndk-root>/samples/hello-jni <ndk_root>/ndk-build
ant debug adb install bin/HelloJni-debug.apk
When you run the application on the device, the string Hello JNI should appear on
your device. You can explore the rest of the samples that are located in the
<ndk-root>/samples directory for more examples on how to use the JNI.
The native-activity sample provided with the Android NDK demonstrates how to use the android_native_app_glue static library. This static library makes creating a native activity easier by providing you with an implementation that handles your callbacks in another thread, so you do not have to worry about them blocking your main UI thread. The main parts of the sample are described below:
AndroidManifest.xml
file, a src/ and res directories). The AndroidManifest.xml declares
that the application is native and specifies the .so file of the native activity. See NativeActivity for the source or see the
<ndk_root>/platforms/samples/native-activity/AndroidManifest.xml file.jni/ directory contains the native activity, main.c, which uses the
android_native_app_glue.h interface to implement the activity. The Android.mk that
describes the native module to the build system also exists here.To build this sample application:
android tool to update the project so it generates a build.xml file that you can
use to build the sample.
<ndk-root>/samples/native-activity directory.<ndk-root>/samples/native-activity directory.android update project -p . -s
ndk-build command.
cd <ndk-root>/platforms/samples/android-9/samples/native-activity <ndk_root>/ndk-build
ant debug adb install bin/NativeActivity-debug.apk