設定 Xcode 專案

Swift Package Manager

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

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

1. 開啟 Xcode project 或 workspace，然後依序前往「File」>「Add Package Dependencies」。
2. 輸入 https://github.com/googlemaps/ios-maps-sdk 做為網址，按 Enter 鍵 提取套件，然後按一下「Add Package」(新增套件)。
3. 如要安裝特定 version，請將「依附元件規則」欄位設為其中一個以版本為準的選項。新專案建議指定最新版本，並使用「Exact Version」選項。完成後，按一下「新增套裝組合」。
4. 在「選擇套件產品」視窗中，確認 GoogleMaps (如果是 9.0.0 之前的版本，請確認 GoogleMaps、GoogleMapsBase 和 GoogleMapsCore) 會新增至指定的 main 目標。完成後，按一下「新增套裝組合」。
5. 如要驗證安裝作業，請前往目標的「一般」窗格。 在「Frameworks, Libraries, and Embedded Content」中，您應該會看到已安裝的套件。 您也可以查看「Project Navigator」的「Package Dependencies」部分，驗證套件及其版本。

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

1. 如果從 9.0.0 之前的版本升級，升級後必須移除下列依附元件：GoogleMapsBase、GoogleMapsCore 和 GoogleMapsM4B。請勿移除 GoogleMaps 的依附元件。詳情請參閱「9.0.0 版版本資訊」。

   在 Xcode 專案設定中，找出「Frameworks, Libraries, and Embedded Content」。使用減號(-)移除下列架構：

   • GoogleMapsBase (僅適用於從 9.0.0 以下版本升級)
   • GoogleMapsCore (僅適用於從 9.0.0 以下版本升級)
   • GoogleMapsM4B (僅適用於從 9.0.0 以下版本升級)
2. 在 Xcode 中，依序前往「File」>「Packages」>「Update To Latest Package Versions」。
3. 如要驗證安裝作業，請前往「Project Navigator」的「Package Dependencies」部分，驗證套件及其版本。

如要移除使用 CocoaPods 新增的現有 Maps SDK for iOS 依附元件，請按照下列步驟操作：

1. 關閉 Xcode 工作區。開啟終端機並執行下列指令：

   sudo gem install cocoapods-deintegrate cocoapods-clean
   pod deintegrate
   pod cache clean --all

2. 如果您除了 CocoaPods 以外，沒有使用 Podfile、Podfile.resolved 和 Xcode workspace，請將這些項目移除。

1. 在 Xcode 專案設定中，找出「Frameworks, Libraries, and Embedded Content」。使用減號 (-) 移除下列架構：
   • GoogleMaps
   • GoogleMapsBase (僅適用於 9.2.0 以下版本)
   • GoogleMapsCore (僅適用於 9.2.0 以下版本)
   • GoogleMapsM4B (僅適用於 9.0.0 以下版本)
2. 從 Xcode 專案的頂層目錄中，移除 GoogleMaps 套件組合。

手動安裝

本指南說明如何手動將包含 Maps SDK for iOS 的 XCFrameworks 新增至專案，並在 Xcode 中設定建構設定。XCFramework 是二進位檔套件，可在多個平台使用，包括使用 Apple 晶片的機器。

1. 下載下列 SDK 二進位檔和資源檔案：
   • GoogleMaps
   • GoogleMapsResources
2. 解壓縮檔案，存取 XCFrameworks 和資源。
3. 如果還沒有 Xcode 專案，請立即建立並儲存至本機電腦。如果您是 iOS 開發新手：
   1. 建立新專案。
   2. 選取「iOS」>「應用程式」範本。
   3. 在專案選項畫面中：
      1. 輸入「專案名稱」。
      2. 記下「軟體包 ID」欄位的值。 您可以使用該值限制下方的 API 金鑰。
      3. 將專案「介面」設為「分鏡腳本」。
      4. 將「Language」(語言) 設為「Swift」或「Objective-C」。
4. 開啟「一般」分頁。將下列 XCFrameworks 拖曳至專案的「Frameworks, Libraries, and Embedded Content」下方。請務必選取「不要內嵌」：
   • GoogleMaps.xcframework
5. 將下載的 GoogleMapsResources 中的 GoogleMaps.bundle 複製到 Xcode 專案的頂層目錄。系統提示時，請務必選取「將項目複製到目標群組的資料夾」。
6. 從「Project Navigator」選取專案，然後選擇應用程式的目標。
7. 開啟應用程式目標的「Build Phases」分頁。 在「Link Binary with Libraries」中，新增下列架構和程式庫：
   • Accelerate.framework
   • Contacts.framework
   • CoreData.framework
   • CoreGraphics.framework
   • CoreImage.framework
   • CoreLocation.framework
   • CoreTelephony.framework
   • CoreText.framework
   • GLKit.framework
   • ImageIO.framework
   • libc++.tbd
   • libz.tbd
   • Metal.framework
   • MetricKit.framework
   • OpenGLES.framework (僅限使用 OpenGL 時)
   • QuartzCore.framework
   • Security.framework
   • SystemConfiguration.framework
   • UIKit.framework

8. 選擇專案 (而非特定目標)，然後開啟「Build Settings」分頁。在「Linking - General -> Other Linker Flags」部分，將 -ObjC 新增至「Debug」和「Release」。如果看不到這些設定，請在「Build Settings」列中將篩選器從「Basic」變更為「All」。

9. 如要安裝 Places SDK for iOS XCFramework，請參閱「開始使用 Places SDK for iOS」。

Swift

將 API 金鑰新增到您的 AppDelegate.swift 中，如下所示：

1. 新增下列匯入陳述式：

   import GoogleMaps

2. 在 application(_:didFinishLaunchingWithOptions:) 方法中加入下列內容，並使用您的 API 金鑰：

   GMSServices.provideAPIKey("YOUR_API_KEY")

3. 如果您也使用 Places API，請再次新增金鑰，如下所示：

   GMSPlacesClient.provideAPIKey("YOUR_API_KEY")

Objective-C

將 API 金鑰新增到您的 AppDelegate.m 中，如下所示：

1. 新增下列匯入陳述式：

   @import GoogleMaps;

2. 在 application:didFinishLaunchingWithOptions: 方法中加入下列內容，並使用您的 API 金鑰：

   [GMSServices provideAPIKey:@"YOUR_API_KEY"];

3. 如果您也使用 Places API，請再次新增金鑰，如下所示：

   [GMSPlacesClient provideAPIKey:@"YOUR_API_KEY"];