Android Studio 的 NDK 配置

╰+哭是因爲堅強的太久メ 2023-01-01 14:49 180阅读 0赞

### **文章目录** ###

*   *   *  [I . 源码编译配置][I .]
         *  [II . 构建脚本配置][II .]
         *  [III . NDK 函数库打包配置][III . NDK]
         *  [IV . Java 与 C 代码示例][IV . Java _ C]
         *  [V . CMake 配置 ( CMakeLists.txt )][V . CMake _ _ CMakeLists.txt]
         *  [VI . ndkBuild 配置 ( Android.mk )][VI . ndkBuild _ _ Android.mk]
         *  [VII . 博客相关资源下载][VII .]

**I . 源码编译配置**

--------------------

**1 . 源码编译配置 :**

**① 配置位置 :** Module 级别的 build.gradle 中进行配置 ;

**② 主要作用 :** 主要作用是配置本工程中的 C/C++ 源码如何编译成动态库的 ;

**③ 常用配置 :** 一般配置将源码编译成哪几个 CPU 的指令集 ;

目前只支持 **armeabi-v7a** , **arm64-v8a** , **x86** , **x86-64** 四种 CPU 指令集架构 ;

**2 . 配置层级 :** 在 android 下 defaultConfig 中配置的 externalNativeBuild 是配置 AS 中的 C/C++ 源码编译内容的 ;

**注意区分配置 :** externalNativeBuild 有两种类型的配置 , 一种在 defaultConfig 内部 , 一种在 defaultConfig 外部 ;

**① defaultConfig 内部的 externalNativeBuild :** 配置的是配置 AS 工程的 C/C++ 源文件编译参数

**② defaultConfig 外部的 externalNativeBuild :** 配置的是 CMakeList.txt 或 Android.mk 构建脚本的路径

**2 . 配置脚本示例 ( 省略无关内容 ) :**

**II . 构建脚本配置**

--------------------

**1 . 构建脚本配置 :**

**① 配置位置 :** Module 级别的 build.gradle 中进行配置 ;

**② 主要作用 :** 主要作用是配置本工程中的 C/C++ 源码的构建脚本 ;

**③ 常用配置 :** 配置 cmake 或 ndkBuild 两种编译脚本中的一种 ( 只能二选一 ) ;

**2 . cmake 配置 :** 配置使用 CMake 编译 C/C++ 时的构建脚本 **CMakeList.txt** 路径 ;

**① cmake 简介 :** 使用 CMake 进行构建 , 构建脚本是 CMakeList.txt , 是 Android Studio 中新引入的 NDK 本地代码构建方式 ;

**② 路径设置 :** 路径的起点就是 build.gradle 文件所在的目录 , 即 **app** 目录 ;

**② 配置示例 :**

