Downloads

android {
    ndkVersion "28.2.13676358"
}

Changelog

Report issues to GitHub.

For Android Studio issues, go to https://b.android.com and file a bug using the
Android Studio component, not the NDK component.

If you're a build system maintainer that needs to use the tools in the NDK
directly, see the build system maintainers guide.

Announcements

• The 16 KiB page size compatibility option that was added in r27 is now on by
  default. If necessary, you can still opt-out (see below).

r28c

• Updated LLVM to clang-r530567e. See clang_source_info.md in the toolchain
  directory for version information.
  • Issue 2144: Fixed issue where lldb.sh did not work when installed to a
    path which contained spaces.
• Issue 2143: Fixed lldb.sh not finding libpython on macOS.
• Issue 2145: ndk-build and CMake now appropriately configure 4KiB page sizes
  when APP_SUPPORT_FLEXIBLE_PAGE_SIZES/ANDROID_SUPPORT_FLEXIBLE_PAGE_SIZES
  are used.

r28b

• Updated LLVM to clang-r530567d. See clang_source_info.md in the toolchain
  directory for version information.
  • Issue 2136: Fixed limits.h not including any of the LONG_LONG related
    macros.
• Issue 1591: libz.a and libdl.a are no longer built with LTO, resolving
  occasional linking failures resulting from LLVM version desynchronization.

Changes

• Updated LLVM to clang-r530567b. See clang_source_info.md in the toolchain
  directory for version information.

  • Runtime libraries for non-Android have been removed reduce disk usage.
  • libc++ now includes debug info to aid debugging. This may make
    libc++_shared.so and any binaries that link libc++_static.a much larger
    before they are stripped. The Android Gradle Plugin will strip binaries when
    creating APKs, so this should not affect production apps.
  • Issue 2046: libclang and libclang-cpp are now supported.

• PAGE_SIZE is no longer defined by default for arm64-v8a or x86_64. To
  re-enable, set APP_SUPPORT_FLEXIBLE_PAGE_SIZES (ndk-build) or
  ANDROID_SUPPORT_FLEXIBLE_PAGE_SIZES (CMake) to false. See Support 16 KB
  page sizes for more information.

• The default alignment of shared libraries for arm64-v86 and x86_64 is now 16k.
  To revert to 4k alignment, set APP_SUPPORT_FLEXIBLE_PAGE_SIZES (ndk-build)
  or ANDROID_SUPPORT_FLEXIBLE_PAGE_SIZES (CMake) to false. See Support 16 KB
  page sizes for more information.

• Issue 1307: Removed non-NDK binder headers. A number of binder headers that
  should have been shipped with aidl were mistakenly shipped in the NDK. These
  headers are tightly coupled to the version of aidl used, so this introduced an
  unwanted version restriction between build-tools and the NDK. If you are using
  the NDK aidl backend, you will need to pass the aidl include path when
  building. See the aidl backend docs for more information.

• Issue 2058: Weak API references now work for libc APIs. This was enabled
  by conditionally removing the #if __ANDROID_API__ >= ... guards that
  previously wrapped declarations in libc headers when weak API references are
  used. When weak API references are not used (the default behavior), the
  declarations will still be hidden by the preprocessor.

  If your project contains polyfills for any of those APIs and uses weak API
  references, this change may break your build due to the conflicting
  declarations. The simplest fix is to rename your polyfill to not collide with
  libc. For example, rename conflicting_api to conflicting_api_fallback and
  call that instead. Use #define conflicting_api() conflicting_api_fallback()
  if you want to avoid rewriting callsites.

  Please open a bug if you run into issues with existing polyfills. We may be
  able to add the polyfill directly to the NDK.

• Issue 2100: Raised minimum required CMake version of the NDK's toolchain
  file from 3.6.0 to 3.10.0 to address warnings from new versions of CMake about
  upcoming loss of compatibility with versions older than 3.10.

