Google Git
Sign in
android / platform / ndk / 2f7aa277079f13e431f355c33ccf1ab601d3e947
commit2f7aa277079f13e431f355c33ccf1ab601d3e947[log] [tgz]
authorDan Albert <[email protected]>Thu Jan 25 15:54:17 2018 -0800
committerDan Albert <[email protected]>Tue Feb 06 17:36:46 2018 -0800
tree36941b49d49b36ba38ea192a0464f256bb50a9c1
parent3efa9291abe7fe7be5193648772a731117e83bee [diff]
Work around Clang not passing --eh-frame-hdr.

Clang doesn't pass this automatically for static executables for some
reason, and libgcc can't unwind without a .eh_frame_hdr section.

Also move the test to libc++ since gnustl is going away soon.

Test: ./run_tests.py --filter static-executable-exceptions
Bug: http://b/24468267
Bug: http://b/30101473
Bug: http://b/72512648
Bug: https://github.com/android-ndk/ndk/issues/593
Change-Id: I153dfee4d22082560833517f1ee575742da21e21
2 files changed
tree: 36941b49d49b36ba38ea192a0464f256bb50a9c1
  1. .github/
  2. build/
  3. docs/
  4. infra/
  5. meta/
  6. ndk/
  7. samples/
  8. scripts/
  9. sources/
  10. tests/
  11. .clang-format
  12. .gitignore
  13. Android.mk
  14. CHANGELOG.md
  15. checkbuild.py
  16. CleanSpec.mk
  17. CONTRIBUTING.md
  18. MANIFEST.in
  19. navbar.md
  20. ndk-gdb
  21. ndk-gdb.cmd
  22. ndk-gdb.py
  23. ndk-which
  24. OWNERS
  25. parse_elfnote.py
  26. pylintrc
  27. qa_config.json
  28. README.md
  29. requirements.txt
  30. run_tests.py
  31. setup.py
  32. unittest.cfg
  33. UserReadme.md
README.md

Android Native Development Kit (NDK)

The latest version of this document is available at https://android.googlesource.com/platform/ndk/+/master/README.md.

Note: This document is for developers of the NDK, not developers that use the NDK.

The NDK allows Android application developers to include native code in their Android application packages, compiled as JNI shared libraries.

Other Resources

Building the NDK

Both Linux and Windows NDKs are built on Linux machines. Windows host binaries are cross-compiled with MinGW.

Building the NDK for Mac OS X requires at least 10.8.

Components

The NDK components can be loosely grouped into host toolchains, target prebuilts, build systems, and support libraries.

Host Toolchains

  • toolchains/ contains GCC and Clang toolchains.
    • $TOOLCHAIN/config.mk contains ARCH and ABIS this toolchain can handle.
    • $TOOLCHAIN/setup.mk contains toolchain-specific default CFLAGS/LDFLAGS when this toolchain is used.
  • prebuilt/$HOST_TAG contains build dependencies and additional tools.
    • make, python, yasm, and for Windows: cmp.exe and echo.exe
    • ndk-depends, ndk-stack and ndk-gdb can also be found here.

Target Prebuilts

  • sysroot/usr/include contains the headers for the NDK. See Unified Headers for more information.
  • platforms/android-$VERSION/arch-$ARCH_NAME/ contains stub shared libraries and a few static libraries for each API level. See Platform APIs for more information.
  • sources/cxx-stl/$STL contains the headers and libraries for the various C++ STLs.
  • prebuilt/android-$ARCH/gdbserver contains gdbserver.

Build Systems

  • build/ contains ndk-build, the NDK's home grown build system. Most of the implementation lives in build/core.
  • build/cmake contains components for using the NDK with CMake (at present only a CMake toolchain file, but in the future it will contain CMake modules that CMake will load, obviating the need for a toolchain file).
  • build/tools contains make_standalone_toolchain.py, but also contains legacy sripts that were used to build the NDK. Eventually, this should contain nothing but the standalone toolchain scripts.
  • The gradle plugins for the NDK are not included in the NDK.

Support Libraries

  • sources/android and sources/third_party contain modules that can be used in apps (gtest, cpufeatures, native_app_glue, etc) via $(call import-module,$MODULE).

Prerequisites

  • AOSP NDK Repository

    • Check out the branch master-ndk

      repo init -u https://android.googlesource.com/platform/manifest \
    -b master-ndk

# Googlers, use
repo init -u \
    persistent-https://android.git.corp.google.com/platform/manifest \
    -b master-ndk

Linux dependencies are listed in the Dockerfile. You can use docker to build the NDK:

docker build -t ndk-dev infra/docker
docker run -it -u $UID -v `realpath ..`:/src -w /src/ndk ndk-dev ./checkbuild.py

Building on Mac OS X has similar dependencies as Linux, but also requires Xcode.

Running tests requires that adb is in your PATH. This is provided as part of the Android SDK.

Building the NDK

For Linux or Darwin:

$ python checkbuild.py

For Windows, from Linux:

$ python checkbuild.py --system windows  # Or windows64.

checkbuild.py will also build all of the NDK tests. This takes about four times as long as building the NDK itself, so pass --no-build-tests to skip building the tests. They can be built later with python run_tests.py --rebuild.

checkbuild.py also accepts a variety of other options to speed up local builds, namely --arch and --module.

Packaging

By default, checkbuild.py will also package the NDK. To skip the packaging step, use the --no-package flag. To avoid packaging an incomplete NDK, packaging will not be run if --module was passed unless --force-package was also provided.