1 概念

ndk-build 本質上是一個腳本，它的位置就在 NDK 目錄的最上層，即在< NDK >/ndk-build 路徑下，運行 ndk-build 腳本相當于運行以下命令：

$GNUMAKE -f <ndk>/build/core/build-local.mk
<parameters>

$GNUMAKE 指向 GNU Make 3.81 或更高版本， 則指向 NDK 安裝目錄，

官方檔案鏈接

2 組成

ndk-build 腳本使用 NDK 的基于 Make 的構建系統構建專案，使用 ndk-build我們需要兩個組態檔: Android.mk 和 Application.mk，

2.1 Android.mk

Android.mk 更像是一個傳統的 makefile，定義源代碼、包含頭檔案的路徑、聯結器的路徑來定位庫、模塊名、構建型別等等，

• LOCAL_PATH :=$(call my-dir)
  回傳當前檔案在系統中路徑，Android.mk 檔案開始時必須定義該變數，
• include $(CLEAR_VARS)
  表明清楚上一次構建程序的所有全域變數，因為在一個 Makefile 編譯腳本中，會使用大量的全域變數，使用這行腳本表明需要清除掉所有的全域變數，
• LOCAL_SRC_FILES
  要編譯的 C 或者 CPP 的檔案，注意這里不需要列舉頭檔案，構建系統會自動幫組開發者依賴這些檔案，
• LOCAL_LDLIBS:=-L$ (SYSROOT)/usr/lib -llog -lOPENSLES -lGLESv2 -lEGL -lz
  指定編譯程序所依賴的 NDK 提供的動態和靜態庫，SYSROOT變數代表的是 NDK_ROOT 下面的目錄 $NDK_ROOT/platforms/android-18/arch-arm，而在這個目錄的 usr/lib/ 目錄下有很多對應的 .so 的動態庫以及 .a 的靜態庫，
• LOCAL_CFLAGS
  編譯 C 或者 CPP 的編譯標志，在實際編譯的時候會發送給編譯器，比如常用的實體是加上 -DAUTO_TEST , 然后在代碼中就可以利用條件判斷 #ifdef AUTO_TEST 來做一些與自動化測驗相關的事情，
• LOCAL_LDFLAGS
  鏈接標志的可選串列，當對目標檔案進行鏈接以生成輸出檔案的時候，將這些標志帶給聯結器，該指令與 LOCAL_LDLIBS 有些類似，一般情況下，該選項會用于指定第三方編譯的靜態庫，LOCAL_LDLIBS 經常用于指定系統的庫(比如 log、OpenGLES、OpenSLES 等)，
• LOCAL_MODULE
  該模塊的編譯的目標名，用于區分各個模塊，名字必須是唯一并不包含空格的，如果編譯目標是 so 庫，那么該 so 庫的名稱就是 lib 專案名 .so，
• include $(BUILD_SHARED_LIBRARY)
  其實類似的 include 還有很多，都是構建系統提供的內置變數，該變數的意義是構建動態庫，其他的內置變數還包括如下幾種，
  • BUILD_STATIC_LIBRARY: 構建靜態庫
  • PREBUILT_STATIC_LIBRARY: 對已有的靜態庫進行包裝，使其成為一個模塊，
  • PREBUILT_SHARED_LIBRARY: 對已有的靜態庫進行包裝，使其成為一個模塊，
  • BUILD_EXECUTABLE: 構建可執行檔案，

官方檔案鏈接

2.2 Application.mk

Application.mk 定義了 Android 應用程式相關的屬性，如 Android SDK 版本、除錯或發布模式、目標平臺 ABI (架構二進制介面)、標準 c/c++ 庫等，

