Google Git
Sign in
android / platform / tools / ndkports / 3c2d8853217993ae1d6d64b0d14019b9c5a9bc9f
commit3c2d8853217993ae1d6d64b0d14019b9c5a9bc9f[log] [tgz]
authorDan Albert <[email protected]>Thu Nov 18 22:53:30 2021 +0000
committerAutomerger Merge Worker <[email protected]>Thu Nov 18 22:53:30 2021 +0000
tree975b1014f0f083c5fbc8dc1c37f0235f8f6de792
parentbbc568949de332c3b53e6945d8cee7078950f356 [diff]
parente66c43e611fa8d96f0e7be5ae1ace570e399d7a0 [diff]
Enable building non-snapshot packages. am: de30c792c9 am: 324dbe1724 am: 368d553975 am: e66c43e611

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

Change-Id: I8e5f282cfe3af687066bb88a29a81fd7fadbc94f
tree: 975b1014f0f083c5fbc8dc1c37f0235f8f6de792
  1. .idea/
  2. buildSrc/
  3. curl/
  4. googletest/
  5. gradle/
  6. jsoncpp/
  7. openssl/
  8. scripts/
  9. .gitignore
  10. build.gradle.kts
  11. Dockerfile
  12. gradle.properties
  13. gradlew
  14. gradlew.bat
  15. README.md
  16. 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.