Android NDK Changelog

What's new in Android NDK R26d

Apr 11, 2024
  • Issue 1994: Fixed ndk-gdb/ndk-lldb to use the correct path for make and other tools.

New in Android NDK R26c (Feb 13, 2024)

  • Updated LLVM to clang-r487747d. See AndroidVersion.txt and clang_source_info.md in the toolchain directory for version information.
  • Issue 1928: Fixed Clang crash in instruction selection for 32-bit armv8 floating point.
  • Issue 1953: armeabi-v7a libc++ libraries are once again built as thumb.

New in Android NDK R26b (Oct 11, 2023)

  • Updated LLVM to clang-r487747d. See AndroidVersion.txt and clang_source_info.md in the toolchain directory for version information.
  • This update was intended to be included in r26 RC 1. The original release noted these fixes in the changelog, but the new toolchain had not actually been included.
  • Issue 1907: HWASan linker will be used automatically for minSdkVersion 34 or higher.
  • Issue 1909: Fixed ABI mismatch between function-multi-versioning and ifunc resolvers.
  • Issue 1938: Fixed ndk-stack to use the correct path for llvm-symbolizer and other tools.
  • Changes:
  • Updated LLVM to clang-r487747c. See AndroidVersion.txt and clang_source_info.md in the toolchain directory for version information.
  • Clang now treats -Wimplicit-function-declaration as an error rather than a warning in C11 and newer. Clang's default C standard is 17, so this is a change in default behavior compared to older versions of Clang, but is the behavior defined by C99.
  • If you encounter these errors when upgrading, you most likely forgot an #include. If you cannot (or do not want to) fix those issues, you can revert to the prior behavior with -Wno-error=implicit-function-declaration.
  • C++ users are unaffected. This has never been allowed in C++.
  • See https://reviews.llvm.org/D122983 for more details.
  • Issue 1298: Fixed seccomp error with ASan on x86_64 devices.
  • Issue 1530: Updated libc++ to match LLVM version.
  • Issue 1565: Fixed lldb ncurses issue with terminal database on Darwin.
  • Issue 1677: Fixed Clang crash in optimizer.
  • Issue 1679: Clang will now automatically enable ELF TLS for minSdkVersion 29 or higher.
  • Issue 1834: Fixed Clang crash during SVE conversions.
  • Issue 1860: Fixed miscompilation affecting armv7.
  • Issue 1861: Fixed front end crash in Clang.
  • Issue 1862: Fixed Clang crash for aarch64 with -Os.
  • Issue 1880: Fixed crash in clang-format.
  • Issue 1883: Fixed crash when incorrectly using neon intrinsics.
  • Version scripts that name public symbols that are not present in the library will now emit an error by default for ndk-build and the CMake toolchain file. Build failures caused by this error are likely a bug in your library or a mistake in the version script. To revert to the earlier behavior, pass -DANDROID_ALLOW_UNDEFINED_VERSION_SCRIPT_SYMBOLS=ON to CMake or set LOCAL_ALLOW_UNDEFINED_VERSION_SCRIPT_SYMBOLS := true in your Android.mk file. For other build systems, see the secion titled "Version script validation" in the build system maintainers guide.
  • [Issue 873]: Weak symbols for API additions is supported. Provide __ANDROID_UNAVAILABLE_SYMBOLS_ARE_WEAK__ as an option.
  • Issue 1400: NDK paths with spaces will now be diagnosed by ndk-build on Windows. This has never been supported for any OS, but the error message wasn't previously working on Windows either.
  • Issue 1764: Fixed Python 3 incompatibility when using ndk-gdb with -f.
  • Issue 1803: Removed useless strtoq and strtouq from the libc stub libraries. These were never exposed in the header files, but could confuse some autoconf like systems.
  • Issue 1852: Fixed ODR issue in linux/time.h.
  • Issue 1878: Fixed incorrect definition of WIFSTOPPED.
  • ndk-build now uses clang rather than clang++ when linking modules that do not have C++ sources. There should not be any observable behavior differences because ndk-build previously handled the C/C++ linking differences itself.
  • ndk-build now delegates C++ stdlib linking to the Clang driver. It is unlikely that this will cause any observable behavior change, but any new behavior will more closely match CMake and other build systems.

New in Android NDK R26 (Sep 19, 2023)

  • Updated LLVM to clang-r487747c, based on LLVM 17 development.
  • Clang now treats -Wimplicit-function-declaration as an error rather than a warning in C11 and newer. Clang's default C standard is 17, so this is a change in default behavior compared to older versions of Clang, but is the behavior defined by C99.
  • If you encounter these errors when upgrading, you most likely forgot an #include. If you cannot (or do not want to) fix those issues, you can revert to the prior behavior with -Wno-error=implicit-function-declaration.
  • C++ users are unaffected. This has never been allowed in C++.
  • See https://reviews.llvm.org/D122983 for more details.
  • Issue 1298: Fixed seccomp error with ASan on x86_64 devices.
  • Issue 1530: Updated libc++ to match LLVM version.
  • Issue 1565: Fixed lldb ncurses issue with terminal database on Darwin.
  • Issue 1677: Fixed Clang crash in optimizer.
  • Issue 1679: Clang will now automatically enable ELF TLS for minSdkVersion 29 or higher.
  • Issue 1834: Fixed Clang crash during SVE conversions.
  • Issue 1860: Fixed miscompilation affecting armv7.
  • Issue 1861: Fixed front end crash in Clang.
  • Issue 1862: Fixed Clang crash for aarch64 with -Os.
  • Issue 1880: Fixed crash in clang-format.
  • Issue 1883: Fixed crash when incorrectly using neon intrinsics.
  • Issue 1907: HWASan linker will be used automatically for minSdkVersion 34 or higher.
  • Issue 1909: Fixed ABI mismatch between function-multi-versioning and ifunc resolvers.
  • Version scripts that name public symbols that are not present in the library will now emit an error by default for ndk-build and the CMake toolchain file. Build failures caused by this error are likely a bug in your library or a mistake in the version script. To revert to the earlier behavior, pass -DANDROID_ALLOW_UNDEFINED_VERSION_SCRIPT_SYMBOLS=ON to CMake or set LOCAL_ALLOW_UNDEFINED_VERSION_SCRIPT_SYMBOLS := true in your Android.mk file. For other build systems, see the secion titled "Version script validation" in the build system maintainers guide.
  • [Issue 873]: Weak symbols for API additions is supported. Provide __ANDROID_UNAVAILABLE_SYMBOLS_ARE_WEAK__ as an option.
  • Issue 1400: NDK paths with spaces will now be diagnosed by ndk-build on Windows. This has never been supported for any OS, but the error message wasn't previously working on Windows either.
  • Issue 1764: Fixed Python 3 incompatibility when using ndk-gdb with -f.
  • Issue 1803: Removed useless strtoq and strtouq from the libc stub libraries. These were never exposed in the header files, but could confuse some autoconf like systems.
  • Issue 1852: Fixed ODR issue in linux/time.h.
  • Issue 1878: Fixed incorrect definition of WIFSTOPPED.
  • ndk-build now uses clang rather than clang++ when linking modules that do not have C++ sources. There should not be any observable behavior differences because ndk-build previously handled the C/C++ linking differences itself.
  • ndk-build now delegates C++ stdlib linking to the Clang driver. It is unlikely that this will cause any observable behavior change, but any new behavior will more closely match CMake and other build systems.

New in Android NDK R25 (Jul 14, 2022)

  • Includes Android 13 APIs.
  • Updated LLVM to clang-r450784d, based on LLVM 14 development.
  • Issue 1455: Improved display of Android API levels in Clang diagnostics.
  • Issue 1710: Fixed compiler crash caused by invalid -march values.
  • Eliminate duplicate static libraries in API-versioned sysroot directories. This reduces the uncompressed size of the NDK by 500 MB.
  • Strip some binaries and libraries. This reduces the uncompressed size of the NDK by 300 MB.
  • Remove python2. All scripts now use python3.
  • Issue 933: Updated reference ASan wrap.sh to support attaching the Java debugger.
  • Issue 1334: Improved argument escaping for compile_commands.json files generated by ndk-build.
  • Issue 1634: Fixed the build rule for the libshaderc_combined target.
  • Issue 1693: The NDK's toolchain file for CMake (android.toolchain.cmake) defaults to the legacy toolchain file for all versions of CMake. The new toolchain file can still be enabled using -DANDROID_USE_LEGACY_TOOLCHAIN_FILE=OFF.
  • Issue 1717: Arranged for --gc-sections to be passed to the linker when building shared libraries.

New in Android NDK R24 (Jul 14, 2022)

  • The GNU Assembler (GAS), has been removed. If you were building with -fno-integrated-as you'll need to remove that flag. See Clang Migration Notes for advice on making assembly compatible with LLVM.
  • GDB has been removed. Use LLDB instead. Note that ndk-gdb uses LLDB by default, and Android Studio has only ever supported LLDB.
  • Jelly Bean (APIs 16, 17, and 18) is no longer supported. The minimum OS supported by the NDK is KitKat (API level 19).
  • Non-Neon devices are no longer supported. A very small number of very old devices do not support Neon so most apps will not notice aside from the performance improvement.
  • RenderScript build support has been removed. RenderScript was deprecated in Android 12. If you have not finished migrating your apps away from RenderScript, NDK r23 LTS can be used.

New in Android NDK R23c (May 27, 2022)

  • Update LLVM to clang-r416183c2, based on LLVM 12 development.
  • Issue 1590: Fixed LLDB crashes when calling help on unknown commands.
  • Issue 1608: Fixed crash in vector conversions.
  • Issue 1619: Fixed performance regression in arm64 vectorization.
  • Issue 1645: Fixed crash caused by openmp master/critical pragmas.
  • Issue 1672: Fixed armeabi-v7a libunwind.a to be compatible with vfpv3-d16 (remember that this is the last release that will support that FPU setting).
  • Issue 1410: Fix ndk-build for Apple M1.
  • Issue 1546: Universal binaries (M1 support) for make (affects ndk-build).
  • Issue 1577: Universal binaries (M1 support) for shader-tools (vulkan compilers).
  • Issue 1569: Fix -fno-integrated-as for Linux and Darwin hosts by making GAS symlink relative
  • Issue 1589: Fix incorrect API level check for -Wl,--no-rosegment in ndk-build and CMake.
  • Issue 1593: Improved ndk-which to fall back to LLVM tools when the GNU names are used. For example, ndk-which strip will now return the path to llvm-strip instead of nothing.
  • Issue 1610: Fix ANDROID_NATIVE_API_LEVEL CMake variable when using the non-legacy toolchain file.
  • Issue 1618: Fix behavior of ANDROID_CPP_FEATURES with the new toolchain file.
  • Issue 1656: The new CMake toolchain file now ignores ANDROID_ARM_MODE when it is passed for ABIs other than armeabi-v7a like the legacy toolchain file did. With CMake 3.22 it is an error to set CMAKE_ANDROID_ARM_MODE for other ABIs, so this fixes a potential incompatibility between the legacy and new toolchains when using CMake 3.22+.
  • Issue 1693: The NDK's toolchain file for CMake (android.toolchain.cmake) defaults to the legacy toolchain file for all versions of CMake. The new toolchain file can still be enabled using -DANDROID_USE_LEGACY_TOOLCHAIN_FILE=OFF.

New in Android NDK R23b (Oct 20, 2021)

  • Update LLVM to clang-r416183c1, based on LLVM 12 development.
  • Issue 1540: Fixed compiler crash when using coroutines.
  • Issue 1544: Now uses universal binaries for M1 Macs.
  • Issue 1551: Prevent each translation unit from receiving its own copy of emulated thread-local global variables.
  • Issue 1555: Fixed compiler crash for armeabi-v7a.
  • Issue 1492: ndk-build.cmd: Stop using make's -O (--output-sync) flag on Windows to avoid fcntl(): Bad file descriptor error.
  • Issue 1553: Updated sysroot to latest Android 12.
  • Issue 1569: Fixed -fno-integrated-as not being able to find the assembler.
  • CMake changes:
  • Issue 1536: Make optimization flags used with CMake more consistent. Historically thumb release builds used -Oz, but AGP switched to using RelWithDebInfo for release builds in the latest release which was not using -Oz. To reduce per-arch differences and behavior differences compared to CMake's defaults, -Oz use was removed. You may see code size increases for armeabi-v7a due to this, but also increased optimization. To restore the prior behavior, add -Oz to your cflags.
  • Issue 1560: Fixed pull-up of unsupported API levels when using the new CMake toolchain file. This affects CMake 3.21 and ANDROID_USE_LEGACY_TOOLCHAIN_FILE=ON use cases, and was the common case for AGP users with a minSdkVersion below 21.
  • Issue 1573: Fixed ANDROID_USE_LEGACY_TOOLCHAIN_FILE not being obeyed during CMake try-compile.
  • Issue 1581: Added workaround for CMake Issue 22647, which was causing MINGW to be incorrectly defined by CMake when building for Android on a Windows host. This only affected those using the Android toolchain file when CMake 3.21 or newer was used. This likely was not a regression for users not using the Android toolchain. The change will fix both use cases.

New in Android NDK R23 (Aug 12, 2021)

  • Announcements:
  • GNU binutils, excluding the GNU Assembler (GAS), has been removed. GAS will be removed in the next release. If you are building with -fno-integrated-as, file bugs if anything is preventing you from removing that flag.
  • Support for GDB has ended. GDB will be removed from the next release. Use LLDB instead. Note that ndk-gdb uses LLDB by default.
  • NDK r23 is the last release that will support non-Neon. Beginning with NDK r24, the armeabi-v7a libraries in the sysroot will be built with Neon. A very small number of very old devices do not support Neon so most apps will not notice aside from the performance improvement.
  • Jelly Bean (APIs 16, 17, and 18) will not be supported in the next NDK release. The minimum OS supported by the NDK for r24 will be KitKat (API level 19).
  • Changes:
  • Includes Android 12 APIs.
  • Updated LLVM to clang-r416183b, based on LLVM 12 development.
  • Issue 1047: Fixes crash when using ASan with the CFI unwinder.
  • Issue 1096: Includes support for Polly. Enable by adding -mllvm -polly to your cflags.
  • Issue 1230: LLVM's libunwind is now used instead of libgcc for all architectures rather than just 32-bit Arm.
  • Issue 1231: LLVM's libclang_rt.builtins is now used instead of libgcc.
  • Issue 1406: Fixes crash with Neon intrinsic.
  • Vulkan validation layer source and binaries are no longer shipped in the NDK. The latest are now posted directly to GitHub.
  • Vulkan tools source is also removed, specifically vulkan_wrapper. It should be downloaded upstream from GitHub.
  • The toolchain file (android.toolchain.cmake) is refactored to base on CMake's integrated Android support. This new toolchain file will be enabled by default for CMake 3.21 and newer. No user side change is expected. But if anything goes wrong, please file a bug and set ANDROID_USE_LEGACY_TOOLCHAIN_FILE=ON to restore the legacy behavior.
  • When using the new behavior (when using CMake 3.21+ and not explicitly selecting the legacy toolchain), default build flags may change. One of the primary goals was to reduce the behavior differences between our toolchain and CMake, and CMake's default flags do not always match the legacy toolchain file. Most notably, if using CMAKE_BUILD_TYPE=Release, your optimization type will likely be -O3 instead of -O2 or -Oz. See Issue 1536 for more information.
  • Issue 929: find_library now prefers shared libraries from the sysroot over static libraries.
  • Issue 1390: ndk-build now warns when building a static executable with the wrong API level.
  • Issue 1452: NDK_ANALYZE=1 now sets APP_CLANG_TIDY=true rather than using scan-build. clang-tidy performs all the same checks by default, and scan-build was no longer working. See the bug for more details, but no user-side changes should be needed.

