iOS Consumer SDK を入手する

Swift Package Manager

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

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

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

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

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

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

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

   • GoogleRidesharingConsumer.xcframework

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

CocoaPods を使用

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

   sudo gem install cocoapods
   

   詳細については、CocoaPods スタートガイドをご覧ください。

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

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

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

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

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

      cd <path-to-project>
      

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

   pod install
   

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

手動インストール

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

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

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

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

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

   • GoogleRidesharingConsumer.xcframework
   • GoogleRidesharingConsumer.bundle
   • gRPCCertificates.bundle

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

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

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

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

6. Consumer SDK をインストールするには、GoogleRidesharingConsumer.xcframework ファイルをプロジェクトの [フレームワーク、ライブラリ、埋め込みコンテンツ] にドラッグします。プロンプトが表示されたら、[アイテムをコピー] を選択します。

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

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

9. [Build Phases] タブを開き、[Link Binary with Libraries] で、まだ追加されていない場合は次のフレームワークとライブラリを追加します。

   • Accelerate.framework
   • CoreData.framework
   • CoreGraphics.framework
   • CoreImage.framework
   • CoreLocation.framework
   • CoreTelephony.framework
   • CoreText.framework
   • GLKit.framework
   • ImageIO.framework
   • libc++.tbd
   • libz.tbd
   • Metal.framework
   • OpenGLES.framework
   • QuartzCore.framework
   • SystemConfiguration.framework
   • UIKit.framework

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

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