<code class="language-java"> externalNativeBuild {
 cmake {
 path "src/main/cpp/CMakeLists.txt"
 version "3.10.2"
 }
 </code>

**3 . ndkBuild 配置 :** 配置使用 ndkBuild 编译 C/C++ 时的构建脚本 **Android.mk** 路径 ;

**① ndkBuild 简介 :** 使用 ndkBuild 进行构建 , 构建脚本是 Android.mk , 是从 Eclipse + ADT 环境遗留下来的配置 NDK 编译方案 , 逐步被 CMake 替代 ;

**② 路径设置 :** 路径的起点就是 build.gradle 文件所在的目录 , 即 **app** 目录 ;

**② 配置示例 :**

<code class="language-java"> externalNativeBuild {
 ndkBuild{
 path "src/main/cpp/Android.mk"
 }
 </code>

**3 . 配置层级 :** 在 android 与 defaultConfig 平级的 externalNativeBuild 是配置 AS 中的 C/C++ 源码编译构建脚本的 ;

**注意区分配置 :** externalNativeBuild 有两种类型的配置 , 一种在 defaultConfig 内部 , 一种在 defaultConfig 外部与之平级的配置 ;

**① defaultConfig 内部的 externalNativeBuild :** 配置的是配置 AS 工程的 C/C++ 源文件编译参数

**② defaultConfig 外部的 externalNativeBuild :** 配置的是 CMakeList.txt 或 Android.mk 构建脚本的路径

**4 . 配置脚本示例 ( 省略无关内容 ) :**

**III . NDK 函数库打包配置**

--------------------

**1 . 构建脚本配置 :**

**① 配置位置 :** Module 级别的 build.gradle 中进行配置 ;

**② 主要作用 :** 主要作用是配置 APK 打包动态库的相关参数 ; 如在工程中编译的函数库 , 其提供了 arm, x86, mips 等指令集的动态库 , 那么为了控制打包后的应用大小, 可以选择性打包一些库 , 此处就是进行该配置 ;

**③ 常用配置 :** 配置 cmake 或 ndkBuild 两种编译脚本中的一种 ( 只能二选一 ) ;

**2 . 配置脚本示例 ( 省略无关内容 ) :**

**IV . Java 与 C 代码示例**

--------------------

**1 . Java 代码 :**

<code class="language-java">package kim.hsl.compile;
 
 import androidx.appcompat.app.AppCompatActivity;
 
 import android.os.Bundle;
 import android.widget.TextView;
 
 public class MainActivity extends AppCompatActivity {
 
 static {
 //此处只能加载动态库 , 不能加载静态库
 System.loadLibrary("native-lib");
 }
 
 @Override
 protected void onCreate(Bundle savedInstanceState) {
 super.onCreate(savedInstanceState);
 setContentView(R.layout.activity_main);
 
 TextView tv = findViewById(R.id.sample_text);
 tv.setText(stringFromJNI());
 
 }
 
 public native String stringFromJNI();
 
 }
 
 </code>

**2 . C 代码 :**

<code class="language-c">#include <jni.h>
 #include <android/log.h>
 
 JNIEXPORT jstring JNICALL
 Java_kim_hsl_compile_MainActivity_stringFromJNI(
 JNIEnv *env,
 jobject obj) {
 
 __android_log_print(ANDROID_LOG_INFO, "JNI_TAG", "Hello from C");
 
 return (*env)->NewStringUTF(env, "Hello from C");
 }
 </code>

**V . CMake 配置 ( CMakeLists.txt )**

--------------------

**1 . CMakeLists.txt 配置示例 :**

<code class="language-shell">
 # 声明 CMake 版本
 cmake_minimum_required(VERSION 3.4.1)
 
 # 添加库
 add_library( # Sets the name of the library.
 native-lib
 
 # Sets the library as a shared library.
 SHARED
 
 # Provides a relative path to your source file(s).
 native-lib.c)
 
 
 # 到预设的目录查找 log 库 , 将找到的路径赋值给 log-lib
 # 这个路径是 NDK 的 ndk-bundle\platforms\android-29\arch-arm\usr\lib\liblog.so
 # 不同的 Android 版本号 和 CPU 架构 需要到对应的目录中查找 , 此处是 29 版本 32 位 ARM 架构的日志库
 find_library(
 log-lib
 
 log)
 
 # 链接库
 target_link_libraries(
 native-lib
 
 ${log-lib})
 </code>

**2 . 对应的 build.gradle 中的 NDK 配置 :**

<code class="language-java">apply plugin: 'com.android.application'
 
 android {
 ...
 /*
 关于 CPU 指令集
 
 NDK 17 以上只支持 armeabi-v7a, arm64-v8a, x86, x86-64 四种 CPU 指令集架构
 */
 
 // 配置 AS 工程中的 C/C++ 源文件的编译
 // defaultConfig 内部的 externalNativeBuild 配置的是配置 AS 工程的 C/C++ 源文件编译参数
 // defaultConfig 外部的 externalNativeBuild 配置的是 CMakeList.txt 或 Android.mk 构建脚本的路径
 externalNativeBuild {
 cmake {
 cppFlags ""
 
 //配置编译 C/C++ 源文件为哪几个 CPU 指令集的函数库 (arm , x86 等)
 abiFilters "armeabi-v7a" , "arm64-v8a", "x86", "x86_64"
 }
 }
 
 
 //配置 APK 打包 哪些动态库
 // 示例 : 如在工程中编译的函数库 , 其提供了 arm, x86, mips 等指令集的动态库
 // 那么为了控制打包后的应用大小, 可以选择性打包一些库 , 此处就是进行该配置
 ndk{
 // 打包生成的 APK 文件指挥包含 ARM 指令集的动态库
 abiFilters "armeabi-v7a" , "arm64-v8a", "x86", "x86_64"
 }
 
 
 }
 
 // 配置 NDK 的编译脚本路径
 // 编译脚本有两种 ① CMakeList.txt ② Android.mk
 // defaultConfig 内部的 externalNativeBuild 配置的是配置 AS 工程的 C/C++ 源文件编译参数
 // defaultConfig 外部的 externalNativeBuild 配置的是 CMakeList.txt 或 Android.mk 构建脚本的路径
 externalNativeBuild {
 
 // 配置 CMake 构建脚本 CMakeLists.txt 脚本路径
 // 使用该配置时 , 将 ndkBuild 配置注释掉
 cmake {
 path "src/main/cpp/CMakeLists.txt"
 version "3.10.2"
 }
 
 // 配置 Android.mk 构建脚本路径
 // 使用该配置时 , 将 cmake 配置注释掉
 /*ndkBuild{
 path "src/main/cpp/Android.mk"
 }*/
 }
 	...
 }
 ...
 </code>

**VI . ndkBuild 配置 ( Android.mk )**

--------------------

**1 . Android.mk 配置示例 :**

<code class="language-shell">
 # my-dir 是 NDK 内置的函数 , 获取当前的目录路径
 #	在该案例中就是 Android.mk 文件所在的目录的绝对路径 , 工程根目录/app/src/main/cpp
 #	将该目录赋值给 LOCAL_PATH 变量
 #	所有的 Android.mk 的第一行配置都是该语句
 
 LOCAL_PATH := $(call my-dir)
 
 
 # 打印 LOCAL_PATH 值
 # Build 打印内容 : LOCAL_PATH : Y:/002_WorkSpace/001_AS/005_NDK_Compile/app/src/main/cpp
 # 编译 APK 时会在 Build 中打印
 
 $(info LOCAL_PATH : $(LOCAL_PATH))
 
 
 # 配置新的模块之前都要先清除 LOCAL_XXX 变量
 #	LOCAL_PATH 变量会保留
 
 include $(CLEAR_VARS)
 
 
 # 配置动态库名称
 # 动态库命名规则 : 在 LOCAL_MODULE 基础上 , 添加 lib 前缀 和 .so 后缀
 # 生成动态库名称 : libnative-lib.so
 
 LOCAL_MODULE := native-lib
 
 
 # 编译的源文件
 
 LOCAL_SRC_FILES := native-lib.c
 
 
 # 配置构建的目标是动态库
 
 include $(BUILD_SHARED_LIBRARY)
 </code>

**2 . 对应的 build.gradle 中的 NDK 配置 :**

<code class="language-java">apply plugin: 'com.android.application'
 
 android {
 ...
 /*
 关于 CPU 指令集
 
 NDK 17 以上只支持 armeabi-v7a, arm64-v8a, x86, x86-64 四种 CPU 指令集架构
 */
 
 // 配置 AS 工程中的 C/C++ 源文件的编译
 // defaultConfig 内部的 externalNativeBuild 配置的是配置 AS 工程的 C/C++ 源文件编译参数
 // defaultConfig 外部的 externalNativeBuild 配置的是 CMakeList.txt 或 Android.mk 构建脚本的路径
 externalNativeBuild {
 cmake {
 cppFlags ""
 
 //配置编译 C/C++ 源文件为哪几个 CPU 指令集的函数库 (arm , x86 等)
 abiFilters "armeabi-v7a" , "arm64-v8a", "x86", "x86_64"
 }
 }
 
 
 //配置 APK 打包 哪些动态库
 // 示例 : 如在工程中编译的函数库 , 其提供了 arm, x86, mips 等指令集的动态库
 // 那么为了控制打包后的应用大小, 可以选择性打包一些库 , 此处就是进行该配置
 ndk{
 // 打包生成的 APK 文件指挥包含 ARM 指令集的动态库
 abiFilters "armeabi-v7a" , "arm64-v8a", "x86", "x86_64"
 }
 
 
 }
 
 // 配置 NDK 的编译脚本路径
 // 编译脚本有两种 ① CMakeList.txt ② Android.mk
 // defaultConfig 内部的 externalNativeBuild 配置的是配置 AS 工程的 C/C++ 源文件编译参数
 // defaultConfig 外部的 externalNativeBuild 配置的是 CMakeList.txt 或 Android.mk 构建脚本的路径
 externalNativeBuild {
 
 // 配置 CMake 构建脚本 CMakeLists.txt 脚本路径
 // 使用该配置时 , 将 ndkBuild 配置注释掉
 /*cmake {
 path "src/main/cpp/CMakeLists.txt"
 version "3.10.2"
 }*/
 
 // 配置 Android.mk 构建脚本路径
 // 使用该配置时 , 将 cmake 配置注释掉
 ndkBuild{
 path "src/main/cpp/Android.mk"
 }
 }
 	...
 }
 ...</code>

