原文地址:http://www.bubuko.com/infodetail-2043502.html
CMake的
在这个页面
使用过Android Studio 2.2及更高版本,可以使用NDK和CMake的 编译C和C ++代码到本机库。Android Studio中,然后构建系统使用Gradle把library打包到APK中
如果您是初次使用CMake的与Android Studio ,去C和C ++代码添加到您的项目学习添加原生资源到项目的基础,创造了CMake的构建脚本,并添加您的CMake项目作为一个gradle依赖。此页面为您提供可以使用自定义您的CMake构建一些额外的信息。
了解CMake的生成命令
当调试CMake的构建问题,它有助于知道对于Android Studio使用特定生成的参数当用交叉编译。
Android Studio中保存它使用用于执行CMake的构建,构建参数在cmake_build_command.txt
文件。对于每一个应用程序二进制接口(ABI)您的应用程序的目标,每个构建类型为那些ABI的(即,释放或调试),Android Studio中生成的副本cmake_build_command.txt
用于特定的配置文件。Android Studio中,然后将其生成在以下目录中的文件:
<project-root>/<module-root>/.externalNativeBuild/cmake/<build-type>/<ABI>/
提示:在Android Studio中,您可以快速通过使用搜索快捷键(查看这些文件shift+shift
),并进入 cmake_build_command.txt在输入字段。
下面的代码段示出的参数的CMake一个例子来构建的可调试释放hello-jni
样品靶向armeabi-v7a
架构。
Executable : /usr/local/google/home/{$USER}/Android/Sdk/cmake/3.6.3155560/bin/cmake arguments : -H/usr/local/google/home/{$USER}/Dev/github-projects/googlesamples/android-ndk/hello-jni/app/src/main/cpp -B/usr/local/google/home/{$USER}/Dev/github-projects/googlesamples/android-ndk/hello-jni/app/.externalNativeBuild/cmake/arm7Debug/armeabi-v7a -GAndroid Gradle - Ninja -DANDROID_ABI=armeabi-v7a -DANDROID_NDK=/usr/local/google/home/{$USER}/Android/Sdk/ndk-bundle -DCMAKE_LIBRARY_OUTPUT_DIRECTORY=/usr/local/google/home/{$USER}/Dev/github-projects/googlesamples/android-ndk/hello-jni/app/build/intermediates/cmake/arm7/debug/obj/armeabi-v7a -DCMAKE_BUILD_TYPE=Debug -DCMAKE_MAKE_PROGRAM=/usr/local/google/home/{$USER}/Android/Sdk/cmake/3.6.3155560/bin/ninja -DCMAKE_TOOLCHAIN_FILE=/usr/local/google/home/{$USER}/Android/Sdk/ndk-bundle/build/cmake/android.toolchain.cmake -DANDROID_NATIVE_API_LEVEL=23 -DANDROID_TOOLCHAIN=clang jvmArgs : Build arg
构建参数
下表突出重点CMake的构建参数为Android。对于您可以设定标准构建参数列表cmake
命令行可执行文件,看CMake的手册。
构建参数 | 描述 |
-G <build-system> | 构建类型文件的CMake生成。 对于Android Studio中使用本地代码项目, 如果 |
-DANDROID_ABI <abi> | 目标ABI。 NDK的支持一组的ABI的,如描述ABI管理。此选项类似于 默认情况下,gradle构建你的本地库为单独 如果没有指定的目标ABI,CMake的默认使用 有效的目标名称是:
|
-DANDROID_NDK <path> | 绝对路径到你的主机上安装NDK的根目录。 |
-DCMAKE_LIBRARY_OUTPUT_DIRECTORY <path> | 位置主机CMake的地方放上 LIBRARY 的目标文件时所建。 |
-DCMAKE_BUILD_TYPE <type> | 类似于构建类型的NDK-nuild 工具。有效值为Release 和Debug 。为了简化调试,CMake的不带的Release或Debug版本作为构建的一部分。然而,gradle当它们打包在APK条二进制文件。 |
-DCMAKE_MAKE_PROGRAM <program-name> | 工具来启动本地构建系统。您可以设置值是可执行文件或工具名称的完整路径,如果它在PATH 。对于交叉编译采用Android Studio中,这个值被设置为CMake的 ninja 与Android SDK捆绑发生器。 |
-DCMAKE_TOOLCHAIN_FILE <path> | 路径android.toolchain.cmake 是CMake的使用进行交叉编译的Android文件。通常情况下,该文件位于 $NDK/build/cmake/ 目录中,其中$NDK 是你的主机上的NDK安装目录。有关工具链文件的详细信息,请参阅交叉编译的Android。 |
-DANDROID_NATIVE_API_LEVEL <level> | 这CMake的编译为Android API级别。 |
-DANDROID_TOOLCHAIN <type> | 该CMake的使用编译器工具链。有效值为 clang (默认)和gcc (不推荐)。 |
在摇篮使用cmake变量
一旦你g到您的CMake的项目,您可以配置更改的CMake构建您的本机库的方式一定NDK特定的变量。若要从模块级的参数传递给CMake的build.gradle
文件中,使用下面的DSL:
android { ... 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 ndkBuild {} cmake { // Passes optional arguments to CMake. arguments "-DANDROID_ARM_NEON=TRUE", "-DANDROID_TOOLCHAIN=clang" // Sets optional flags for the C compiler. cFlags "-D_EXAMPLE_C_FLAG1", "-D_EXAMPLE_C_FLAG2" // Sets a flag to enable format macro constants for the C++ compiler. cppFlags "-D__STDC_FORMAT_MACROS" } } } buildTypes {...} productFlavors { ... demo { ... externalNativeBuild { cmake { ... // Specifies which native libraries to build and package for this // product flavor. If you don‘t configure this property, Gradle // builds and packages all shared object libraries that you define // in your CMake or ndk-build project. targets "native-lib-demo" } } } paid { ... externalNativeBuild { cmake { ... targets "native-lib-paid" } } } } // Use this block to link Gradle to your CMake or ndk-build script. externalNativeBuild { cmake {...} // or ndkBuild {...} } }
下表描述了一些你可以使用CMake的与NDK时配置变量。
变量名 | 参数 | 描述 |
---|---|---|
ANDROID_TOOLCHAIN |
| 指定编译器工具链的CMake应该使用。 |
ANDROID_PLATFORM | 有关平台名称和相应的Android系统映像的完整列表,请参阅的Android NDK Native API解决方案。 | 指定目标Android平台的名称。例如,
|
ANDROID_STL | 有关选项的完整列表,请助手运行时 默认情况下,CMake的使用 | 指定STL的CMake应该使用。 |
ANDROID_PIE |
| 指定是否使用与位置无关的可执行文件(PIE)。Android的动态链接器支持在Android 4.1(API级别16)和较高的PIE。 |
ANDROID_CPP_FEATURES | 这个变量默认为空。然而,以下是你可以传递参数的几个例子:
| 指定某些C ++功能CMake的需要编译你的本地库,如RTTI(运行时类型信息)和C ++异常时使用。 |
ANDROID_ALLOW_UNDEFINED_SYMBOLS |
| 指定是否如果CMake的遇到不确定的参考,同时建立你的本地库抛出一个未定义的符号错误。要禁用这些类型的错误,把这个变量设为 |
ANDROID_ARM_MODE |
| 指定是否生成在ARM目标二进制文件 |
ANDROID_ARM_NEON |
| 指定的CMake是否应该建立自己的与NEON支持本机库。 |
ANDROID_DISABLE_NO_EXECUTE |
| 指定是否启用NXbit,或不能执行,安全功能。要禁用此功能,通过 |
ANDROID_DISABLE_RELRO |
| 指定是否启用只读搬迁。 |
ANDROID_DISABLE_FORMAT_STRING_CHECKS |
| 指定是否编译格式字符串保护你的源代码。当启用时,如果一个非恒定的格式字符串在所使用的编译器会引发错误 |
报告问题
如果碰上的是不是由于cmake的开源版本的任何问题,通过报告这些android-ndk/ndk
GitHub上的问题跟踪器。
原文
https://developer.android.com/ndk/guides/cmake.html#variables