本頁面說明如何設定 Maps SDK for iOS 公用程式庫。
如要試用這些公用程式,您可以採取下列任一做法:
- 安裝並執行試用版應用程式。試用版應用程式是獨立專案,其中包含試用公用程式所需的所有程式碼。
- 在現有的 Xcode 專案中安裝公用程式庫。請在自己的專案中新增這些公用程式。
視需要安裝 CocoaPods
公用程式庫是以名為 Google-Maps-iOS-Utils
的 CocoaPods Pod 的形式提供。CocoaPods 是 Swift 和 Objective-C Cocoa 專案的開放原始碼依附元件管理工具。
如果您還沒有 CocoaPods 工具,請從終端機執行下列指令,以在 macOS 上安裝這個工具:
sudo gem install cocoapods
詳情請參閱 CocoaPods 入門指南。
安裝並執行試用版應用程式
公用程式庫內含試用版應用程式,您可以安裝,然後再試用各項公用程式。
使用下列其中一種方法安裝試用版應用程式:使用 GitHub 中的檔案
- 從 GitHub 下載程式碼範例封存檔,並將封存檔解壓縮。
- 開啟終端機視窗,前往展開範例檔案的目錄,然後針對您要使用的語言細查適當範例目錄:
- 針對 Swift,執行
cd google-maps-ios-utils-master/samples/SwiftDemoApp
- 針對 Objective-C,請執行
cd google-maps-ios-utils-master/samples/ObjCDemoApp
- 針對 Swift,執行
- 執行下列指令:
pod install
- 關閉 Xcode,然後開啟 (按兩下) 專案的
.xcworkspace
檔案來啟動 Xcode。從現在起,您必須使用.xcworkspace
檔案來開啟專案。
使用 CocoaPods 1.6.1 版
- 開啟終端機視窗,然後安裝 1.6.1 版:
sudo gem install cocoapods -v1.6.1
- 使用 Cocoapods 擷取 Google 地圖檔案:
pod try Google-Maps-iOS-Utils
在系統提示時選擇 Swift 或 Objective-C。CocoaPods 會更新規格存放區,然後在名為
SwiftDemoApp.xcodeproj
或ObjCDemoApp.xcodeproj
的臨時 Xcode 專案中開啟示範。
在試用版應用程式中加入 API 金鑰
在「取得 API 金鑰」中,您需要為應用程式產生 API 金鑰,現在請將該金鑰加進試用版應用程式的 Xcode 專案。Swift
將 API 金鑰新增到您的 AppDelegate.swift
中,如下所示:
- 新增下列匯入陳述式:
import GoogleMaps
- 編輯下列程式碼,在雙引號之間加入 API 金鑰:
// Change this key to a valid key registered with the demo app bundle id. let mapsAPIKey = ""
Objective-C
將 API 金鑰新增到您的 AppDelegate.m
中,如下所示:
- 新增下列匯入陳述式:
@import GoogleMaps;
- 編輯下列程式碼,在雙引號之間加入 API 金鑰:
// Change this key to a valid key registered with the demo app bundle id. static NSString *const kMapsAPIKey = @"";
建構並執行試用版應用程式
新增 API 金鑰後,請建構並執行專案:
- 如果您是 Swift 版本的示範,可以選取要在應用程式中查看的公用程式。
- 如果執行的是示範的 Objective-C 版本,我們會提供標記叢集公用程式示範。接著,您可以編輯示範的 Objective-C 版本,請嘗試使用各項公用程式。詳情請參閱下方的「在應用程式中新增公用程式」一節。
將公用程式庫安裝為 Xcode 專案
如要將公用程式庫新增至 Xcode 工作區,請按照下列步驟操作:
使用 CocoaPods
- 如果您還沒有 Xcode 專案,請立即建立專案,並儲存至本機電腦。(如果您是 iOS 開發的新手,請建立單一檢視應用程式)。
- 如果專案還沒有 pod 檔案,請在專案目錄中建立名為
Podfile
的檔案。這個檔案定義了專案的依附元件。 - 編輯專案的 Pod 檔案,並為
Google-Maps-iOS-Utils
Pod 新增依附元件。以下範例包含 Maps SDK for iOS 所需的依附元件和公用程式庫:source 'https://github.com/CocoaPods/Specs.git' platform :ios, '13.0' target 'YOUR_APPLICATION_TARGET_NAME_HERE' do use_frameworks! pod 'GoogleMaps', '7.4.0' pod 'Google-Maps-iOS-Utils', '4.2.2' end
- 執行
pod install
。 - 關閉 Xcode,然後開啟 (按兩下) 專案的
.xcworkspace
檔案來啟動 Xcode。從現在起,您必須使用.xcworkspace
檔案來開啟專案。
注意:標記叢集公用程式取決於四重樹,但您可以在不建立標記叢集的情況下使用四樹狀圖。如果只想使用四葉樹公用程式,可以將 pod 檔案中的 pod 'Google-Maps-iOS-Utils'
變更為 'Google-Maps-iOS-Utils/QuadTree'
。
使用 Carthage
- 安裝 Carthage。方法有很多種,具體步驟請參閱 Carthage README 檔案。
- 如果您還沒有 Xcode 專案,請立即建立一個並儲存至本機電腦 (如果您是 iOS 開發新手,請建立新專案,並選取 [iOS App template])。在 Xcode 11.7 版或更舊版本中,建立 Single View Application。
- 在專案目錄中建立名為
Cartfile
的檔案。這個檔案定義了專案的依附元件。 - 編輯
Cartfile
,並加入 Maps SDK for iOS 公用程式庫依附元件:
github "googlemaps/google-maps-ios-utils"
- 儲存
Cartfile
。 - 在終端機視窗中,前往包含
Cartfile
的目錄:
cd <path-to-project>
- 執行更新指令:
carthage update --platform iOS
這項操作會安裝Cartfile
中指定的 API,以及這些 API 擁有的所有依附元件。 - 在 Finder 的專案目錄中,前往
Carthage/Build/iOS
下下載的架構檔案。 - 將下列套件拖曳至專案中,即可將 Maps SDK for iOS 架構加進專案。(系統提示時,請選取「視需要複製項目,請使用與上述相同的版本」)。
GoogleMaps-x.x.x/Base/Frameworks/GoogleMapsBase.framework
GoogleMaps-x.x.x/Maps/Frameworks/GoogleMaps.framework
GoogleMaps-x.x.x/Maps/Frameworks/GoogleMapsCore.framework
GoogleMaps-x.x.x/Maps/Frameworks/GoogleMapsUtils.framework
- 以滑鼠右鍵按一下專案中的
GoogleMaps.framework
,然後選取 [Show in Finder]。 - 將
Carthage/Build/iOS/GoogleMaps.framework/Resources/GoogleMaps.bundle
從Resources
資料夾拖曳至專案。畫面顯示提示時,請確保您並未選取 [Copy items into destination group's folder]。 - 從「Project Navigator」中選取您的專案,然後為您的應用程式選擇目標。
- 開啟應用程式目標的「Build 階段」分頁,然後在「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
OpenGLES.framework
QuartzCore.framework
SystemConfiguration.framework
UIKit.framework
選擇您的專案 (而不是特定目標),然後開啟 [Build Settings] 分頁標籤。在「Other Linker Flags」部分中,新增
-ObjC
。如果您沒有看到這些設定,請將「Build Settings」列中的篩選器從「Basic」變更為「All」。
使用 Swift Package Manager
- 如果你還沒有 Xcode 專案,請立即建立專案,並儲存至本機電腦。(如果您是 iOS 開發新手,請建立新專案並選取「iOS App Template」。在 Xcode 11.7 以下版本中,建立 Single View Application。)
- 將 Maps SDK for iOS 新增為依附元件。如要瞭解相關選項,請參閱安裝 SDK。
- 在 Xcode 專案中,依序前往「File」->「Swift Packages」->「Add Package Dependency」。
- 在出現的視窗中,輸入 Maps SDK for iOS 公用程式庫存放區網址
https://github.com/googlemaps/google-maps-ios-utils
,然後選取「Next」(下一步)。 - 此時,系統可能會提示您使用 GitHub 帳戶進行驗證。按照操作說明建立 GitHub 個人存取權杖,繼續這個流程。
- 在下一個視窗中,選取「版本」圓形按鈕選項,從下拉式選單中選取「完全比對」,輸入最新版本的 Maps SDK for iOS 公用程式庫 (例如「3.4.0」),然後選取「下一步」。
在應用程式中加入 API 金鑰
想瞭解如何產生 API 金鑰並新增到 Xcode 專案,請參閱「設定 Xcode 專案」一文。建構並執行專案
新增 API 金鑰後,請建構並執行專案。
在應用程式中新增公用程式
如要進一步瞭解如何在應用程式中使用各項公用程式,請參閱各公用程式的說明文件: