ExternalNativeBuildOptions

@Incubating interface ExternalNativeBuildOptions


DSL object for per-variant CMake and ndk-build configurations, such as toolchain arguments and compiler flags.

android {
// Similar to other properties in the defaultConfig block, you can override
// these properties for each product flavor you configure.
defaultConfig {
// This block is different from the one you use to link Gradle
// to your CMake or ndk-build script.
externalNativeBuild {
// For ndk-build, instead use the ndkBuild block.
cmake {
// Passes optional arguments to CMake.
arguments "-DANDROID_ARM_NEON=TRUE", "-DANDROID_TOOLCHAIN=clang"

// Sets a flag to enable format macro constants for the C compiler.
cFlags "-D__STDC_FORMAT_MACROS"

// Sets optional flags for the C++ compiler.
cppFlags "-fexceptions", "-frtti"

// Specifies the library and executable targets from your CMake project
// that Gradle should build.
targets "libexample-one", "my-executible-demo"
}
}
}
}

To enable external native builds and set the path to your CMake or ndk-build script, use android.externalNativeBuild.

Summary

Public functions

Unit

Encapsulates per-variant CMake configurations, such as compiler flags and toolchain arguments.

Unit

Encapsulates per-variant ndk-build configurations, such as compiler flags and toolchain arguments.

Public properties

ExternalNativeCmakeOptions

Encapsulates per-variant CMake configurations, such as compiler flags and toolchain arguments.

MutableMap<String, Any>

Additional per-variant experimental properties for C and C++.

ExternalNativeNdkBuildOptions

Encapsulates per-variant ndk-build configurations, such as compiler flags and toolchain arguments.

Public functions

cmake

fun cmake(action: @ExtensionFunctionType ExternalNativeCmakeOptions.() -> Unit): Unit

Encapsulates per-variant CMake configurations, such as compiler flags and toolchain arguments.

To enable external native builds and set the path to your CMakeLists.txt script, use android.externalNativeBuild.cmake.path.

ndkBuild

fun ndkBuild(action: @ExtensionFunctionType ExternalNativeNdkBuildOptions.() -> Unit): Unit

Encapsulates per-variant ndk-build configurations, such as compiler flags and toolchain arguments.

To enable external native builds and set the path to your Android.mk script, use android.externalNativeBuild.ndkBuild.path.

Public properties

cmake

val cmake: ExternalNativeCmakeOptions

Encapsulates per-variant CMake configurations, such as compiler flags and toolchain arguments.

To enable external native builds and set the path to your CMakeLists.txt script, use android.externalNativeBuild.cmake.path.

experimentalProperties

val experimentalProperties: MutableMap<String, Any>

Additional per-variant experimental properties for C and C++.

ndkBuild

val ndkBuild: ExternalNativeNdkBuildOptions

Encapsulates per-variant ndk-build configurations, such as compiler flags and toolchain arguments.

To enable external native builds and set the path to your Android.mk script, use android.externalNativeBuild.ndkBuild.path.