萬盛學電腦網

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

Eclipse 導出簽名 APK 避坑指南:Lint 錯誤與 Keystore 逗號陷阱完美解決

背景:為什麼 Release 簽名總報錯?

從 Eclipse 導出簽名 APK 是 Android 早期開發的必經之路。雖然 Android Studio 已全面取代,但大量存量專案仍依賴 Eclipse + ADT。本文針對兩大高頻阻斷問題——strings.xml 缺失翻譯導致 Lint Fatal Error與Keystore 填寫逗號觸發 AVA 格式錯誤——提供根因分析與最小侵入性修復方案,助你一次打包成功。

問題一:Lint 檢測缺失翻譯阻斷導出

現象復現

  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 檢查(如硬編碼字符串、未使用資源),僅放寬翻譯強制要求。

替代方案(不推薦)

  • 關閉 Run full error check when exporting app:會跳過所有 Lint 檢查,隱患大。
  • 在 lint.xml 中配置 <issue id="MissingTranslation" severity="ignore" />:專案級生效,適合團隊統一標準。

問題二:Keystore 填寫「City, Country」逗號導致簽名失敗

現象復現

  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. 轉義法:若必須保留逗號,需用反斜槓轉義 GuangXi\, China(Eclipse 圖形界面可能不支持,需命令行生成)。
  3. 命令行生成 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
    
    再在 Eclipse 選擇 Use existing keystore 選中該文件即可。

進階:Eclipse 之外的現代簽名流程

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 降級 MissingTranslation 為 Warning/Ignore。
  • Keystore 逗號錯誤 → 字段值避開逗號等特殊字符,或改用命令行 keytool 生成後導入。
  • 長期策略:遷移至 Android Studio + Gradle,享受自動化構建、混淆、簽名一體化流程。
copyright © 萬盛學電腦網 all rights reserved