Merge "Rename GTest docs back to old case."
tree: e72d0a93b891c99464c7925634a106ccdceb399c
  1. .clang-format
  2. .github/
  3. .gitignore
  4. Android.mk
  5. CONTRIBUTING.md
  6. CleanSpec.mk
  7. MANIFEST.in
  8. NOTICE
  9. OWNERS
  10. README.md
  11. UserReadme.md
  12. bootstrap/
  13. build/
  14. checkbuild.py
  15. do_checkbuild.py
  16. docs/
  17. infra/
  18. meta/
  19. navbar.md
  20. ndk-gdb
  21. ndk-gdb.cmd
  22. ndk-gdb.py
  23. ndk-stack
  24. ndk-stack.cmd
  25. ndk-stack.py
  26. ndk-which
  27. ndk/
  28. parse_elfnote.py
  29. pylintrc
  30. qa_config.json
  31. requirements.txt
  32. run_tests.py
  33. samples/
  34. scripts/
  35. setup.py
  36. sources/
  37. tests/
  38. unittest.cfg
  39. wrap.sh/
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.

This page provides an overview of what is contained in the NDK. For information on building or testing the NDK, the roadmap, or other information, see the navigation bar at the top of this page, or the docs directory.

Other Resources

Components

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

For more information, see the Build System Maintainers guide.

Build Systems

While the NDK is primarily a toolchain for building Android code, the package also includes some build system support.

First, $NDK/build/core contains ndk-build. This is the NDK's home grown build system. The entry point for this build system is $NDK/build/ndk-build (or $NDK/build/ndk-build.cmd).

A CMake toolchain file is included at $NDK/build/cmake/android.toolchain.cmake. This is separate from CMake's own support for the NDK.

$NDK/build/tools/make_standalone_toolchain.py is a tool which can create a redistributable toolchain that targets a single Android ABI and API level. As of NDK r19 it is necessary, as the installed toolchain may be invoked directly, but it remains for compatibility.

Since the Android Gradle plugin is responsible for both Java and native code, is not included as part of 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) in ndk-build. CMake modules are not yet available.