Google Git
Sign in
android / platform / tools / ndkports / refs/tags/android-11.0.0_r22
tag75261501250d95faaa8265d5387a411739e28ee7
taggerThe Android Open Source Project <initial-contribution@android.com>Mon Dec 14 16:53:00 2020 -0800
objectd0ec81e4b134f4b1446d3fd5a6dfbf095475597c 
Android 11.0.0 Release 22 (RQ1A.201205.011)
commitd0ec81e4b134f4b1446d3fd5a6dfbf095475597c[log] [tgz]
authorAutomerger Merge Worker <android-build-automerger-merge-worker@system.gserviceaccount.com>Sat Jan 11 03:25:27 2020 +0000
committerAutomerger Merge Worker <android-build-automerger-merge-worker@system.gserviceaccount.com>Sat Jan 11 03:25:27 2020 +0000
tree87adc91dc8b9927eeca53f1abe19ae6879addaff
parent96e7474da70c90db0c1c5da58a0de281fc582756 [diff]
parent4aa04b4bb32d2082210020e17ee438f2c1484c1a [diff]
Merge "Add docker file and build script for kokoro." am: a171259fff am: 60839884c9 am: 4aa04b4bb3

Change-Id: I412d75a28135a33f087c5f361ec7ca8c7da91d16
tree: 87adc91dc8b9927eeca53f1abe19ae6879addaff
  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.

abstract class Port {
    abstract val name: String
    abstract val version: String
    abstract val url: String

    open val dependencies: List<String> = emptyList()
    abstract val modules: List<Module>

    open fun fetchSource(
        sourceDirectory: File,
        workingDirectory: File
    ): Result<Unit, String>

    open fun configure(
        toolchain: Toolchain,
        sourceDirectory: File,
        buildDirectory: File,
        installDirectory: File,
        workingDirectory: File
    ): Result<Unit, String>

    open fun build(
        toolchain: Toolchain,
        buildDirectory: File
    ): Result<Unit, String>

    open fun install(
        toolchain: Toolchain,
        buildDirectory: File,
        installDirectory: File
    ): Result<Unit, String>
}

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.