New in Android NDK R22b (Mar 26, 2021)

  • Announcements:
  • GNU binutils is deprecated and will be removed in an upcoming NDK release. Note that the GNU assembler (as) is a part of this. If you are building with -fno-integrated-as, file bugs if anything is preventing you from removing that flag. If you're using as directly, use clang instead.
  • LLD is now the default linker. ndk-build and our CMake toolchain file have also migrated to using llvm-ar and llvm-strip.
  • See the Changes section below for more information.
  • r22b:
  • Issue 1377: Fix Clang backend crash in register scavenging.
  • Issue 1388: Fixed LLVM's incorrect conversion to list files for long command lines on Windows.
  • Issue 1391: Fixed missing symbols from libz.a.
  • Issue 1427: Fixed Clang auto-detection for CMake 3.19 and older for Windows.
  • Changes:
  • Updated LLVM to r399163b, based on LLVM 11 development.
  • Issue 829: Fixed issue with __attribute__((visibility("hidden"))) symbols sometimes not being hidden.
  • Issue 1149: Fixed Clang crash with #pragma detect_mismatch.
  • Issue 1212: Fixed llvm-strip to match GNU behavior for removing file symbols.
  • Issue 1248: Fixed LLD Neon crash.
  • Issue 1303: Fixed Neon intrinsic optimizer crash.
  • Updated make to 4.3.
  • Updated libc++, libc++abi, and libunwind to https://github.com/llvm/llvm-project/commit/52ec983895436089c5be0b0c4d967423db16045b.
  • Issue 609: std::filesystem support is now included. There are two known issues.
  • Issue 1258: std::filesystem::perm_options::nofollow may not be honored on old devices.
  • Issue 1260: std::filesystem::canonical will incorrectly succeed when passed a non-existent path on old devices.
  • Issue 843: llvm-strip is now used instead of strip to avoid breaking RelRO with LLD. Note that the Android Gradle Plugin performs its own stripping, so most users will need to upgrade to Android Gradle Plugin version 4.0 or newer to get the fix.
  • Issue 1130: Fixed undefined references to new that could occur when building for APIs prior to 21 and the static libc++. Note that LLD appears to have been unaffected, but the problem is still present for ndk-build when using the deprecated linkers.
  • Issue 1139: native_app_glue now hooks up the APP_CMD_WINDOW_RESIZED, APP_CMD_WINDOW_REDRAW_NEEDED, and APP_CMD_CONTENT_RECT_CHANGED messages.
  • Issue 1196: Backtraces for crashes on devices older than API 29 are now correct when using LLD if using ndk-build or the CMake toolchain file. If using a different system and targeting devices older than API 29, use -Wl,--no-rosegment when linking. See the Build System Maintainers Guide for more information.
  • The deprecated /platforms and /sysroot directories have been removed. These directories were merged and relocated into the toolchain during r19. The location of these contents should not be relevant to anyone, including build systems, since the toolchain handles them implicitly. If you are using a build system that hasn't adapted to the changes introduced in NDK r19, file a bug with your build system maintainer. See the Build System Maintainers Guide for information on using the NDK in your own build system.
  • llvm-ar is now used instead of ar.
  • Issue 1200: Fixed an issue with using dlclose with libraries using thread_local with non-trivial destructors and the static libc++.
  • The legacy libc++ linker scripts in /sources/cxx-stl/llvm-libc++ have been removed. The linkers scripts in the toolchain should be used instead as described by the Build System Maintainers Guide.
  • LLD is now used by default. If your build is not yet compatible with LLD, you can continue using the deprecated linkers, set APP_LD=deprecated for ndk-build, ANDROID_LD=deprecated for CMake, or use an explicit -fuse-ld=gold or -fuse-ld=bfd in your custom build system. If you encounter issues be sure to file a bug, because this will not be an option in a subsequent release.
  • Note that Issue 843 will affect builds using LLD with binutils strip and objcopy as opposed to llvm-strip and llvm-objcopy.
  • ndk-gdb now uses lldb as the debugger. gdb is deprecated and will be removed in a future release. To fall back to gdb, use --no-lldb option. But please file a bug explaining why you couldn't use lldb.

New in Android NDK R21e (Jan 29, 2021)

  • Updated LLVM to r399163b, based on LLVM 11 development.
  • Issue 829: Fixed issue with __attribute__((visibility("hidden"))) symbols sometimes not being hidden.
  • Issue 1149: Fixed Clang crash with #pragma detect_mismatch.
  • Issue 1212: Fixed llvm-strip to match GNU behavior for removing file symbols.
  • Issue 1248: Fixed LLD Neon crash.
  • Issue 1303: Fixed Neon intrinsic optimizer crash.
  • Updated make to 4.3.
  • Updated libc++, libc++abi, and libunwind to https://github.com/llvm/llvm-project/commit/52ec983895436089c5be0b0c4d967423db16045b.
  • Issue 609: std::filesystem support is now included. There are two known issues
  • Issue 1258: std::filesystem::perm_options::nofollow may not be honored on old devices.
  • Issue 1260: std::filesystem::canonical will incorrectly succeed when passed a non-existent path on old devices.
  • Issue 843: llvm-strip is now used instead of strip to avoid breaking RelRO with LLD. Note that the Android Gradle Plugin performs its own stripping, so most users will need to upgrade to Android Gradle Plugin version 4.0 or newer to get the fix.
  • Issue 1130: Fixed undefined references to new that could occur when building for APIs prior to 21 and the static libc++. Note that LLD appears to have been unaffected, but the problem is still present for ndk-build when using the deprecated linkers.
  • Issue 1139: native_app_glue now hooks up the APP_CMD_WINDOW_RESIZED, APP_CMD_WINDOW_REDRAW_NEEDED, and APP_CMD_CONTENT_RECT_CHANGED messages.
  • Issue 1196: Backtraces for crashes on devices older than API 29 are now correct when using LLD if using ndk-build or the CMake toolchain file. If using a different system and targeting devices older than API 29, use -Wl,--no-rosegment when linking. See the Build System Maintainers Guide for more information.
  • The deprecated /platforms and /sysroot directories have been removed. These directories were merged and relocated into the toolchain during r19. The location of these contents should not be relevant to anyone, including build systems, since the toolchain handles them implicitly. If you are using a build system that hasn't adapted to the changes introduced in NDK r19, file a bug with your build system maintainer. See the Build System Maintainers Guide for information on using the NDK in your own build system.
  • llvm-ar is now used instead of ar.
  • Issue 1200: Fixed an issue with using dlclose with libraries using thread_local with non-trivial destructors and the static libc++.
  • The legacy libc++ linker scripts in /sources/cxx-stl/llvm-libc++ have been removed. The linkers scripts in the toolchain should be used instead as described by the Build System Maintainers Guide.
  • LLD is now used by default. If your build is not yet compatible with LLD, you can continue using the deprecated linkers, set APP_LD=deprecated for ndk-build, ANDROID_LD=deprecated for CMake, or use an explicit -fuse-ld=gold or -fuse-ld=bfd in your custom build system. If you encounter issues be sure to file a bug, because this will not be an option in a subsequent release.
  • Note that Issue 843 will affect builds using LLD with binutils strip and objcopy as opposed to llvm-strip and llvm-objcopy.
  • ndk-gdb now uses lldb as the debugger. gdb is deprecated and will be removed in a future release. To fall back to gdb, use --no-lldb option. But please file a bug explaining why you couldn't use lldb.

New in Android NDK R21d (Jun 11, 2020)

  • Announcements:
  • LLD is now available for testing. AOSP is in the process of switching to using LLD by default and the NDK will follow (timeline unknown). Test LLD in your app by passing -fuse-ld=lld when linking.
  • 32-bit Windows is no longer supported. This does not affect the vast majority of users. If you do still need to build NDK apps from 32-bit versions of Windows, continue using NDK r20.
  • For more information on this change within Android Developer tools, see the blog post on the topic.
  • LLD is now available for testing. AOSP has switched to using LLD by default and the NDK will follow (timeline unknown). Test LLD in your app by passing `-fuse-ld=lld` when linking. Note that Issue 843 will affect builds using LLD with binutils strip and objcopy as opposed to llvm-strip and llvm-objcopy.
  • The legacy toolchain install paths will be removed over the coming releases. These paths have been obsolete since NDK r19 and take up a considerable amount of space in the NDK. The paths being removed are: platforms; sources/cxx-stl; sysroot; toolchains (with the exception of toolchains/llvm)
  • In general this change should only affect build system maintainers, or those using build systems that are not up to date. ndk-build and the CMake toolchain users are unaffected, and neither are `make_standalone_toolchain.py` users (though that script has been unnecessary since r19). For information on migrating away from the legacy toolchain layout, see the Build System Maintainers Guide for the NDK version you're using.
  • The Play Store will require 64-bit support when uploading an APK beginning in August 2019. Start porting now to avoid surprises when the time comes. For more information, see this blog post.
  • A macOS app bundle that is signed and notarized is now available for download from our wiki and our website. Note that because only bundles may use RPATHs and pass notarization, the traditional NDK package for macOS cannot be notarized. The SDK will continue to use the traditional package as the app bundle requires layout changes that would make it incompatible with Android Studio. The NDK is not quarantined when it is downloaded via the SDK manager, so is curently allowed by Gatekeeper. The SDK manager is currently the most reliable way to get the NDK formacOS.

New in Android NDK R21c (May 29, 2020)

  • Issue 1060: A macOS app bundle that is signed and notarized is now available for download from our wiki and our website. Note that because only bundles may use RPATHs and pass notarization, the traditional NDK package for macOS *cannot be notarized. The SDK will continue to use the traditional package as the app bundle requires layout changes that would make it incompatible with Android Studio. The NDK is not quarantined when it is downloaded via the SDK manager, so is curently allowed by Gatekeeper. The SDK manager is currently the most reliable way to get the NDK for macOS.
  • Issue 1207: Fix fatal error in clang when building with -O2 on arm64.
  • Issue 1239: Fix network drive issues for clang.
  • Issue 1229: README.md turned back to ordinary file.

New in Android NDK R21b (May 29, 2020)

  • Fixed debugging processes containing Java with gdb. Cherrypicked "gdb: Don't fault for 'maint print psymbols' when using an index", which fixes a bug that caused gdb to fail when debugging a process with Java. Pure C/C++ executables were fine, but this effectively broke all app debugging. The error from gdb that confirms you were affected by this was gdb-8.3/gdb/psymtab.c:316: internal-error: sect_index_text not initialized.
  • Issue 1166: Rehid unwinder symbols all architectures.
  • Issue 1173: Fix gdb python symbol missing issue on Darwin.
  • Issue 1176: Fix strip failing with "File truncated" errors on Windows.
  • Issue 1178: Revert changes to stdatomic.h to maintain compatibility with C's _Atomic type qualifier. Note that the C++ standard will likely mandate this breakage in the future. See P0943R4 for more details.
  • Issue 1184: Fix Clang crash for x86_64.
  • Issue 1198: Fix incorrect constant folding of long doubles on Windows.
  • Issue 1201: Fixed issue in ndk-build that was causing APP_PLATFORM to be corrupted for API 30+ with LP64 ABIs.
  • Issue 1203: libc++ prebuilts and CRT objects are no longer built as Neon.
  • Issue 1205: Potential fixes for relocation out of range issues with LLD.
  • Issue 1206: LLD support for --fix-cortex-a8.
  • Changes:
  • Updated Clang and LLD to r365631.
  • Issue 855: LLD no longer hangs when using multithreaded linking on Windows.
  • Issue 884: Clang no longer passes -faddrsig by default.
  • Issue 859: Clang now default to using Neon for all 32-bit Android Arm targets.
  • If your minSdkVersion is 23 or higher, or if you were already enabling Neon manually, this change does not affect you.
  • CPUs that do not support this feature are uncommon.
  • If you need to continue supporting these devices you can disable Neon explicitly by setting LOCAL_ARM_NEON := false in ndk-build or passing -DANDROID_ARM_NEON=false to CMake.
  • Alternatively, use the Play Console to blacklist CPUs without Neon to disallow your app from being installed on those devices.
  • Issue 1004: Fixed bug with bad line number information when building Arm64 with -O0.
  • Issue 1028: OpenMP is now available in both static and shared variants. Note that shared is the default behavior, but in prior NDK releases the static library would be used because there was no shared library. To keep the old behavior, link with -static-openmp.
  • Updated libc++ to r369764.
  • Updated make to 4.2.1.
  • Modified ndk-build to supply -O for more readable errors with parallel builds.
  • abspath now works properly with Windows drive letters, so if you're using the workaround similar to what's found in the NDK samples, you'll need to either drop the workaround or make sure it's only used prior to r21.
  • Updated glibc to 2.17.
  • Updated gdb to 8.3.
  • Issue 885: For LLD+LLDB compatibility, the NDK build systems now pass -Wl,--build-id=sha1 instead of -Wl,--build-id when using LLD. Note that the CMake toolchain does not have access to flags set in CMakeLists.txt, so using an explicit -fuse-ld=lld instead of ANDROID_LD=lld will produce output that cannot be debugged with Android Studio. Third-party build systems need to apply the workaround manually. For more details, see the Build System Maintainers Guide.
  • Fixed ndk-build to use Clang's default C++ standard version (currently C++14) when using libc++.
  • Removed the cxx-stl/system module from ndk-build. The system STL is still available (for now, see Issue 744); only an implementation detail has been removed. If you were explicitly linking libstdc++ or importing cxx-stl/system, remove that and ensure that APP_STL is set to system instead.
  • Issue 976: ndk-build and the CMake toolchain file now enable _FORTIFY_SOURCE by default. See FORTIFY in Android for more details.
  • Added NDK_GRADLE_INJECTED_IMPORT_PATH support to ndk-build. This is to support import of dependencies from AAR dependencies. See Issue 916 for more information.
  • Added NDK_MAJOR, NDK_MINOR, NDK_BETA, NDK_CANARY, and ndk-major-at-least APIs to ndk-build. These can be used to check what version of the NDK you are using from within ndk-build (CMake already has equivalent APIs). The first three are integers, NDK_CANARY is either true or false, and ndk-major-at-least is a function that takes a single integer.
  • Note that because this API was not available before r21, it cannot be used to determine which NDK version earlier than 21 is being used.
  • Issue 1092: Fixed hiding of unwinder symbols in outputs of ndk-build and CMake. Maintainers of third-party build systems should apply similar fixes when using NDK r19 and above to guard against possible future compatibility issues.

