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. ワークスペース グループを作成します。詳細については、ワークスペース グループをご覧ください。

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

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

既存のプロジェクトの 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 をインストールするには、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 コンソール プロジェクトを構成する