• APP_ABI := XXX，這里的 XXX 是指不同平臺，可以選填的有 x86 、X86_64 、armeabi-v8a、armeabi-v7a、all 等，值得一提的是，若選擇 all 則會構建構建出所有平臺的 so，如果不填寫該項，那么將默認構建為 armeabi 平臺下的庫，
• APP_STL := gnustl_static，NDK 構建系統提供了由 Android 系統給出的最小 C++ 運行時庫 （system/lib/libstdc++.so）的 C++ 頭檔案，
• APP_CPPFLAGS :=-std=gnu++11 -fexceptions，指定編譯程序的 flag ,可以在該選項中開啟 exception rtti 等特性，但是為了效率考慮，最好關閉 rtti，
• NDK_TOOLCHAIN_VERSION = 4.8，指定交叉工具編譯鏈里面的版本號，這里指定使用 4.8，
• APP_PLATFORM :=android-21，指定創建的動態庫的平臺
• APP_OPTIM := release，該變數是可選的，用來定義 “release” 或者 “debug” ，“release” 模式是默認的，并且會生成高度優化的二進制代碼；“debug” 模式生成的是未優化的二進制代碼，但是可以檢測出很多的 BUG，經常用于除錯階段，也相當于在 ndk-build 指令后邊直接加上引數 NDK_DEBUG=1，

官方檔案鏈接

3 ndk-build 轉換為 CMake

在Android Studio 2.2 之后，工具中增加了 CMake 的支持，所以在 Android Studio 2.2 之后有2種方式來編譯 c/c++ 代碼，

• 一種是 ndk-build + Android.mk + Application.mk 的方式
• 另一種是 CMake + CMakeLists.txt 的方式
  這兩種方式與 Android 代碼和 c/c++ 代碼無關，只是不同的構建腳本和構建命令，

如果非必須，不推薦使用 ndk-build 來構建，因為這樣構建原始碼后，是無法使用方法跳轉、方法提示等功能的！如果要改代碼，就等于文本編輯器寫代碼，相反 CMake 是支持這些的，因此更有助于提高開發效率，所以這里就不詳細說明 ndk-build 的使用步驟了，如果是新建專案就使用 CMake，如果是使用 ndk-build 的老專案，可以按照以下步驟轉為 CMake，

3.1 操作步驟

軟體環境：
Android Studio：3.6.3
JDK：1.8
NDK：21.2.6472646

3.1.1 修改 module 下的 build.gradle

android {
    defaultConfig {
        externalNativeBuild {
            cmake {
                cppFlags "-std=c++11 -stdlib=libc++ -fPIC -w"
                arguments "-DANDROID_TOOLCHAIN=clang", "-DANDROID_STL=c++_shared", "-DANDROID_ARM_MODE=arm", "-DANDROID_ARM_NEON=TRUE", "-DANDROID_PLATFORM=android-21"
            }
            ndk {
                abiFilters 'armeabi-v7a'
            }
        }
    }

    externalNativeBuild {
        cmake {
            path "src/main/jni/CMakeLists.txt"
            version "3.10.2"
        }
    }
}

Application.mk中的 APP_PLATFORM 對應 arguments 中的 -DANDROID_PLATFORM；
Application.mk中的 APP_STL 對應 arguments 中的 -DANDROID_STL；
Application.mk中的 APP_ABI 對應 這里的 abiFilters；
Android.mk 中的 LOCAL_ARM_MODE 對應 arguments 中的 -DANDROID_ARM_MODE；
Android.mk 中的 LOCAL_ARM_NEON 對應 arguments 中的 -DANDROID_ARM_NEON，

3.1.2 新建 CMakeLists.txt

相關配置對應關系如下：

配置完成后，Android.mk 和 Application.mk 就不需要了，

3.2 常見問題及解決方案

（1）CMake Error: CMake was unable to find a build program corresponding to “Ninja”. CMAKE_MAKE_PROGRAM is not set. You probably need to select a different build tool.

編譯時報錯，修改工程的 build.gradle 的 com.android.tools.build:gradle 為更高版本，

（2）java.lang.UnsatisfiedLinkError: dlopen failed: library “xxxx.so” not found

運行時報錯，這是由于 so 庫并沒有打包進 apk，所以找不到，

在 Android Studio 中，會默認匹配 src/main/jniLibs 目錄，如果沒有目錄需要自己手動創建，如果想要使用其他路徑的庫，需要手動指定，
在 module 的 build.gradle 中添加：

sourceSets {
    main {
        jniLibs.srcDirs = ['libs'] //這里的ibs替換為存放so庫的檔案夾，不能在jni檔案夾下
    }
}

建議全部放在 jniLibs，不需要額外的任何配置，
通常我們把第三方提供的 h 檔案夾，放在 src/main/cpp/include 里面，so 庫放在 src/main/jniLibs/armeabi-v7a（不同 CPU 架構不同目錄）下，