New in Android NDK R21 (Jan 16, 2020)

  • LLD is now available for testing. AOSP is in the process of switching to using LLD by default and the NDK will follow (timeline unknown). Test LLD in your app by passing -fuse-ld=lld when linking.
  • LLD is now available for testing. AOSP has switched to using LLD by default and the NDK will follow (timeline unknown). Test LLD in your app by passing `-fuse-ld=lld` when linking. Note that Issue 843 will affect builds using LLD with binutils strip and objcopy as opposed to llvm-strip and llvm-objcopy.
  • The legacy toolchain install paths will be removed before the next LTS release (likely in r22). These paths have been obsolete since NDK r19 and take up a considerable amount of space in the NDK. The paths being removed are: platforms, sources/cxx-stl, sysroot, toolchains (with the exception of toolchains/llvm)
  • In general this change should only affect build system maintainers, or those using build systems that are not up to date. ndk-build and the CMake toolchain users are unaffected, and neither are `make_standalone_toolchain.py` users (though that script has been unnecessary since r19). For information on migrating away from the legacy toolchain layout, see the Build System Maintainers Guide for the NDK version you're using.
  • The Play Store will require 64-bit support when uploading an APK beginning in August 2019. Start porting now to avoid surprises when the time comes.

New in Android NDK R21 Beta 1 (Nov 7, 2019)

  • Changes:
  • Updated Clang and LLD to r365631:
  • Issue 855: LLD no longer hangs when using multithreaded linking on Windows.
  • Issue 884: Clang no longer passes -faddrsig by default.
  • Issue 859: Clang now default to using Neon for all 32-bit Android Arm targets.
  • If your minSdkVersion is 23 or higher, or if you were already enabling Neon manually, this change does not affect you.
  • CPUs that do not support this feature are uncommon.
  • If you need to continue supporting these devices you can disable Neon explicitly by setting LOCAL_ARM_NEON := false in ndk-build or passing -DANDROID_ARM_NEON=false to CMake.
  • Alternatively, use the Play Console to blacklist CPUs without Neon to disallow your app from being installed on those devices.
  • Issue 1004: Fixed bug with bad line number information when building Arm64 with -O0.
  • Issue 1028: OpenMP is now available in both static and shared variants. Note that shared is the default behavior, but in prior NDK releases the static library would be used because there was no shared library. To keep the old behavior, link with -static-openmp.
  • Updated libc++ to r369764.
  • Updated make to 4.2.1:
  • Modified ndk-build to supply -O for more readable errors with parallel builds.
  • Updated glibc to 2.17.
  • Updated gdb to 8.3:
  • Issue 885: For LLD+LLDB compatibility, the NDK build systems now pass -Wl,--build-id=sha1 instead of -Wl,--build-id. Third-party build systems need to apply the workaround manually. For more details, see the Build System Maintainers Guide.
  • Fixed ndk-build to use Clang's default C++ standard version (currently C++14) when using libc++.
  • Removed the cxx-stl/system module from ndk-build. The system STL is still available (for now, see Issue 744); only an implementation detail has been removed. If you were explicitly linking libstdc++ or importing cxx-stl/system, remove that and ensure that APP_STL is set to system instead.
  • Issue 976: ndk-build and the CMake toolchain file now enable _FORTIFY_SOURCE by default. See FORTIFY in Android for more details.
  • Added NDK_GRADLE_INJECTED_IMPORT_PATH support to ndk-build. This is to support import of dependencies from AAR dependencies. See Issue 916 for more information.
  • Added NDK_MAJOR, NDK_MINOR, NDK_BETA, NDK_CANARY, and ndk-major-at-least APIs to ndk-build. These can be used to check what version of the NDK you are using from within ndk-build (CMake already has equivalent APIs). The first three are integers, NDK_CANARY is either true or false, and ndk-major-at-least is a function that takes a single integer. For example, to check if your build is being performed with NDK r21 or newer:
  • Note that because this API was not available before r21, it cannot be used to determine which NDK version earlier than 21 is being used, so this API is of limited use today. Also note that the above code will behave correctly even on pre-r21 because calling an undefined function in make returns the empty string, so the else case will be taken.
  • Issue 1092: Fixed hiding of unwinder symbols in outputs of ndk-build and CMake. Maintainers of third-party build systems should apply similar fixes when using NDK r19 and above to guard against possible future compatibility issues.

New in Android NDK R20b (Nov 7, 2019)

  • Changes:
  • Updated Clang to r346389c.
  • Updated libc++ to r350972.
  • Add Android Q Beta 1 APIs:
  • MIDI ().
  • Binder.
  • Extensions to several APIs from previous releases.
  • Issue 908: LOCAL_LDFLAGS now take precedence over APP_LDFLAGS.

New in Android NDK R20 (Jun 18, 2019)

  • LLD is now available for testing. AOSP is in the process of switching to using LLD by default and the NDK will follow (timeline unknown). Test LLD in your app by passing -fuse-ld=lld when linking.
  • The Play Store will require 64-bit support when uploading an APK beginning in August 2019. Start porting now to avoid surprises when the time comes. For more information, see this blog post.
  • Added Android Q APIs.

New in Android NDK R19 (Jan 30, 2019)

  • Developers should begin testing their apps with LLD. AOSP has switched to using LLD by default and the NDK will use it by default in the next release. BFD and Gold will be removed once LLD has been through a release cycle with no major unresolved issues (estimated r21). Test LLD in your app by passing -fuse-ld=lld when linking. Note: lld does not currently work on Windows. See Issue 888.
  • The Play Store will require 64-bit support when uploading an APK beginning in August 2019. Start porting now to avoid surprises when the time comes. For more information, see this blog post.
  • Issue 780: Standalone toolchains are now unnecessary. Clang, binutils, the sysroot, and other toolchain pieces are now all installed to $NDK/toolchains/llvm/prebuilt/ and Clang will automatically find them. Instead of creating a standalone toolchain for API 26 ARM, instead invoke the compiler directly from the NDK: $ $NDK/toolchains/llvm/prebuilt//bin/armv7a-linux-androideabi26-clang++ src.cpp
  • For r19 the toolchain is also installed to the old path to give build systems a chance to adapt to the new layout. The old paths will be removed in r20. The make_standalone_toolchain.py script will not be removed. It is now unnecessary and will emit a warning with the above information, but the script will remain to preserve existing workflows. If you're using ndk-build, CMake, or a standalone toolchain, there should be no change to your workflow. This change is meaningful for maintainers of third-party build systems, who should now be able to delete some Android-specific code. For more information, see the Build System Maintainers guide.
  • ndk-depends has been removed. We believe that ReLinker is a better solution to native library loading issues on old Android versions.
  • Issue 862: The GCC wrapper scripts which redirected to Clang have been removed, as they are not functional enough to be drop in replacements.

New in Android NDK R18 (Sep 20, 2018)

  • GCC has been removed.
  • LLD is now available for testing. AOSP is in the process of switching to using LLD by default and the NDK will follow (timeline unknown). Test LLD in your app by passing -fuse-ld=lld when linking.
  • gnustl, gabi++, and stlport have been removed.
  • Support for ICS (android-14 and android-15) has been removed. Apps using executables no longer need to provide both a PIE and non-PIE executable.
  • The Play Store will require 64-bit support when uploading an APK beginning in August 2019. Start porting now to avoid surprises when the time comes.

New in Android NDK R17c (Sep 10, 2018)

  • GCC is no longer supported. It will be removed in NDK r18.
  • libc++ is now the default STL for CMake and standalone toolchains. If you manually selected a different STL, we strongly encourage you to move to `libc++`. Note that ndk-build still defaults to no STL. For more details, see this blog post.
  • gnustl and stlport are deprecated and will be removed in NDK r18.
  • Support for ARMv5 (armeabi), MIPS, and MIPS64 has been removed. Attempting to build any of these ABIs will result in an error.
  • Support for ICS (android-14 and android-15) will be removed from r18.
  • The Play Store will require 64-bit support when uploading an APK beginning in August 2019. Start porting now to avoid surprises when the time comes.

New in Android NDK R18 Beta 2 (Aug 23, 2018)

  • ANNOUNCEMENTS:
  • GCC has been removed.
  • LLD is now available for testing. AOSP is in the process of switching to using LLD by default and the NDK will follow (timeline unknown). Test LLD in your app by passing -fuse-ld=lld when linking.
  • gnustl, gabi++, and stlport have been removed.
  • Support for ICS (android-14 and android-15) has been removed. Apps using executables no longer need to provide both a PIE and non-PIE executable.
  • The Play Store will require 64-bit support when uploading an APK beginning in August 2019. Start porting now to avoid surprises when the time comes. For more information, see this blog post.
  • CHANGES:
  • Updated Clang to build 4751641, based on r328903. With Issue 573 fixed, -Oz is now the default optimization mode for thumb.
  • Updated libc++ to revision r334917.
  • Issue 749: The libc++_shared.so in the NDK is no longer stripped of debug info. Debugging libc++ is now possible. Gradle will still strip the library before packaging it in an APK.
  • Added support for clang-tidy to ndk-build:
  • Enable application-wide with APP_CLANG_TIDY := true, or per-module with LOCAL_CLANG_TIDY := true.
  • Pass specific clang-tidy flags such as -checks with APP_CLANG_TIDY_FLAGS or LOCAL_CLANG_TIDY_FLAGS.
  • As usual, module settings override application settings.
  • By default no flags are passed to clang-tidy, so only the checks enabled by default in clang-tidy will be enabled. View the default list with clang-tidy -list-checks.
  • By default clang-tidy warnings are not errors. This behavior can be changed with -warnings-as-errors=*.
  • ndk-build can now generate a JSON Compilation Database:
  • Generate with either ndk-build compile_commands.json (does not build) or ndk-build GEN_COMPILE_COMMANDS_DB=true (builds and generates database).
  • Issue 490: ndk-build and CMake now default to using NEON for ARM when targeting android-23 (Marshmallow) or newer:
  • If your minSdkVersion is below 23 or if you were already enabling NEON manually, this change does not affect you.
  • CPUs that do not support this feature are uncommon and new devices were not allowed to ship without it beginning in Marshmallow, but older devices that did not support NEON may have been upgraded to Marshmallow.
  • If you need to continue supporting these devices and have a minSdkVersion of 23 or higher, you can disable NEON explicitly by setting LOCAL_ARM_NEON := false in ndk-build or passing -DANDROID_ARM_NEON=false to CMake.
  • Alternatively, use the Play Console to blacklist CPUs without NEON to disallow your app from being installed on those devices.
  • Added APP_STRIP_MODE and LOCAL_STRIP_MODE to ndk-build:
  • Allows the user to specify the strip mode used for their modules.
  • The option is passed directly to the strip command. See the strip documentation for details.
  • If set to "none", strip will not be run.
  • Defaults to "--strip-unneeded". This is the same behavior as previous NDKs.
  • LOCAL_STRIP_MODE always overrides APP_STRIP_MODE when set.
  • KNOWN ISSUES:
  • This is not intended to be a comprehensive list of all outstanding bugs.
  • Issue 360: thread_local variables with non-trivial destructors will cause segfaults if the containing library is dlcloseed on devices running M or newer, or devices before M when using a static STL. The simple workaround is to not call dlclose.
  • Issue 70838247: Gold emits broken debug information for AArch64. AArch64 still uses BFD by default.
  • This version of the NDK is incompatible with the Android Gradle plugin version 3.0 or older. If you see an error like No toolchains found in the NDK toolchains folder for ABI with prefix: mips64el-linux-android, update your project file to use plugin version 3.1 or newer. You will also need to upgrade to Android Studio 3.1 or newer.

New in Android NDK R18 Beta 1 (Jul 28, 2018)

  • Updated Clang to build 4751641, based on r328903. With Issue 573 fixed, -Oz is now the default optimization mode for thumb.
  • Updated libc++ to revision r334917.
  • Added support for clang-tidy to ndk-build:
  • Enable application-wide with APP_CLANG_TIDY := true, or per-module with LOCAL_CLANG_TIDY := true.
  • Pass specific clang-tidy flags such as -checks with APP_CLANG_TIDY_FLAGS or LOCAL_CLANG_TIDY_FLAGS.
  • As usual, module settings override application settings.
  • By default no flags are passed to clang-tidy, so only the checks enabled by default in clang-tidy will be enabled. View the default list with clang-tidy -list-checks.
  • By default clang-tidy warnings are not errors. This behavior can be changed with -warnings-as-errors=*.
  • Issue 490: ndk-build and CMake now default to using NEON for ARM when targeting android-23 (Marshmallow) or newer:
  • If your minSdkVersion is below 23 or if you were already enabling NEON manually, this change does not affect you.
  • CPUs that do not support this feature are uncommon and new devices were not allowed to ship without it beginning in Marshmallow, but older devices that did not support NEON may have been upgraded to Marshmallow.
  • If you need to continue supporting these devices and have a minSdkVersion of 23 or higher, you can disable NEON explicitly by setting LOCAL_ARM_NEON := false in ndk-build or passing -DANDROID_ARM_NEON=false to CMake.
  • Alternatively, use the Play Console to blacklist CPUs without NEON to disallow your app from being installed on those devices.

New in Android NDK R17 Beta 2 (Apr 18, 2018)

  • Announcements:
  • The deprecated headers have been removed. Unified Headers are now simply The Headers. For migration tips, see Unified Headers Migration Notes.
  • GCC is no longer supported. It will not be removed from the NDK just yet, but is no longer receiving backports. It cannot be removed until after libc++ has become stable enough to be the default, as some parts of gnustl are still incompatible with Clang. It will be removed when the other STLs are removed in r18.
  • libc++ is out of beta and is now the preferred STL in the NDK. Starting in r17, libc++ is the default STL for CMake and standalone toolchains. If you manually selected a different STL, we strongly encourage you to move to libc++. For more details, see this blog post.
  • Support for ARMv5 (armeabi), MIPS, and MIPS64 are deprecated. They will no longer build by default with ndk-build, but are still buildable if they are explicitly named, and will be included by “all”, “all32”, and “all64”. Support for each of these has been removed in r17.
  • Both CMake and ndk-build will issue a warning if you target any of these ABIs.
  • r16b:
  • Issue 573: Revert the switch to -Oz by default.
  • NDK:
  • ndk-build and CMake now link libatomic by default. Manually adding -latomic to your ldflags should no longer be necessary.
  • Clang static analyzer support for ndk-build has been fixed to work with Clang as a compiler. See https://github.com/android-ndk/ndk/issues/362.
  • Clang now defaults to -Oz instead of -Os. This should reduce generated code size increases compared to GCC.
  • GCC no longer uses -Bsymbolic by default. This allows symbol preemption as specified by the C++ standard and as required by ASAN. For libraries with large numbers of public symbols, this may increase the size of your binaries.
  • Updated binutils to version 2.27. This includes the fix for miscompiles for aarch64: https://sourceware.org/bugzilla/show_bug.cgi?id=21491.
  • Improved compatibility between our CMake toolchain file and newer CMake versions. The NDK‘s CMake toolchain file now completely supercedes CMake’s built-in NDK support.
  • ndk-stack now works for arm64 on Darwin.
  • libc++:
  • libandroid_support now contains only APIs needed for supporting libc++ on old devices. See https://github.com/android-ndk/ndk/issues/300.
  • APIs:
  • Added native APIs for Android O MR1: Neural Networks API, JNI Shared Memory API.
  • Known Issues:
  • This is not intended to be a comprehensive list of all outstanding bugs.
  • Issue 360: thread_local variables with non-trivial destructors will cause segfaults if the containing library is dlcloseed on devices running M or newer, or devices before M when using a static STL. The simple workaround is to not call dlclose.
  • Issue 374: gabi++ (and therefore stlport) binaries can segfault when built for armeabi.
  • Issue 399: MIPS64 must use the integrated assembler. Clang defaults to using binutils rather than the integrated assembler for this target. ndk-build and cmake handle this for you, but make sure to use -fintegrated-as for MIPS64 for custom build systems.
  • Issue 573: Clang miscompile when using -Oz and -fexceptions.

