版本代碼

永續維護 Android 應用程式版本代碼

為防止意外降級，Android 要求每次發布時，應用程式版本代碼都必須遞增；此外，Google Play 也對版本代碼設有嚴格的上限。若編號規則導致數值遞增過快，日後發布更新時可能會受到限制。為確保應用程式在未來幾年都能持續更新，請務必瞭解應用程式的版本管理機制，並採用具備彈性的策略來產生版本代碼。

關於應用程式版本

Android 應用程式採用兩項主要版本管理屬性：

• versionCode：32 位元整數，每次推出新版本時都會遞增。Android 系統和 Google Play 會在內部使用這個數值，來判斷版本的新舊。
• versionName：代表面向使用者的版本號碼字串，例如「1.0.0」、「1.1 Beta」、「2.0」。使用者會在 Google Play 和裝置上看到這個名稱。

如要深入瞭解如何選擇版本代碼，請參閱 Android 開發人員說明文件中，有關多個 APK 和版本代碼的解說。

接近版本代碼上限

Google Play 對版本代碼設有上限，允許的 versionCode 最大值為 2,100,000,000。雖然這個數字看似龐大，但若版本管理不當或缺乏效率，仍可能導致應用程式發生問題，例如：

• 無法發布更新：如果應用程式的 versionCode 達到或超過上限，您將無法再將新的 APK 或應用程式套件上傳至 Google Play。換言之，使用者將不再收到錯誤修正、新功能或相容性更新。

如何避免達到版本代碼上限：

• 採用永續的 versionCode 策略：制定 versionCode 產生策略，確保版本代碼逐步穩定增加，避免過快達到上限
• 監控 versionCode 使用情形：定期追蹤應用程式的 versionCode 遞增情況，預測何時可能接近上限。
• 導入自動檢查機制：將檢查機制納入建構和發布流程，在 versionCode 值過高時發出警告或禁止使用。

如果版本代碼達到上限，Google Play 或許能提供支援。請與 Google Play 支援團隊聯絡，尋求協助。