このセクションでは、システムが最小要件を満たしていることを確認する方法、Workspace グループを設定する方法、Driver SDK を取得する方法について説明します。
始める前に
Driver SDK for iOS を使用するには、アプリが次の条件を満たしている必要があります。
- Navigation SDK を用意する。
- Google Cloud コンソールで Maps SDK for iOS を有効にして、API キーを取得します。
最小システム要件を確認する
使用している Driver SDK のバージョンの最小要件については、リリースノートでご確認ください。リリースノートをご覧ください。
- モバイル デバイスに iOS 14 以降が搭載されている必要があります。
- Apple Xcode バージョン 15 以降。
Google Workspace にアクセスする
Google Workspace をご利用の場合は、次の手順を行います。
ワークスペース グループを作成します。詳細については、ワークスペース グループをご覧ください。
たとえば、オンボーディング時にグループに
google-maps-platform-sdk-users@workspacedomain.com
という名前を付けることをおすすめします。名前を Google に提供して、Workspace グループを許可リストに追加し、適切な CocoaPods リポジトリへのアクセス権を付与します。
アクセス権が必要なユーザーのメールアドレスとサービス アカウントのメールアドレスがこのリストに含まれていることを確認します。
組織で Workspace グループを作成できない場合は、これらのアーティファクトにアクセスする必要があるユーザー アカウントとサービス アカウントのメールアドレスのリストを Google に送信してください。
Cloud SDK でログインする
ローカル開発の場合は、Cloud SDK でログインします。詳細については、gcloud CLI をインストールするをご覧ください。
次の例は、Cloud SDK でログインする方法を示しています。
gcloud
gcloud auth login
Workspace グループのメンバーであるメールアドレスを使用する必要があります。
自動化ホストを設定する
ビルドシステムまたは継続的インテグレーションの場合は、サービス アカウントを使用して Google API とサービスの認証を行う方法のリストに基づいて、自動化ホストを設定します。詳しくは、Google での認証方法のページのサービス アカウントのセクションをご覧ください。
プロセスが Google Cloud 環境内で実行される場合は、自動認証情報検出を使用します。詳細については、認証情報の自動検出をご覧ください。
それ以外の場合は、サービス アカウント キーファイルをホストのファイル システムの安全な場所に保存し、GOOGLE_APPLICATION_CREDENTIALS 環境変数を適切に設定します。詳細については、GOOGLE_APPLICATION_CREDENTIALS をご覧ください。
認証情報に関連付けられているサービス アカウントのメールアドレスは、Workspace グループのメンバーである必要があります。
Driver SDK を入手する
Driver SDK をインストールして構成します。
CocoaPods
CocoaPods ツールをインストールする: ターミナル ウィンドウを開き、次のコマンドを実行します。
sudo gem install cocoapods
詳しくは、CocoaPods スタートガイドをご覧ください。
Driver SDK の Podfile を作成する: Podfile を使用して、API とその依存関係をインストールします。
プロジェクト ディレクトリに
Podfile
という名前のファイルを作成します。このファイルでプロジェクトの依存関係を定義します。Podfile を編集して、依存関係を追加します。依存関係を含む例を次に示します。
source "https://github.com/CocoaPods/Specs.git" target 'YOUR_APPLICATION_TARGET_NAME_HERE' do pod 'GoogleRidesharingDriver' end
以下は、Driver SDK のアルファ版 Pod とベータ版 Pod を依存関係として含む例です。
source "https://cpdc-eap.googlesource.com/ridesharing-driver-sdk.git" source "https://github.com/CocoaPods/Specs.git" target 'YOUR_APPLICATION_TARGET_NAME_HERE' do pod 'GoogleRidesharingDriver' end
Podfile を保存する: ターミナルを開き、Podfile があるフォルダに移動します。
cd <path-to-project>
pod install コマンドを実行する: このコマンドは、Podfile で指定されている API と、その依存関係(存在する場合)をインストールします。
pod install
Xcode でプロジェクトを開く: Xcode を終了し、プロジェクトの .xcworkspace ファイルを開いて(ダブルクリックして)Xcode を起動します。後でプロジェクトを開くには、.xcworkspace ファイルを使用します。
Swift Package Manager
Driver SDK は Swift Package Manager を使用してインストールできます。SDK を追加するには、既存の Driver SDK の依存関係をすべて削除してください。
SDK を新規または既存のプロジェクトに追加する手順は次のとおりです。
-
Xcode
project
またはworkspace
を開き、[File] > [Add Package Dependencies] に移動します。 - URL として https://github.com/googlemaps/ios-driver-sdk を入力し、Enter キーを押してパッケージを取得し、[パッケージを追加] をクリックします。
-
特定の
version
をインストールするには、[依存関係ルール] フィールドをバージョンベースのオプションのいずれかに設定します。新しいプロジェクトの場合は、最新バージョンを指定し、[Exact Version] オプションを使用することをおすすめします。完了したら、[パッケージを追加] をクリックします。
既存のプロジェクトの package
を更新する手順は次のとおりです。
- インストールを確認するには、Project Navigator の [Package Dependencies] セクションに移動して、パッケージとそのバージョンを確認します。
手動でインストールされた既存の Driver SDK を削除する手順は次のとおりです。
Xcode プロジェクトの構成設定で、[フレームワーク、ライブラリ、埋め込みコンテンツ] を見つけます。マイナス記号
(-)
を使用して、次のフレームワークを削除します。GoogleRidesharingDriver.xcframework
Xcode プロジェクトの最上位ディレクトリから、
GoogleRidesharingDriver
バンドルを削除します。
手動インストール
このガイドでは、Driver SDK を含む XCFramework を手動でプロジェクトに追加し、Xcode でビルド設定を構成する方法について説明します。
このガイドに進む前に、次のことを行ってください。
XCFramework(ドライバ SDK のインストールに使用するバイナリ パッケージ)をダウンロードします。このパッケージは、Apple シリコンを使用するマシンなど、複数のプラットフォームで使用できます。
Navigation SDK をインストールします。
次の手順に沿って、Driver SDK を手動でインストールします。
SDK バイナリとリソースをダウンロードします。
圧縮ファイルを解凍して、XCFramework とリソースにアクセスします。
Xcode を起動し、既存のプロジェクトを開くか、プロジェクトを作成します。iOS を初めて使用する場合は、新しいプロジェクトを作成し、iOS アプリ テンプレートを選択します。
プロジェクト グループに Frameworks グループが含まれていない場合は、作成します。
Driver SDK をインストールするには、
GoogleRidesharingDriver.xcframework
ファイルをプロジェクトの [フレームワーク、ライブラリ、埋め込みコンテンツ] にドラッグします。プロンプトが表示されたら、[アイテムをコピー] を選択します。ダウンロードした
GoogleRidesharingDriver.bundle
を Xcode プロジェクトの最上位ディレクトリにドラッグします。プロンプトが表示されたら、[アイテムをコピー] を選択します。プロジェクト ナビゲータでプロジェクトを選択し、アプリのターゲットを選択します。
[Build Phases] タブを開き、[Link Binary with Libraries] で、次のフレームワークとライブラリがまだ存在しない場合は追加します。
Accelerate.framework
AudioToolbox.framework
AVFoundation.framework
CoreData.framework
CoreGraphics.framework
CoreLocation.framework
CoreTelephony.framework
CoreText.framework
GLKit.framework
ImageIO.framework
libc++.tbd
libxml2.tbd
libz.tbd
LocalAuthentication.framework
OpenGLES.framework
QuartzCore.framework
SystemConfiguration.framework
UIKit.framework
WebKit.framework
特定のターゲットではなく、プロジェクトを選択して、[Build Settings] タブを開きます。[Other Linker Flags] セクションで、デバッグとリリースの両方に
-ObjC
を追加します。これらの設定が表示されない場合は、[Build Settings] バーのフィルタを [Basic] から [All] に変更します。
Apple プライバシー マニフェスト ファイルを検査する
Apple は、App Store でアプリを公開するデベロッパーに対して、アプリのプライバシーに関する詳細情報の開示を求めています。最新情報と詳細については、Apple App Store のプライバシーに関する詳細情報のページをご覧ください。
Apple プライバシー マニフェスト ファイルは、SDK のリソース バンドルに含まれています。プライバシー マニフェスト ファイルが含まれていることを確認して、その内容を検査するには、アプリのアーカイブを作成し、アーカイブからプライバシー レポートを生成します。
次のステップ
Google Cloud コンソール プロジェクトを構成する