New in Android NDK R16b (Dec 8, 2017)

  • Fixed issues:
  • Issue 573: Revert the switch to -Oz by default.
  • NDK:
  • ndk-build and CMake now link libatomic by default. Manually adding -latomic to your ldflags should no longer be necessary.
  • Clang static analyzer support for ndk-build has been fixed to work with Clang as a compiler. See https://github.com/android-ndk/ndk/issues/362.
  • Clang now defaults to -Oz instead of -Os. This should reduce generated code size increases compared to GCC.
  • GCC no longer uses -Bsymbolic by default. This allows symbol preemption as specified by the C++ standard and as required by ASAN. For libraries with large numbers of public symbols, this may increase the size of your binaries.
  • Updated binutils to version 2.27. This includes the fix for miscompiles for aarch64: https://sourceware.org/bugzilla/show_bug.cgi?id=21491.
  • Improved compatibility between our CMake toolchain file and newer CMake versions. The NDK‘s CMake toolchain file now completely supercedes CMake’s built-in NDK support.
  • ndk-stack now works for arm64 on Darwin.
  • libc++:
  • libandroid_support now contains only APIs needed for supporting libc++ on old devices. See https://github.com/android-ndk/ndk/issues/300.
  • APIs:
  • Added native APIs for Android O MR1.
  • Neural Networks API
  • JNI Shared Memory API

New in Android NDK R16 (Nov 15, 2017)

  • Announcements:
  • The deprecated headers have been removed. Unified Headers are now simply "The Headers". For migration tips, see Unified Headers Migration Notes.
  • GCC is no longer supported. It will not be removed from the NDK just yet, but is no longer receiving backports. It cannot be removed until after libc++ has become stable enough to be the default, as some parts of gnustl are still incompatible with Clang. It will be removed when the other STLs are removed in r18.
  • libc++ is out of beta and is now the preferred STL in the NDK. Starting in r17, libc++ is the default STL for CMake and standalone toolchains. If you manually selected a different STL, we strongly encourage you to move to libc++. For more details, see this blog post.
  • Support for ARM5 (armeabi), MIPS, and MIPS64 are deprecated. They will no longer build by default with ndk-build, but are still buildable if they are explicitly named, and will be included by "all", "all32", and "all64". Support for each of these has been removed in r17. Both CMake and ndk-build will issue a warning if you target any of these ABIs.
  • APIs:
  • Added native APIs for Android 8.1. To learn more about these APIs, see the Native APIs overview: Neural Networks API and JNI Shared Memory API.

New in Android NDK R16 Beta 2 (Oct 27, 2017)

  • Adds support for the Android 8.1 Developer Preview and headers for the new Neural Networks API.

New in Android NDK R16 Beta 1 (Sep 1, 2017)

  • Announcements:
  • The deprecated headers have been removed. Unified Headers are now simply The Headers.
  • For migration tips, see Unified Headers Migration Notes.
  • GCC is no longer supported. It will not be removed from the NDK just yet, but is no longer receiving backports. It cannot be removed until after libc++ has become stable enough to be the default, as some parts of gnustl are still incompatible with Clang. It will be removed when the other STLs are removed in r18.
  • libc++ is out of beta and is now the preferred STL in the NDK. Starting in r17, libc++ is the default STL for CMake and standalone toolchains. If you manually selected a different STL, we strongly encourage you to move to libc++. For more details, see this blog post. TODO: Create blog post.
  • Support for ARM5 (armeabi) is deprecated. It will no longer build by default with ndk-build, but is still buildable if it is explicitly named, and will be included by "all" and "all32".
  • Both CMake and ndk-build will issue a warning if you target this ABI.
  • NDK:
  • ndk-build and CMake now link libatomic by default. Manually adding -latomic to your ldflags should no longer be necessary.
  • Clang static analyzer support for ndk-build has been fixed to work with Clang as a compiler. See https://github.com/android-ndk/ndk/issues/362.
  • libc++:
  • libandroid_support now contains only APIs needed for supporting libc++ on old devices. See https://github.com/android-ndk/ndk/issues/300.
  • Known Issues:
  • This is not intended to be a comprehensive list of all outstanding bugs.
  • gabi++ (and therefore stlport) binaries can segfault when built for armeabi: https://github.com/android-ndk/ndk/issues/374.
  • MIPS64 must use the integrated assembler. Clang defaults to using binutils rather than the integrated assmebler for this target. ndk-build and cmake handle this for you, but make sure to use -fintegrated-as for MIPS64 for custom build systems. See https://github.com/android-ndk/ndk/issues/399.

New in Android NDK R15c (Jul 28, 2017)

  • Fixes for _FILE_OFFSET_BITS=64 APIs. See https://github.com/android-ndk/ndk/issues/459 and https://github.com/android-ndk/ndk/issues/442.
  • Fix termios.h APIs for old target APIs. See https://github.com/android-ndk/ndk/issues/441.
  • Added an inline for ffs to maintain compatibility with the deprecated headers. See https://github.com/android-ndk/ndk/issues/439.
  • Added legacy pthread API declarations for compatibility with old releases. See https://github.com/android-ndk/ndk/issues/420 and https://github.com/android-ndk/ndk/issues/423.

New in Android NDK R15b (Jun 26, 2017)

  • Fix libsync header/library mismatch: https://issuetracker.google.com/62229958.
  • Several libc header updates to improve compatibility with code written for other systems.

New in Android NDK R15 (Jun 9, 2017)

  • Announcements:
  • Unified headers are enabled by default. To learn how to use these headers, see Unified Headers. Note: The deprecated headers will be removed in an upcoming release. If you encounter any issues with these headers, please file a bug. For migration tips, see the unified headers migration notes.
  • GCC is no longer supported. It is not removed from NDK yet, but is no longer receiving backports. It cannot be removed until after libc++ stabilizes enough to be the default, as some parts of gnustl are still incompatible with Clang.
  • Android 2.3 (android-9) is no longer supported. The minimum API level target in the NDK is now Android 4.0 (android-14). If your APP_PLATFORM is set lower than android-14, android-14 is used instead.
  • CMake in NDK now supports building assembly code written in YASM to run on x86 and x86-64 architectures. To learn more, see Building assembly code.
  • APIs:
  • Added native APIs for Android O: AAudio API, Hardware Buffer API, Shared Memory API.

New in Android NDK R14b (Mar 22, 2017)

  • Fixed issue of XSI strerror_r not being available until android-23 with unified headers: https://github.com/android-ndk/ndk/issues/324.
  • Fixed issue of __ANDROID_API__ not being set for standalone toolchains with unified headers on Windows: https://github.com/android-ndk/ndk/issues/321.
  • Fixed issue of not being able to find gnustl headers with standalone toolchains for mips32: https://github.com/android-ndk/ndk/issues/310.
  • Removed accidentally exposed non-NDK API Vulkan headers. The functions in the non-API headers themselves weren't exposed, so these weren't usable anyways.

New in Android NDK R14 (Mar 3, 2017)

  • These new unified headers are not enabled by default. To learn how to enable and use these headers, see Unified Headers.
  • GCC deprecation: This release ends active support for GCC. GCC is not removed from the NDK just yet, but will no longer receive backports. As some parts of gnustl are still incompatible with Clang, GCC won't be entirely removed until after libc++ has become stable enough to be the default.
  • Unified headers: This release introduces platform headers that are synchronized and kept always up-to-date and accurate with the Android platform. Header-only bug fixes now affect all API levels. The introduction of unified headers fixes inconsistencies in earlier NDK releases, such as:
  • Headers in M and N were actually headers for L.
  • Function declarations in headers did not match their platform levels correctly; headers declared non-existent functions or failed to declare available functions.
  • Several of the old API levels had missing or incorrect constants that were in newer API levels.

New in Android NDK R14 Beta 2 (Feb 1, 2017)

  • ndk-build:
  • Module builds will now fail if they have any missing dependencies. To revert to the old behavior, set APP_ALLOW_MISSING_DEPS=true. See https://github.com/android-ndk/ndk/issues/208.
  • CMake:
  • RTTI and exceptions are now on by default. This was done for improved compatibility with existing CMake projects. See https://github.com/android-ndk/ndk/issues/212.
  • libc++:
  • libc++abi has been updated and now has a fallback implementation of __cxa_thread_atexit_impl. Non-global thread_local variables with non-trivial destructors are now supported.
  • Clang/LLVM:
  • The x86 ASAN issues noted since r11 appear to have been emulator specific. Up to date emulators no longer have this issue.
  • LTO with Clang now builds without errors on Linux and Darwin. This fixes https://github.com/android-ndk/ndk/issues/108.
  • RenderScript:
  • The RenderScript tools are now included in the NDK once again. This fixes https://github.com/android-ndk/ndk/issues/7.
  • Known Issues:
  • This is not intended to be a comprehensive list of all outstanding bugs.
  • Gradle does not yet support unified headers.

New in Android NDK R14 Beta 1 (Dec 14, 2016)

  • ndk-build:
  • Module builds will now fail if they have any missing dependencies. To revert to the old behavior, set APP_ALLOW_MISSING_DEPS=false. See https://github.com/android-ndk/ndk/issues/208.
  • CMake:
  • RTTI and exceptions are now on by default. This was done for improved compatibility with existing CMake projects. See https://github.com/android-ndk/ndk/issues/212.
  • Clang/LLVM:
  • The x86 ASAN issues noted since r11 appear to have been emulator specific. Up to date emulators no longer have this issue.

New in Android NDK R13b (Nov 1, 2016)

  • Additional fixes for missing __cxa_bad_cast.

New in Android NDK R13 (Oct 7, 2016)

  • Announcements:
  • GCC is no longer supported. It will not be removed from the NDK just yet, but is no longer receiving backports. It cannot be removed until after libc++ has become stable enough to be the default, as some parts of gnustl are still incompatible with Clang. It will likely be removed after that point.
  • NDK:
  • NDK_TOOLCHAIN_VERSION now defaults to Clang.
  • libc++ has been updated to r263688.
  • We've reset to a (nearly) clean upstream. This should remove a number of bugs, but we still need to clean up libandroid_support before we will recommend it as the default.
  • make-standalone-toolchain.sh is now simply a wrapper around the Python version of the tool. There are a few behavioral differences. See the commit message for details.
  • Some libraries for unsupported ABIs have been removed (mips64r2, mips32r6, mips32r2, and x32). There might still be some stragglers.
  • Issues with crtbegin_static.o that resulted in missing atexit at link time when building a static executable for ARM android-21+ have been resolved: Issue 132
  • Added CMake toolchain file in build/cmake/android.toolchain.cmake.
  • Known Issues:
  • This is not intended to be a comprehensive list of all outstanding bugs.
  • Standlone toolchains using libc++ and GCC do not work. This seems to be a bug in GCC. See the commit message for more details.
  • Exception unwinding with c++_shared still does not work for ARM on Gingerbread or Ice Cream Sandwich.
  • Bionic headers and libraries for Marshmallow and N are not yet exposed despite the presence of android-24. Those platforms are still the Lollipop headers and libraries (not a regression from r11).
  • RenderScript tools are not present (not a regression from r11): Issue 7.

New in Android NDK R12b (Jul 9, 2016)

  • Fixed ndk-gdb.py. (Issue 118)
  • Updated NdkCameraMetadataTags.h so that it no longer contain an invalid enum value.
  • A bug in ndk-build that resulting in spurious warnings for static libraries using libc++ has been fixed. For more information about this change, see the comments here.
  • The OpenSLES headers have been updated for android-24.

New in Android NDK R12 (Jun 27, 2016)

  • Announcements:
  • The ndk-build command will default to using Clang in an upcoming release. GCC will be removed in a later release.
  • The make-standalone-toolchain.sh script will be removed in an upcoming release. If you use this script, please plan to migrate to the make_standalone_toolchain.py as soon as possible.
  • NDK:
  • Removed support for the armeabi-v7a-hard ABI. See the explanation in the documentation.
  • Removed all sysroots for platform levels prior to Android 2.3 (API level 10). We dropped support for them in NDK r11, but neglected to actually remove them.
  • Updated exception handling when using c++_shared on ARM32 so that it mostly works (see Known Issues). The unwinder is now linked into each linked object rather than into libc++ itself.
  • Pruned the default compiler flags (NDK Issue 27). You can see details of this update in Change 207721.
  • Added a Python implementation of standalone toolchains in build/tools/make_standalone_toolchain.py. On Windows, you no longer need Cygwin to use this feature. Note that the bash flavor will be removed in an upcoming release, so please test the new one now.
  • Configured Clang debug builds to have the -fno-limit-debug-info option is enabled by default. This change enables better debugging with LLDB.
  • Enabled the --build-id as a default option. This option causes an identifier to be shown in native crash reports so you can easily identify which version of your code was running.
  • Fixed issue with NDK_USE_CYGPATH so that it no longer causes problems with libgcc (Issue 195486).
  • Enabled the following options as default: -Wl,--warn-shared-textrel and -Wl,--fatal-warnings. If you have shared text relocations, your app does not load on Android 6.0 (API level 23) and higher. Note that this configuration has never been allowed for 64-bit apps.
  • Fixed a few issues so that precompiled headers work better (NDK Issue 14, NDK Issue 16).
  • Removed unreachable ARM (non-thumb) STL libraries.
  • Added Vulkan support to android-24.
  • Added Choreographer API to android-24.
  • Added libcamera2 APIs for devices that support the INFO_SUPPORTED_HARDWARE_LEVEL_LIMITED feature level or higher. For more information, see the CameraCharacteristics reference.
  • Clang:
  • Clang has been updated to 3.8svn (r256229, build 2812033). Note that Clang packaged in the Windows 64-bit NDK is actually 32-bit.
  • Fixed __thread so that it works for real this time.
  • GCC:
  • Synchronized the compiler with the ChromeOS GCC @ google/gcc-4_9 r227810.
  • Backported coverage sanitizer patch from ToT (r231296).
  • Fixed libatomic to not use ifuncs (NDK Issue 31).
  • Binutils:
  • Silenced the "Erratum 843419 found and fixed" info messages.
  • Introduced option --long-plt to fix an internal linker error when linking huge arm32 binaries.
  • Fixed wrong run time stubs for AArch64. This problem was causing jump addresses to be calculated incorrectly for very large dynamic shared objects (DSOs).
  • Introduced default option --no-apply-dynamic to work around a dynamic linker bug for earlier Android releases.
  • Fixed a known issue with NDK r11 where dynamic_cast was not working with Clang, x86, stlport_static and optimization.
  • GDB:
  • Updated to GDB version 7.11. For more information about this release, see GDB News.
  • Fixed a number of bugs in the ndk-gdb.py script.

