設定和示範

選取平台： Android iOS

本頁面說明如何設定 Maps SDK for iOS 的公用程式庫。

如要試用這些公用程式，請採取下列任一做法：

將 Maps SDK for iOS 公用程式庫新增至 Xcode 專案

請按照下列步驟，將公用程式庫新增至 Xcode 工作區：

使用 Swift Package Manager

  1. 如果您還沒有 Xcode 專案，請立即建立一個並儲存至本機電腦。 (如果您是 iOS 開發新手，請建立新專案，並選取「iOS App template」。在 Xcode 11.7 版或更舊版本中，建立 Single View Application。
  2. 將 Maps SDK for iOS 新增為依附元件。如需相關選項，請參閱「安裝 SDK」。
  3. 在 Xcode 專案中，依序前往「File」->「Swift Packages」->「Add Package Dependency」。
  4. 在顯示的視窗中，輸入 Maps SDK for iOS 公用程式庫存放區網址 https://github.com/googlemaps/google-maps-ios-utils，然後選取「Next」。
    • 此時，系統可能會提示您驗證 GitHub 帳戶。請按照操作說明建立 GitHub 個人存取權杖，然後繼續進行程序。
  5. 在下一個視窗中，選取「版本」單選選項，從下拉式清單中選取「Up to Next Major Version」(下一個主要版本)，然後輸入最新版本的 Maps SDK for iOS 公用程式庫 (例如「6.0.0」)。
  6. 按一下「新增至專案」旁的下拉式選單，選取專案，然後選取「新增套件」。

在應用程式中加入 API 金鑰

如要瞭解如何產生 API 金鑰並新增至 Xcode 專案，請參閱「設定 Xcode 專案」。

建構並執行專案

新增 API 金鑰後，請建構並執行專案。

在應用程式中使用公用程式

如要進一步瞭解如何在應用程式中使用各項公用程式，請參閱相關說明文件：

安裝並執行試用版應用程式

公用程式庫內含試用版應用程式，您可以安裝並試用各項公用程式。

安裝試用版應用程式：

使用 GitHub 的檔案

  1. 從 GitHub下載程式碼範例封存檔，然後解壓縮封存檔。或者，將存放區複製到本機目錄： 
    git clone https://github.com/googlemaps/google-maps-ios-utils.git
  2. 開啟終端機視窗，前往展開範例檔案的目錄，然後深入瞭解要使用的語言適用的範例目錄：

    Swift

    cd google-maps-ios-utils/samples/SwiftDemoApp
open SwiftDemoApp.xcodeproj

    Objective-C

    cd google-maps-ios-utils/samples/ObjCDemoApp
open ObjCDemoApp.xcodeproj

在試用版應用程式中加入 API 金鑰

在「取得 API 金鑰」中，您為應用程式產生了 API 金鑰。現在請將該金鑰新增至試用版應用程式的 Xcode 專案。

Swift

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

  1. 新增下列匯入陳述式： 
    import GoogleMaps
  2. 編輯下列程式碼行，在雙引號之間加入 API 金鑰： 
    // Change this key to a valid key registered with the demo app bundle id.
let mapsAPIKey = ""

Objective-C

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

  1. 新增下列匯入陳述式： 
    @import GoogleMaps;
  2. 編輯下列程式碼行，在雙引號之間加入 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 版本的範例，試用各項公用程式。 詳情請參閱下方的「在應用程式中新增公用程式」一節。