如要在 iOS 消費者應用程式中追蹤隨選行程,請使用 Consumer SDK如需更多資訊及參閱以下簡介 透過分享歷程分享的行程,請參閱 在 iOS 裝置上追蹤行程。
如要為 iOS 消費者應用程式設定 Consumer SDK,請按照下列步驟操作:
檢查最低系統需求
查看版本資訊,瞭解 您使用的用戶端 SDK。請參閱版本資訊。
- 行動裝置必須搭載 iOS 14 以上版本。
- Apple Xcode 15 以上版本。
取得 Consumer SDK
使用 CocoaPods 安裝並設定 Consumer SDK。
Swift 套件管理工具
您可以透過 安裝 Consumer SDK Swift 套件管理工具。如要新增 SDK,請確認您具備 移除了所有現有的 Consumer SDK 依附元件。
如要將 SDK 加入新專案或現有專案,請按照下列步驟操作:
-
開啟 Xcode
project
或workspace
,然後依序前往「File」>新增套件依附元件。 - 輸入 https://github.com/googlemaps/ios-consumer-sdk 做為網址,然後按下 Enter 鍵 來提取套件,然後點選「Add Package」
-
如要安裝特定
version
,請將「Dependency Rule」(依附元件規則) 欄位設為 版本化選項如果是新專案,建議您指定最新版本 使用「完全比對版本」如果有需要 SQL 指令的分析工作負載 則 BigQuery 可能是最佳選擇完成後,點選「新增套件」。 -
在「Choose Package Products」視窗中,確認
GoogleRidesharingConsumer
將新增至 您指定的main
目標完成後,點選「新增套件」。 -
如要驗證安裝狀態,請前往目標的
General
窗格。 在「Frameworks、Library and Embedded Content」中應會顯示已安裝的套件。 您也可以查看「套件依附元件」「專案導覽器」的 驗證套件及其版本
如要更新現有專案的 package
,請按照下列步驟操作:
如果要升級的是 9.0.0 以下版本,請務必移除 下列依附元件:
GoogleMapsBase
、GoogleMapsCore
和 升級後的費用為GoogleMapsM4B
。請勿移除以下項目的依附元件:GoogleMaps
。詳情請參閱 9.0.0 版本資訊。在 Xcode 專案配置設定中,找到「Frameworks, libraries」 和嵌入內容請使用減號(-) 移除下列架構:
GoogleMapsBase
(僅適用於 9.0.0 以下版本的升級作業)GoogleMapsCore
(僅適用於 9.0.0 以下版本的升級作業)GoogleMapsM4B
(僅適用於 9.0.0 以下版本的升級作業)
- 在 Xcode 中,前往 [檔案] >套裝行程 >更新至最新套件版本」。
- 如要驗證安裝狀態,請前往「Project Navigator」的「Package Dependencies」部分 驗證套件及其版本
如要移除使用
CocoaPods
,請按照下列步驟操作:
- 關閉 Xcode 工作區。開啟終端機並執行下列指令:
sudo gem install cocoapods-deintegrate cocoapods-clean pod deintegrate pod cache clean --all
-
移除
Podfile
、Podfile.resolved
和 如果不是 CocoaPods,則使用 Xcodeworkspace
。
移除已安裝的現有 Consumer SDK 手動操作,步驟如下:
在 Xcode 專案配置設定中,找出 Frameworks、 程式庫和嵌入內容使用減號
(-)
即可移除 下列架構:GoogleRidesharingConsumer.xcframework
從 Xcode 專案的頂層目錄中,移除
GoogleRidesharingConsumer
軟體包。
使用 CocoaPods
安裝 CocoaPods 工具:開啟終端機視窗, 執行下列指令:
sudo gem install cocoapods
詳情請參閱 CocoaPods 入門指南。
建立 Consumer SDK 的 Podfile:您 使用 Podfile 安裝 API 及其依附元件
在專案目錄中建立名為
Podfile
的檔案。這個檔案 定義專案的依附元件編輯 Podfile 並新增依附元件。這裡是 包含依附元件的範例:
source "https://github.com/CocoaPods/Specs.git" target 'YOUR_APPLICATION_TARGET_NAME_HERE' do pod 'GoogleRidesharingConsumer' end
儲存 Podfile:開啟終端機,並前往 Podfile:
cd <path-to-project>
執行 pod 安裝指令:這個指令會安裝 API 及其所有依附元件。
pod install
在 Xcode 中開啟專案:關閉 Xcode,然後開啟 (連按兩下) 您專案的 .xcworkspace 檔案會啟動 Xcode。開啟專案 請稍後使用 .xcworkspace 檔案。
手動安裝程式庫
本指南將說明如何手動新增包含 用戶端 SDK 新增至專案,並在 Xcode 中進行建構設定。
按照本指南操作前,請先執行下列操作:
下載 XCFramework (用於安裝 Consumer SDK。這個套件可用於多個平台,包括 搭載使用 M1 晶片組的機器
安裝 Maps SDK:
下載 SDK 二進位檔和資源:
將壓縮的檔案解壓縮,以存取 XCFramework 和資源。
啟動 Xcode,然後開啟或建立專案。如果你是 iOS 新手 建立新專案並選取 iOS 應用程式範本。
如果您的專案群組不含架構群組,請建立一個。
將下載的
gRPCCertificates.bundle
檔案拖曳到頂層 目錄。畫面出現提示時,請選取「複製項目」。如要安裝 Consumer SDK,請拖曳 將
GoogleRidesharingConsumer.xcframework
個檔案匯入專案 架構、程式庫和嵌入內容。畫面出現提示時,請選取 複製項目。將下載的
GoogleRidesharingConsumer.bundle
拖曳到 您 Xcode 專案的頂層目錄畫面出現提示時,請選取 複製項目。從「Project Navigator」中選取專案,然後選擇 並指定應用程式的目標
開啟「Build Phases」分頁,並在「Link Binary with Libraries」內找到。 新增下列架構和程式庫 (如果尚未這麼做) 目前:
Accelerate.framework
CoreData.framework
CoreGraphics.framework
CoreImage.framework
CoreLocation.framework
CoreTelephony.framework
CoreText.framework
GLKit.framework
ImageIO.framework
libc++.tbd
libz.tbd
Metal.framework
OpenGLES.framework
QuartzCore.framework
SystemConfiguration.framework
UIKit.framework
選擇專案 (而非特定目標),然後開啟 「Build Settings」分頁。在「Other Linker Flags」部分中 為偵錯和發布版本新增
-ObjC
。如果這些設定未顯示,請在 「Build Settings」列從「Basic」到「All」。
檢查 Apple 隱私權資訊清單檔案
Apple 要求在 App Store 上架應用程式,要求取得應用程式隱私權詳細資訊。如需最新資訊和其他資訊,請前往 Apple App Store 隱私權詳細資料頁面。
Apple 隱私權資訊清單檔案包含在 SDK 資源套件中。如要確認隱私權資訊清單檔案已納入並檢查其中的內容,請建立應用程式的封存檔案,然後從封存檔中產生隱私權報告。