New in Android NDK R10e (May 15, 2015)

  • IMPORTANT CHANGES:
  • Integrated the workaround for Cortex-A53 Erratum 843419 into the aarch64-linux-android-4.9 linker. For more information on this workaround, see Workaround for cortex-a53 erratum 843419.
  • Added Clang 3.6; NDK_TOOLCHAIN_VERSION=clang now picks that version of Clang by default.
  • Removed Clang 3.4.
  • Removed GCC 4.6.
  • Upgraded GDB/gdbserver to 7.7 for all architectures.
  • Removed the NDK package for 32-bit Darwin.
  • Implemented multithreading support in ld.gold for all architectures. It can now link with or without support for multithreading; the default is to do it without:
  • To compile with multithreading, use the --threads option.
  • To compile without multithreading, use the --no-threads option.
  • IMPORTANT BUG FIXES:
  • Fixed a crash that occurred when there were OpenMP loops outside of the main thread.
  • Fixed a GCC 4.9 internal compiler error (ICE) that occured when the user declared #pragma GCC optimize ("O0"), but had a different level of optimization specified on the command line. The pragma takes precedence.
  • Fixed an error that used to produce a crash with the following error message: in add_stores, at var-tracking.c:6000
  • Implemented a workaround for a Clang 3.5 issue in which LLVM auto-vectorization generates llvm.cttz.v2i64(), an instruction with no counterpart in the ARM instruction set.
  • OTHER BUG FIXES:
  • Fixed a spurious array-bounds warning that GCC 4.9 produced for x86, and reenabled the array bounds warning that GCC 4.9 had produced for ARM. The warning for ARM had previously been unconditionally disabled.
  • Fixed Clang 3.5 for mips and mips64 to create a writable .gcc_except_table section, thus matching GCC behavior. This change allows you to avoid the following linker warning: .../ld: warning: creating a DT_TEXTREL in a shared object
  • Backported a fix for compiler-rt issues that were causing crashes when Clang compiled for mips64. For more information, see LLVM Issue 20098.
  • Fixed Clang 3.5 crashes that occurred on non-ASCII comments. (Issue 81440)
  • Fixed stlport collate::compare to return -1 and 1. Previously, it had returned arbitrary signed numbers.
  • Fixed ndk-gdb for 64-bit ABIs. (Issue 118300)
  • Fixed the crash that the HelloComputeNDK sample for RenderScript was producing on Android 4.4 (Android API level 19). For more information, see this page.
  • Fixed libc++ __wrap_iter for GCC. For more information, see LLVM Issue 22355.
  • Fixed .asm support for ABI x86_64.
  • Implemented a workaround for the GCC 4.8 stlport issue. (Issue 127773)
  • Removed the trailing directory separator \\ from the project path in Windows. (Issue 160584)
  • Fixed a no rule to make target error that occurred when compiling a single .c file by executing the ndk-build.cmd command from gradle. (Issue 66937)
  • Added the libatomic.a and libgomp.a libraries that had been missing from the following host toolchains:
  • aarch64-linux-android-4.9
  • mips64el-linux-android-4.9
  • mipsel-linux-android-4.9
  • x86_64-4.9
  • Made the following header and library fixes:
  • Fixed PROPERTY_* in media/NdkMediaDrm.h.
  • Fixed sys/ucontext.h for mips64.
  • Dropped the Clang version check for __builtin_isnan and __builtin_isinf.
  • Added android-21/arch-mips/usr/include/asm/reg.h and android-21/arch-mips64/usr/include/asm/reg.h.
  • OTHER CHANGES:
  • Added ld.gold for aarch64. The default linker remains ld.bfd. To explicitly enable ld.gold, add -fuse-ld=gold to the LOCAL_LDFLAGS or APP_LDFLAGS variable.
  • Built the MIPS and MIPS64 toolchains with binutils-2.25, which provides improved R6 support.
  • Made -fstandalone-debug (full debug info) a default option for Clang.
  • Replaced -fstack-protector with -fstack-protector-strong for the ARM, AArch64, X86, and X86_64 toolchains for GCC 4.9, Clang 3.5, and Clang 3.6.
  • Added the --package command-line switch to ndk-gdb to allow the build system to override the package name. (Issue 56189)
  • Deprecated -mno-ldc1-stc1 for MIPS. This option may not work with the new -fpxx and -mno-odd-spreg options, or with the FPXX ABI.
  • Added MIPS MSA and R6 detection to cpu-features.

New in Android NDK R10d (Dec 5, 2014)

  • IMPORTANT CHANGES:
  • Made GCC 4.8 the default for all 32-bit ABIs. Deprecated GCC 4.6, and will remove it next release. To restore previous behavior, either add 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.
  • Stopped all x86[_64] toolchains from adding -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)
  • Added Address Sanitizer functionality to Clang 3.5 support to the ARM and x86 ABIs. For more information on this change, see the Address Sanitizer project.
  • Introduced the requirement, starting from API level 21, to use -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.
  • IMPORTANT BUG FIXES:
  • Made more fixes related to A53 Errata #835769 in the aarch64-linux-android-4.9 linker. As part of this, GCC passes a new option, --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.
  • Documented a fix to a libc++ sscanf/vsscanf hang that occurred in API level 21. The fix itself had been implemented in r10c. (Issue 77988)
  • Fixed an AutoFDO (-fauto-profile) crash that occurred with GCC 4.9 when -Os was specified. (Issue 77571)
  • OTHER BUG FIXES:
  • Fixed LOCAL_SRC_FILES in ndk-build to use Windows absolute paths. (Issue 74333)
  • Removed bash-specific code from ndk-gdb. (Issue 73338)
  • Removed bash-specific code from make-standalone-toolchain.sh. (Issue 74145)
  • Revised documentation concerning a fix for System.loadLibrary() transitive dependencies. (Issue 41790)
  • Fixed a problem that was preventing 64-bit packages from extracting on Ubuntu 14.04 and OS X 10.10 (Yosemite). (Issue 78148)
  • Fixed an issue with LOCAL_PCH to improve Clang support. (Issue 77575)
  • Clarified "requires executable stack" warning from ld.gold. (Issue 79115)
  • Made the following header and library fixes:
  • Added posix_memalign to API level 16. Also, added a prototype in stdlib.h to API levels 16 to 19. (Issue 77861)
  • Fixed stdatomic.h so that it includes only for C++11.
  • Modified the following headers for standalone use: sys/user.h, and gl2ext.h, dlext.h, fts.h, sgidefs.h for API level 21.
  • Modified sys/user.h to rename mxcsr_mask as mxcr_mask, and to change the data type for u_ar0
  • from unsigned long to struct user_regs_struct*.
  • Changed sysconf() return value type from int to long.
  • Fixed ndk-build's handling of thumb for LOCAL_ARM_MODE: In r10d, ndk-build adds LOCAL_LDFLAGS+=-mthumb by default, unless one of the following conditions applies:
  • You have set LOCAL_ARM_MODE equal to arm.
  • You are doing a debug build (with settings such as 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)

New in Android NDK R10c (Oct 18, 2014)

  • IMPORTANT CHANGES:
  • Changed everything previously called Android-L to the official release designation: android-21.
  • Made it possible to enter ART debugging mode, when debugging on an Android 5.0 device using ART as its virtual machine, by specifying the art-on option. For more information, see prebuilt/common/gdb/common.setup in the directory containing the NDK.
  • Removed support for Clang 3.3.
  • Deprecated GCC 4.6, and may remove it from future releases.
  • Updated mclinker to 2.8 with Identical Code Folding ("ICF") support. Specify ICF using the --icf option.
  • Broadened arm_neon.h support in x86 and x86_64, attaining coverage of ~93% of NEON intrinsics.
  • Documented support for _FORTIFY_SOURCE in headers/libs/android-21, which appeared in r10 (when android-21 was still called Android-L), but had no documentation.
  • Made the following changes to download structure:
  • Each package now contains both the 32- and the 64-bit headers, libraries, and tools for its respective platform.
  • STL libraries with debugging info no longer need be downloaded separately.
  • Updated GCC 4.9 by rebasing to the google branch of the GCC repository. Major differences from the upstream version of GCC 4.9 include:
  • The -O2 option now turns on vectorization, without loop peeling but with more aggressive unrolling.
  • Enhancements to FDO and LIPO
  • For more detailed information, see Important bug fixes below.

  • Added Clang 3.5 support to all hosts: NDK_TOOLCHAIN_VERSION=clang now picks Clang 3.5. Note that:
  • ARM and x86 default to using the integrated assembler. If this causes issues, use -fno-integrated-as as a workaround.
  • Clang 3.5 issues more warnings for unused flags, such as the -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.

  • For more information about NEON support:
  • Navigate to the NDK Programmer's Guide (docs/Programmers_Guide/html/), and see Architectures and CPUs > Neon.
  • Examine the updated hello-neon sample in samples/.
  • See Intel's guide to porting from ARM NEON to Intel SSE.
  • IMPORTANT BUG FIXES:
  • Fixed an internal compiler error with GCC4.9/aarch64 that was causing the following error message (Issue 77564):
  • internal compiler error: in simplify_const_unary_operation, at simplify-rtx.c:1539
  • Fixed incorrect code generation from GCC4.9/arm. (Issue 77567)
  • Fixed an internal compiler error with GCC4.9/mips involving inline-assembly. (Issue 77568)
  • Fixed incorrect code that GCC4.9/arm was generating for x = (cond) ? y : x. (Issue 77569)
  • Fixed GCC4.9/aarch64 and Clang3.5/aarch64 to work around the Cortex-A53 erratum (835769) by default. Disable the workaround by specifying -mno-fix-cortex-a53-835769.
  • OTHER BUG FIXES:
  • Restored MXU support in GCC 4.8 and 4.9 for mips. This support had been absent from r10 and r10b because those versions of GCC had been compiled with binutils-2.24, which did not support MXU. It now does.
  • Fixed --toolchain= in make-standalone-toolchain.sh so that it now properly supports use of a suffix specifying a version of Clang.
  • Fixed the libc++/armeabi strtod() functions.
  • Made fixes to NDK documentation in docs/.
  • Made the following header and library fixes to android-21:
  • Added more TV keycodes: android/keycodes.h
  • Added more constants and six new sensor functions to android/sensor.h: ASensorManager_getDefaultSensorEx, ASensor_getFifoMaxEventCount, ASensor_getFifoReservedEventCount, ASensor_getStringType, ASensor_getReportingMode, and ASensor_isWakeUpSensor.
  • Fixed stdatomic.h to improve compatibility with GCC 4.6, and provide support for the header.
  • Added sys/ucontext.h and sys/user.h to all API levels. The signal.h header now includes . You may remove any existing definition of struct ucontext.
  • Added posix_memalign to API levels 17, 18, and 19.
  • Added the following functions to all architectures: android_set_abort_message, posix_fadvise, posix_fadvise64, pthread_gettid_np.
  • Added the required permissions to the native-media/AndroidManifest.xml sample. (Issue 106640)
  • Added clock_nanosleep and clock_settime to API level 21. (Issue 77372)
  • Removed the following symbols from all architectures: 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.
  • Removed the following functions from the 64-bit architectures: basename_r, dirname_r, __isthreaded, _flush_cache (mips64).
  • Removed the following function from the 32-bit architectures: __signalfd4.
  • Changed the type of the third argument from size_t to int in the following functions: strtoll_l, strtoull_l, wcstoll_l, and wcstoull_l.
  • Restored the following functions to the 64-bit architecture: arc4random, arc4random_buf, and arc4random_uniform.
  • Moved cxa_* and the new and delete operators back to libstdc++.so. This change restores r9d behavior; previous versions of r10 contained dummy files.
  • OTHER CHANGES:
  • Enhanced cpu-features to detect ARMv8 support for the following instruction sets: AES, CRC32, SHA2, SHA1, and 64-bit PMULL/PMULL2. (Issue 106360)
  • Modified ndk-build to use *-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.
  • Removed the include-fixed/linux/a.out.h and include-fixed/linux/compiler.h headers from the GCC compiler. (Issue 73728)
  • Fixed an issue related to -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
  • Fixed a typo in build-binary.mk. (Issue 76992)

New in Android NDK R10b (Sep 11, 2014)

  • IMPORTANT NOTES:
  • Because of the 512MB size restriction on downloadable packages, the following 32-bit items are not in the 32-bit NDK download packages. Instead, they reside in the 64-bit ones:
  • Android-L headers
  • GCC 4.9
  • Currently, the only Renderscript support provided by the NDK is for 32-bit Renderscript with Android 4.4 (API level 19). You cannot build HelloComputeNDK (the only Renderscript sample) with any other combination of Renderscript (32- or 64-bit) and Android version.
  • To compile native-codec, you must use a 64-bit NDK package, which is where all the Android-L headers are located.
  • IMPORTANT BUG FIXES:
  • Fixed gdb 7.6 in GCC 4.8/4.9. (Issues 74112 and 74371.)
  • Fixed GCC 4.8/4.9 for x86, so that they no longer enable -msse4.2 and -mpopcnt by default. (Issue 73843.)
  • OTHER BUG FIXES:
  • Removed stdio.h from the include-fixed/ directories of all versions of GCC. (Issue 73728.)
  • Removed duplicate header files from the Windows packages in the platforms/android-L/arch-*/usr/include/linux/netfilter*/ directories. (Issue 73704.)
  • Fixed a problem that prevented Clang from building HelloComputeNDK.
  • Fixed atexit. (Issue 66595.)
  • Made various fixes to the docs in docs/ and sources/third_party/googletest/README.NDK. (Issue 74069.)
  • Made the following fixes to the Android-L headers:
  • Added the following functions to 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.
  • Renamed cmsg_nxthdr to __cmsg_nxthdr.
  • Removed __libc_malloc_dispatch.
  • Changed the ptrace() prototype to long ptrace(int, ...);.
  • Removed sha1.h.
  • Extended android_dlextinfo in android/dlext.h.
  • Annotated __NDK_FPABI__ for functions receiving or returning float- or double-type values in stdlib.h, time.h, wchar.h, and complex.h.
  • OTHER CHANGES:
  • Updated mipsel-linux-android-4.9 and mips64el-linux-android-4.9, implementing a new multilib directory layout, and providing support for gdb-7.7
  • Enhanced cpu-features to detect more arm64 features. (Change list 100339.)