Downloads

android {
    ndkVersion "29.0.13599879"
}

Changelog

Report issues to GitHub.

For Android Studio issues, go to https://b.android.com and file a bug using the
Android Studio component, not the NDK component.

If you're a build system maintainer that needs to use the tools in the NDK
directly, see the build system maintainers guide.

Announcements

Changes

• Updated LLVM to clang-r563880. See clang_source_info.md in the toolchain
  directory for version information.
  • Issue 2142: Fixed crash with icf=safe due to duplicate GOT entries.
  • Issue 2144: Fixed issue where lldb.sh did not work when installed to a
    path which contained spaces.
• ndk-stack will now find symbols in files with matching build IDs even if the
  file names do not match.
• ndk-stack will now find symbols in files with matching build IDs even if the
  name of the file is not present in the trace.
• Issue 2078: ndk-stack now accepts a native-debug-symbols.zip file for the
  --sym argument as an alternative to a directory.
• Issue 2109: llvm-lipo has been removed. This tool is only useful for
  building macOS binaries but was mistakenly included in the NDK.
• Issue 2135: simpleperf no longer depends on Tk-Inter in non-GUI mode.
• Issue 2146: Fixed a case where invalid data would appear in simpleperf
  reports.

Downloads

android {
    ndkVersion "28.1.13356709"
}

Changelog

Report issues to GitHub.

For Android Studio issues, go to https://b.android.com and file a bug using the
Android Studio component, not the NDK component.

If you're a build system maintainer that needs to use the tools in the NDK
directly, see the build system maintainers guide.

Announcements

• The 16 KiB page size compatibility option that was added in r27 is now on by
  default. If necessary, you can still opt-out (see below).

r28b

• Updated LLVM to clang-r530567d. See clang_source_info.md in the toolchain
  directory for version information.
  • Issue 2136: Fixed limits.h not including any of the LONG_LONG related
    macros.
• Issue 1591: libz.a and libdl.a are no longer built with LTO, resolving
  occasional linking failures resulting from LLVM version desynchronization.

Changes

• Updated LLVM to clang-r530567b. See clang_source_info.md in the toolchain
  directory for version information.

  • Runtime libraries for non-Android have been removed reduce disk usage.
  • libc++ now includes debug info to aid debugging. This may make
    libc++_shared.so and any binaries that link libc++_static.a much larger
    before they are stripped. The Android Gradle Plugin will strip binaries when
    creating APKs, so this should not affect production apps.
  • Issue 2046: libclang and libclang-cpp are now supported.

• PAGE_SIZE is no longer defined by default for arm64-v8a or x86_64. To
  re-enable, set APP_SUPPORT_FLEXIBLE_PAGE_SIZES (ndk-build) or
  ANDROID_SUPPORT_FLEXIBLE_PAGE_SIZES (CMake) to false. See Support 16 KB
  page sizes for more information.

• The default alignment of shared libraries for arm64-v86 and x86_64 is now 16k.
  To revert to 4k alignment, set APP_SUPPORT_FLEXIBLE_PAGE_SIZES (ndk-build)
  or ANDROID_SUPPORT_FLEXIBLE_PAGE_SIZES (CMake) to false. See Support 16 KB
  page sizes for more information.

• Issue 1307: Removed non-NDK binder headers. A number of binder headers that
  should have been shipped with aidl were mistakenly shipped in the NDK. These
  headers are tightly coupled to the version of aidl used, so this introduced an
  unwanted version restriction between build-tools and the NDK. If you are using
  the NDK aidl backend, you will need to pass the aidl include path when
  building. See the aidl backend docs for more information.

