在 Eclipse 中導出簽名 Release APK 時常遇到兩個阻礙:Lint MissingTranslation 致命錯誤 與 Keystore 憑證資訊中逗號導致 keytool 失敗。本文提供具體解決步驟與原理說明。
問題一:Lint MissingTranslation 導致導出失敗
錯誤訊息
Lint Error Checking: MissingTranslation
Fatal: "app_name" is not translated in "af" (Afrikaans), "am" (Amharic), "ar" (Arabic)...
Run full error check when exporting app
原因
專案依賴 appcompat_v7 等庫,其 strings.xml 定義大量語言翻譯,導出時 Lint 檢測主專案缺少對應翻譯,預設等級為 Fatal 阻止導出。
解決方案:降低 Lint 等級 (不關閉全部檢查)
- Eclipse 選單:Window → Preferences (Mac: Eclipse → Preferences)。
- 導航:Android → Lint Error Checking。
- 搜尋 MissingTranslation。
- 將 Severity 從
Fatal 改為 Warning 或 Ignore。
- Apply and Close。
優點: 保留其他 Lint 檢查 (如 UnusedResource, HardcodedText 等),僅放寬翻譯檢查。
問題二:Keystore 憑證資訊含逗號導致 keytool 錯誤
錯誤訊息
keytool error: java.io.IOException: Incorrect AVA format
原因
在產生 Keystore 時,「City or Locality」 (城市/地區) 欄位若填入 Beijing, China 或 GuangXi, China 等含逗號的值,keytool 解析 DN (Distinguished Name) 時會將逗號視為分隔符,導致格式錯誤。
解決方案
- 重新建立 Keystore。
- 在「City or Locality」欄位不要使用逗號,改用空格或分號:
✅ GuangXi China / GuangXi; China
❌ GuangXi, China
- 其他可能觸發特殊字符的欄位 (Organization Unit, Organization 等) 同理避免:
, + " \ < > ;。
特殊字符轉義對照 (若必須使用)
| 字符 | 轉義寫法 |
| , (逗號) | \, |
| + (加號) | \+ |
| " (雙引號) | \" |
| \ (反斜線) | \\ |
| < (小於) | \< |
| > (大於) | \> |
| ; (分號) | \; |
替代方案:命令列 keytool + jarsigner (支援逗號)
# 1. 產生 Keystore (支援逗號,需轉義)
keytool -genkeypair -v -keystore my-release-key.jks -keyalg RSA -keysize 2048 -validity 10000 \
-alias my_alias \
-dname "CN=My Name, OU=My Unit, O=My Org, L=GuangXi\, China, ST=GuangXi, C=CN" \
-storepass password -keypass password
# 2. 簽名 APK
jarsigner -verbose -sigalg SHA256withRSA -digestalg SHA-256 \
-keystore my-release-key.jks unsigned.apk my_alias
# 3. 優化對齊
zipalign -v 4 signed.apk aligned.apk
現代建議:遷移至 Android Studio + Gradle
- Eclipse ADT 已停止維護 (2015 年底)。
- Gradle 簽名配置在
build.gradle 中集中管理,支援多渠道、多簽名配置。
signingConfigs { release { storeFile file("key.jks") storePassword "..." keyAlias "..." keyPassword "..." } }
copyright ©
萬盛學電腦網 all rights reserved