Driver SDK を入手する

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

始める前に

Driver SDK for iOS では、アプリが次の条件を満たす必要があります。

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

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

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

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

Google Workspace にアクセス

Google Workspace をご利用の場合は、次の手順を行います。

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

   たとえば、プロジェクトに名前をつけるのがおすすめです。 オンボーディング時の[e-mail]。

2. Workspace グループを許可リストに登録するには、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 Cloud 環境内で実行される場合は、認証情報の自動検出を使用します。詳細については、認証情報の自動検出をご覧ください。

• それ以外の場合は、サービス アカウント キーファイルをホストのファイル システムの安全な場所に保存し、GOOGLE_APPLICATION_CREDENTIALS 環境変数を適切に設定します。詳しくは、GOOGLE_APPLICATION_CREDENTIALS をご覧ください。

認証情報に関連付けられたサービス アカウントのメールアドレスは、 クリックします。

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
      

      ここに示す例には、Terraform の Alpha Pod と Beta Pod が含まれています。 Driver SDK を依存関係として使用する場合:

      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 を保存する: ターミナルを開いて、Pod が保存されているフォルダに移動します。 Podfile:

      cd <path-to-project>
      

3. pod install コマンドを実行: このコマンドは API をインストールします。 Podfile 内で指定されている状態になっています。

   pod install
   

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

   注: pod outdated を定期的に実行して、 新しいバージョンがあります詳細については、<ph type="x-smartling-placeholder"></ph>をご覧ください。 Driver SDK for iOS バージョンをご覧ください。

Swift Package Manager

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

重要: 以下の手順では Xcode 15 以降の使用を想定していますが、 サポートしています。

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

1. Xcode project または workspace を開き、[File >パッケージの依存関係を追加する。
2. URL として「https://github.com/googlemaps/ios-driver-sdk」と入力し、Enter キーを押します。 [パッケージを追加]をクリックします
3. 特定の version をインストールするには、[依存関係ルール] フィールドをバージョンベースのオプションのいずれかに設定します。新しいプロジェクトの場合は、最新バージョンと 1 つのバージョンを 「正確なバージョン」を使用して選択します。完了したら、[Add Package] をクリックします。
4. [パッケージ プロダクトを選択] ウィンドウで、指定した main ターゲットに GoogleRidesharingDriver が追加されることを確認します。完了したら、[Add Package] をクリックします。
5. インストールを確認するには、ターゲットの General ペインに移動します。 [Frameworks, Libraries, and Embedded Content] に、インストールされたパッケージが表示されます。 [Package Dependencies] ペインもセクション（プロジェクト ナビゲーター） パッケージとそのバージョンを確認します。

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

1. Xcode で、[File] > [パッケージ >最新のパッケージ バージョンへの更新」を選択します。
2. インストールを確認するには、Project Navigator の [Package Dependencies] セクションに移動します。 パッケージとそのバージョンを確認します。

で確認できます。 <ph type="x-smartling-placeholder">

</ph> 重要: アーティファクトを解決できない場合や、エラーが発生する場合があります。 この場合は [ファイル] >パッケージ >Reset Package Cache」というメッセージが表示されます。

インストールされている既存の Driver SDK を削除するには 次の操作を行います。

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

   • GoogleRidesharingDriver.xcframework

2. Xcode プロジェクトの最上位ディレクトリから、 GoogleRidesharingDriver セット。

手動インストール

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

注意: 可能な限り Cocoapods を使用して Driver SDK をインストールすることをおすすめします。

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

• XCFramework というバイナリ パッケージをダウンロードします。これは、 Driver SDKこのパッケージは、 Apple Silicon を使用したマシン

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

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

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

   • GoogleRidesharingDriver.xcframework
   • GoogleRidesharingDriver.bundle

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

3. Xcode を起動し、既存のプロジェクトを開くか、プロジェクトを作成します。もし 新しいプロジェクトを作成し、iOS アプリ テンプレートを選択します。

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

5. Driver SDK をインストールするには、 GoogleRidesharingDriver.xcframework ファイルを、 フレームワーク、ライブラリ、埋め込みコンテンツ。プロンプトが表示されたら、 アイテムをコピーする。

6. ダウンロードした GoogleRidesharingDriver.bundle をトップレベルにドラッグします ディレクトリに移動します。プロンプトが表示されたら、[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 設定タブ。[その他のリンカーフラグ] セクションで、-ObjC デバッグとリリースの両方に対応しています。

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

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

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

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

次のステップ

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