• Issue 2058: Weak API references now work for libc APIs. This was enabled
  by conditionally removing the #if __ANDROID_API__ >= ... guards that
  previously wrapped declarations in libc headers when weak API references are
  used. When weak API references are not used (the default behavior), the
  declarations will still be hidden by the preprocessor.

  If your project contains polyfills for any of those APIs and uses weak API
  references, this change may break your build due to the conflicting
  declarations. The simplest fix is to rename your polyfill to not collide with
  libc. For example, rename conflicting_api to conflicting_api_fallback and
  call that instead. Use #define conflicting_api() conflicting_api_fallback()
  if you want to avoid rewriting callsites.

  Please open a bug if you run into issues with existing polyfills. We may be
  able to add the polyfill directly to the NDK.

• Issue 2100: Raised minimum required CMake version of the NDK's toolchain
  file from 3.6.0 to 3.10.0 to address warnings from new versions of CMake about
  upcoming loss of compatibility with versions older than 3.10.

Downloads

android {
    ndkVersion "29.0.13113456"
}

Changelog

Report issues to GitHub.

For Android Studio issues, go to https://b.android.com and file a bug using the
Android Studio component, not the NDK component.

If you're a build system maintainer that needs to use the tools in the NDK
directly, see the build system maintainers guide.

Announcements

Changes

• Updated LLVM to clang-r547379. See clang_source_info.md in the toolchain
  directory for version information.
• ndk-stack will now find symbols in files with matching build IDs even if the
  file names do not match.
• ndk-stack will now find symbols in files with matching build IDs even if the
  name of the file is not present in the trace.
• Issue 2078: ndk-stack now accepts a native-debug-symbols.zip file for the
  --sym argument as an alternative to a directory.

Downloads

android {
    ndkVersion "28.0.13004108"
}

Changelog

Report issues to GitHub.

For Android Studio issues, go to https://b.android.com and file a bug using the
Android Studio component, not the NDK component.

If you're a build system maintainer that needs to use the tools in the NDK
directly, see the build system maintainers guide.

Announcements

• The 16 KiB page size compatibility option that was added in r27 is now on by
  default. If necessary, you can still opt-out (see below).

Changes

• Updated LLVM to clang-r530567c. See clang_source_info.md in the toolchain
  directory for version information.

  • Runtime libraries for non-Android have been removed reduce disk usage.
  • libc++ now includes debug info to aid debugging. This may make
    libc++_shared.so and any binaries that link libc++_static.a much larger
    before they are stripped. The Android Gradle Plugin will strip binaries when
    creating APKs, so this should not affect production apps.
  • Issue 2046: libclang and libclang-cpp are now supported.

• PAGE_SIZE is no longer defined by default for arm64-v8a or x86_64. To
  re-enable, set APP_SUPPORT_FLEXIBLE_PAGE_SIZES (ndk-build) or
  ANDROID_SUPPORT_FLEXIBLE_PAGE_SIZES (CMake) to false. See Support 16 KB
  page sizes for more information.

• The default alignment of shared libraries for arm64-v86 and x86_64 is now 16k.
  To revert to 4k alignment, set APP_SUPPORT_FLEXIBLE_PAGE_SIZES (ndk-build)
  or ANDROID_SUPPORT_FLEXIBLE_PAGE_SIZES (CMake) to false. See Support 16 KB
  page sizes for more information.

• Issue 1307: Removed non-NDK binder headers. A number of binder headers that
  should have been shipped with aidl were mistakenly shipped in the NDK. These
  headers are tightly coupled to the version of aidl used, so this introduced an
  unwanted version restriction between build-tools and the NDK. If you are using
  the NDK aidl backend, you will need to pass the aidl include path when
  building. See the aidl backend docs for more information.

• Issue 2058: Weak API references now work for libc APIs. This was enabled
  by conditionally removing the #if __ANDROID_API__ >= ... guards that
  previously wrapped declarations in libc headers when weak API references are
  used. When weak API references are not used (the default behavior), the
  declarations will still be hidden by the preprocessor.

  If your project contains polyfills for any of those APIs and uses weak API
  references, this change may break your build due to the conflicting
  declarations. The simplest fix is to rename your polyfill to not collide with
  libc. For example, rename conflicting_api to conflicting_api_fallback and
  call that instead. Use #define conflicting_api() conflicting_api_fallback()
  if you want to avoid rewriting callsites.

  Please open a bug if you run into issues with existing polyfills. We may be
  able to add the polyfill directly to the NDK.

