Google Git
Sign in
android / platform / tools / ndkports / a181fe59a34803a1ba7300bd1a32532b6dc3e9fb
commita181fe59a34803a1ba7300bd1a32532b6dc3e9fb[log] [tgz]
authorXin Li <[email protected]>Thu Sep 10 21:30:49 2020 +0000
committerAutomerger Merge Worker <[email protected]>Thu Sep 10 21:30:49 2020 +0000
tree96d3320fa24a1aa2160e56ef7d8157d653cc0f9b
parent01e16af09bccbf6012d13935717798c7ba1c2dbb [diff]
parent44beb13dabbb0f74fb3f29d789d82d310ccb2d1a [diff]
[automerger skipped] Merge Android R am: ae27a0a500 -s ours am: 22c391f627 -s ours am: 75335b2489 -s ours am: a007ac4b54 -s ours am: 44beb13dab -s ours

am skip reason: Change-Id I412d75a28135a33f087c5f361ec7ca8c7da91d16 with SHA-1 d0ec81e4b1 is in history

Original change: https://android-review.googlesource.com/c/platform/tools/ndkports/+/1421830

Change-Id: I3cc7904edcb9fdd0730122256cc3d899c4595e5f
tree: 96d3320fa24a1aa2160e56ef7d8157d653cc0f9b
  1. .idea/
  2. gradle/
  3. ports/
  4. scripts/
  5. src/
  6. .gitignore
  7. build.gradle.kts
  8. Dockerfile
  9. gradle.properties
  10. gradlew
  11. gradlew.bat
  12. README.md
  13. settings.gradle.kts
README.md

ndkports

A collection of Android build scripts for various third-party libraries and the tooling to build them.

If you're an Android app developer looking to consume these libraries, this is probably not what you want. This project builds AARs to be published to Maven. You most likely want to use the AAR, not build it yourself.

Note: Gradle support for consuming these artifacts from an AAR is a work in progress.

Ports

Each third-party project is called a “port”. Ports consist of a description of where to fetch the source, apply any patches needed, build, install, and package the library into an AAR.

A port is a subclass of the abstract Kotlin class com.android.ndkports.Port. Projects define the name and version of the port, the URL to fetch source from, a list of modules (libraries) to build, and the build steps.

See the Port class for documentation on the port API.

Individual port files are kept in ports/$name/port.kts. For example, the cURL port is ports/curl/port.kts.

Building a Port

ndkports requires an NDK to be used for building to be specified on the command line as well as a list of packages to build. For example, to build cURL:

$ ./gradlew run --args='--ndk /path/to/android-ndk-r20 openssl curl'
Build output...
$ find  -name '*.aar'
./out/curl/curl.aar
./out/openssl/openssl.aar

Note that dependencies currently need to be already built or ordered explicitly.

To build all ports using Docker, use scripts/build.sh.