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] をクリックします。
4. [Choose Package Products] ウィンドウで、GoogleMaps（バージョン 9.0.0 より前の場合は GoogleMaps、GoogleMapsBase、GoogleMapsCore）が指定した main ターゲットに追加されることを確認します。完了したら、[Add Package] をクリックします。
5. インストールを確認するには、ターゲットの [General] ペインに移動します。[Frameworks, Libraries, and Embedded Content] に、インストールされたパッケージが表示されます。 [Project Navigator] の [Package Dependencies] セクションで、パッケージとそのバージョンを確認することもできます。

既存のプロジェクトの 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. インストールを確認するには、[Project Navigator] の [Package Dependencies] セクションに移動して、パッケージとそのバージョンを確認します。

CocoaPods を使用して追加された既存の Maps SDK for iOS の依存関係を削除する手順は次のとおりです。

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

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

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

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 を含む XCFrameworks をプロジェクトに手動で追加し、Xcode でビルド設定を構成する方法について説明します。XCFramework は、Apple シリコンを使用するマシンを含む複数のプラットフォームで使用するバイナリ パッケージです。

1. 次の SDK バイナリとリソース ファイルをダウンロードします。
   • GoogleMaps
   • GoogleMapsResources
2. ファイルを解凍して、XCFrameworks とリソースにアクセスします。
3. Xcode プロジェクトがまだない場合は、ここで作成してローカルマシンに保存します。iOS 開発を初めて行う場合:
   1. 新しいプロジェクトを作成する。
   2. [iOS] > [App] テンプレートを選択します。
   3. プロジェクト オプション画面で、次の操作を行います。
      1. [プロジェクト名] を入力します。
      2. [Bundle identifier] フィールドの値を記録します。 この値を使用して、API キーを制限できます。
      3. プロジェクトの [Interface] を [Storyboard] に設定します。
      4. [Language] を [Swift] または [Objective-C] に設定します。
4. [全般] タブを開きます。次の XCFrameworks を、[Frameworks, Libraries, and Embedded Content] のプロジェクトにドラッグします。[埋め込まない] を選択してください。
   • 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] セクションで、[Debug] と [Release] に -ObjC を追加します。これらの設定が表示されない場合は、[Build Settings] バーのフィルタを [Basic] から [All] に変更します。

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

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