• Issue 2100: Raised minimum required CMake version of the NDK's toolchain
  file from 3.6.0 to 3.10.0 to address warnings from new versions of CMake about
  upcoming loss of compatibility with versions older than 3.10.

Downloads

android {
    ndkVersion "28.0.12916984-rc2"
}

Changelog

Report issues to GitHub.

For Android Studio issues, go to https://b.android.com and file a bug using the
Android Studio component, not the NDK component.

If you're a build system maintainer that needs to use the tools in the NDK
directly, see the build system maintainers guide.

Announcements

• The 16 KiB page size compatibility option that was added in r27 is now on by
  default. If necessary, you can still opt-out (see below).

Changes

• Updated LLVM to clang-r530567c. See clang_source_info.md in the toolchain
  directory for version information.

  • Runtime libraries for non-Android have been removed reduce disk usage.
  • libc++ now includes debug info to aid debugging. This may make
    libc++_shared.so and any binaries that link libc++_static.a much larger
    before they are stripped. The Android Gradle Plugin will strip binaries when
    creating APKs, so this should not affect production apps.
  • Issue 2046: libclang and libclang-cpp are now supported.

• PAGE_SIZE is no longer defined by default for arm64-v8a or x86_64. To
  re-enable, set APP_SUPPORT_FLEXIBLE_PAGE_SIZES (ndk-build) or
  ANDROID_SUPPORT_FLEXIBLE_PAGE_SIZES (CMake) to false. See Support 16 KB
  page sizes for more information.

• The default alignment of shared libraries for arm64-v86 and x86_64 is now 16k.
  To revert to 4k alignment, set APP_SUPPORT_FLEXIBLE_PAGE_SIZES (ndk-build)
  or ANDROID_SUPPORT_FLEXIBLE_PAGE_SIZES (CMake) to false. See Support 16 KB
  page sizes for more information.

• Issue 1307: Removed non-NDK binder headers. A number of binder headers that
  should have been shipped with aidl were mistakenly shipped in the NDK. These
  headers are tightly coupled to the version of aidl used, so this introduced an
  unwanted version restriction between build-tools and the NDK. If you are using
  the NDK aidl backend, you will need to pass the aidl include path when
  building. See the aidl backend docs for more information.

• Issue 2058: Weak API references now work for libc APIs. This was enabled
  by conditionally removing the #if __ANDROID_API__ >= ... guards that
  previously wrapped declarations in libc headers when weak API references are
  used. When weak API references are not used (the default behavior), the
  declarations will still be hidden by the preprocessor.

  If your project contains polyfills for any of those APIs and uses weak API
  references, this change may break your build due to the conflicting
  declarations. The simplest fix is to rename your polyfill to not collide with
  libc. For example, rename conflicting_api to conflicting_api_fallback and
  call that instead. Use #define conflicting_api() conflicting_api_fallback()
  if you want to avoid rewriting callsites.

  Please open a bug if you run into issues with existing polyfills. We may be
  able to add the polyfill directly to the NDK.

• Issue 2100: Raised minimum required CMake version of the NDK's toolchain
  file from 3.6.0 to 3.10.0 to address warnings from new versions of CMake about
  upcoming loss of compatibility with versions older than 3.10.

Downloads

android {
    ndkVersion "28.0.12674087"
}

Changelog

Report issues to GitHub.

For Android Studio issues, go to https://b.android.com and file a bug using the
Android Studio component, not the NDK component.

If you're a build system maintainer that needs to use the tools in the NDK
directly, see the build system maintainers guide.

Announcements

