Contents

Phonegap 編譯APK錯誤訊息

問題描述

使用 phonegap build android 編譯 APK 時,出現以下錯誤:

1
2
The SDK Build Tools revision (19.0.3) is too low for project 'Testing'.
Minimum required is 19.1.0

Phonegap 要求 Android SDK 19,但機器上安裝的 SDK Build-tools 版本是 19.0.3,版本不符導致編譯失敗。

解決方法

開啟 SDK Manager.exe,在 Tools 資料夾中找到 Android SDK Build-tools (Rev. 19.1),勾選後安裝,重新編譯即可。

Android SDK 版本管理概念

Android SDK 由多個獨立元件組成,各元件版本可分別管理:

元件 說明
Android SDK Platform 對應 Android API 版本的 SDK(如 API 19 = Android 4.4)
Android SDK Build-tools 編譯工具,包含 aaptdxzipalign
Android SDK Platform-tools adbfastboot 等偵錯工具
Android SDK Tools SDK Manager 本身及模擬器等基礎工具

Build-tools 版本需符合專案設定的最低要求,且同一台機器可以安裝多個版本共存。

使用 SDK Manager 管理版本

圖形介面(SDK Manager.exe):

  1. 開啟 %ANDROID_HOME%\SDK Manager.exe
  2. 展開 Tools 節點
  3. 勾選需要的 Android SDK Build-tools 版本
  4. 點選「Install packages…」安裝

命令列方式(sdkmanager):

1
2
3
4
5
6
7
8
# 列出所有可安裝的套件
sdkmanager --list

# 安裝指定版本的 Build-tools
sdkmanager "build-tools;19.1.0"

# 更新所有已安裝元件
sdkmanager --update

常見版本相容性問題排查

  1. 確認專案要求的版本:查看 project.propertiesbuild.gradle 中的 buildToolsVersion
  2. 版本不存在:確認 SDK Manager 中有該版本可供下載。
  3. 多版本衝突:若有多個版本,Gradle 會使用 build.gradle 中指定的版本。
  4. PATH 設定:確保 ANDROID_HOME 環境變數正確指向 SDK 目錄。
1
2
3
4
5
# 確認環境變數
echo %ANDROID_HOME%

# 確認 Build-tools 是否正確安裝
ls %ANDROID_HOME%\build-tools\