Changelog

Report issues to GitHub.

For Android Studio issues, follow the docs on the Android Studio site.

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.

  • 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/toolchain 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/toolchain/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.

Changes

  • Updated Clang to r339409.

  • Issue 780: A complete NDK toolchain is now installed to $NDK/toolchain. See the announcements section for more information.

  • ndk-build no longer removes artifacts from NDK_LIBS_OUT for ABIs not present in APP_ABI. This enables workflows like the following:

    for abi in armeabi-v7a arm64-v8a x86 x86_64; do
    ndk-build APP_ABI=$abi
done

    Prior to this change, the above workflow would remove the previously built ABI's artifacts on each successive build, resulting in only x86_64 being present at the end of the loop.

  • Issue 776: To better support LLD, ndk-build and CMake no longer pass -Wl,--fix-cortex-a8 by default.

    • CPUs that require this fix are uncommon in the NDK's supported API range (16+).
    • If you need to continue supporting these devices, add -Wl,--fix-cortex-a8 to your APP_LDFLAGS or CMAKE_C_FLAGS, but note that LLD will not be adding support for this workaround.
    • Alternatively, use the Play Console to blacklist Cortex-A8 CPUs to disallow your app from being installed on those devices.

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.