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

Swift Package Manager

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

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

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

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

1. 9.0.0 より前のバージョンからアップグレードする場合: アップグレード後に、GoogleMapsBase、GoogleMapsCore、およびGoogleMapsM4B の依存関係を削除する必要があります。 GoogleMaps の依存関係は削除しないでください。詳細については、 バージョン 9.0.0 のリリースノートをご覧ください。

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

   • GoogleMapsBase（9.0.0 より前のバージョンからアップグレードする場合のみ）
   • GoogleMapsCore（9.0.0 より前のバージョンからアップグレードする場合のみ）
   • GoogleMapsM4B（9.0.0 より前のバージョンからアップグレードする場合のみ）
2. Xcode で、[File] > [Packages] > [Update To Latest Package Versions] に移動します。
3. インストールを確認するには、[Package Dependencies] セクションの [Project Navigator] に移動して、パッケージとそのバージョンを確認します。

既存の Maps SDK for iOS の依存関係を削除する手順は次のとおりです。CocoaPods

1. Xcode ワークスペースを閉じます。ターミナルを開き、次のコマンドを実行します。

   sudo gem install cocoapods-deintegrate cocoapods-clean
   pod deintegrate
   pod cache clean --all

2. Podfile、Podfile.resolved、Xcode の workspace を CocoaPods 以外の用途で使用していない場合は、削除します。

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

手動インストール

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

1. 次の SDK バイナリとリソース ファイルをダウンロードします。
   • GoogleMaps
   • GoogleMapsResources
2. ファイルを抽出して、XCFramework とリソースにアクセスします。
3. Xcode プロジェクトをまだ作成していない場合は、ここで作成してローカルマシンに保存します iOS アプリを初めて開発する場合は、次の手順を行います。
   1. 新しいプロジェクトを作成する。
   2. [iOS > App] テンプレートを選択します。
   3. プロジェクト オプション画面で、次の操作を行います。
      1. プロジェクト名 を入力します。
      2. [Bundle identifier] フィールドの値を記録します。この値を使用して、後で API キーを制限できます。
      3. プロジェクトの [Interface] を [Storyboard] に設定します。
      4. [Language] を [Swift] または [Objective-C] に設定します。
4. [General] タブを開きます。次の XCFramework をプロジェクト の [Frameworks, Libraries, and Embedded Content] の下にドラッグします。[**Do Not Embed**] を選択してください。
   • GoogleMaps.xcframework
5. ダウンロードした GoogleMapsResources から GoogleMaps.bundle をコピーして、Xcode プロジェクトの最上位ディレクトリに貼り付けます。プロンプトが表示されたら、[Copy items into destination group's folder] を選択してください。
6. プロジェクト ナビゲータで目的のプロジェクトを選択し、アプリのターゲットを選択します。
7. アプリのターゲットの [Build Phases] タブを開きます。
   [Link Binary with Libraries] で、次のフレームワークとライブラリを追加します。
   • Accelerate.framework
   • Contacts.framework
   • CoreData.framework
   • CoreGraphics.framework
   • CoreImage.framework
   • CoreLocation.framework
   • CoreTelephony.framework
   • CoreText.framework
   • GLKit.framework
   • ImageIO.framework
   • libc++.tbd
   • libz.tbd
   • Metal.framework
   • MetricKit.framework
   • OpenGLES.framework（OpenGL を使用している場合のみ）
   • QuartzCore.framework
   • Security.framework
   • SystemConfiguration.framework
   • UIKit.framework

8. （特定のターゲットではなく）プロジェクトを選択して、 [Build Settings] タブを開きます。[Linking - General -> Other Linker Flags] セクションで、-ObjC を [Debug] と [Release] に追加します。これらの設定が表示されない場合は、[Build Settings] バーのフィルタを [Basic] から [All] に変更します。

9. Places SDK for iOS XCFramework をインストールするには、 スタートガイド をご覧ください。

CocoaPods

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

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

sudo gem install cocoapods

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

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

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

   `pod outdated` を定期的に実行して、新しい バージョンがあるかどうかを検出して、常に最新バージョンを使用していることを確認します。必要に応じて、 最新バージョンにアップグレードします。
4. Podfile を保存します。

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

   cd <path-to-project>

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

   pod install

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

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

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

Swift

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

1. 以下のインポート文を追加します。

   import GoogleMaps

2. API キーを使用して、次のコードを application(_:didFinishLaunchingWithOptions:) メソッドに追加します。

   GMSServices.provideAPIKey("YOUR_API_KEY")

3. Places API も使用している場合は、次のようにキーを再度追加します。

   GMSPlacesClient.provideAPIKey("YOUR_API_KEY")

Objective-C

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

1. 以下のインポート文を追加します。

   @import GoogleMaps;

2. API キーを使用して、次のコードを application:didFinishLaunchingWithOptions: メソッドに追加します。

   [GMSServices provideAPIKey:@"YOUR_API_KEY"];

3. Places API も使用している場合は、次のようにキーを再度追加します。

   [GMSPlacesClient provideAPIKey:@"YOUR_API_KEY"];