New in Android NDK R10 (Jul 17, 2014)

  • IMPORTANT CHANGES:
  • Added 3 new ABIs, all 64-bit: arm64-v8a, x86_64, mips64.
  • Upgraded GDB to version 7.6 in GCC 4.8/4.9 and x86*. Since GDB is still at version GDB-7.3.x in GCC 4.6 (the default for ARM and MIPS), you must set NDK_TOOLCHAIN_VERSION=4.8 or 4.9 to enable ndk-gdb to select GDB 7.6.
  • Added the -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.
  • Updated GCC 4.8 to 4.8.3.
  • mclinker is now version 2.7, and has aarch64 Linux support.
  • Added precompiled header support for headers specified by LOCAL_PCH. (Issue 25412).
  • Improved ARM libc++ EH support by switching from gabi++ to libc++abi. For details, see the "C++ Support" section of the documentation. Note that:
  • All tests except for locale now pass for Clang 3.4 and GCC 4.8. For more information, see the "C++ Support" section of the documentation.
  • The libc++ libraries for X86 and MIPS libc++ still use gabi++.
  • GCC 4.7 and later can now use .
  • You must add -fno-strict-aliasing if you use , because __list_imp::_end_ breaks TBAA rules. (Issue 61571.)
  • As of GCC 4.6, LIBCXX_FORCE_REBUILD:=true no longer rebuilds libc++. Rebuilding it requires the use of a different compiler. Note that Clang 3.3 is untested.
  • Added GCC 4.9 compilers to the 32-/64-bit ABIs. GCC 4.9 is the default (only) compiler for 64-bit ABIs, as previously mentioned. For 32-bit ABIs, you must explcitly enable GCC 4.9, as GCC 4.6 is still the default.
  • For ndk-build, enable 32-bit, GCC 4.9 building either by adding NDK_TOOLCHAIN_VERSION=4.9 to Application.mk, or exporting it as an environment variable from the command line.
  • For a standalone toolchain, use the --toolchain= option in the make-standalone-toolchain.sh script. For example: --toolchain=arm-linux-androideabi-4.9.
  • Note that:
  • GCC 4.9 is the default compiler for 64-bit ABIs. Clang is currently version 3.4. NDK_TOOLCHAIN_VERSION=clang may not work for arm64-v8a and mips64.
  • Android API level L is the first level with 64-bit support. Note that this API level is a temporary one, and only for L-preview. An actual API level number will replace it at L-release.
  • This release includes now includes 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.
  • The new GNU libstdc++ in Android-L contains all 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.
  • The cpu-features library has been updated for the ARMv8 kernel. The existing cpu-features library may fail to detect the presence of NEON on the ARMv8 platform. Recompile your code with the new version.
  • Added a new platforms/android-L/ API directory. It includes:
  • Updated Bionic headers, which had not changed from Android API levels 3 (Cupcake) to 19 (KitKat). This new version, for level L, is to be synchronized with AOSP.
  • New media APIs and a native-codec sample.
  • An updated Android.h header for SLES/OpenSLES, enabling support for single-precision, floating-point audio format in AudioPlayer.
  • GLES 3.1 and AEP extensions to libGLESv3.so.
  • GLES2 and GLES3 headers updated to the latest official Khronos versions.
  • IMPORTANT BUG FIXES:
  • Fixed libc++ so that it now compiles std::feof, etc. (Issue 66668).
  • Fixed a Clang 3.3/3.4 atomic library call that caused crashes in some of the libc++ tests for ABI armeabi.
  • Fixed Clang 3.4 crashes that were occurring on reading precompiled headers. (Issue 66657).
  • Fixed the Clang 3.3/3.4 -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).
  • Fixed the following Clang 3.3/3.4 crash:
  • 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).
  • OTHER BUG FIXES:
  • Fixed GCC warning about redefinition of putchar. Warning message reads:
  • include/stdio.h:236:5: warning: conflicts with previous declaration here [-Wattributes] int putchar(int); (Change list 91185).
  • Fixed GCC/Windows to quote arguments only when necessary for spawning processes in external programs. This change decreases the likelihood of exceeding the 32K length limit.
  • Fixed an issue that made it impossible to adjust the APP_PLATFORM environment variable.
  • Fixed the implementation of IsSystemLibrary() in crazy_linker so that it uses strrchr() instead of strchr() to find the library path's true basename.
  • Fixed native-audio's inability to build in debug mode.
  • Fixed gdb's inability to print extreme floating-point numbers. (Issue 69203).
  • Fixed Clang 3.4 inability to compile with -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.
  • Fixed make-standalone-toolchain.sh --stl=libc++ so that it:
  • Copies cxxabi.h. (Issue 68001).
  • Runs in directories other than the NDK install directory. (Issues 67690 and 68647).
  • Fixed headers:
  • Fixed 32-bit ssize_t to be int instead of long int.
  • Fixed WCHAR_MIN and WCHAR_MAX so that they they take appropriate signs according to the architecture they're running on:
  • X86/MIPS: signed.
  • ARM: unsigned.
  • To force X86/MIPS to default to unsigned, use -D__WCHAR_UNSIGNED__.
  • To force wchar_t to be 16 bits, use -fshort-wchar.
  • Removed non-existent symbols from 32-bit 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.
  • OTHER CHANGES:
  • Added 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.
  • Ported ARM/GOT_PREL optimization (present in GCC 4.6 built from the GCC google branch) to ARM GCC 4.8/4.9. This optimization sometimes reduces instruction count when accessing global variables. As an example, see the build.sh script in $NDK/tests/build/b14811006-GOT_PREL-optimization/.
  • Added ARM version for STL gabi++, stlport, and libc++. They now have both it and Thumb mode.
  • It is now possible to call the make-standalone-toolchain.sh script with --toolchain=x86_64-linux-android-4.9, which is equivalent to --toolchain=x86_64-4.9.

New in Android NDK R9d (Mar 5, 2014)

  • IMPORTANT CHANGES:
  • Added support for the Clang 3.4 compiler. The NDK_TOOLCHAIN_VERSION=clang option now picks Clang 3.4. GCC 4.6 is still the default compiler.
  • Added 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).
  • Added the yasm assembler, as well as 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.
  • Updated MClinker to 2.6.0, which adds -gc-sections support.
  • Added experimental libc++ support (upstream r201101).
  • IMPORTANT BUG FIXES:
  • Fixed an uncaught throw from an unexpected exception handler for GCC 4.6/4.8 ARM EABI. (GCC Issue 59392)
  • Fixed GCC 4.8 so that it now correctly resolves partial specialization of a template with a dependent, non-type template argument. (GCC Issue 59052)
  • Added more modules to prebuilt python (Issue 59902):
  • Fixed the x86 and MIPS gdbserver event_getmsg_helper.
  • Fixed numerous issues in the RenderScript NDK toolchain, including issues with compatibility across older devices and C++ reflection.
  • OTHER BUG FIXES:
  • Fixed gabi++ std::unexpected() to call std::terminate() so that a user-defined std::terminate() handler has a chance to run.
  • Fixed gabi++ to catch std::nullptr.
  • Fixed samples Teapot and MoreTeapots.
  • Fixed the 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)
  • Removed -Bsymbolic from all STL builds.
  • Fixed ndk-gdb-py.cmd by setting SHELL as an environment variable instead of passing it to python.exe, which ignores the setting. (Issue 63054)
  • Fixed the 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.
  • Header fixes:
  • Fixed a missing #include in android/asset_manager.h for Android API level 13 and higher. (Issue 64988)
  • Fixed a missing #include in android/rect_manager.h for Android API level 14 and higher.
  • Added 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.
  • Updated the following headers so that they can be included without the need to manually include their dependencies (Issue 64679): 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
  • Added sys/cachectl.h for all architectures. MIPS developers can now include this header instead of writing #ifdef __mips__.
  • Fixed platforms/android-18/include/android/input.h by adding __NDK_FPABI__ to functions taking or returning float or double values.
  • Fixed MIPS 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.
  • Defined __PTHREAD_MUTEX_INIT_VALUE, __PTHREAD_RECURSIVE_MUTEX_INIT_VALUE, and __PTHREAD_ERRORCHECK_MUTEX_INIT_VALUE for Android API level 9 and lower.
  • Added scalbln, scalblnf, and scalblnl to x86 libm.so for APIs 18 and later.
  • Fixed a typo in sources/android/support/include/iconv.h. (Issue 63806)
  • OTHER CHANGES:
  • Applied execution permissions to all *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.
  • Improved the speed of the make-standalone-toolchain.sh script by moving instead of copying if the specified destination directory does not exist.

New in Android NDK R9c (Dec 20, 2013)

  • IMPORTANT BUG FIXES:
  • Fixed a problem with GCC 4.8 ARM, in which the stack pointer is restored too early. This problem prevented the frame pointer from reliably accessing a variable in the stack frame. For more information, see http://gcc.gnu.org/bugzilla/show_bug.cgi?id=58854.
  • - Fixed a problem with GCC 4.8 libstdc++, in which a bug in std::nth_element was causing generation of code that produced a random segfault. For more information, see https://code.google.com/p/android/issues/detail?id=62910.
  • Fixed GCC 4.8 ICE in cc1/cc1plus with -fuse-ld=mcld, so that the following error no longer occurs: cc1: internal compiler error: in common_handle_option, at opts.c:1774
  • Fixed -mhard-float support for __builtin math functions. For ongoing information on fixes for -mhard-float with STL, please follow http://b.android.com/61784.
  • OTHER BUG FIXES:
  • Header fixes:
  • Changed prototype of poll to poll(struct pollfd *, nfds_t, int); in poll.h.
  • Added utimensat to libc.so in API levels 12 and 19. It is now present in levels 12-19.
  • Introduced futimens into libc.so, as of API level 19.
  • Added missing clock_settime() and clock_nanosleep() to time.h for API 8 and higher.
  • Added CLOCK_MONOTONIC_RAW, CLOCK_REALTIME_COARSE, CLOCK_MONOTONIC_COARSE, CLOCK_BOOTTIME, CLOCK_REALTIME_ALARM, and CLOCK_BOOTTIME_ALARM in time.h.
  • Removed obsolete CLOCK_REALTIME_HR and CLOCK_MONOTONIC_HR.
  • Refactored samples Teapot, MoreTeapots, and source/android/ndk_helper as follows:
  • They now use a hard-float abi for armeabi-v7a.
  • Android-19 now has immersive mode.
  • Fixed a problem with Check_ReleaseStringUTFChars in /system/lib/libdvm.so that was causing crashes on x86 devices.
  • Fixed ndk-build fails that happen in cygwin when the NDK package is referenced via symlink.
  • Fixed ndk-build.cmd fails that happen in windows cmd.exe when LOCAL_SRC_FILES contains absolute paths. See https://android-review.googlesource.com/#/c/69992.
  • Fixed ndk-stack to proceed even when it can't parse a frame due to inability to find a routine, filename, or line number. In any of those cases, it prints "??".
  • Fixed ndk-stack windows-x64_64 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.
  • Fixed gabi++ so that it:
  • Does not use malloc() to allocate C++ thread-local objects.
  • Avoids deadlocks in gabi++ in cases where libc.debug.malloc is non-zero in userdebug/eng Android platform builds.
  • OTHER CHANGES:
  • Added LOCAL_EXPORT_LDFLAGS.
  • Introduced the 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.
  • Provided the ability (option -g) to rebuild all of STL with debugging info in an optional, separate package called android-ndk-r9c-cxx-stl-libs-with-debugging-info.zip. This option helps ndk-stack to provide better a stack dump across STL. This change should not affect the code/size of the final, stripped file.
  • Enhanced hello-jni samples to report APP_ABI at compilation.
  • Used the ar tool in Deterministic mode (option -D) to build static libraries.

New in Android NDK R9b (Nov 1, 2013)

  • IMPORTANT CHANGES:
  • Updated 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)
  • Added support for API level 19, including Renderscript binding.
  • Added support for -mhard-float in the existing armeabi-v7a ABI. For more information and current restrictions on Clang, see tests/device/hard-float/jni/Android.mk.
  • Migrated from GNU Compiler Collection (GCC) 4.8 to 4.8.2, and added diagnostic color support.
  • Added two new samples to demonstrate OpenGL ES 3.0 features: Teapot and MoreTeapots. These samples run on devices with Android 4.1 (API level 16) and higher.
  • Deprecated GCC 4.7 and Clang 3.2 support, which will be removed in the next release.
  • IMPORTANT BUG FIXES:
  • Fixed problem with ARM GCC 4.6 thumb2 failing to generate 16-bit relative jump tables. (GCC Issue)
  • Fixed GCC 4.8 internal compiler error (ICE) on g++.dg/cpp0x/lambda/lambda-defarg3.C. (Change 62770, GCC Issue)
  • Fixed a problem with Windows 32-bit *-gdb.exe executables failing to launch. (Issue 58975)
  • Fixed GCC 4.8 ICE when building bullet library.
  • Modified GDB/ARM build to skip ARM.exidx data for unwinding in prologue code and added a command (set arm exidx-unwinding) to control exidx-based stack unwinding. (Issue 55826)
  • Fixed Clang 3.3 MIPS compiler problem where HI and LO registers are incorrectly reused.
  • Fixed issue with MIPS 4.7 ICE in dbx_reg_number.
  • OTHER BUG FIXES:
  • Fixed problem building samples/gles3jni with Clang on Android API level 11.
  • Fixed MCLinker to allow multiple occurrences of the following options: -gc-sections and --eh-frame-hdr.
  • Fixed MCLinker to accept the --no-warn-mismatch option.
  • Modified 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)
  • Fixed problem with android_native_app_glue.c erroneously logging errors on event predispatch operations.
  • Fixed all operations on gabi++ terminate and unexpected_handler to be thread-safe.
  • Fixed several issues with Clang -integrated-as option so it can pass tests for ssax-instructions and fenv.
  • Fixed GCC 4.6/4.7/4.8 compiler to pass the linker option --eh-frame-hdr even for static executables. For more information, see the GCC patch.
  • Fixed extra apostrophe in CPU-ARCH-ABIS.html. For more information, see NDK-DEPENDS.html. (Issue 60142)
  • Fixed extra quotes in ndk-build output on Windows. (Issue 60649)
  • Fixed Clang 3.3 to compile ARM's built-in, atomic operations such as __atomic_fetch_add, __atomic_fetch_sub, and __atomic_fetch_or.
  • Fixed Clang 3.3 ICE with customized vfprintf. (Clang issue)
  • Header fixes:
  • Fixed the ARM 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)
  • Fixed include/netinet/tcp.h to contain TCP_INFO state enum. (Issue 38881)
  • Fixed the 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)
  • Removed non-existent functions imaxabs and imaxdiv from header inttypes.h.
  • Fixed issue with pthread_exit() return values and pthread_self(). (Issue 60686)
  • Added missing mkdtemp() function, which already exists in bionic header stdlib.h.
  • OTHER CHANGES:
  • Enabled OpenMP for all GCC builds.
  • Reduced the size of ld.mcld significantly (1.5MB vs. ld.bfd 3.5MB and ld.gold 7.5MB), resulting in a speed improvement of approximately 20%.
  • Added 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.
  • Added gabi++ array helper functions.
  • Modified GCC builds so that all libgcc.a files are built with -funwind-tables to allow the stack to be unwound past previously blocked points, such as __aeabi_idiv0.
  • Added Ingenic MXU support in MIPS GCC4.6/4.7/4.8 with new -mmxu option.
  • Extended MIPS GCC4.6/4.7/4.8 -mldc1-sdc1 to control ldxc1/sdxc1 too
  • Added crazy linker. For more information, see sources/android/crazy_linker/README.TXT.
  • Fixed bitmap-plasma to draw to full screen rather than a 200x200 pixel area.
  • Reduced linux and darwin toolchain sizes by 25% by creating symlinks to identical files.

