Cocos2d-x 3.6 移植 Android 常見錯誤：NDK 版本與 minSdkVersion 不匹配解決方案

將 Cocos2d-x 3.6 專案移植至 Android 時，若編譯報錯或執行崩潰，多半是 NDK 編譯目標版本與 Manifest 宣告的 minSdkVersion 不一致 導致。

錯誤現象

• NDK 設定編譯目標為 android-17 (Android 4.2)
• AndroidManifest.xml 卻設定 minSdkVersion=9 (Android 2.3)
• 導致連結器找不到對應 API，或執行時 ClassNotFoundException。

解決步驟

1. 打開 proj.android/jni/Application.mk，確認 APP_PLATFORM := android-17（或專案需求版本）。
2. 打開 proj.android/AndroidManifest.xml，將 <uses-sdk android:minSdkVersion="9" /> 修改為 17 或更高，與 NDK 目標一致。
3. 同步修改 proj.android/project.properties 中的 target=android-17。
4. 清理專案：ndk-build clean → ndk-build → Eclipse/Studio 重新建置。

版本對照表（常用）

補充建議

• 若需支援舊版 Android，請降低 NDK 的 APP_PLATFORM 而非提高 Manifest 版本。
• 使用 CMake 建置（Cocos2d-x 3.10+）可在 CMakeLists.txt 統一管理 ANDROID_PLATFORM。
• 參考官方遷移指南：Cocos2d-x Android 移植文件