iOS Consumer SDK を入手する

プラットフォームを選択: Android iOS JavaScript

iOS のユーザー向けアプリでオンデマンド ルートを追跡するには、Consumer SDK を使用します。ルートのフォローの詳細と概要については、iOS でルートをフォローするをご覧ください。

iOS コンシューマ アプリに Consumer SDK を設定する手順は次のとおりです。

  1. 最小システム要件を確認する
  2. Consumer SDK を入手する
  3. Apple プライバシー マニフェスト ファイルを検査する
  4. Google Cloud コンソール プロジェクトを構成する
  5. 認証トークンを取得します
  6. Consumer SDK を初期化します

最小システム要件を確認する

使用している Consumer SDK のバージョンの最小要件については、リリースノートでご確認ください。リリースノートをご覧ください。

  • モバイル デバイスに iOS 14 以降が搭載されている必要があります。
  • Apple Xcode バージョン 15 以降。

Consumer SDK を入手する

Consumer SDK は CocoaPods を使用してインストールして設定します。

Swift Package Manager

Consumer SDK は Swift Package Manager を使用してインストールできます。SDK を追加するには、既存の Consumer SDK の依存関係をすべて削除してください。

SDK を新規または既存のプロジェクトに追加する手順は次のとおりです。

  1. Xcode project または workspace を開き、[File] > [Add Package Dependencies] に移動します。
  2. URL として https://github.com/googlemaps/ios-consumer-sdk を入力し、Enter キーを押してパッケージを取得し、[パッケージを追加] をクリックします。
  3. 特定の version をインストールするには、[依存関係ルール] フィールドをバージョンベースのオプションのいずれかに設定します。新しいプロジェクトの場合は、最新バージョンを指定し、[Exact Version] オプションを使用することをおすすめします。完了したら、[パッケージを追加] をクリックします。

既存のプロジェクトの package を更新する手順は次のとおりです。

  1. インストールを確認するには、Project Navigator の [Package Dependencies] セクションに移動して、パッケージとそのバージョンを確認します。

手動でインストールされた既存の Consumer SDK を削除する手順は次のとおりです。

  1. Xcode プロジェクトの構成設定で、[フレームワーク、ライブラリ、埋め込みコンテンツ] を見つけます。マイナス記号(-) を使用して、次のフレームワークを削除します。

    • GoogleRidesharingConsumer.xcframework
  2. Xcode プロジェクトの最上位ディレクトリから、GoogleRidesharingConsumer バンドルを削除します。

CocoaPods を使用

  1. CocoaPods ツールをインストールする: ターミナル ウィンドウを開き、次のコマンドを実行します。

    sudo gem install cocoapods
    

    詳細については、CocoaPods スタートガイドをご覧ください。

  2. Consumer SDK の Podfile を作成する: Podfile を使用して、API とその依存関係をインストールします。

    1. プロジェクトのディレクトリに、Podfile という名前のファイルを作成します。このファイルでプロジェクトの依存関係を定義します。

    2. Podfile を編集して、依存関係を追加します。依存関係を含む例を次に示します。

      source "https://github.com/CocoaPods/Specs.git"
      target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
        pod 'GoogleRidesharingConsumer'
      end
      
    3. Podfile を保存する: ターミナルを開き、Podfile があるフォルダに移動します。

      cd <path-to-project>
      
  3. pod install コマンドを実行する: このコマンドは、Podfile で指定された API と、その依存関係(存在する場合)をインストールします。

    pod install
    
  4. Xcode でプロジェクトを開く: Xcode を閉じて、プロジェクトの .xcworkspace ファイルを開いて(ダブルクリックして)Xcode を起動します。後でプロジェクトを開くには、.xcworkspace ファイルを使用します。

手動インストール

このガイドでは、Consumer SDK を含む XCFramework を手動でプロジェクトに追加し、Xcode でビルド設定を構成する方法について説明します。

このガイドに進む前に、次のことを行ってください。

  • XCFramework(Consumer SDK のインストールに使用するバイナリ パッケージ)をダウンロードします。このパッケージは、M1 チップセットを使用したマシンなど、複数のプラットフォームで使用できます。

  • Maps SDK をインストールします。

  1. SDK バイナリとリソースをダウンロードします。

  2. 圧縮ファイルを解凍して、XCFramework とリソースにアクセスします。

  3. Xcode を起動し、プロジェクトを開くか作成します。iOS を初めて使用する場合は、新しいプロジェクトを作成し、iOS アプリ テンプレートを選択します。

  4. プロジェクト グループに Frameworks グループが含まれていない場合は、作成します。

  5. ダウンロードした gRPCCertificates.bundle ファイルを Xcode プロジェクトの最上位ディレクトリにドラッグします。プロンプトが表示されたら、[アイテムをコピー] を選択します。

  6. Consumer SDK をインストールするには、GoogleRidesharingConsumer.xcframework ファイルをプロジェクトの [フレームワーク、ライブラリ、埋め込みコンテンツ] にドラッグします。プロンプトが表示されたら、[アイテムをコピー] を選択します。

  7. ダウンロードした GoogleRidesharingConsumer.bundle を Xcode プロジェクトの最上位ディレクトリにドラッグします。プロンプトが表示されたら、[アイテムをコピー] を選択します。

  8. プロジェクト ナビゲータでプロジェクトを選択し、アプリのターゲットを選択します。

  9. [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
  10. (特定のターゲットではなく)プロジェクトを選択して、[Build Settings] タブを開きます。[Other Linker Flags] セクションで、デバッグとリリースの両方に -ObjC を追加します。

    これらの設定が表示されない場合は、[Build Settings] バーのフィルタを [Basic] から [All] に変更します。

Apple プライバシー マニフェスト ファイルを検査する

Apple は、App Store のアプリにアプリのプライバシーに関する詳細情報を表示することを義務付けています。最新情報と詳細については、Apple App Store のプライバシーに関する詳細情報のページをご覧ください。

Apple プライバシー マニフェスト ファイルは、SDK のリソース バンドルに含まれています。プライバシー マニフェスト ファイルが含まれていることを確認して、その内容を検査するには、アプリのアーカイブを作成し、アーカイブからプライバシー レポートを生成します。

次のステップ

Google Cloud コンソール プロジェクトを構成する