【Android NDK 开发】Android.mk 配置动态库 ( Android Studio 配置动态库 | 动态库加载版本限制

文章目录

I . Android Studio 中使用 Android.mk 配置动态库总结
II . 第三方动态库来源
III . 配置 Android.mk 构建脚本路径
IV . 预编译第三方动态库 ( Android.mk )
V . 链接动态库 ( 设置动态库依赖 )
VI . Java 代码定义 native 方法并加载动态库
VII . C 代码调用动态库函数
VIII . 动态库加载版本限制 ( 6.0 以上不能使用 Android.mk 配置动态库 )
IX . 完整代码示例
- 1 . build.gradle 配置示例
- 2 . Android.mk 配置示例
- 3 . Java 代码示例
- 4 . C 代码示例
- 5 . 运行结果 ( Android 4.3 手机 | 6.0 以上系统无法运行 )
X . 博客资源

I . Android Studio 中使用 Android.mk 配置动态库总结

Android Studio 中使用 Android.mk 配置第三方动态库 :

① Android.mk 脚本路径设置 : 在 Module 级别的 build.gradle 脚本中配置 Android.mk 构建脚本的路径 ;

    externalNativeBuild {ndkBuild{path "src/main/ndkBuild_Shared/Android.mk"}}

② 预编译第三方动态库 : 在 Android.mk 中预编译动态库 , 注意动态库与静态库使用的配置不同 , 这里以动态库举例 :

include $(CLEAR_VARS)
LOCAL_MODULE := add
LOCAL_SRC_FILES := libadd.so
include $(PREBUILT_SHARED_LIBRARY)

③ 链接动态库 : 在 Android.mk 中预链接动态库或静态库 , 注意动态库与静态库使用的配置不同 , 这里以动态库举例 :

LOCAL_SHARED_LIBRARIES := add

④ Java 代码实现 : 声明 native 方法 , 加载编译的动态库 ;

⑤ C 代码实现 : 声明函数库中的函数 , 调用动态库中的函数 ;

II . 第三方动态库来源

1 . 第三方动态库源码 : add.c ;

#include <stdio.h>int add(int a, int b){return a + b;
}

2 . Ubuntu 交叉编译过程 : 参考【Android NDK 开发】Ubuntu 函数库交叉编译 ( Android 动态库交叉编译 | Android 静态库交叉编译 ) , 最终编译出 libadd.so 动态库 , 和 libadd.a 静态库 ;

III . 配置 Android.mk 构建脚本路径

1 . 源码编译 / 打包配置原理 : 【Android NDK 开发】Android Studio 的 NDK 配置 ( 源码编译配置 | 构建脚本配置 | 打包配置 | CMake 配置 | ndkBuild 配置 ) : I . 源码编译配置

2 . 构建脚本路径配置原理 : 【Android NDK 开发】Android Studio 的 NDK 配置 ( 源码编译配置 | 构建脚本配置 | 打包配置 | CMake 配置 | ndkBuild 配置 ) : II . 构建脚本配置

3 . 这里直接设置 Android.mk 构建脚本路径 : 省略无关配置 , 只保留 NDK 相关配置 ;

