【Android NDK 开发】Android.mk 配置静态库 ( Android Studio 配置静态库 | 配置动态库与静态库区别 | 动态库与静态库打包对比 )
文章目錄
- I . Android Studio 中使用 Android.mk 配置靜態(tài)庫 總結
- II . 第三方動態(tài)庫來源
- III . 配置 Android.mk 構建腳本路徑
- IV . 預編譯 第三方 靜態(tài)庫 ( Android.mk )
- V . 鏈接靜態(tài)庫 ( 設置靜態(tài)庫依賴 )
- VI . Java 代碼定義 native 方法并加載動態(tài)庫
- VII . C 代碼調(diào)用動態(tài)庫函數(shù)
- VIII . 動態(tài)庫 與 靜態(tài)庫 打包對比
- IX . 配置動態(tài)庫與靜態(tài)庫區(qū)別
- X . 完整代碼示例
- 1 . build.gradle 配置示例
- 2 . Android.mk 配置示例
- 3 . Java 代碼示例
- 4 . C 代碼示例
- 5 . 運行結果 ( Android 7.0 手機 )
- XI . 博客資源
I . Android Studio 中使用 Android.mk 配置靜態(tài)庫 總結
Android Studio 中使用 Android.mk 配置第三方 靜態(tài)庫 :
① Android.mk 腳本路徑設置 : 在 Module 級別的 build.gradle 腳本中配置 Android.mk 構建腳本的路徑 ;
externalNativeBuild {ndkBuild{path "src/main/ndkBuild_Static/Android.mk"}}② 預編譯第三方動態(tài)庫 : 在 Android.mk 中預編譯動態(tài)庫 , 注意動態(tài)庫與靜態(tài)庫使用的配置不同 , 這里以靜態(tài)庫舉例 :
include $(CLEAR_VARS) LOCAL_MODULE := add LOCAL_SRC_FILES := libadd.a include $(PREBUILT_STATIC_LIBRARY)③ 鏈接動態(tài)庫 : 在 Android.mk 中預鏈接動態(tài)庫或靜態(tài)庫 , 注意動態(tài)庫與靜態(tài)庫使用的配置不同 , 這里以靜態(tài)庫舉例 :
LOCAL_STATIC_LIBRARIES := add④ Java 代碼實現(xiàn) : 聲明 native 方法 , 加載編譯的動態(tài)庫 ; ( 雖然引入了第三方靜態(tài)庫 , 但是 Android 最終將該靜態(tài)庫打包到動態(tài)庫中使用 )
⑤ C 代碼實現(xiàn) : 聲明函數(shù)庫中的函數(shù) , 調(diào)用靜態(tài)庫中的函數(shù) ;
II . 第三方動態(tài)庫來源
1 . 第三方動態(tài)庫源碼 : add.c ;
#include <stdio.h>int add(int a, int b){return a + b; }2 . Ubuntu 交叉編譯過程 : 參考 【Android NDK 開發(fā)】Ubuntu 函數(shù)庫交叉編譯 ( Android 動態(tài)庫交叉編譯 | Android 靜態(tài)庫交叉編譯 ) , 最終編譯出 libadd.so 動態(tài)庫 , 和 libadd.a 靜態(tài)庫 ;
III . 配置 Android.mk 構建腳本路徑
1 . 源碼 編譯 / 打包 配置 原理 : 【Android NDK 開發(fā)】Android Studio 的 NDK 配置 ( 源碼編譯配置 | 構建腳本配置 | 打包配置 | CMake 配置 | ndkBuild 配置 ) : I . 源碼編譯配置
2 . 構建腳本路徑配置 原理 : 【Android NDK 開發(fā)】Android Studio 的 NDK 配置 ( 源碼編譯配置 | 構建腳本配置 | 打包配置 | CMake 配置 | ndkBuild 配置 ) : II . 構建腳本配置
3 . 這里直接設置 Android.mk 構建腳本路徑 : 省略無關配置 , 只保留 NDK 相關配置 ;
apply plugin: 'com.android.application'android {...defaultConfig {...// 配置 AS 工程中的 C/C++ 源文件的編譯// defaultConfig 內(nèi)部的 externalNativeBuild 配置的是配置 AS 工程的 C/C++ 源文件編譯參數(shù)// defaultConfig 外部的 externalNativeBuild 配置的是 CMakeList.txt 或 Android1.mk 構建腳本的路徑externalNativeBuild {/*cmake {cppFlags ""//配置編譯 C/C++ 源文件為哪幾個 CPU 指令集的函數(shù)庫 (arm , x86 等)abiFilters "armeabi-v7a"}*/ndkBuild{abiFilters "armeabi-v7a" /*, "arm64-v8a", "x86", "x86_64"*/}}//配置 APK 打包 哪些動態(tài)庫// 示例 : 如在工程中集成了第三方庫 , 其提供了 arm, x86, mips 等指令集的動態(tài)庫// 那么為了控制打包后的應用大小, 可以選擇性打包一些庫 , 此處就是進行該配置ndk{// 打包生成的 APK 文件指揮包含 ARM 指令集的動態(tài)庫abiFilters "armeabi-v7a" /*, "arm64-v8a", "x86", "x86_64"*/}}// 配置 NDK 的編譯腳本路徑// 編譯腳本有兩種 ① CMakeList.txt ② Android1.mk// defaultConfig 內(nèi)部的 externalNativeBuild 配置的是配置 AS 工程的 C/C++ 源文件編譯參數(shù)// 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 . 預編譯 第三方 靜態(tài)庫 ( Android.mk )
1 . 清除變量 : ( add 模塊配置開始 )
① 作用 : 配置新的模塊之前都要先清除 LOCAL_XXX 變量 ;
② 例外情況 : 有一個例外 , 就是不會清除 LOCAL_PATH 變量 ;
③ 模塊開始標識 : include $(CLEAR_VARS) , 一般作為一個模塊配置的起始標志 ;
④ 模塊結尾 : include $(XXX_STATIC_LIBRARY) / include $(XXX_SHARED_LIBRARY) 一般作為模塊配置結束標志 ;
include $(CLEAR_VARS)2 . 配置靜態(tài)庫名稱 :
① 自動生成函數(shù)庫名稱前提 : 沒有 LOCAL_MODULE_FILENAME 配置 , 就會自動生成函數(shù)庫名稱 ;
② 靜態(tài)庫命名規(guī)則 : 在 LOCAL_MODULE 名稱基礎上 , 添加 lib 前綴 ( 如果前面有 lib 前綴不再添加 ) 和 .a 后綴 ;
③ 生成動態(tài)庫名稱 : libadd.a ;
LOCAL_MODULE := add3 . 設置預編譯的靜態(tài)庫路徑 :
LOCAL_SRC_FILES := libadd.a4 . 設置預編譯靜態(tài)庫 : ( add 模塊配置結束 )
include $(BUILD_SHARED_LIBRARY)5 . 完整的第三方靜態(tài)庫預編譯模塊配置 :
# II . 預編譯第三方靜態(tài)庫# 1 . 清除變量 ( add 模塊配置開始 ) # ① 作用 : 配置新的模塊之前都要先清除 LOCAL_XXX 變量 # ② 例外情況 : 但是不會清除 LOCAL_PATH 變量 # ③ 模塊開始 : include $(CLEAR_VARS) # ④ 模塊結尾 : include $(XXX_STATIC_LIBRARY) / include $(XXX_SHARED_LIBRARY) include $(CLEAR_VARS)# 2 . 配置動態(tài)庫名稱 # ① 自動生成函數(shù)庫名稱前提 : 沒有 LOCAL_MODULE_FILENAME 配置 , 就會自動生成函數(shù)庫名稱 # ② 動態(tài)庫命名規(guī)則 : 在 LOCAL_MODULE 名稱基礎上 , 添加 lib 前綴 ( 如果前面有 lib 前綴不再添加 ) 和 .a 后綴 # ③ 生成動態(tài)庫名稱 : libadd.a LOCAL_MODULE := add# 3 . 預編譯的動態(tài)庫路徑 LOCAL_SRC_FILES := libadd.a# 4 . 設置預編譯動態(tài)庫 ( add 模塊配置結束 ) include $(PREBUILT_STATIC_LIBRARY)V . 鏈接靜態(tài)庫 ( 設置靜態(tài)庫依賴 )
設置靜態(tài)依賴庫 :
① 依賴庫 : 編譯 native-lib 模塊 , 需要鏈接 add 靜態(tài)庫 ;
② add 動態(tài)庫 : add 模塊是一個預編譯庫 , 預編譯內(nèi)容是引入的第三方動態(tài)庫 ;
# 4 . 設置靜態(tài)依賴庫 # ① 依賴庫 : 編譯 native-lib 模塊 , 需要鏈接 add 靜態(tài)庫 # ② add 靜態(tài)庫 : add 模塊是一個預編譯庫 , 預編譯內(nèi)容是引入的第三方靜態(tài)庫 LOCAL_STATIC_LIBRARIES := add # IV . 配置動態(tài)庫模塊# 1 . 清除變量 ( native-lib 模塊配置開始 ) # ① 作用 : 配置新的模塊之前都要先清除 LOCAL_XXX 變量 # ② 例外情況 : 但是不會清除 LOCAL_PATH 變量 include $(CLEAR_VARS)# 2 . 配置動態(tài)庫名稱 # ① 自動生成函數(shù)庫名稱前提 : 沒有 LOCAL_MODULE_FILENAME 配置 , 就會自動生成函數(shù)庫名稱 # ② 動態(tài)庫命名規(guī)則 : 在 LOCAL_MODULE 名稱基礎上 , 添加 lib 前綴 和 .so 后綴 # ③ 生成動態(tài)庫名稱 : libnative-lib.so LOCAL_MODULE := native-lib# 3 . 編譯的源文件 LOCAL_SRC_FILES := native-lib.c# 4 . 設置靜態(tài)依賴庫 # ① 依賴庫 : 編譯 native-lib 模塊 , 需要鏈接 add 靜態(tài)庫 # ② add 靜態(tài)庫 : add 模塊是一個預編譯庫 , 預編譯內(nèi)容是引入的第三方靜態(tài)庫 LOCAL_STATIC_LIBRARIES := add# 5 . 鏈接日志庫 LOCAL_LDLIBS := -llog# 6 . 設置預編譯動態(tài)庫 ( native-lib 模塊配置結束 ) include $(BUILD_SHARED_LIBRARY)VI . Java 代碼定義 native 方法并加載動態(tài)庫
VII . C 代碼調(diào)用動態(tài)庫函數(shù)
VIII . 動態(tài)庫 與 靜態(tài)庫 打包對比
動態(tài)庫打包策略 : 使用動態(tài)庫 , 打包時會將所有的動態(tài)庫打包入 APK 文件中 ,
靜態(tài)庫打包策略 : 靜態(tài)庫只將使用到的靜態(tài)庫打包入 APK 中 , 生成的庫比較小 ;
IX . 配置動態(tài)庫與靜態(tài)庫區(qū)別
1 . 預編譯時的路徑不一致 :
① 動態(tài)庫路徑 : libadd.so
② 靜態(tài)庫路徑 : libadd.a
2 . 預編譯時結束配置不一致 :
① 動態(tài)庫配置 : include $(PREBUILT_SHARED_LIBRARY)
② 靜態(tài)庫配置 : include $(PREBUILT_STATIC_LIBRARY)
3 . 鏈接依賴庫時配置不一致 :
① 動態(tài)庫依賴配置 : LOCAL_SHARED_LIBRARIES
② 靜態(tài)庫依賴配置 : LOCAL_STATIC_LIBRARIES
X . 完整代碼示例
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 內(nèi)部的 externalNativeBuild 配置的是配置 AS 工程的 C/C++ 源文件編譯參數(shù)// defaultConfig 外部的 externalNativeBuild 配置的是 CMakeList.txt 或 Android1.mk 構建腳本的路徑externalNativeBuild {/*cmake {cppFlags ""//配置編譯 C/C++ 源文件為哪幾個 CPU 指令集的函數(shù)庫 (arm , x86 等)abiFilters "armeabi-v7a"}*/ndkBuild{abiFilters "armeabi-v7a" /*, "arm64-v8a", "x86", "x86_64"*/}}//配置 APK 打包 哪些動態(tài)庫// 示例 : 如在工程中集成了第三方庫 , 其提供了 arm, x86, mips 等指令集的動態(tài)庫// 那么為了控制打包后的應用大小, 可以選擇性打包一些庫 , 此處就是進行該配置ndk{// 打包生成的 APK 文件指揮包含 ARM 指令集的動態(tài)庫abiFilters "armeabi-v7a" /*, "arm64-v8a", "x86", "x86_64"*/}}// 配置 NDK 的編譯腳本路徑// 編譯腳本有兩種 ① CMakeList.txt ② Android1.mk// defaultConfig 內(nèi)部的 externalNativeBuild 配置的是配置 AS 工程的 C/C++ 源文件編譯參數(shù)// 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 變量# ① 內(nèi)置函數(shù) : my-dir 是 NDK 內(nèi)置的函數(shù) , 獲取當前的目錄路徑 # 在該案例中就是 Android.mk 文件所在的目錄的絕對路徑 , 工程根目錄/app/src/main/cpp # 將該目錄賦值給 LOCAL_PATH 變量 # 所有的 Android1.mk 的第一行配置都是該語句LOCAL_PATH := $(call my-dir)# II . 預編譯第三方靜態(tài)庫# 1 . 清除變量 ( add 模塊配置開始 ) # ① 作用 : 配置新的模塊之前都要先清除 LOCAL_XXX 變量 # ② 例外情況 : 但是不會清除 LOCAL_PATH 變量 # ③ 模塊開始 : include $(CLEAR_VARS) # ④ 模塊結尾 : include $(XXX_STATIC_LIBRARY) / include $(XXX_SHARED_LIBRARY) include $(CLEAR_VARS)# 2 . 配置動態(tài)庫名稱 # ① 自動生成函數(shù)庫名稱前提 : 沒有 LOCAL_MODULE_FILENAME 配置 , 就會自動生成函數(shù)庫名稱 # ② 動態(tài)庫命名規(guī)則 : 在 LOCAL_MODULE 名稱基礎上 , 添加 lib 前綴 ( 如果前面有 lib 前綴不再添加 ) 和 .a 后綴 # ③ 生成動態(tài)庫名稱 : libadd.a LOCAL_MODULE := add# 3 . 預編譯的動態(tài)庫路徑 LOCAL_SRC_FILES := libadd.a# 4 . 設置預編譯動態(tài)庫 ( add 模塊配置結束 ) include $(PREBUILT_STATIC_LIBRARY)# III . 打印變量值# 打印 LOCAL_PATH 值 # Build 打印內(nèi)容 : LOCAL_PATH : Y:/002_WorkSpace/001_AS/005_NDK_Compile/app/src/main/cpp # 編譯 APK 時會在 Build 中打印 $(info LOCAL_PATH : $(LOCAL_PATH))# IV . 配置動態(tài)庫模塊# 1 . 清除變量 ( native-lib 模塊配置開始 ) # ① 作用 : 配置新的模塊之前都要先清除 LOCAL_XXX 變量 # ② 例外情況 : 但是不會清除 LOCAL_PATH 變量 include $(CLEAR_VARS)# 2 . 配置動態(tài)庫名稱 # ① 自動生成函數(shù)庫名稱前提 : 沒有 LOCAL_MODULE_FILENAME 配置 , 就會自動生成函數(shù)庫名稱 # ② 動態(tài)庫命名規(guī)則 : 在 LOCAL_MODULE 名稱基礎上 , 添加 lib 前綴 和 .so 后綴 # ③ 生成動態(tài)庫名稱 : libnative-lib.so LOCAL_MODULE := native-lib# 3 . 編譯的源文件 LOCAL_SRC_FILES := native-lib.c# 4 . 設置靜態(tài)依賴庫 # ① 依賴庫 : 編譯 native-lib 模塊 , 需要鏈接 add 靜態(tài)庫 # ② add 靜態(tài)庫 : add 模塊是一個預編譯庫 , 預編譯內(nèi)容是引入的第三方動態(tài)庫 LOCAL_STATIC_LIBRARIES := add# 5 . 鏈接日志庫 LOCAL_LDLIBS := -llog# 6 . 設置預編譯動態(tài)庫 ( native-lib 模塊配置結束 ) include $(BUILD_SHARED_LIBRARY)# V . 配置動態(tài)庫與靜態(tài)庫區(qū)別# 1 . 預編譯時的路徑不一致 : # ① 動態(tài)庫路徑 : libadd.so # ② 靜態(tài)庫路徑 : libadd.a# 2 . 預編譯時結束配置不一致 : # ① 動態(tài)庫配置 : include $(PREBUILT_SHARED_LIBRARY) # ② 靜態(tài)庫配置 : include $(PREBUILT_STATIC_LIBRARY)# 3 . 鏈接依賴庫時配置不一致 : # ① 動態(tài)庫依賴配置 : LOCAL_SHARED_LIBRARIES # ② 靜態(tài)庫依賴配置 : 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 . 加載動態(tài)庫的情況 : ( 必須不能注釋下面的代碼 )// ① 6.0 以下的版本 : 需要手動加載依賴庫 libadd.so// ② 6.0 以上的版本 : 無法使用 Android.mk 構建腳本加載第三方動態(tài)庫// 此情況下, 無論是否手動加載 libadd.so 都會報錯//// 2 . 加載靜態(tài)庫的情況 : ( 必須注釋掉下面的這行代碼 )//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>//調(diào)用 libadd.so 動態(tài)庫中的方法 extern int add(int a, int b);JNIEXPORT jstring JNICALL Java_kim_hsl_mk_MainActivity_stringFromJNI(JNIEnv *env,jobject obj) {//調(diào)用動態(tài)庫中的函數(shù)int sum = add(1, 2);// Logcat 打印計算結果__android_log_print(ANDROID_LOG_INFO, "JNI_TAG", "Native Caculate : %d + %d = %d", 1, 2, sum);//將加法運算轉(zhuǎn)為字符串char str[50] = "0";//字符串格式化sprintf(str, "Native Caculate : Static Library : %d + %d = %d", 1, 2, sum);return (*env)->NewStringUTF(env, str); }
5 . 運行結果 ( Android 7.0 手機 )
XI . 博客資源
CSDN 博客地址 : 【Android NDK 開發(fā)】Android.mk 配置靜態(tài)庫 ( Android Studio 配置靜態(tài)庫 | 配置動態(tài)庫與靜態(tài)庫區(qū)別 | 動態(tài)庫與靜態(tài)庫打包對比 )
博客資源下載地址 : https://download.csdn.net/download/han1202012/12157595
示例代碼 GitHub 地址 : https://github.com/han1202012/007_NDK_Android_mk_Static
總結
以上是生活随笔為你收集整理的【Android NDK 开发】Android.mk 配置静态库 ( Android Studio 配置静态库 | 配置动态库与静态库区别 | 动态库与静态库打包对比 )的全部內(nèi)容,希望文章能夠幫你解決所遇到的問題。
- 上一篇: 【Android NDK 开发】Andr
- 下一篇: 【Android NDK 开发】Andr