將應用程式遷移至 Android 10

歡迎!Android 10 提供許多新的 API 來建立新的體驗,以及更新系統行為,這些 API 在 Android 10 裝置上執行時可能會受到影響。

首先,建議您詳閱系統行為變更隱私權變更新功能和 API,並在以下兩個階段遷移應用程式:

  1. 確保基本相容性。如果使用者要更新或購買搭載 Android 10 的新裝置,請盡快確認已發布的應用程式已就緒。請測試應用程式,確認可以正常運作,然後向使用者發布相容的應用程式版本。
  2. 使用 Android 10 功能和 API 建構。接著,探索 Android 10 的新功能和 API設定開發環境、變更應用程式的 targetSdkVersion,並使用與應用程式相關的新 API 進行建構。

以下各節說明您在各階段需要採取的行動。 開始之前,請確認您已備妥硬體裝置或模擬器,可以執行並測試應用程式。

第 1 階段:基本相容性

此階段的目標,是找出應用程式在 Android 10 上執行時的任何功能迴歸問題或其他影響,然後解決這些問題並向使用者發布更新版本。在多數情況下,您應該不需要變更應用程式的 targetSdkVersion 或使用新的 API,但您可以視需要變更 compileSdkVersion 以支援相容性。

請務必透過所有流程測試現有應用程式的功能,因為某些平台變更可能會影響應用程式的行為。當您發布相容的應用程式版本時,建議您在更新附註中通知使用者 Android 10 支援。

為了讓使用者順利轉換至 Android 10,建議您盡早發布相容的應用程式版本,最好在裝置開始接收 Android 10 更新之前。

執行測試

相容性測試涉及您在準備發布應用程式時執行的測試類型。建議您務必詳閱核心應用程式品質指南測試最佳做法

請務必熟悉可能對應用程式造成影響的已知行為變更。即使您未變更 targetSdkVersion這些行為變更也會套用至您的應用程式。事先審查變更有助於找出可能的影響範圍,並更快地偵錯。

Android 10 對隱私權做了廣泛的調整,因此也請務必查看重大的隱私權異動,瞭解應用程式可能受到的影響。

第 2 階段:使用 Android 10 建構內容

準備就緒後,您就可以探索 Android 10 的新功能和 API,並利用新體驗強化應用程式。如要開始使用新的 API 進行開發,您需要在 Android Studio 中設定 Android 10 (API 29) SDK,並將 targetSdkVersioncompileSdkVersion 變更為 29

變更 targetSdkVersion 時,您也需要考量應用程式鎖定 Android 10 (API 29) 以上版本時,應用程式所套用的系統行為變更

部分行為變更可能會導致迴歸或當機,因此在發布會變更 targetSdkVersion 的應用程式更新之前,請務必仔細查看變更並完整測試。

取得 SDK

如要取得 SDK 套件以建構 Android 10 應用程式,請先確認您使用的是最新版的 Android Studio。詳情請參閱「設定 SDK」。

執行測試

完成上述的準備作業後,您就可以建構應用程式並進一步進行測試,確保應用程式在以 Android 10 為目標的環境中能正常運作。趁這個機會詳閱核心應用程式品質指南測試最佳做法

使用 targetSdkVersion 設為 29 建構應用程式時,請留意特定平台異動。即便您尚未使用新的 API,部分變更 (請參閱「Android 10 行為變更」頁面的說明) 可能會對應用程式行為或造成當機情形造成重大影響。