Xcode プロジェクトを設定する

Swift Package Manager

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

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

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

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

1. Xcode で、[File] > [Packages] > [Update To Latest Package Versions] の順に移動します。
2. インストールを確認するには、プロジェクト ナビゲータの [Package Dependencies] セクションに移動して、パッケージとそのバージョンを確認します。

1. Xcode プロジェクトの構成設定で、[フレームワーク、ライブラリ、埋め込みコンテンツ] を見つけます。マイナス記号（-）を使用して、次のフレームワークを削除します。
   • GoogleMaps.xcframework
   • GoogleNavigation.xcframework
2. Xcode プロジェクトの最上位ディレクトリから、GoogleMaps バンドルを削除します。

手動インストール

このガイドでは、Navigation SDK for iOS と Maps SDK for iOS を含む XCFrameworks をプロジェクトに手動で追加し、Xcode でビルド設定を構成する方法を説明します。XCFramework は、M1 チップセットを使用するマシンを含む複数のプラットフォームで使用できるバイナリ パッケージです。

Navigation SDK for iOS と Maps SDK for iOS の XCFrameworks をインストールする手順は次のとおりです。

1. 次の SDK バイナリとリソース ファイルをダウンロードします。
   • GoogleMaps
   • GoogleMapsResources
   • GoogleNavigation
   • GoogleNavigationResources
2. Xcode を起動し、既存のプロジェクトを開くか、新しいプロジェクトを作成します。iOS を初めて使用する場合は、新しいプロジェクトを作成し、iOS アプリ テンプレートを選択します。
3. プロジェクトから既存の Maps、Navigation、Places の参照をすべて削除します。
4. 次の XCFramework を [Frameworks, Libraries, and Embedded Content] の下のプロジェクトにドラッグして、Maps SDK と Navigation SDK の両方をインストールします（プロンプトが表示されたら、[Copy items if needed] を選択します）。
   • GoogleMaps.xcframework
   • GoogleNavigation.xcframework
5. ダウンロードした GoogleMapsResources から GoogleMaps.bundle を Xcode プロジェクトの最上位ディレクトリにドラッグします。プロンプトが表示されたら、[Copy items if needed] が選択されていることを確認します。
6. ダウンロードした GoogleNavigationResources から GoogleNavigation.bundle を Xcode プロジェクトの最上位ディレクトリにドラッグします。プロンプトが表示されたら、[Copy items into destination group's folder] が選択されていることを確認します。
7. プロジェクト ナビゲータで目的のプロジェクトを選択し、アプリのターゲットを選択します。
8. [Build Phases] タブを開き、[Link Binary with Libraries] 内に次のフレームワークとライブラリを追加します。
   • Accelerate.framework
   • AudioToolbox.framework
   • AVFoundation.framework
   • CarPlay.framework
   • Contacts.framework
   • CoreData.framework
   • CoreGraphics.framework
   • CoreImage.framework
   • CoreLocation.framework
   • CoreTelephony.framework
   • CoreText.framework
   • GLKit.framework
   • ImageIO.framework
   • libc++.tbd
   • libxml2.tbd
   • libz.tbd
   • MapKit.framework
   • Metal.framework
   • OpenGLES.framework
   • QuartzCore.framework
   • Security.framework
   • SystemConfiguration.framework
   • UIKit.framework
   • UserNotifications.framework
   • WebKit.framework
9. アプリのターゲットで [Capabilities] タブを選択し、[Background Modes] をオンにして、次のモードを有効にします。
   • 音声、AirPlay、ピクチャー イン ピクチャー
   • 位置情報の更新
10. （特定のターゲットではなく）プロジェクトを選択して、[Build Settings] タブを開きます。[Other Linker Flags] セクションで、デバッグとリリースの両方に ‑ObjC を追加します。これらの設定が表示されない場合は、[Build Settings] バーのフィルタを [Basic] から [All] に変更します。
11. Info.plist を開き、次の Key-Value ペアを追加します。
    • キー: NSLocationWhenInUseUsageDescription（プライバシー - 使用中の位置情報の使用状況の説明）
      値: 「このアプリは、ターンバイターン ナビゲーションに位置情報を使用するための権限を必要とします。」
    • キー: NSLocationAlwaysAndWhenInUseUsageDescription（プライバシー - 位置情報の常時と使用中の使用目的の説明）
      値: 「このアプリは、ターンバイターン ナビゲーションに位置情報を使用するための権限を必要とします。」

Swift

次のように、API キーを AppDelegate.swift に追加します。

1. 次の import ステートメントを追加します。

   import GoogleMaps
   import GoogleNavigation

2. application(_:didFinishLaunchingWithOptions:) メソッドに以下を追加します。

   GMSServices.provideAPIKey("YOUR_API_KEY")

Objective-C

次のように、API キーを AppDelegate.m に追加します。

1. 次の import ステートメントを追加します。

   @import GoogleMaps;
   @import GoogleNavigation;

2. application:didFinishLaunchingWithOptions: メソッドに以下を追加します。

   [GMSServices provideAPIKey:@"YOUR_API_KEY"];