[I .]: https://blog.csdn.net/shulianghan/article/details/104272170?utm_medium=distribute.pc_relevant.none-task-blog-baidujs_baidulandingword-2&spm=1001.2101.3001.4242#I___6
[II .]: https://blog.csdn.net/shulianghan/article/details/104272170?utm_medium=distribute.pc_relevant.none-task-blog-baidujs_baidulandingword-2&spm=1001.2101.3001.4242#II___79
[III . NDK]: https://blog.csdn.net/shulianghan/article/details/104272170?utm_medium=distribute.pc_relevant.none-task-blog-baidujs_baidulandingword-2&spm=1001.2101.3001.4242#III__NDK__194
[IV . Java _ C]: https://blog.csdn.net/shulianghan/article/details/104272170?utm_medium=distribute.pc_relevant.none-task-blog-baidujs_baidulandingword-2&spm=1001.2101.3001.4242#IV__Java__C__243
[V . CMake _ _ CMakeLists.txt]: https://blog.csdn.net/shulianghan/article/details/104272170?utm_medium=distribute.pc_relevant.none-task-blog-baidujs_baidulandingword-2&spm=1001.2101.3001.4242#V__CMake___CMakeListstxt__308
[VI . ndkBuild _ _ Android.mk]: https://blog.csdn.net/shulianghan/article/details/104272170?utm_medium=distribute.pc_relevant.none-task-blog-baidujs_baidulandingword-2&spm=1001.2101.3001.4242#VI__ndkBuild___Androidmk__414
[VII .]: https://blog.csdn.net/shulianghan/article/details/104272170?utm_medium=distribute.pc_relevant.none-task-blog-baidujs_baidulandingword-2&spm=1001.2101.3001.4242#VII___530