• The 16 KiB page size compatibility option that was added in r27 is now on by
  default. If necessary, you can still opt-out (see below).

Changes

• Updated LLVM to clang-r530567. See clang_source_info.md in the toolchain
  directory for version information.

  • Runtime libraries for non-Android have been removed reduce disk usage.
  • libc++ now includes debug info to aid debugging. This may make
    libc++_shared.so and any binaries that link libc++_static.a much larger
    before they are stripped. The Android Gradle Plugin will strip binaries when
    creating APKs, so this should not affect production apps.
  • Issue 2046: libclang and libclang-cpp are now supported.

• PAGE_SIZE is no longer defined by default for arm64-v8a or x86_64. To
  re-enable, set APP_SUPPORT_FLEXIBLE_PAGE_SIZES (ndk-build) or
  ANDROID_SUPPORT_FLEXIBLE_PAGE_SIZES (CMake) to false. See Support 16 KB
  page sizes for more information.

• The default alignment of shared libraries for arm64-v86 and x86_64 is now 16k.
  To revert to 4k alignment, set APP_SUPPORT_FLEXIBLE_PAGE_SIZES (ndk-build)
  or ANDROID_SUPPORT_FLEXIBLE_PAGE_SIZES (CMake) to false. See Support 16 KB
  page sizes for more information.

• Issue 1307: Removed non-NDK binder headers. A number of binder headers that
  should have been shipped with aidl were mistakenly shipped in the NDK. These
  headers are tightly coupled to the version of aidl used, so this introduced an
  unwanted version restriction between build-tools and the NDK. If you are using
  the NDK aidl backend, you will need to pass the aidl include path when
  building. See the aidl backend docs for more information.

• Issue 2058: Weak API references now work for libc APIs. This was enabled
  by conditionally removing the #if __ANDROID_API__ >= ... guards that
  previously wrapped declarations in libc headers when weak API references are
  used. When weak API references are not used (the default behavior), the
  declarations will still be hidden by the preprocessor.

  If your project contains polyfills for any of those APIs and uses weak API
  references, this change may break your build due to the conflicting
  declarations. The simplest fix is to rename your polyfill to not collide with
  libc. For example, rename conflicting_api to conflicting_api_fallback and
  call that instead. Use #define conflicting_api() conflicting_api_fallback()
  if you want to avoid rewriting callsites.

  Please open a bug if you run into issues with existing polyfills. We may be
  able to add the polyfill directly to the NDK.

Downloads

android {
    ndkVersion "27.2.12479018"
}

Changelog

Report issues to GitHub.

For Android Studio issues, go to https://b.android.com and file a bug using the
Android Studio component, not the NDK component.

If you're a build system maintainer that needs to use the tools in the NDK
directly, see the build system maintainers guide.

Announcements

• Android V will allow OEMs to ship arm64-v8a devices with 16KiB page sizes.
  Devices that use this configuration will not be able to run existing apps that
  use native code. To be compatible with these devices, applications will need
  to rebuild all their native code to be 16KiB aligned, and rewrite any code
  which assumes a specific page size. ndk-build and CMake have options to enable
  this mode (see note about APP_SUPPORT_FLEXIBLE_PAGE_SIZES and
  ANDROID_SUPPORT_FLEXIBLE_PAGE_SIZES below). A future version of the NDK will
  enable this mode by default. If you're using or maintaining a third-party
  build system, consult the build system maintainers guide for instructions.

  See Support 16 KB page sizes for more information.

r27c

• Updated LLVM to clang-r522817c. See clang_source_info.md in the toolchain
  directory for version information.
  • Issue 2040: Further fixes for miscompiles of indirect gotos.
  • Issue 2064: Fix HWAsan miscompilation.
  • Issue 2070: Fix crash in instantiation of function definitions.
  • Issue 2084: Fix for incorrect compiler error on overloaded member
    functions with ref-qualifiers.

r27b

