Places SDK for iOS 版本

選取平台： Android iOS JavaScript

注意： 應用程式可用的 Places SDK for iOS 功能，取決於您在應用程式設定中指定的 SDK 版本號碼，以及在 API 金鑰中啟用的 API。詳情請參閱「選擇 SDK 版本」一文。

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

要連結哪個版本？

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

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

  優點：

  • 根據行動裝置支援政策，如果您在 Places SDK for iOS 中發現問題，在主要版本首次發布後的 12 個月內，我們會以回溯相容的方式提供修正內容。您無須立即升級至不相容的 SDK 版本，即可進行修正。
  • 如果您已在最新版本中建構應用程式，便可輕鬆採用最新改善項目和功能。
  • 相較於處理多次發布主要版本時造成的回溯不相容性變更，每年更新 SDK 最新主要版本的做法，在調整、重寫及測試應用程式方面所需的作業量較少。

• 如果是非重要應用程式，請連結至任何修正版本。收到該修正版本的淘汰通知後，您必須在 12 個月內向使用者提供新版應用程式的程式碼。

  優點：

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

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

安裝

Swift Package Manager

您可以透過 Swift Package Manager 安裝 Places SDK for iOS。如要新增 SDK，請務必移除任何現有的 Places SDK for iOS 依附元件。

重要事項：這些操作說明假設您使用 Xcode 15 以上版本，但應與先前版本的 Xcode 相似。

如要將 SDK 加進新的或現有專案，請按照下列步驟操作：

1. 開啟 Xcode project 或 workspace，然後依序點選「File」>「Add Package Dependencies」。
2. 輸入 https://github.com/googlemaps/ios-places-sdk 做為網址，按下 Enter 鍵來匯入套件，然後按一下「新增套件」。
3. 如要安裝特定 version，請將「Dependency Rule」欄位設為其中一個版本選項。對於新專案，建議您指定最新版本並使用「Exact Version」選項。完成後，按一下「新增套件」。
4. 在「Choose Package Products」視窗中，確認 GooglePlaces、GooglePlacesSwift 或兩者都會新增至指定的主要目標。完成後，按一下「新增套件」。

   如果您要更新 Google Places Swift

   重要事項：自 0.3.0 版起，存取 Google Places Swift 的 GitHub 網址已變更。如果您要更新透過舊網址 https://github.com/googlemaps/ios-places-swift-sdk 存取的 GooglePlacesSwift 版本，請從 Xcode 的套件依附元件部分移除該版本。

5. 如要驗證安裝作業，請前往目標的「General」窗格。在「架構、程式庫和嵌入內容」中，您應該會看到已安裝的套件。您也可以查看 Project Navigator 的「Package Dependencies」部分，驗證套件及其版本。Xcode 會顯示 GitHub 版本，該版本與 GooglePlaces 版本相符 (例如 9.2.0)，但與 GooglePlacesSwift 版本不符 (例如 0.3.0)。

如要更新現有專案的 package，請按照下列步驟操作：

1. 在 Xcode 中，依序前往「File」>「Packages」>「Update To Latest Package Versions」。

   如果您要更新 Google Places Swift

   重要事項：自 0.3.0 版起，存取 Google Places Swift 的 GitHub 網址已變更。如果您要更新透過舊網址 https://github.com/googlemaps/ios-places-swift-sdk 存取的 GooglePlacesSwift 版本，請從 Xcode 的套件依附元件部分移除該版本。

2. 如要驗證安裝作業，請前往 Project Navigator 的「Package Dependencies」部分，驗證套件及其版本。

重要事項：有時無法解析構件或發生錯誤，在這種情況下，請依序選取「File」>「Packages」>「Reset Package Cache」。

CocoaPods

請一律在依附元件中指定版本號碼，而非使用樂觀運算子 (~>)，因為這麼做可能導致系統產生無法預測且不可重複的版本。Places SDK for iOS 採用語意化版本管理，而新的主要版本可能包含破壞性變更。

使用 Podfile 語法建立 Podfile 依附元件的範例：

source 'https://github.com/CocoaPods/Specs.git'

platform :ios, '15.0'

target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
  pod 'GooglePlaces', '9.2.0'
  pod 'GooglePlacesSwift', '0.3.0'
end

維護與升級

如要使用最新改善項目進行建構，請定期檢查新版本，並更新版本規格。如果您要更新至新的主要版本，請查看版本資訊，瞭解是否有回溯不相容的變更，以及程式碼的更新方法。

Swift Package Manager

如要更新現有專案的 package，請按照下列步驟操作：

1. 如要驗證安裝作業，請前往 Project Navigator 的「Package Dependencies」部分，驗證套件及其版本。

重要事項：有時無法解析構件或發生錯誤，在這種情況下，請依序選取「File」>「Packages」>「Reset Package Cache」。

Cocoapods

1. 開啟終端機並前往包含 Podfile 的目錄：

   cd <path-to-project>

2. 執行 pod outdated，查看是否有較新版本的 Places SDK for iOS。
3. 如果找到較新版本的 SDK，請使用這個新版本更新 Podfile。請參閱「指定 pod 版本」，瞭解如何在 Podfile 中設定特定版本。
4. 執行 pod update。
5. 進行升級後，請視需要進行變更。如要查看各版本的變更清單，請參閱版本資訊。
6. 依序選取「Product」>「Clean」和「Product」>「Build」，清理及重建專案

手動安裝程式庫

請參閱「安裝 SDK」一文，取得最新來源檔案的連結。

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