ndk-pkg-prefab-aar-maven-repo

A Maven Repository for the commonly used google prefab AARs that were created by ndk-pkg

configure with Android Gradle Plugin Kotlin DSL

step1. enable prefab feature for Android Gradle Plugin

android {
    buildFeatures {
        prefab = true
    }
}

step2. enable this maven repository for Gradle

allprojects {
    repositories {
        maven {
            url = uri("https://raw.githubusercontent.com/leleliu008/ndk-pkg-prefab-aar-maven-repo/master")
        }
    }
}

中国大陆的用户可使用如下配置：

allprojects {
    repositories {
        maven {
            url = uri("https://ghproxy.com/https://raw.githubusercontent.com/leleliu008/ndk-pkg-prefab-aar-maven-repo/master")
        }
    }
}

step3. add dependencies in build.gradle.kts

Every package's coordinate for Gradle is com.fpliu.ndk.pkg.prefab.android.21:<PACKAGE-NAME>:<PACKAGE-VERSION>, for example, libpng package has a version 1.6.37, we could use it as follows:

dependencies {
    implementation ("com.fpliu.ndk.pkg.prefab.android.21:libpng:1.6.37")
}

step4. invoke find_package(PACKAGE-NAME [REQUIRED] CONFIG) command in your Android project's CMakeLists.txt

Every package provides several cmake imported targets:

TARGET-NAME	example	summary
<PACKAGE-NAME>::headers	libpng::headers	C/C++ header files only
<PACKAGE-NAME>::lib*.a	libpng::libpng16.a	static library
<PACKAGE-NAME>::lib*.so	libpng::libpng16.so	shared library
<PACKAGE-NAME>::*	libpng::libpng	base on .pc files

Following is a piece of codes show you how to link libpng.a which is provided by libpng package:

find_package(libpng REQUIRED CONFIG)
target_link_libraries(app libpng::libpng.a)

or

find_package(libpng CONFIG)
if (libpng_FOUND)
    target_link_libraries(app libpng::libpng.a)
endif()

step5. configure C++ standard and STL in build.gradle.kts

android {
    defaultConfig {
        externalNativeBuild {
            cmake {
                arguments += "-DANDROID_STL=c++_shared"
                cppFlags  += "-std=c++17"
            }
        }
    }
}

Note:

• This step is only required for packages that use libc++.
• If you link a shared library that depends on libc++_shared.so, then your Android app should use libc++_shared.so too.

configure with Android Gradle Plugin Groovy DSL

step1. enable prefab feature for Android Gradle Plugin

android {
    buildFeatures {
        prefab true
    }
}

step2. enable this maven repository for Gradle

allprojects {
    repositories {
        maven {
            url 'https://raw.githubusercontent.com/leleliu008/ndk-pkg-prefab-aar-maven-repo/master'
        }
    }
}

中国大陆的用户可使用如下配置：

allprojects {
    repositories {
        maven {
            url 'https://ghproxy.com/https://raw.githubusercontent.com/leleliu008/ndk-pkg-prefab-aar-maven-repo/master'
        }
    }
}

step3. add dependencies in build.gradle

Every package's coordinate for Gradle is com.fpliu.ndk.pkg.prefab.android.21:<PACKAGE-NAME>:<PACKAGE-VERSION>, for example, libpng package has a version 1.6.37, we could use it as follows:

dependencies {
    implementation 'com.fpliu.ndk.pkg.prefab.android.21:libpng:1.6.37'
}

step4. invoke find_package(PACKAGE-NAME [REQUIRED] CONFIG) command in your Android project's CMakeLists.txt

Every package provides several cmake imported targets:

TARGET-NAME	example	summary
<PACKAGE-NAME>::headers	libpng::headers	C/C++ header files only
<PACKAGE-NAME>::lib*.a	libpng::libpng16.a	static library
<PACKAGE-NAME>::lib*.so	libpng::libpng16.so	shared library
<PACKAGE-NAME>::*	libpng::libpng	base on .pc files

Following is a piece of codes show you how to link libpng.a which is provided by libpng package:

find_package(libpng REQUIRED CONFIG)
target_link_libraries(app libpng::libpng.a)

or

find_package(libpng CONFIG)
if (libpng_FOUND)
    target_link_libraries(app libpng::libpng.a)
endif()

step5. configure C++ standard and STL in build.gradle

This step is only required for packages that use libc++.

android {
    defaultConfig {
        externalNativeBuild {
            cmake {
                arguments '-DANDROID_STL=c++_shared'
                cppFlags  '-std=c++17'
            }
        }
    }
}

Note:

• This step is only required for packages that use libc++.
• If you link a shared library that depends on libc++_shared.so, then your Android app should use libc++_shared.so too.

References

• https://google.github.io/prefab/
• https://developer.android.com/studio/projects/android-library#aar-contents
• https://developer.android.com/studio/build/dependencies?agpversion=4.1#using-native-dependencies

Examples

• https://github.com/leleliu008/ndk-pkg-prefab-example-ffmpeg
• https://github.com/leleliu008/ndk-pkg-prefab-example-libphonenumber

Note

Some aar files are very huge (over 100MB), I don't put them into this repo, but published them as GitHub Releases, if you need them, please go to https://github.com/leleliu008/ndk-pkg-prefab-aar-maven-repo/releases to download them then uncompress them to your Maven Local Repository.

More

If you have any advice, please let me know.

I will keep on publishing more packages to this repository.