• Updated LLVM to clang-r522817b. See clang_source_info.md in the toolchain
  directory for version information.
  • Issue 2040: Fixed miscompile with indirect gotos.
  • Issue 2054: Fixed crash in x86 fp16 instruction selection.
  • Issue 2059: Fixed infinite loop in aarch64 vector instruction selection.
• Issue 2032: Fixed compatibility issues with projects that used a very old
  cmake_minimum_required version ("Policy CMP0057 is not set: Support new
  IN_LIST if() operator").
• Issue 2039: Fixed LOCAL_STRIP_MODE not being reset by
  include $(CLEAR_VARS).
• Issue 2049: Restored metadata used by CMake in non-toolchain-file use cases
  that used CMAKE_SYSTEM_PROCESSOR instead of CMAKE_ANDROID_ARCH_ABI. If you
  ran into this problem, you should switch to using CMAKE_ANDROID_ARCH_ABI
  because that's what CMake's docs say to use. Better still, use the NDK's
  toolchain file.

Changes

• Updated LLVM to clang-r522817. See clang_source_info.md in the toolchain
  directory for version information.
  • Issue 1728: Clang now emits an error for invalid Android target versions.
  • Issue 1853: clang-scan-deps is now included.
  • Issue 1911: Fixed inconsistent std::regex_replace results.
  • Issue 1947: Improved support for AArch64 function multi-versioning in clang.
  • Issue 1963: Fixed undefined behavior in std::unexpected::has_value().
  • Issue 1988: Added aarch64 support for preserve_all calling convention.
  • Issue 2007: Fixed crash in class template argument deduction caused by
    self-referential friend declaration.
  • Issue 2010: Removed superfluous libraries to reduce disk use.
  • Issue 2012: Fixed front end crash when using concepts and modules.
  • Issue 2013: Fixed false positive ODR violation in global module fragments.
  • Issue 2023: Fixed Clang crashes related to lambda captures in unevaluated
    contexts.
  • Issue 2024: Removed invalid __attribute__((__const__)) from gettid.
• A RISC-V sysroot (AKA riscv64, or rv64) has been added. It is not
  supported. It is present to aid bringup for OS vendors, but it's not yet a
  supported Android ABI. It will not be built by default.
• Issue 1856: Target-prefixed cmd wrappers for clang should now behave
  appropriately when the first argument includes quotes. You probably do not
  need to use those wrappers. In most cases where you would use
  aarch64-linux-android21-clang, you can instead use clang -target aarch64-linux-android21, e.g. CC="clang -target aarch64-linux-android21" ./configure. The wrappers are only needed when working with systems that do
  not properly handle a CC that includes arguments.
• Issue 1898: ndk-stack now tolerates 0x prefixed addresses.
• Issue 1921: ANDROID_USE_LEGACY_TOOLCHAIN_FILE value is now preserved
  during try-compile steps when ON.
• Issue 1974: Unintentionally shipped Vulkan headers have been removed from
  sources/third_party/vulkan. The standard Vulkan headers are included in the
  Android sysroot, which Clang will find automatically.
• Issue 1993: ndk-stack now tolerates invalid UTF-8 characters in the trace.
• Issue 1994: Fixed ndk-gdb/ndk-lldb to use the correct path for
  make and other tools.
• Added APP_SUPPORT_FLEXIBLE_PAGE_SIZES for ndk-build and
  ANDROID_SUPPORT_FLEXIBLE_PAGE_SIZES for CMake. Set to
  APP_SUPPORT_FLEXIBLE_PAGE_SIZES := true in your Application.mk or pass
  -DANDROID_SUPPORT_FLEXIBLE_PAGE_SIZES=ON to CMake (via
  android.defaultConfig.externalNativeBuild.cmake.arguments if you're using
  the Android Gradle Plugin) to build your code to be compatible with devices
  that use a 16KiB page size. Third-party build system users and maintainers
  should consult the build system maintainers guide.
• Symlinks are now properly preserved in the macOS App Bundle. The NDK installed
  via that method is now the same size as the one installed via the SDK manager.
• The unsupported libclang, libclang-cpp, libLLVM, and libLTO libraries were
  removed to save space.

Downloads

android {
    ndkVersion "28.0.12433566"
}

Changelog

Report issues to GitHub.

For Android Studio issues, go to https://b.android.com and file a bug using the
Android Studio component, not the NDK component.

If you're a build system maintainer that needs to use the tools in the NDK
directly, see the build system maintainers guide.

Announcements

• The 16 KiB page size compatibility option that was added in r27 is now on by
  default. If necessary, you can still opt-out (see below).

Changes

• Updated LLVM to clang-r530567. See clang_source_info.md in the toolchain
  directory for version information.

  • Runtime libraries for non-Android have been removed reduce disk usage.

• PAGE_SIZE is no longer defined by default for arm64-v8a or x86_64. To
  re-enable, set APP_SUPPORT_FLEXIBLE_PAGE_SIZES (ndk-build) or
  ANDROID_SUPPORT_FLEXIBLE_PAGE_SIZES (CMake) to false. See Support 16 KB
  page sizes for more information.

• The default alignment of shared libraries for arm64-v86 and x86_64 is now 16k.
  To revert to 4k alignment, set APP_SUPPORT_FLEXIBLE_PAGE_SIZES (ndk-build)
  or ANDROID_SUPPORT_FLEXIBLE_PAGE_SIZES (CMake) to false. See Support 16 KB
  page sizes for more information.

• Issue 1307: Removed non-NDK binder headers. A number of binder headers that
  should have been shipped with aidl were mistakenly shipped in the NDK. These
  headers are tightly coupled to the version of aidl used, so this introduced an
  unwanted version restriction between build-tools and the NDK. If you are using
  the NDK aidl backend, you will need to pass the aidl include path when
  building. See the aidl backend docs for more information.

• Issue 2058: Weak API references now work for libc APIs. This was enabled
  by removing the explicit #if __ANDROID_API__ >= ... guards that previously
  wrapped declarations in libc headers.

  If your project contains polyfills for any of those APIs, this change may
  break your build due to the conflicting declarations. The simplest fix is to
  rename your polyfill to not collide with libc. For example, rename
  conflicting_api to conflicting_api_fallback and call that instead. Use
  #define conflicting_api() conflicting_api_fallback() if you want to avoid
  rewriting callsites.

  Please open a bug if you run into issues with existing polyfills. We may be
  able to add the polyfill directly to the NDK.

Downloads

android {
    ndkVersion "27.1.12297006"
}

Changelog

Report issues to GitHub.

For Android Studio issues, go to https://b.android.com and file a bug using the
Android Studio component, not the NDK component.

If you're a build system maintainer that needs to use the tools in the NDK
directly, see the build system maintainers guide.

Announcements

• Android V will allow OEMs to ship arm64-v8a devices with 16KiB page sizes.
  Devices that use this configuration will not be able to run existing apps that
  use native code. To be compatible with these devices, applications will need
  to rebuild all their native code to be 16KiB aligned, and rewrite any code
  which assumes a specific page size. ndk-build and CMake have options to enable
  this mode (see note about APP_SUPPORT_FLEXIBLE_PAGE_SIZES and
  ANDROID_SUPPORT_FLEXIBLE_PAGE_SIZES below). A future version of the NDK will
  enable this mode by default. If you're using or maintaining a third-party
  build system, consult the build system maintainers guide for instructions.

  See Support 16 KB page sizes for more information.

r27b

• Updated LLVM to clang-r522817b. See clang_source_info.md in the toolchain
  directory for version information.
  • Issue 2040: Fixed miscompile with indirect gotos.
  • Issue 2054: Fixed crash in x86 fp16 instruction selection.
  • Issue 2059: Fixed infinite loop in aarch64 vector instruction selection.
• Issue 2032: Fixed compatibility issues with projects that used a very old
  cmake_minimum_required version ("Policy CMP0057 is not set: Support new
  IN_LIST if() operator").
• Issue 2039: Fixed LOCAL_STRIP_MODE not being reset by
  include $(CLEAR_VARS).
• Issue 2049: Restored metadata used by CMake in non-toolchain-file use cases
  that used CMAKE_SYSTEM_PROCESSOR instead of CMAKE_ANDROID_ARCH_ABI. If you
  ran into this problem, you should switch to using CMAKE_ANDROID_ARCH_ABI
  because that's what CMake's docs say to use. Better still, use the NDK's
  toolchain file.

Changes

• Updated LLVM to clang-r522817. See clang_source_info.md in the toolchain
  directory for version information.
  • Issue 1728: Clang now emits an error for invalid Android target versions.
  • Issue 1853: clang-scan-deps is now included.
  • Issue 1911: Fixed inconsistent std::regex_replace results.
  • Issue 1947: Improved support for AArch64 function multi-versioning in clang.
  • Issue 1963: Fixed undefined behavior in std::unexpected::has_value().
  • Issue 1988: Added aarch64 support for preserve_all calling convention.
  • Issue 2007: Fixed crash in class template argument deduction caused by
    self-referential friend declaration.
  • Issue 2010: Removed superfluous libraries to reduce disk use.
  • Issue 2012: Fixed front end crash when using concepts and modules.
  • Issue 2013: Fixed false positive ODR violation in global module fragments.
  • Issue 2023: Fixed Clang crashes related to lambda captures in unevaluated
    contexts.
  • Issue 2024: Removed invalid __attribute__((__const__)) from gettid.
• A RISC-V sysroot (AKA riscv64, or rv64) has been added. It is not
  supported. It is present to aid bringup for OS vendors, but it's not yet a
  supported Android ABI. It will not be built by default.
• Issue 1856: Target-prefixed cmd wrappers for clang should now behave
  appropriately when the first argument includes quotes. You probably do not
  need to use those wrappers. In most cases where you would use
  aarch64-linux-android21-clang, you can instead use clang -target aarch64-linux-android21, e.g. CC="clang -target aarch64-linux-android21" ./configure. The wrappers are only needed when working with systems that do
  not properly handle a CC that includes arguments.
• Issue 1898: ndk-stack now tolerates 0x prefixed addresses.
• Issue 1921: ANDROID_USE_LEGACY_TOOLCHAIN_FILE value is now preserved
  during try-compile steps when ON.
• Issue 1974: Unintentionally shipped Vulkan headers have been removed from
  sources/third_party/vulkan. The standard Vulkan headers are included in the
  Android sysroot, which Clang will find automatically.
• Issue 1993: ndk-stack now tolerates invalid UTF-8 characters in the trace.
• Issue 1994: Fixed ndk-gdb/ndk-lldb to use the correct path for
  make and other tools.
• Added APP_SUPPORT_FLEXIBLE_PAGE_SIZES for ndk-build and
  ANDROID_SUPPORT_FLEXIBLE_PAGE_SIZES for CMake. Set to
  APP_SUPPORT_FLEXIBLE_PAGE_SIZES := true in your Application.mk or pass
  -DANDROID_SUPPORT_FLEXIBLE_PAGE_SIZES=ON to CMake (via
  android.defaultConfig.externalNativeBuild.cmake.arguments if you're using
  the Android Gradle Plugin) to build your code to be compatible with devices
  that use a 16KiB page size. Third-party build system users and maintainers
  should consult the build system maintainers guide.
• Symlinks are now properly preserved in the macOS App Bundle. The NDK installed
  via that method is now the same size as the one installed via the SDK manager.
• The unsupported libclang, libclang-cpp, libLLVM, and libLTO libraries were
  removed to save space.