萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> 程式語言綜合

Eclipse ADT 導出簽名 APK 兩大經典坑:Lint 翻譯檢查與 Keystore 逗號轉義完美解決

背景:Eclipse ADT 時代的簽名痛點

雖然 Google 已停止更新 ADT,但大量存量 Android 專案仍在 Eclipse 中維護。導出簽名 APK 時,最常卡住開發者的兩個問題是:**Lint 強制要求所有語言翻譯**與 **Keystore 證書信息中逗號導致 AVA 格式錯誤**。本文提供最小侵入性修復方案,並給出遷移至 Gradle 現代構建的長期建議。

問題一:MissingTranslation 導致 Lint Fatal Error 阻斷導出

現象

  1. 右鍵專案 → Android Tools → Export Signed Application Package...
  2. 彈出「Lint has found fatal errors」對話框,錯誤列表顯示:MissingTranslation — app_name 缺少 af、am、ar、bg、bn-rBD… 數十種語言翻譯。

根因

  • ADT 默認啟用 Run full error check when exporting app。
  • 專案依賴 appcompat_v7 庫,其 strings.xml 定義了大量語言資源,Lint 推斷主專案也必須提供同等覆蓋。
  • 實際業務多僅需中英文,逐條翻譯成本極高且無必要。

解決方案(推薦:降級嚴重級別)

  1. 打開 Window → Preferences → Android → Lint Error Checking。
  2. 搜索 MissingTranslation,將 Severity 從 Fatal 改為 Warning 或 Ignore。
  3. Apply → OK,重新導出即可通過。

優勢:保留其他 Lint 檢查(硬編碼字符串、未使用資源等),僅放寬翻譯強制要求。

替代方案:專案級 lint.xml 配置

<?xml version="1.0" encoding="UTF-8"?>
<lint>
    <issue id="MissingTranslation" severity="ignore" />
</lint>

放在專案根目錄,團隊共享配置,避免每人手動改 Preferences。

問題二:Keystore 證書信息中逗號觸發「Incorrect AVA format」

現象

  1. 新建 Keystore → 輸入密碼 → 填寫證書信息。
  2. City or Locality (城市/地區) 欄位按習慣填 GuangXi, China(含逗號)。
  3. 點擊下一步報錯:keytool error: java.io.IOException: Incorrect AVA format。

根因

  • Eclipse 內部調用 keytool -genkeypair 生成 X.500 Distinguished Name (DN)。
  • DN 字段按 RFC 4514 規範,**逗號 , 為字段分隔符**(如 CN=..., OU=..., O=..., L=..., ST=..., C=...)。
  • 值中若包含逗號、加號 +、引號 "、斜槓 \、尖括號 <>、分號 ; 等特殊字符,會被誤判為字段分隔,導致解析失敗。

解決方案

  1. 最簡單:City 欄位填 GuangXi China(去掉逗號),其餘字段同理避開特殊字符。
  2. 命令行生成 Keystore 後導入(完美支持特殊字符,推薦團隊統一管理):
    keytool -genkeypair -alias mykey -keyalg RSA -keysize 2048 \
      -validity 10000 -keystore my-release-key.jks \
      -dname "CN=My App, OU=Dev, O=MyCompany, L=GuangXi\, China, ST=GuangDong, C=CN" \
      -storepass storepass -keypass keypass
    
    注意:DN 字符串中逗號需用反斜槓轉義 \,。生成後在 Eclipse 選擇 Use existing keystore 選中該文件即可。

特殊字符轉義速查表 (keytool DN)

字符轉義寫法示例
, (逗號)\,L=GuangXi\, China
+ (加號)\+OU=R\+D
" (雙引號)\"CN="My App"
\ (反斜槓)\\O=My\\Company
< (小於)\<CN=Test\<1\>
> (大於)\>同上
; (分號)\;O=A\;B

進階:Eclipse 之外的現代簽名流程 (Gradle + Apksigner)

Google 官方已推薦 Apksigner (Android 7.0+) 替代 jarsigner,支持 v2/v3/v4 簽名方案,提升安裝速度與安全性。Gradle 簽名配置範例:

android {
    signingConfigs {
        release {
            storeFile file("my-release-key.jks")
            storePassword "storepass"
            keyAlias "mykey"
            keyPassword "keypass"
        }
    }
    buildTypes {
        release {
            signingConfig signingConfigs.release
            minifyEnabled true
            proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
        }
    }
}

配合 ./gradlew assembleRelease 一鍵產出簽名並混淆的 AAB/APK,**徹底告別 Eclipse 時代的手動點擊痛苦**。

總結

  • Lint 翻譯錯誤 → Preferences 或 lint.xml 降級 MissingTranslation 為 Warning/Ignore。
  • Keystore 逗號錯誤 → 字段值避開逗號等特殊字符,或改用命令行 keytool 生成後導入(支持轉義)。
  • 長期策略:遷移至 Android Studio + Gradle,享受自動化構建、混淆、簽名一體化流程,並獲得 Instant Run、Jetpack Compose、Kotlin 等現代開發紅利。
copyright © 萬盛學電腦網 all rights reserved