New in Android NDK R8e (Mar 22, 2013)

  • IMPORTANT CHANGES:
  • Added 64-bit host toolchain set (package name suffix *-x86_64.*). For more information, see CHANGES.HTML and NDK-BUILD.html.
  • Added Clang 3.2 compiler. GCC 4.6 is still the default. For information on using the Clang compiler, see CHANGES.HTML.
  • Added static code analyzer for Linux/MacOSX hosts. For information on using the analyzer, see CHANGES.HTML.
  • Added MCLinker for Linux/MacOSX hosts as an experimental feature. The ld.gold linker is the default where available, so you must explicitly enable it. For more information, see CHANGES.HTML.
  • Updated ndk-build to use topological sort for module dependencies, which means the build automatically sorts out the order of libraries specified in LOCAL_STATIC_LIBRARIES, LOCAL_WHOLE_STATIC_LIBRARIES and LOCAL_SHARED_LIBRARIES. For more information, see CHANGES.HTML. (Issue 39378)
  • IMPORTANT BUG FIXES:
  • Fixed build script to build all toolchains in -O2. Toolchains in previous releases were incorrectly built without optimization.
  • Fixed build script which unconditionally builds Clang/llvm for MacOSX in 64-bit.
  • Fixed GCC 4.6/4.7 internal compiler error: gen_thumb_movhi_clobber at config/arm/arm.md:5832. (Issue 52732)
  • Fixed build problem where GCC/ARM 4.6/4.7 fails to link code using 64-bit atomic built-in functions. (Issue 41297)
  • Fixed GCC 4.7 linker DIV usage mismatch errors. (Sourceware Issue)
  • Fixed GCC 4.7 internal compiler error build_data_member_initialization, at cp/semantics.c:5790.
  • Fixed GCC 4.7 internal compiler error redirect_eh_edge_1, at tree-eh.c:2214. (Issue 52909)
  • Fixed a GCC 4.7 segfault. (GCC Issue)
  • Fixed clock resolution and enabled steady_clock. (Issue 39680)
  • Fixed toolchain to enable _GLIBCXX_HAS_GTHREADS for GCC 4.7 libstdc++. (Issue 41770, Issue 41859)
  • Fixed problem with the X86 MXX/SSE code failing to link due to missing posix_memalign. (Change 51872)
  • Fixed GCC4.7/X86 segmentation fault in i386.c, function distance_non_agu_define_in_bb(). (Change 50383)
  • Fixed GCC4.7/X86 to restore earlier cmov behavior. (GCC Issue)
  • Fixed handling NULL return value of setlocale() in libstdc++/GCC4.7. (Issue 46718)
  • Fixed ld.gold runtime undefined reference to __exidx_start and __exidx_start_end. (Change 52134)
  • Fixed Clang 3.1 internal compiler error when using Eigen library. (Issue 41246)
  • Fixed Clang 3.1 internal compiler error including in C++11 mode. (Issue 39600)
  • Fixed Clang 3.1 internal compiler error when generating object code for a method call to a uniform initialized rvalue. (Issue 41387)
  • Fixed Clang 3.1/X86 stack realignment. (Change 52154)
  • Fixed problem with GNU Debugger (GDB) SIGILL when debugging on Android 4.1.2. (Issue 40941)
  • Fixed problem where GDB cannot set source:line breakpoints when symbols contain long, indirect file paths. (Issue 42448)
  • Fixed GDB read_program_header for MIPS PIE executables. (Change 49592)
  • Fixed STLport segmentation fault in uncaught_exception(). (Change 50236)
  • Fixed STLport bus error in exception handling due to unaligned access of DW_EH_PE_udata2, DW_EH_PE_udata4, and DW_EH_PE_udata8.
  • Fixed Gabi++ infinite recursion problem with nothrow new[] operator. (Issue 52833)
  • Fixed Gabi++ wrong offset to exception handler pointer. (Change 53446)
  • Removed Gabi++ redundant free on exception object (Change 53447)
  • OTHER BUG FIXES:
  • Fixed STLport to abort after out of memory error instead of silently exiting.
  • Fixed system and Gabi++ headers to be able to compile with API level 8 and lower.
  • Fixed cpufeatures to not parse /proc/self/auxv. (Issue 43055)
  • Fixed ld.gold to not depend on host libstdc++ and on Windows platforms, to not depend on the libgcc_sjlj_1.dll library.
  • Fixed Clang 3.1 which emits inconsistent register list in .vsave and fails assembler. (Change 49930)
  • Fixed Clang 3.1 to be able to compile libgabi++ and pass the test-stlport tests for MIPS build targets. (Change 51961)
  • Fixed Clang 3.1 to only enable exception by default for C++, not for C.
  • Fixed several issues in Clang 3.1 to pass most GNU exception tests.
  • Fixed scripts clang and clang++ in standalone NDK compiler to detect -cc1 and to not specify -target when found.
  • Fixed ndk-build to observe NDK_APP_OUT set in Application.mk.
  • Fixed X86 libc.so and lib.a which were missing the sigsetjmp and siglongjmp functions already declared in setjmp.h. (Issue 19851)
  • Patched GCC 4.4.3/4.6/4.7 libstdc++ to work with Clang in C++ 11. (Clang Issue)
  • Fixed cygwin path in argument passed to HOST_AWK.
  • Fixed ndk-build script warning in windows when running from project's JNI directory. (Issue 40192)
  • Fixed problem where the ndk-build script does not build if makefile has trailing whitespace in the LOCAL_PATH definition. (Issue 42841)
  • Fixed NDK headers:
  • Removed redundant definitions of size_t, ssize_t, and ptrdiff_t.
  • Fixed MIPS and ARM fenv.h header.
  • Fixed stddef.h to not redefine offsetof since it already exists in the toolchain.
  • Fixed elf.h to contain Elf32_auxv_t and Elf64_auxv_t. (Issue 38441)
  • Fixed the #ifdef C++ definitions in the OpenSLES_AndroidConfiguration.h header file. (Issue 53163)
  • OTHER CHANGES:
  • Enabled threading support in GCC/MIPS toolchain.
  • Updated GCC exception handling helpers __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.
  • Updated build scripts so that Gabi++ and STLport static libraries are now built with hidden visibility except for exception handling helpers.
  • Updated build so that STLport is built for ARM in Thumb mode.
  • Added support for std::set_new_handler in Gabi++. (Issue 52805)
  • Enabled FUTEX system call in GNU libstdc++.
  • Updated ndk-build so that it no longer copies prebuilt static library to a project's obj/local// directory. (Issue 40302)
  • Removed __ARM_ARCH_5*__ from ARM toolchains/*/setup.mk script. (Issue 21132)
  • Built additional GNU libstdc++ libraries in thumb for ARM.
  • Enabled MIPS floating-point madd/msub/nmadd/nmsub/recip/rsqrt instructions with 32-bit FPU.
  • Enabled graphite loop optimizer in GCC 4.6 and 4.7 to allow more optimizations: -fgraphite, -fgraphite-identity, -floop-block, -floop-flatten, -floop-interchange, -floop-strip-mine, -floop-parallelize-all, and -ftree-loop-linear. (info)
  • Enabled polly for Clang 3.1 on Linux and Max OS X 32-bit hosts which analyzes and optimizes memory access. (info)
  • Enabled -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.
  • Enabled --plugin and --plugin-opt for ld.gold in GCC 4.6/4.7.
  • Enabled --text-reorder for ld.gold in GCC 4.7.
  • Configured GNU libstdc++ with _GLIBCXX_USE_C99_MATH which undefines the isinf script in the bionic header. For more information, see CHANGES.html.
  • Added APP_LDFLAGS to the build scripts. For more information, see ANDROID-MK.html.
  • Updated build scripts to allow NDK_LOG=0 to disable the NDK_LOG.
  • Updated build scripts to allow NDK_HOST_32BIT=0 to disable the host developer environment 32-bit toolchain.
  • Changed the default GCC/X86 flags -march= and -mtune= from pentiumpro and generic to i686 and atom.
  • Enhanced toolchain build scripts:
  • Fixed a race condition in build-gcc.sh for the mingw build type which was preventing a significant amount of parallel build processing.
  • Updated build-gabi++.sh and build-stlport.sh so they can now run from the NDK package. (Issue 52835)
  • Fixed run-tests.sh in the MSys utilities collection.
  • Improved 64-bit host toolchain and Canadian Cross build support.
  • Updated build-mingw64-toolchain.sh script to more recent version.
  • Added option to build libgnustl_static.a and stlport_static.a without hidden visibility.

New in Android NDK R8d (Dec 21, 2012)

  • IMPORTANT CHANGES:
  • Added the GNU Compiler Collection (GCC) 4.7 compiler to the NDK.
  • Added stlport exception support via gabi++. Note that the new gabi++ depends on dlopen and related code
  • For more information, see 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.
  • Added a -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.
  • Added 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)
  • IMPORTANT BUG FIXES:
  • Fixed unnecessary rebuild of object files when using the ndk-build script. (Issue 39810)
  • Fixed a linker failure with the NDK 8c release for Mac OS X 10.6.x that produced the following error: dyld: lazy symbol binding failed: Symbol not found: _memmem
  • Referenced from: ...../arm-linux-androideabi/bin/ld
  • Expected in: /usr/lib/libSystem.B.dylib. This 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.
  • Removed the -x c++ options from the Clang++ standalone build script. (Issue 39089)
  • Fixed issues using the NDK_TOOLCHAIN_VERSION=clang3.1 option in Cygwin. (Issue 39585)
  • Fixed the 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)
  • Added missing SL_IID_ANDROIDBUFFERQUEUESOURCE option in android-14 builds for ARM and X86. (Issue 40625)
  • Fixed x86 CPU detection for the ANDROID_CPU_X86_FEATURE_MOVBE feature. (Issue 39317)
  • Fixed an issue preventing the Standard Template Library (STL) from using C++ sources that do not have a .cpp file extension.
  • Fixed GCC 4.6 ARM internal compiler error at reload1.c:1061. (Issue 20862)
  • Fixed GCC 4.4.3 ARM internal compiler error at emit-rtl.c:1954. (Issue 22336)
  • Fixed GCC 4.4.3 ARM internal compiler error at postreload.c:396. (Issue 22345)
  • Fixed problem with GCC 4.6/4.7 skipping lambda functions. (Issue 35933)
  • OTHER BUG FIXES:
  • Fixed ndk-build script to not overwrite -Os with -O2 for ARM builds.
  • Fixed build scripts to allow overwriting of HOST_AWK, HOST_SED, and HOST_MAKE settings.
  • Fixed issue for ld.gold on fsck_msdos builds linking objects built by the Intel C/C++ compiler (ICC).
  • Fixed ARM EHABI support in Clang to conform to specifications.
  • Fixed GNU Debugger (GDB) to shorten the time spent on walking the target's link map during solib events. (Issue 38402)
  • Fixed missing libgcc.a file when linking shared libraries.
  • OTHER CHANGES:
  • Backported 64-bit built-in atomic functions for ARM to GCC 4.6.
  • Added documentation for audio output latency, along with other documentation and fixes.
  • Fixed debug builds with Clang so that non-void functions now raise a SIGILL signal for paths without a return statement.
  • Updated 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.
  • Updated GCC and Clang bug report URL to: http://source.android.com/source/report-bugs.html
  • Added ARM ELF support to llvm-objdump.
  • Suppressed treating c input as c++ warning for Clang builds.
  • Updated build so that only the 32-bit version of libiberty.a is built and placed in lib32/.
  • NDK header file fixes:
  • Fixed __WINT_TYPE__ and wint_t to be the same type.
  • Corrected typo in android/bitmap.h. (Issue 15134)
  • Corrected typo in errno.h.
  • Added check for the presence of __STDC_VERSION__ in sys/cdefs.h. (Issue 14627)
  • Reorganized headers in byteswap.h and dirent.h.
  • Fixed limits.h to include page.h which provides PAGE_SIZE settings. (Issue 39983)
  • Fixed return type of glGetAttribLocation() and glGetUniformLocation() from int to GLint.
  • Fixed __BYTE_ORDER constant for x86 builds. (Issue 39824)

New in Android NDK R8c (Nov 14, 2012)

  • IMPORTANT CHANGES:
  • Added the Clang 3.1 compiler to the NDK. The GNU Compiler Collection (GCC) 4.6 is still the default, so you must explicitly enable the Clang compiler option as follows
  • For ndk-build, export NDK_TOOLCHAIN_VERSION=clang3.1 or add this environment variable setting to Application.mk.
  • For standalone builds, add --llvm-version=3.1 to make-standalone-toolchain.sh and replace CC and CXX in your makefile with /bin/clang and /bin/clang++.
  • Added Gold linker 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.
  • Added checks for spaces in the NDK path to the ndk-build[.cmd] and ndk-gdb scripts, to prevent build errors that are difficult to diagnose.
  • Made the following changes to API level handling:
  • Modified build logic so that projects that specify android-10 through android-13 in APP_PLATFORM, project.properties or default.properties link against android-9 instead of android-14.
  • Updated build so that executables using android-16 (Jelly Bean) or higher are compiled with the -fPIE option for position-independent executables (PIE). A new APP_PIE option allows you to control this behavior.
  • Updated the cpu-features helper library to include more ARM-specific features. See sources/android/cpufeatures/cpu-features.h for details.
  • Modified the long double on the X86 platform to be 8 bytes. This data type is now the same size as a double, but is still treated as a distinct type.
  • Updated build for APP_ABI=armeabi-v7a
  • Modified this build type to pass the -march=armv7-a parameter to the linker. This change ensures that v7-specific libraries and crt*.o are linked correctly.
  • Added -mfpu=vfpv3-d16 to ndk-build instead of the -mfpu=vfp option used in previous releases.
  • IMPORTANT BUG FIXES:
  • Fixed an issue where running make-standalone-toolchain.sh with root privileges resulted in the stand alone tool chain being inaccessible to some users.
  • All files and executables in the NDK release package are set to have read and execute permissions for all.
  • The ownership/group of libstdc++.a is now preserved when copied.
  • Removed redundant \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.
  • Fixed Windows parallel builds that sometimes failed due to timing issues in the host-mkdir implementation.
  • Fixed GCC 4.4.3 GNU libstdc++ to not merge typeinfo names by default. For more details, see toolchain repo gcc/gcc-4.4.3/libstdc++-v3/libsupc++/typeinfo.
  • Fixed problem on 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.
  • Fixed GCC 4.4.3 crashes on ARM NEON-specific type definitions for floats. Fixed the STLport internal _IteWrapper::operator*() implementation where a stale stack location holding the dereferenced value was returned and caused runtime crashes.
  • ARM-specific fixes:
  • Fixed ARM GCC 4.4.3/4.6 g++ to not warn that the mangling of was changed in GCC 4.4. The workaround using the -Wno-psabi switch to avoid this warning is no longer required.
  • Fixed an issue when a project with .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.
  • Fixed 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.
  • Removed Unknown EABI object attribute 44 warning when binutils-2.19/ld links prebuilt object by newer binutils-2.21
  • Fixed an issue in GNU stdc++ compilation with both -mthumb and -march=armv7-a, by modifying make-standalone-toolchain.sh to populate headers/libs in sub-directory armv7-a/thumb.
  • Fixed unresolvable R_ARM_THM_CALL relocation error.
  • Fixed internal compiler error at reload1.c:3633, caused by the ARM back-end expecting the wrong operand type when sign-extend from char.
  • Fixed internal compiler error with negative shift amount.
  • Fixed -fstack-protector for X86, which is also the default for the ndk-build x86 ABI target.
  • MIPS-specific fixes:
  • Fixed STLport endian-ness by setting _STLP_LITTLE_ENDIAN to 1 when compiling MIPS libstlport_*.
  • Fixed GCC __builtin_unreachable issue when compiling LLVM. (GCC Issue 54369)
  • Backported fix for cc1 compile process consuming 100% CPU.
  • GNU Debugger-specific fixes:
  • Disabled Python support in gdb-7.x at build, otherwise the gdb-7.x configure function may pick up whatever Python version is available on the host and build gdb with a hard-wired dependency on a specific version of Python.
  • Fixed ndk-gdb when APP_ABI contains all and matchs none of the known architectures.
  • Fixed Windows pathname support, by keeping the : character if it looks like it could be part of a Windows path starting with a drive letter.
  • Fixed adding of hardware breakpoint support for ARM in gdbserver.
  • Added fix to only read the current solibs when the linker is consistent. This change speeds up solib event handling.
  • Added fix to make repeated attempts to find solib breakpoints. GDB now retries enable_break() during every call to svr4_current_sos() until it succeeds.
  • Fixed an issue where gdb would not stop on breakpoints placed in dlopen-ed libraries.
  • Fixed 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.
  • OTHER BUG FIXES:
  • Fixed NDK headers
  • Fixed arch-mips/include/asm/* code that was incorrectly removed from original kernel. (Change 43335)
  • Replaced struct member data __unused with __linux_unused in linux/sysctl.h and linux/icmp.h to avoid conflict with #define __unused in sys/cdefs.h.
  • Fixed fenv.h for enclosed C functions with __BEGIN_DECLS and __END_DECLS.
  • Removed unimplemented functions in malloc.h.
  • Fixed stdint.h defintion of uint64_t for ANSI compilers. (Issue 1952)
  • Fixed preprocessor macros in /include/machine/*.
  • Replaced link.h for MIPS with new version supporting all platforms.
  • Removed linux-unistd.h
  • Move GLibc-specific macros LONG_LONG_MIN, LONG_LONG_MAX and ULONG_LONG_MAX from to .
  • Fixed a buffer overflow in ndk-stack-parser.
  • Fixed _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.
  • Fixed building of Linux-only NDK packages without also building Windows code.
  • Fixed 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
  • Fixed symbol decoder for ARM used in objdump for plt entries to generate a more readable form function@plt.
  • Removed the following symbols, introduced in GCC 4.6 libgcc.a, from the X86 platform libc.so library: __aeabi_idiv0, __aeabi_ldiv0, __aeabi_unwind_cpp_pr1, and __aeabi_unwind_cpp_pr2.
  • Removed unused .ctors, .dtors, and .eh_frame in MIPS crt*_so.S.
  • Updated 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.
  • OTHER CHANGES:
  • Removed 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.
  • Simplified c++ include path in standalone packages
  • Fixed 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.
  • Fixed an issue in samples/san-angeles that caused a black screen or freeze frame on re-launch.
  • Replaced deprecated APIs in NDK samples.
  • hello-gl2 from android-5 to android-7
  • native-activity from android-9 to android-10
  • native-audio from android-9 to android-10
  • native-plasma from android-9 to android-10
  • Added new branding for Android executables with a simpler scheme in section .note.android.ident (defined in crtbegin_static/dynamic.o) so that debugging tools can act accordingly. The previous branding options in section .note.ABI-tag are deprecated.
  • Added a new script 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

New in Android NDK R8b (Jul 19, 2012)

  • IMPORTANT BUG FIXES:
  • Fixed 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.
  • Fixed several issues in ndk-gdb:
  • Updated tool to pass flags -e, -d and -s to adb more consistently.
  • Updated tool to accept device serial names containing spaces.
  • Updated tool to retrieve /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).
  • Fixed ndk-build clean on Windows, which was failing to remove ./libs/*/lib*.so.
  • Fixed ndk-build.cmd to return a non-zero ERRORLEVEL when make fails.
  • Fixed libc.so to stop incorrectly exporting the __exidx_start and __exidx_end symbols.
  • Fixed SEGV when unwinding the stack past __libc_init for ARM and MIPS.
  • IMPORTANT CHANGES:
  • Added GCC 4.6 toolchain (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):
  • GCC 4.6 is now the default toolchain. You may set NDK_TOOLCHAIN_VERSION=4.4.3 in Android.mk to select the original one.
  • Support for the gold linker is only available for ARM and x86 architectures on Linux and Mac OS hosts. This support is disabled by default. Add LOCAL_C_FLAGS += -fuse-ld=gold in Android.mk to enable it.
  • Programs compiled with -fPIE require the new GDB for debugging, including binaries in Android 4.1 (API Level 16) system images.
  • The binutils 2.21 ld tool contains back-ported fixes from version 2.22:
  • Fixed ld --gc-sections, which incorrectly retains zombie references to external libraries. (more info).
  • Fixed ARM 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. (more info)
  • Disabled sincos() optimization for compatibility with older platforms.
  • Updated build options to enable the Never eXecute (NX) bit and relro/bind_now protections by default:
  • Added --noexecstack to assembler and -z noexecstack to linker that provides NX protection against buffer overflow attacks by enabling NX bit on stack and heap.
  • Added -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)
  • Added branding for Android executables with the .note.ABI-tag section (in crtbegin_static/dynamic.o) so that debugging tools can act accordingly.
  • OTHER BUG FIXES:
  • Fixed mips-linux-gnu relocation truncated to fit R_MIPS_TLS_LDM issue. (more info)
  • Fixed ld tool segfaults when using --gc-sections. (more info)
  • Fixed MIPS GOT_PAGE counting issue. (more info)
  • Fixed follow warning symbol link for mips_elf_count_got_symbols.
  • Fixed follow warning symbol link for mips_elf_allocate_lazy_stub.
  • Moved MIPS .dynamic to the data segment, so that it is writable.
  • Replaced hard-coded values for symbols with correct segment sizes for MIPS.
  • Removed the -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.
  • Fixed wrong package names in samples hello-jni and two-libs so that the tests project underneath it can compile.
  • OTHER CHANGES:
  • Changed locations of binaries:
  • Moved gdbserver from toolchain//prebuilt/gdbserver to prebuilt/android-/gdbserver/gdbserver.
  • Renamed x86 toolchain prefix from i686-android-linux- to i686-linux-android-.
  • Moved 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.
  • Moved libbfd.a and libintl.a from lib/ to lib32/.
  • Added and improved various scripts in the rebuild and test NDK toolchain:
  • Added build-mingw64-toolchain.sh to generate a new Linux-hosted toolchain that generates Win32 and Win64 executables.
  • Improved speed of 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.
  • Added build-host-gcc.sh and build-host-gdb.sh scripts.
  • Added tests/check-release.sh to check the content of a given NDK installation directory, or an existing NDK package.
  • Rewrote the tests/standalone/run.sh standalone tests .
  • Removed 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).

