將應用程式遷移至 Android 10

歡迎Android 10 有許多新的 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 行為變更頁面所述) 可能會對應用程式的行為或造成當機問題造成重大影響。