Cocos2d-x 3.7 在 Windows 7 打包 APK 完整教學與常見錯誤排除

環境配置檢查清單

1. JDK：1.8 版本，設定 JAVA_HOME、PATH。
2. Android SDK：安裝 API Level 19+、Build Tools、Platform Tools，設定 ANDROID_HOME。
3. Android NDK：r10e 或 r16b（Cocos2d-x 3.7 建議 r10e），設定 NDK_ROOT，路徑不能包含中文或空格。
4. Apache Ant：1.9+，設定 ANT_HOME。
5. Python：2.7 版本（Cocos2d-x 3.x 需 Python 2），設定 PATH。
6. Cocos2d-x 3.7：解壓至無中文路徑，執行 setup.py 設定環境變數。

常見打包錯誤與對策

打包指令

cd proj.android
./build_native.py   # 編譯原生庫
ant debug           # 產生 debug APK
# 或
ant release         # 產生 release APK（需簽名配置）

替代方案：使用 CMake + Gradle（Cocos2d-x 3.17+）

若專案可升級，建議遷移至 CMake + Gradle 建置系統，支援 Android Studio，除錯更容易。