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] を押してパッケージをプルし、[Add Package] をクリックします。
3. 特定の version をインストールするには、[Dependency Rule] フィールドをバージョン ベースのオプションのいずれかに設定します。新しいプロジェクトの場合は、最新バージョンを指定して [Exact Version] オプションを使用することをおすすめします。完了したら、[Add Package] をクリックします。

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

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

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

手動インストール

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

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

1. 次の SDK バイナリとリソース ファイルをダウンロードします。
   • GoogleMaps
   • GoogleMapsResources
   • GoogleNavigation
   • GoogleNavigationResources
2. Xcode を起動し、既存のプロジェクトを開くか、新しい プロジェクトを作成します。iOS を初めて使用する場合は、新しいプロジェクトを作成して iOS アプリ テンプレート を選択します。
3. プロジェクトから既存の Maps、Navigation、Places の参照をすべて削除します。
4. 次の XCFramework を [**Frameworks, Libraries, and Embedded Content**] の下のプロジェクトにドラッグして、Maps と 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] をオンにして、次のモードを有効にします:
   • Audio, AirPlay, and Picture in Picture
   • Location updates
10. （特定のターゲットではなく）プロジェクトを選択して、[Build Settings] タブを開きます。[Other Linker Flags] セクションで、 ‑ObjC を **debug** と **release** の両方に追加します。 これらの設定が表示されない場合は、[Build Settings] バーのフィルタを [Basic] から [All] に変更します。
11. Info.plist を開き、次の Key-Value ペアを追加します。
    • Key: NSLocationWhenInUseUsageDescription (Privacy - Location When In Use Usage Description)
      Value: "This app needs permission to use your location for turn-by-turn navigation."
    • Key: NSLocationAlwaysAndWhenInUseUsageDescription (Privacy - Location Always and When In Use Usage Description)
      Value: "This app needs permission to use your location for turn-by-turn navigation."

CocoaPods

Navigation SDK for iOS は CocoaPods ポッドとして提供されています。 CocoaPods は、Swift と Objective-C の Cocoa プロジェクトで依存関係を管理するためのオープンソース ツールです。

CocoaPods ツールがない場合は、ターミナルから以下のコマンドを実行して、macOS 上に CocoaPods ツールをインストールします。詳しくは、 CocoaPods スタートガイドをご覧ください。

sudo gem install cocoapods

Navigation SDK for iOS の Podfile を作成し、これを使用して API とその依存関係をインストールします。

1. Xcode プロジェクトをまだ作成していない場合は、ここで作成してローカルマシンに保存します iOS 開発を初めて行う場合:
   1. 新しいプロジェクトを作成する。
   2. [iOS] > [App] テンプレートを選択します。
   3. プロジェクト オプション画面で、次の操作を行います。
      1. プロジェクト名 を入力します。
      2. [Bundle identifier] フィールドの値を記録します。この値を使用して、以下の API キーを制限できます。
      3. プロジェクトのインターフェース を [Storyboard] に設定します。
      4. 言語 を Swift または Objective-C に設定します。
2. プロジェクトのディレクトリに、Podfile という名前のファイルを作成します。この ファイルでプロジェクトの依存関係を定義します。
3. Podfile を編集して、依存関係とその バージョンを追加します。 次の例では、Navigation SDK for iOS に必要な依存関係を追加しています。 # Cocoapods install reference #

   source 'https://github.com/CocoaPods/Specs.git'
   
   platform :ios, '16.0'
   
   target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
     pod 'GoogleNavigation', '10.10.0'
   end
           

   `pod outdated` を定期的に実行して、新しい バージョンを検出してください。必要に応じて、最新バージョンに アップグレードします。
4. Podfile を保存します。

5. ターミナルを開き、Podfile を含むディレクトリに移動します。

   cd <path-to-project>

6. pod install コマンドを実行します。 で指定した API とその依存関係がインストールされます。Podfile

   pod install

7. Xcode を終了し、プロジェクトの .xcworkspace ファイルを（ダブルクリックして）開いて、Xcode を起動します。これ以降、 このプロジェクトを開くには .xcworkspace ファイルを使用する必要があります。

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

1. ターミナルを開き、Podfile を含むプロジェクト ディレクトリに移動します。
2. pod update コマンドを実行します。これにより、Podfile で指定されたすべての API が最新バージョンに更新されます。

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"];