前言:為什麼 APK 必須簽名?
Android 系統要求所有安裝裝置上的應用程式必須經過數位簽名,才能確認開發者身分並保證應用完整性。未簽名的 APK 無法安裝至真機,也無法上架 Google Play。本文將以 Eclipse 為開發環境,詳細示範從建立 Keystore 到導出正式版 APK 的完整流程。
步驟總覽
- 在 Eclipse 專案上右鍵選擇 Export
- 選擇 Android → Export Android Application → Next
- 確認專案無誤 → Next
- 建立新 Keystore:指定路徑、設定密碼(範例:123456)
- 建立 Key Alias:輸入別名、密碼(範例:123123)、有效期限(建議 25 年以上)、開發者資訊
- 指定 APK 輸出路徑與檔名 → Finish
詳細操作步驟與截圖說明
步驟 1:啟動導出精靈
在 Package Explorer 中對目標 Android 專案按右鍵,選擇 Export...。
步驟 2:選擇 Android 應用程式導出
展開 Android 資料夾,選擇 Export Android Application,按 Next。
步驟 3:專案確認
精靈會自動帶入目前選取的專案,確認無誤後直接按 Next。
步驟 4:建立新 Keystore(關鍵步驟)
- 選擇 Create new keystore
- Location:指定 `.keystore` 檔案儲存路徑(建議放在專案外的固定目錄,便於多專案共用)
- Password / Confirm:設定 Keystore 存取密碼(範例:123456),務必妥善保管,遺失將無法更新應用
步驟 5:建立 Key Alias(金鑰別名)
- Alias:一個 Keystore 可包含多組金鑰,以 Alias 區分(範例:my-release-key)
- Password / Confirm:該 Alias 專用密碼(範例:123123),可與 Keystore 密碼不同
- Validity (years):有效年限,Google Play 要求至少 25 年(2033 年 10 月後),建議填 25~50
- First and Last Name / Organization 等:至少填寫一項開發者資訊,供憑證識別用
步驟 6:指定 APK 輸出目的地
輸入想要的 APK 檔名(如 `MyApp_v1.0_release.apk`),選擇儲存資料夾,按 Finish 完成導出。
重要提醒與最佳實務
⚠️ Keystore 保管鐵則
- 備份、備份、再備份! 遺失 Keystore 或忘記密碼,將永無法發布同一包名的更新版本。
- 建議使用強密碼,並將 Keystore 檔案與密碼分開儲存(如密碼管理軟體)。
- 正式上架前,請以真機測試簽名後的 APK 功能是否正常。
常見問題 FAQ
- Q: 可以用同一組 Keystore 簽名不同專案嗎?
- A: 可以,只要 Alias 不同即可。但建議依專案建立獨立 Keystore,降低風險。
- Q: 導出 APK 時跳錯 "Key store password was incorrect"?
- A: 請確認 Keystore 密碼與 Alias 密碼輸入正確,注意大小寫。
- Q: Eclipse 找不到 Export Android Application 選項?
- A: 請確認已安裝 ADT Plugin,且專案為 Android 專案性質。
結語
掌握 APK 簽名導出流程是 Android 開發者的必修課。雖然現代開發多改用 Android Studio + Gradle 自動化簽名,但理解底層 Keystore/Key 機制對排查打包問題、遷移舊專案仍具高價值。妥善保管你的金鑰,祝你發布順利!