Driver SDK を入手する

このセクションでは、システムが最小要件を満たしていることを確認する方法、Workspace グループを設定する方法、Driver SDK を取得する方法について説明します。

始める前に

iOS 向け Driver SDK を使用するには、アプリが次の条件を満たしている必要があります。

• Navigation SDK を使用している。
• Google Cloud コンソールで Maps SDK for iOS を有効にして、API キーを取得します。

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

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

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

Google Workspace にアクセスする

Google Workspace をご利用のお客様の場合、以下の手順を行います。

1. Workspace グループを作成します。詳細については、ワークスペース グループをご覧ください。

   たとえば、オンボーディング時にグループに [e-mail] という名前を付けることをおすすめします。

2. Google に名前を提供して、正しい CocoaPods リポジトリへのアクセス権を付与する許可リストに Workspace グループを追加します。

3. アクセスが必要なユーザーのメールアドレスとサービス アカウントのメールアドレスがこのリストに含まれていることを確認します。

組織で Workspace グループを作成できない場合、これらのアーティファクトへのアクセスが必要なユーザーとサービス アカウントのメールアドレスのリストを Google に送信してください。

注: Workspace グループは、末尾が @googlegroups.com の Google グループとは異なります。Workspace グループのみがサポートされています。

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

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

   sudo gem install cocoapods
   

   詳しくは、CocoaPods スタートガイドをご覧ください。

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

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

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

      source "https://github.com/CocoaPods/Specs.git"
      
      target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
        pod 'GoogleRidesharingDriver'
      end
      

      次の例では、Driver SDK のアルファ版とベータ版の 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
      

   3. Podfile を保存する: ターミナルを開き、Podfile があるフォルダに移動します。

      cd <path-to-project>
      

3. pod install コマンドを実行する: このコマンドは、Podfile で指定された API とその依存関係をインストールします。

   pod install
   

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

   注: pod outdated を定期的に実行して、新しいバージョンの SDK があるかどうかを検出します。詳しくは、 iOS 版 Driver SDK のバージョンをご覧ください。

Swift Package Manager

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

重要: これらの手順は Xcode 15 以降の使用を前提としていますが、以前のバージョンの Xcode でも同様の手順で対応できます。

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

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

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

1. インストールを確認するには、プロジェクト ナビゲータの [パッケージの依存関係] セクションに移動して、パッケージとそのバージョンを確認します。

重要: アーティファクトを解決できない場合やエラーが発生する場合は、[File] > [Packages] > [Reset Package Cache] を選択します。

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

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

   • GoogleRidesharingDriver.xcframework

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

手動インストール

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

注意: ベスト プラクティスとして、可能な限り Cocoapods を使用して Driver SDK をインストールしてください。

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

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

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

Driver SDK を手動でインストールする手順は次のとおりです。

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

   • GoogleRidesharingDriver.xcframework
   • GoogleRidesharingDriver.bundle

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

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

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

5. Driver SDK をインストールするには、GoogleRidesharingDriver.xcframework ファイルをプロジェクトの [Frameworks, Libraries, and Embedded Content] にドラッグします。メッセージが表示されたら、[Copy items] を選択します。

6. ダウンロードした GoogleRidesharingDriver.bundle を Xcode プロジェクトの最上位ディレクトリにドラッグします。メッセージが表示されたら、[Copy items] を選択します。

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

8. [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

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

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

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

Apple は、App Store のアプリに対してアプリのプライバシーに関する詳細情報を求めています。最新情報と詳細については、Apple App Store のプライバシーの詳細ページをご覧ください。

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

次のステップ

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