このページは Cloud Translation API によって翻訳されました。

バージョン

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

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

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

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

1 年を通してアプリケーションの新しいバージョンをリリースする際には、Maps SDK for iOS の新しいバージョンを使用する必要があります。新しいドットバージョンは下位互換性があるため、アプリで更新する必要はありません。

メリット:
- Maps SDK for iOS で問題が見つかった場合、メジャーバージョンの最初のリリースから 12 か月間、モバイルサポートポリシーに従って修正が行われます。修正した恩恵を受けるために、互換性のない SDK バージョンに今すぐアップグレードする必要はありません。
- すでに最新バージョンでビルド済みのアプリの場合、最新の改善と機能を簡単に導入できます。
- 最新のメジャーバージョンの SDK を年 1 回更新すると、アプリのメジャーアップデート、書き換え、テストの手間が軽減され、複数のメジャーバージョンのリリースにまたがる下位互換性のない変更に対処する必要がなくなります。
重要性の低いアプリの場合: 任意の修正済みバージョンにリンクします。その修正済みバージョンのサポート終了の案内を受けたら、12 か月以内にアプリのコードをアップデートしてユーザーに提供開始する必要があります。

メリット:
- メンテナンス作業の頻度が下がります。
- アプリの新しいバージョンが引き続きユーザーをサポートします。古いモバイルオペレーティングシステムを長時間実行しているデバイスは（新しい SDK バージョンへのアップグレードが必要になるまで）。

モニタリング対象メールアドレスを持つプロジェクトオーナー様には、各プロジェクトに影響する変更を通知で事前にお知らせしています。メジャーアップデート、サービス終了、その他の変更に関する最新情報を把握する方法

インストール

楽観的な演算子（~>）を使用する代わりに、必ず依存関係にバージョン番号を指定してください。そうしないと、ビルドが予測不能または繰り返し不能になる可能性があります。Maps SDK for iOS はセマンティックバージョニングに則っており、新たなメジャーバージョンリリースには破壊的変更が含まれます。

CocoaPods を使用する

Podfile 構文を使用した Podfile の依存関係の例:

source 'https://github.com/CocoaPods/Specs.git'

platform :ios, '13.0'

target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
  pod 'GoogleMaps', '7.1.0'
end

Carthage の使用

Cartfile 構文を使用した Cartfile 依存関係の例:

binary "https://dl.google.com/geosdk/GoogleMaps.json" == 6.2.1

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

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

CocoaPods の使用

ターミナルを開き、Podfile を含むディレクトリに移動します。
```
cd <path-to-project>
```
pod outdated を実行して、Maps SDK for iOS の新しいバージョンが利用可能かどうかを確認します。
より新しいバージョンの SDK が見つかった場合は、その新しいバージョンで Podfile を更新します。 Podfile で特定のバージョンを設定する方法については、Pod バージョンの指定をご覧ください。
pod update を実行します。
アップグレードの結果、必要な変更を行います。各リリースにおける変更点の一覧については、リリースノートをご覧ください。
[Product > Clean]、[Product > Build] の順に選択して、プロジェクトのクリーンアップと再ビルドを行います。

Carthage の使用

ターミナルを開き、Podfile を含むディレクトリに移動します。
```
cd <path-to-project>
```
carthage outdated を実行して、Maps SDK for iOS の新しいバージョンが利用可能かどうかを確認します。
より新しいバージョンの SDK が見つかった場合は、その新しいバージョンで Cartfile を更新します。 Cartfile で特定のバージョンを設定する方法については、バージョンの要件をご覧ください。
carthage update を実行します。
アップグレードの結果、必要な変更を行います。各リリースにおける変更点の一覧については、リリースノートをご覧ください。
[Product > Clean]、[Product > Build] の順に選択して、プロジェクトのクリーンアップと再ビルドを行います。

手動

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

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