Maps SDK for iOS のバージョン

プラットフォームを選択: Android iOS JavaScript

Google Maps Platform チームは定期的に SDK を更新し、新機能の追加、バグの修正、パフォーマンスの改善を行っています。このページでは、モバイル SDK への依存関係を管理する方法について説明します。

リンクするバージョンの選び方

• ミッション クリティカルなアプリの場合、使用しているメジャー バージョンの最新のドットリリース（X.*）にリンクし、1 年ごとに新しいメジャー バージョンにアップグレードします。

  年間を通じてアプリケーションの新バージョンをリリースする際に、Maps SDK for iOS の新しいドット バージョンを使い始めても問題ありません。新しいドット バージョンには下位互換性があるため、これによってアプリケーションのアップデートが必要となることはありません。

  メリット:

  • Maps SDK for iOS に問題が見つかっても、モバイル サポート ポリシーの規定により、該当メジャー バージョンの最初のリリースから 12 か月間は、下位互換性を保った方法で修正が提供されます。修正のメリットを得るために、互換性のない SDK バージョンへのアップグレードを急ぐ必要はありません。
  • 最新バージョンをベースにアプリを制作すれば、最新の改良点や機能を容易に導入できます。
  • SDK の最新メジャー バージョンへの年次増分アップデートに対応するだけであれば、アプリケーションの調整、書き換え、テストに必要な作業は、複数のメジャー バージョン リリースで導入された下位互換性のない変更に対応するよりも少なくて済むことが予想されます。

• 重要性の低いアプリの場合、任意の修正済みバージョンにリンクします。その修正済みバージョンのサポート終了の案内を受けたら、12 か月以内にアプリのコードをアップデートしてユーザーに提供開始する必要があります。

  メリット:

  • メンテナンス作業の頻度を下げられます。
  • アプリの新バージョンで、搭載 OS の古いモバイル デバイスへの対応を維持できる期間が延びます（新しい SDK バージョンにアップグレードする必要が生じるまで）。

モニタリング対象メールアドレスを持つプロジェクト オーナー様には、各プロジェクトに影響する変更を通知で事前にお知らせしています。大規模アップデート、非推奨などの変更に関する最新情報をご確認いただきますようお願いいたします。

インストール

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] オプションを使用することをおすすめします。完了したら、[パッケージを追加] をクリックします。
4. [Choose Package Products] ウィンドウで、GoogleMaps（バージョン 9.0.0 より前の場合は GoogleMaps、GoogleMapsBase、GoogleMapsCore）が指定した main ターゲットに追加されることを確認します。完了したら、[パッケージを追加] をクリックします。
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] セクションに移動して、パッケージとそのバージョンを確認します。

重要: アーティファクトを解決できない場合や、エラーが発生する場合があります。その場合は、[File] > [Packages] > [Reset Package Cache] を選択します。

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 を削除します。

メンテナンスとアップグレード

最新の改善点を取り入れてビルドするには、定期的に新しいバージョンを確認し、バージョン仕様を更新してください。新しいメジャー バージョンに更新する場合は、下位互換性のない変更とコードの更新方法をリリースノートで確認してください。

Swift Package Manager

To update the package for an existing project, follow these steps:

  

    
    
    

      To verify your installation, go to the Package Dependencies section of Project Navigator
      to verify the package and its version.
    
  
  
  

    Important: Sometimes, artifacts cannot be resolved or errors can occur, 
    in this case select "File > Packages > Reset Package Cache".
  

手動インストール

SDK のインストールで最新のソースファイルへのリンクを取得します。

Google Cloud プロジェクト オーナーは、新しいバージョンをポーリングするだけでなく、プロジェクトに影響するかもしれない下位互換性のない変更に関するメールも受信します。下位非互換性のある変更についてパーソナル通知を受け取るには、モニタリング対象メールアドレスを使用して、プロジェクトごとにオーナーのロールを割り当てます。