本頁面由 Cloud Translation API 翻譯而成。

Places SDK for Android 版本

選取平台： Android iOS JavaScript

Google 地圖平台團隊會定期更新 SDK，加入新功能、修正錯誤及改善執行效能。本頁內容說明如何透過行動 SDK 管理依附元件。

要連結哪個版本？

如果是重要業務應用程式，請連結至目前使用的主要版本中最新的次要版本 (X.*)，然後每年升級至新的主要版本。

如果全年陸續發布新版應用程式，您可以開始使用較新的 Places SDK for Android 次要版本。這種做法不需要更新應用程式，因為新的次要版本具有回溯相容性。

優點：
- 如果您在 Places SDK for Android 中發現問題，我們會透過主要版本發布後 12 個月內，回溯相容。行動服務支援政策。您無須立即升級至不相容的 SDK 版本，即可進行修正。
- 如果您已在最新版本中建構應用程式，便可輕鬆採用最新改善項目和功能。
- 相較於處理多次發布主要版本時造成的回溯不相容性變更，每年更新 SDK 最新主要版本的做法，在調整、重寫及測試應用程式方面所需的作業量較少。
如果是非重要應用程式，請連結至任何修正版本。收到該修正版本的淘汰通知後，您必須在 12 個月內向使用者提供新版應用程式的程式碼。

優點：
- 維護作業頻率降低。
- 針對執行舊版行動作業系統的使用者裝置，新版應用程式持續提供支援的時間較長 (可持續到您必須升級至新版 SDK 為止)。

相關變更影響到各項專案時，電子郵件地址有人監管的專案擁有者會收到主動通知。隨時掌握重大更新、淘汰項目和其他異動。

安裝

在應用程式層級的 build.gradle.kts 或 build.gradle 檔案中，請一律指定版本，而不使用前置字串範圍 (+) 或 latest，因為這麼做可能導致系統產生無法預測且不可重複的版本。Places SDK for Android 遵循語意化版本管理，以及主要版本可能包含破壞性變更。支援的最低 API 級別為 23。

dependencies {
    // If updating kotlin-bom version number above, also edit project-level build.gradle definition of $kotlin_version variable
    implementation(platform("org.jetbrains.kotlin:kotlin-bom:$kotlin_version"))
    implementation 'com.google.android.libraries.places:places:3.3.0'
}

維護與升級

Android Studio 會自動檢查可用的新版本，並在偵測到可用的新版依附元件時發出提醒。為了盡可能避免產生技術債，請盡快更新至最新的可用版本。如果您要更新至新的主要版本，請查看版本資訊瞭解是否有回溯不相容的變更，以及程式碼的更新方法。

除了針對新版本的意見調查之外，Google Cloud 專案擁有者也會收到通知電子郵件，說明回溯不相容性變更對專案可能造成的影響。如要取得與回溯不相容性變更相關的主動通知，請在每個專案中使用可監控的電子郵件地址指派擁有者角色。

如果您要從 Places SDK for Android 3.2.0 以下版本升級

改用新版 SDK 時，不需要進行遷移。你只需要：

在應用程式使用的 API 金鑰上啟用 Places API (新版)。詳情請參閱「使用 API 金鑰」一文。
在模組層級 build.gradle 檔案的 dependencies 區段中，更新 places 依附元件並新增 kotlin-bom 依附元件：
```
  dependencies {
      implementation(platform("org.jetbrains.kotlin:kotlin-bom:1.8.0"))
      implementation 'com.google.android.libraries.places:places:3.5.0'
  }
```
如要進一步瞭解 kotlin-bom 依附元件，請參閱遞移依附元件中最新版 kotlin-stdlib 版本的使用。
更新現有應用程式，即可呼叫新的 Places.initializeWithNewPlacesApiEnabled()敬上方法，用於初始化應用程式。若需更多資訊，請參閲初始化 Places API 用戶端。

現有的應用程式將繼續正常運作，但您現在可以利用所有新的 SDK 功能。