Android Cocos2d-x 環境搭建報錯 UnsatisfiedLinkError：NDK 配置與 so 庫加載排查

錯誤核心

java.lang.UnsatisfiedLinkError: Couldn't load hellocpp ... findLibrary returned null

表示 Java 層 System.loadLibrary("hellocpp") 找不到對應的 libhellocpp.so。

排查清單

1. NDK 版本匹配：Cocos2d-x 版本對應特定 NDK 版本（如 v3.x 需 NDK r10-r16），過高版本默認禁用 GCC 工具鏈導致編譯失敗。
2. Application.mk 設置：

   APP_ABI := armeabi-v7a
   APP_STL := c++_static
   APP_CPPFLAGS := -frtti -fexceptions
   

3. Android.mk 包含所有源文件：確保 LOCAL_SRC_FILES 包含 hellocpp/main.cpp 及 Classes 目錄下所有 .cpp。
4. gradle.properties / build.gradle：配置 android.ndkVersion、externalNativeBuild 指向 CMakeLists.txt 或 Android.mk。
5. 打包檢查：解壓生成的 APK，查看 lib/armeabi-v7a/ 下是否存在 libhellocpp.so、libcocos2dcpp.so。

快速修復參考

參考教程：Cocos2d-x Android 環境配置三步走，核心在於 NDK 路徑、ABI、STL 三項設置正確。