Driver SDK を入手する

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

始める前に

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

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

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

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

  • モバイル デバイスで iOS 16 以降が実行されている。
  • Apple Xcode バージョン 26 以降。

Google Workspace にアクセスする

Google Workspace をご利用のお客様 は、次の手順を行います。

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

    たとえば、効果的な手法として、オンボーディング時にグループに google-maps-platform-sdk-users@workspacedomain.com という名前を付けることをおすすめします。

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

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

組織で 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

  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 の Alpha Pod と Beta 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 ファイルを使用します。

Swift Package Manager

Driver SDK は、 Swift Package Manager を使用してインストールできます。SDK を追加するには、既存の Driver SDK の依存関係を削除する必要があります。

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

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

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

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

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

  1. Xcode プロジェクトの構成設定で、[Frameworks, Libraries, and Embedded Content] を見つけます。マイナス記号 (-) を使用して、次のフレームワークを削除します。

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

手動インストール

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

このガイドの手順を行う前に、次の操作を行います。

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

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

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

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

  2. 圧縮ファイルを解凍して、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 コンソール プロジェクトを構成する