apply plugin: 'com.android.application'android {...defaultConfig {...// 配置 AS 工程中的 C/C++ 源文件的编译//     defaultConfig 内部的 externalNativeBuild 配置的是配置 AS 工程的 C/C++ 源文件编译参数//     defaultConfig 外部的 externalNativeBuild 配置的是 CMakeList.txt 或 Android1.mk 构建脚本的路径externalNativeBuild {/*cmake {cppFlags ""//配置编译 C/C++ 源文件为哪几个 CPU 指令集的函数库 (arm , x86 等)abiFilters "armeabi-v7a"}*/ndkBuild{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 ② Android1.mk//     defaultConfig 内部的 externalNativeBuild 配置的是配置 AS 工程的 C/C++ 源文件编译参数//     defaultConfig 外部的 externalNativeBuild 配置的是 CMakeList.txt 或 Android1.mk 构建脚本的路径externalNativeBuild {// 配置 CMake 构建脚本 CMakeLists.txt 脚本路径/*cmake {path "src/main/cpp/CMakeLists.txt"version "3.10.2"}*/// 配置 Android1.mk 构建脚本路径ndkBuild{path "src/main/ndkBuild_Shared/Android.mk"//path "src/main/ndkBuild_Static/Android.mk"}}...
}
...

IV . 预编译第三方动态库 ( Android.mk )

1 . 清除变量 : ( add 模块配置开始 )

① 作用 : 配置新的模块之前都要先清除 LOCAL_XXX 变量 ;

② 例外情况 : 有一个例外 , 就是不会清除 LOCAL_PATH 变量 ;

③ 模块开始标识 : include $(CLEAR_VARS) , 一般作为一个模块配置的起始标志 ;

④ 模块结尾 : include $(XXX_STATIC_LIBRARY) / include $(XXX_SHARED_LIBRARY) 一般作为模块配置结束标志 ;

include $(CLEAR_VARS)

2 . 配置动态库名称 :

① 自动生成函数库名称前提 : 没有 LOCAL_MODULE_FILENAME 配置 , 就会自动生成函数库名称 ;

② 动态库命名规则 : 在 LOCAL_MODULE 名称基础上 , 添加 lib 前缀 ( 如果前面有 lib 前缀不再添加 ) 和 .so 后缀 ;

③ 生成动态库名称 : libadd.so ;

LOCAL_MODULE := add

3 . 设置预编译的动态库路径 :

LOCAL_SRC_FILES := libadd.so

4 . 设置预编译动态库 : ( add 模块配置结束 )

include $(PREBUILT_SHARED_LIBRARY)

5 . 完整的第三方动态库预编译模块配置 :

# II . 预编译第三方动态库# 1 . 清除变量 ( add 模块配置开始 )
#   ① 作用 : 配置新的模块之前都要先清除 LOCAL_XXX 变量
#   ② 例外情况 : 但是不会清除 LOCAL_PATH 变量
#   ③ 模块开始 : include $(CLEAR_VARS)
#   ④ 模块结尾 : include $(XXX_STATIC_LIBRARY) / include $(XXX_SHARED_LIBRARY)
include $(CLEAR_VARS)# 2 . 配置动态库名称
#   ① 自动生成函数库名称前提 : 没有 LOCAL_MODULE_FILENAME 配置 , 就会自动生成函数库名称
#   ② 动态库命名规则 : 在 LOCAL_MODULE 名称基础上 , 添加 lib 前缀和 .so 后缀
#   ③ 生成动态库名称 : libadd.so
LOCAL_MODULE := add# 3 . 预编译的动态库路径
LOCAL_SRC_FILES := libadd.so# 4 . 设置预编译动态库 ( add 模块配置结束 )
include $(PREBUILT_SHARED_LIBRARY)

V . 链接动态库 ( 设置动态库依赖 )

设置动态依赖库 :

① 依赖库 : 编译 native-lib 模块 , 需要链接 add 静态库 ;

② add 动态库 : add 模块是一个预编译库 , 预编译内容是引入的第三方动态库 ;

LOCAL_SHARED_LIBRARIES := add

# IV . 配置动态库模块# 1 . 清除变量 ( native-lib 模块配置开始 )
#   ① 作用 : 配置新的模块之前都要先清除 LOCAL_XXX 变量
#   ② 例外情况 : 但是不会清除 LOCAL_PATH 变量
include $(CLEAR_VARS)# 2 . 配置动态库名称
#   ① 自动生成函数库名称前提 : 没有 LOCAL_MODULE_FILENAME 配置 , 就会自动生成函数库名称
#   ② 动态库命名规则 : 在 LOCAL_MODULE 名称基础上 , 添加 lib 前缀 和 .so 后缀
#   ③ 生成动态库名称 : libnative-lib.so
LOCAL_MODULE := native-lib# 3 . 编译的源文件
LOCAL_SRC_FILES := native-lib.c# 4 . 设置动态依赖库
#   ① 依赖库 : 编译 native-lib 模块 , 需要链接 add 动态库
#   ② add 动态库 : add 模块是一个预编译库 , 预编译内容是引入的第三方动态库
LOCAL_SHARED_LIBRARIES := add# 5 . 链接日志库
LOCAL_LDLIBS := -llog# 6 . 设置预编译动态库 ( native-lib 模块配置结束 )
include $(BUILD_SHARED_LIBRARY)

VI . Java 代码定义 native 方法并加载动态库

1 . 声明并使用 native 方法 :

public native String stringFromJNI();

2 . 加载动态库 : 这里要加载两个动态库 ;

        System.loadLibrary("add");System.loadLibrary("native-lib");

VII . C 代码调用动态库函数

1 . 声明动态库外部方法 :

//声明 libadd.so 动态库中的方法
extern int add(int a, int b);

2 . 调用动态库的方法 :

//调用动态库中的函数
int sum = add(1, 2);

VIII . 动态库加载版本限制 ( 6.0 以上不能使用 Android.mk 配置动态库 )

1 . 问题描述 :

6.0 版本开始 , 使用 Android.mk 构建脚本预编译第三方的动态库 , 如果程序中使用 System.loadLibrary 加载该预编译库 , 就会报错 ;

6.0 以下的手机版本 ( 不包括 6.0 版本 ) , System.loadLibrary 需要手动加载依赖的动态库 ;

6.0 及以上的手机版本 , System.loadLibrary 会自动加载依赖的动态库 , 此时不能加载依赖的动态库 , 否则会出错 ;

2 . 报错信息 : 6.0 以上的手机不能使用 Android.mk 加载动态库 , 一旦加载崩溃 ; 报以下错误 ;

2020-02-13 01:58:38.044 23033-23033/kim.hsl.mk E/AndroidRuntime: FATAL EXCEPTION: mainProcess: kim.hsl.mk, PID: 23033java.lang.UnsatisfiedLinkError: dlopen failed: library "Y:/002_WorkSpace/001_AS/006_NDK_Android_mk/app/build/intermediates/ndkBuild/debug/obj/local/armeabi-v7a/libadd.so" not foundat java.lang.Runtime.loadLibrary0(Runtime.java:977)at java.lang.System.loadLibrary(System.java:1567)at kim.hsl.mk.MainActivity.<clinit>(MainActivity.java:19)...

3 . 解决方案 : 6.0 以上的手机 , 只能使用 CMake 配置动态库 , 或者使用静态库 ;

4 . CMake 配置方案参考 : 【Android NDK 开发】NDK 交叉编译 ( Ubuntu 中交叉编译动态库 | Android Studio 中配置使用第三方动态库 )

IX . 完整代码示例

1 . build.gradle 配置示例

apply plugin: 'com.android.application'android {compileSdkVersion 29buildToolsVersion "29.0.0"defaultConfig {applicationId "kim.hsl.mk"minSdkVersion 15targetSdkVersion 29versionCode 1versionName "1.0"testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"// 配置 AS 工程中的 C/C++ 源文件的编译//     defaultConfig 内部的 externalNativeBuild 配置的是配置 AS 工程的 C/C++ 源文件编译参数//     defaultConfig 外部的 externalNativeBuild 配置的是 CMakeList.txt 或 Android1.mk 构建脚本的路径externalNativeBuild {/*cmake {cppFlags ""//配置编译 C/C++ 源文件为哪几个 CPU 指令集的函数库 (arm , x86 等)abiFilters "armeabi-v7a"}*/ndkBuild{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 ② Android1.mk//     defaultConfig 内部的 externalNativeBuild 配置的是配置 AS 工程的 C/C++ 源文件编译参数//     defaultConfig 外部的 externalNativeBuild 配置的是 CMakeList.txt 或 Android1.mk 构建脚本的路径externalNativeBuild {// 配置 CMake 构建脚本 CMakeLists.txt 脚本路径/*cmake {path "src/main/cpp/CMakeLists.txt"version "3.10.2"}*/// 配置 Android1.mk 构建脚本路径ndkBuild{path "src/main/ndkBuild_Shared/Android.mk"//path "src/main/ndkBuild_Static/Android.mk"}}buildTypes {release {minifyEnabled falseproguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'}}
}dependencies {implementation fileTree(dir: 'libs', include: ['*.jar'])implementation 'androidx.appcompat:appcompat:1.1.0'implementation 'androidx.constraintlayout:constraintlayout:1.1.3'testImplementation 'junit:junit:4.12'androidTestImplementation 'androidx.test:runner:1.2.0'androidTestImplementation 'androidx.test.espresso:espresso-core:3.2.0'
}

2 . Android.mk 配置示例

# I . 保存构建脚本的路径 , 并赋值给 LOCAL_PATH 变量#   ① 内置函数 : my-dir 是 NDK 内置的函数 , 获取当前的目录路径
#   在该案例中就是 Android.mk 文件所在的目录的绝对路径 , 工程根目录/app/src/main/cpp
#   将该目录赋值给 LOCAL_PATH 变量
#   所有的 Android1.mk 的第一行配置都是该语句LOCAL_PATH := $(call my-dir)# II . 预编译第三方动态库# 1 . 清除变量 ( add 模块配置开始 )
#   ① 作用 : 配置新的模块之前都要先清除 LOCAL_XXX 变量
#   ② 例外情况 : 但是不会清除 LOCAL_PATH 变量
#   ③ 模块开始 : include $(CLEAR_VARS)
#   ④ 模块结尾 : include $(XXX_STATIC_LIBRARY) / include $(XXX_SHARED_LIBRARY)
include $(CLEAR_VARS)# 2 . 配置动态库名称
#   ① 自动生成函数库名称前提 : 没有 LOCAL_MODULE_FILENAME 配置 , 就会自动生成函数库名称
#   ② 动态库命名规则 : 在 LOCAL_MODULE 名称基础上 , 添加 lib 前缀 和 .so 后缀
#   ③ 生成动态库名称 : libadd.so
LOCAL_MODULE := add# 3 . 预编译的动态库路径
LOCAL_SRC_FILES := libadd.so# 4 . 设置预编译动态库 ( add 模块配置结束 )
include $(PREBUILT_SHARED_LIBRARY)# III . 打印变量值# 打印 LOCAL_PATH 值
# Build 打印内容 : LOCAL_PATH : Y:/002_WorkSpace/001_AS/005_NDK_Compile/app/src/main/cpp
# 编译 APK 时会在 Build 中打印
$(info LOCAL_PATH : $(LOCAL_PATH))# IV . 配置动态库模块# 1 . 清除变量 ( native-lib 模块配置开始 )
#   ① 作用 : 配置新的模块之前都要先清除 LOCAL_XXX 变量
#   ② 例外情况 : 但是不会清除 LOCAL_PATH 变量
include $(CLEAR_VARS)# 2 . 配置动态库名称
#   ① 自动生成函数库名称前提 : 没有 LOCAL_MODULE_FILENAME 配置 , 就会自动生成函数库名称
#   ② 动态库命名规则 : 在 LOCAL_MODULE 名称基础上 , 添加 lib 前缀 和 .so 后缀
#   ③ 生成动态库名称 : libnative-lib.so
LOCAL_MODULE := native-lib# 3 . 编译的源文件
LOCAL_SRC_FILES := native-lib.c# 4 . 设置静态依赖库
#   ① 依赖库 : 编译 native-lib 模块 , 需要链接 add 静态库
#   ② add 静态库 : add 模块是一个预编译库 , 预编译内容是引入的第三方动态库
LOCAL_SHARED_LIBRARIES := add# 5 . 链接日志库
LOCAL_LDLIBS := -llog# 6 . 设置预编译动态库 ( native-lib 模块配置结束 )
include $(BUILD_SHARED_LIBRARY)# V . 配置动态库与静态库区别#   1 . 预编译时的路径不一致 :
#       ① 动态库路径 : libadd.so
#       ② 静态库路径 : libadd.a# 2 . 预编译时结束配置不一致 :
#       ① 动态库配置 : include $(PREBUILT_SHARED_LIBRARY)
#       ② 静态库配置 : include $(PREBUILT_STATIC_LIBRARY)#   3 . 链接依赖库时配置不一致 :
#       ① 动态库依赖配置 : LOCAL_SHARED_LIBRARIES
#       ② 静态库依赖配置 : LOCAL_STATIC_LIBRARIES

3 . Java 代码示例

package kim.hsl.mk;import androidx.appcompat.app.AppCompatActivity;import android.os.Bundle;
import android.widget.TextView;public class MainActivity extends AppCompatActivity {static {// 1 . 加载动态库的情况 : ( 必须不能注释下面的代码 )//      ① 6.0 以下的版本 : 需要手动加载依赖库 libadd.so//      ② 6.0 以上的版本 : 无法使用 Android.mk 构建脚本加载第三方动态库//                         此情况下, 无论是否手动加载 libadd.so 都会报错//// 2 . 加载静态库的情况 : ( 必须注释掉下面的这行代码 )System.loadLibrary("add");System.loadLibrary("native-lib");}@Overrideprotected 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();
}

4 . C 代码示例

#include <jni.h>#include <stdio.h>
#include <stdlib.h>#include <android/log.h>//调用 libadd.so 动态库中的方法
extern int add(int a, int b);JNIEXPORT jstring JNICALL
Java_kim_hsl_mk_MainActivity_stringFromJNI(JNIEnv *env,jobject obj) {//调用动态库中的函数int sum = add(1, 2);// Logcat 打印计算结果__android_log_print(ANDROID_LOG_INFO, "JNI_TAG", "Native Caculate : %d + %d = %d", 1, 2, sum);//将加法运算转为字符串char str[50] = "0";//字符串格式化sprintf(str, "Native Caculate : Static Library : %d + %d = %d", 1, 2, sum);return (*env)->NewStringUTF(env, str);
}

5 . 运行结果 ( Android 4.3 手机 | 6.0 以上系统无法运行 )

X . 博客资源

CSDN 博客地址 : 【Android NDK 开发】Android.mk 配置动态库 ( Android Studio 配置动态库 | 动态库加载版本限制 | 本章仅做参考推荐使用 CMake 配置动态库 )

博客资源下载地址 : https://download.csdn.net/download/han1202012/12157107

示例代码 GitHub 地址 : https://github.com/han1202012/006_NDK_Android_mk