Driver SDK を入手する

このセクションでは、システムが最小要件を満たしていることを確認し、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 をご利用の場合は、次の手順を行います。

1. Workspace グループを作成します。詳しくは、Workspace グループをご覧ください。

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

2. 名前を Google に指定して、ワークスペース グループを許可リストに追加して、適切な CocoaPods リポジトリへのアクセス権を付与します。

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 とベータ版 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 があるかどうかを検出します。詳しくは、Driver SDK for iOS のバージョンをご覧ください。

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 キーを押してパッケージを取得して、[Add Package] をクリックします。
3. 特定の version をインストールするには、[依存関係ルール] フィールドをバージョンベースのオプションのいずれかに設定します。新しいプロジェクトの場合は、最新バージョンを指定し、[Exact Version] オプションを使用することをおすすめします。完了したら、[Add Package] をクリックします。

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

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

重要: アーティファクトを解決できない場合やエラーが発生する場合があります。その場合は、[ファイル] > [パッケージ] > [パッケージ キャッシュをリセット] を選択します。

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

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

   • GoogleRidesharingDriver.xcframework

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

手動インストール

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

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

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

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

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

Driver SDK を手動でインストールするには、次の手順を行います。

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

   • GoogleRidesharingDriver.xcframework
   • GoogleRidesharingDriver.bundle

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

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

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

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

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

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 コンソール プロジェクトを構成する