New in Android NDK R8 (Jun 28, 2012)

  • New features:
  • Added support for the MIPS ABI, which allows you to generate machine code that runs on compatible MIPS-based Android devices. Major features for MIPS include MIPS-specific toolchains, system headers, libraries and debugging support. For more details regarding MIPS support, see docs/CPU-MIPS.html in the NDK package.
  • You can build a standalone MIPS toolchain using the --arch=mips option when calling make-standalone-toolchain.sh. See docs/STANDALONE-TOOLCHAIN.html for more details.
  • Important bug fixes:
  • Fixed a typo in GAbi++ implementation where the result of dynamic_cast(b) of base class object b to derived class D is incorrectly adjusted in the opposite direction from the base class. (Issue 28721)
  • Fixed an issue in which make-standalone-toolchain.sh fails to copy libsupc++.*.
  • Other bug fixes:
  • Fixed 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.

New in Android NDK R7c (Apr 10, 2012)

  • Important bug fixes:
  • Fixed GNU STL armeabi-v7a binaries to not crash on non-NEON devices. The files provided with NDK r7b were not configured properly, resulting in crashes on Tegra2-based devices and others when trying to use certain floating-point functions (e.g., cosf, sinf, expf).
  • Important changes:
  • Added support for custom output directories through the 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.
  • Added support for building modules with hundreds or even thousands of source files by defining 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.
  • Other bug fixes:
  • Fixed 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.

New in Android NDK R7b (Mar 21, 2012)

  • Important bug fixes:
  • Updated 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.
  • Reverted to binutils 2.19 to fix debugging issues that appeared in NDK r7 (which switched to binutils 2.20.1).
  • Fixed 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.
  • Fixed native Windows build (ndk-build.cmd). Other build modes were not affected.
  • Fixed the standalone toolchain to generate proper binaries when using -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.
  • Fixed gnustl_shared on Cygwin. The linker complained that it couldn't find libsupc++.a even though the file was at the right location.
  • Fixed Cygwin C++ link when not using any specific C++ runtime through APP_STL.
  • Other changes:
  • When your application uses the GNU libstdc++ runtime, the compiler will no longer forcibly enable exceptions and RTTI. This change results in smaller code.
  • 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.
  • Fixed a rare bug where NDK r7 would fail to honor the 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
  • stlport: Removed 5 unnecessary static initializers from the library.
  • The GNU libstdc++ libraries for armeabi-v7a were mistakenly compiled for armeabi instead. This change had no impact on correctness, but using the right ABI should provide slightly better performance.
  • The 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.
  • Cygwin: ndk-build no longer creates an empty "NUL" file in the current directory when invoked.
  • Cygwin: Added better automatic dependency detection.
  • Cygwin: 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.

New in Android NDK R7 (Nov 12, 2011)

  • Android NDK r7 includes a number of build system improvements and bug fixes, but most importantly it gives you access to two new sets of APIs:
  • Low-level streaming multimedia: A new API based on Khronos OpenMAX AL 1.0.1 provides a direct, efficient path for low-level streaming multimedia. The new path is ideal for applications that need to maintain complete control over media data before passing it to the platform for presentation. For example, media applications can now retrieve data from any source, apply proprietary encryption/decryption, and then send the data to the platform for display.
  • Audio decoding into PCM: Extensions to the existing native audio API based on Khronos OpenSL ES let native apps decode compressed audio assets to PCM format.

New in Android NDK R6b (Oct 19, 2011)

  • Fixed the build when APP_ABI="armeabi x86" is used for multi-architecture builds.
  • Fixed the location of prebuilt STLport binaries in the NDK release package. A bug in the packaging script placed them in the wrong location.
  • Fixed atexit() usage in shared libraries with the x86standalone toolchain.
  • Fixed make-standalone-toolchain.sh --arch=x86. It used to fail to copy the proper GNU libstdc++ binaries to the right location.
  • Fixed the standalone toolchain linker warnings about missing the definition and size for the __dso_handle symbol (ARM only).
  • Fixed the inclusion order of $(SYSROOT)/usr/include for x86 builds. See the bug for more information.
  • Fixed the definitions of ptrdiff_t and size_t in x86-specific systems when they are used with the x86 standalone toolchain.

New in Android NDK R6 (Jul 16, 2011)

  • General notes:
  • Adds support for the x86 ABI, which allows you to generate machine code that runs on compatible x86-based Android devices. Major features for x86 include x86-specific toolchains, system headers, libraries and debugging support. For all of the details regarding x86 support, see 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.
  • You can build a standalone x86 toolchain using the --toolchain=x86-4.4.3 option when calling make-standalone-toolchain.sh. See docs/STANDALONE-TOOLCHAIN.html for more details.
  • The new 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.
  • Other changes:
  • arm-eabi-4.4.0, which had been deprecated since NDK r5, has been removed from the NDK distribution.

New in Android NDK R4b (Sep 2, 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 the changes in this release, read the CHANGES.TXT document included in the downloaded NDK package.
  • Provides a simplified build system through the new ndk-build build command.
  • Adds support for easy native debugging of generated machine code on production devices through the new ndk-gdb command.
  • Adds a new Android-specific ABI for ARM-based CPU architectures, armeabi-v7a. The new ABI extends the existing armeabi ABI to include these CPU instruction set extensions:
  • Thumb-2 instructions
  • VFP hardware FPU instructions (VFPv3-D16)
  • Optional support for ARM Advanced SIMD (NEON) GCC intrinsics and VFPv3-D32. Supported by devices such as Verizon Droid by Motorola, Google Nexus One, and others.
  • Adds a new 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.
  • Adds a sample application, 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.
  • Lets you generate machine code for either or both of the instruction sets supported by the NDK. For example, you can build for both ARMv5 and ARMv7-A architectures at the same time and have everything stored to your application's final .apk.
  • To ensure that your applications are available to users only if their devices are capable of running them, Android Market now 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.
  • Adds support for Android 2.2, including a new stable API for accessing the pixel buffers of Bitmap objects from native code.

New in Android NDK R4 (May 21, 2010)

  • Provides a simplified build system through the new ndk-build build command.
  • Adds support for easy native debugging of generated machine code on production devices through the new ndk-gdb command.
  • Adds a new 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.
  • Adds a sample application, 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.
  • Lets you generate machine code for either or both of the instruction sets supported by the NDK. For example, you can build for both ARMv5 and ARMv7-A architectures at the same time and have everything stored to your application's final .apk.
  • To ensure that your applications are available to users only if their devices are capable of running them, Android Market now 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.
  • Adds support for Android 2.2, including a new stable API for accessing the pixel buffers of Bitmap objects from native code.
  • Adds a new Android-specific ABI for ARM-based CPU architectures, armeabi-v7a. The new ABI extends the existing armeabi ABI to include these CPU instruction set extensions:
  • Thumb-2 instructions
  • VFP hardware FPU instructions (VFPv3-D16)
  • Optional support for ARM Advanced SIMD (NEON) GCC intrinsics and VFPv3-D32. Supported by devices such as Verizon Droid by Motorola, Google Nexus One, and others.

New in Android NDK R3 (May 21, 2010)

  • Toolchain improvement:
  • The toolchain binaries have been refreshed for this release with GCC 4.4.0, which should generate slightly more compact and efficient machine code than the previous one (4.2.1).
  • Note that the GCC 4.4.0 C++ frontend is more pedantic, and may refuse to compile certain rare and invalid template declarations that were accepted by 4.2.1. To alleviate the problem, this NDK still provides the 4.2.1 binaries, which can optionally be used to build your machine code.
  • OpenGL ES 2.0 support:
  • Applications targeting Android 2.0 (API level 5) or higher can now directly access OpenGL ES 2.0 features. This brings the ability to control graphics rendering through vertex and fragment shader programs, using the GLSL shading language.
  • A new trivial sample, named "hello-gl2", demonstrates how to render a simple triangle using both shader types.
  • Name simplification:
  • This NDK release is just called "r3", for "Revision 3", to indicate that it is not limited to a specific Android platform/API level. Some developers thought that the previous release's name (1.6_r1) was confusing and indicated that it could only be used to target Android 1.6, which was not true.