iOS のユーザー向けアプリでオンデマンド ルートを追跡するには、Consumer SDK を使用します。ルートのフォローの詳細と概要については、iOS でルートをフォローするをご覧ください。
iOS コンシューマ アプリに Consumer SDK を設定する手順は次のとおりです。
- 最小システム要件を確認する。
- Consumer SDK を入手する。
- Apple プライバシー マニフェスト ファイルを検査する。
- Google Cloud コンソール プロジェクトを構成する。
- 認証トークンを取得します。
- 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 を新規または既存のプロジェクトに追加する手順は次のとおりです。
-
Xcode
project
またはworkspace
を開き、[File] > [Add Package Dependencies] に移動します。 - URL として https://github.com/googlemaps/ios-consumer-sdk を入力し、Enter キーを押してパッケージを取得し、[パッケージを追加] をクリックします。
-
特定の
version
をインストールするには、[依存関係ルール] フィールドをバージョンベースのオプションのいずれかに設定します。新しいプロジェクトの場合は、最新バージョンを指定し、[Exact Version] オプションを使用することをおすすめします。完了したら、[パッケージを追加] をクリックします。
既存のプロジェクトの package
を更新する手順は次のとおりです。
- インストールを確認するには、Project Navigator の [Package Dependencies] セクションに移動して、パッケージとそのバージョンを確認します。
手動でインストールされた既存の Consumer SDK を削除する手順は次のとおりです。
Xcode プロジェクトの構成設定で、[フレームワーク、ライブラリ、埋め込みコンテンツ] を見つけます。マイナス記号
(-)
を使用して、次のフレームワークを削除します。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 install コマンドを実行する: このコマンドは、Podfile で指定された API と、その依存関係(存在する場合)をインストールします。
pod install
Xcode でプロジェクトを開く: Xcode を閉じて、プロジェクトの .xcworkspace ファイルを開いて(ダブルクリックして)Xcode を起動します。後でプロジェクトを開くには、.xcworkspace ファイルを使用します。
手動インストール
このガイドでは、Consumer SDK を含む XCFramework を手動でプロジェクトに追加し、Xcode でビルド設定を構成する方法について説明します。
このガイドに進む前に、次のことを行ってください。
XCFramework(Consumer SDK のインストールに使用するバイナリ パッケージ)をダウンロードします。このパッケージは、M1 チップセットを使用したマシンなど、複数のプラットフォームで使用できます。
Maps SDK をインストールします。
SDK バイナリとリソースをダウンロードします。
圧縮ファイルを解凍して、XCFramework とリソースにアクセスします。
Xcode を起動し、プロジェクトを開くか作成します。iOS を初めて使用する場合は、新しいプロジェクトを作成し、iOS アプリ テンプレートを選択します。
プロジェクト グループに Frameworks グループが含まれていない場合は、作成します。
ダウンロードした
gRPCCertificates.bundle
ファイルを Xcode プロジェクトの最上位ディレクトリにドラッグします。プロンプトが表示されたら、[アイテムをコピー] を選択します。Consumer SDK をインストールするには、
GoogleRidesharingConsumer.xcframework
ファイルをプロジェクトの [フレームワーク、ライブラリ、埋め込みコンテンツ] にドラッグします。プロンプトが表示されたら、[アイテムをコピー] を選択します。ダウンロードした
GoogleRidesharingConsumer.bundle
を Xcode プロジェクトの最上位ディレクトリにドラッグします。プロンプトが表示されたら、[アイテムをコピー] を選択します。プロジェクト ナビゲータでプロジェクトを選択し、アプリのターゲットを選択します。
[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 のリソース バンドルに含まれています。プライバシー マニフェスト ファイルが含まれていることを確認して、その内容を検査するには、アプリのアーカイブを作成し、アーカイブからプライバシー レポートを生成します。