iOS 版本驅動程式 SDK

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

要連結哪個版本？

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

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

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

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

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

安裝

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

CocoaPods

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

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

      target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
        pod 'GoogleRidesharingDriver', '2.0.0'
      end

Swift Package Manager

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

如要在新專案或現有專案中新增 SDK，請按照下列步驟操作：

開啟 Xcode project 或 workspace，然後依序前往「File」>「Add Package Dependencies」。
輸入 https://github.com/googlemaps/ios-driver-sdk 做為網址，按下 Enter 鍵拉取套件，然後按一下「Add Package」(新增套件)。
如要安裝特定 version，請將「依附元件規則」欄位設為其中一個版本選項。如果是新專案，建議指定最新版本，並使用「Exact Version」(確切版本) 選項。完成後，按一下「新增套裝組合」。

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

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

維護與升級

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

Cocoapods

開啟終端機並前往包含 Podfile 的目錄：
```
cd <path-to-project>
```
執行 pod outdated，查看是否有較新版本的 iOS Driver SDK。
如果系統找到較新版本的 SDK，請使用這個新版本更新 Podfile。請參閱「指定 Pod 版本」，瞭解如何在 Podfile 中設定特定版本。
執行 pod update。
升級後，請視需要進行變更。如要查看各版本的異動項目清單，請參閱「版本資訊」。
依序選取「Product」>「Clean」和「Product」>「Build」，清理並重建專案

手動安裝程式庫

在「安裝 SDK」一節中，取得最新來源檔案的連結。

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