Google Maps Platform チームは定期的に SDK を更新し、新機能の追加、バグの修正、パフォーマンスの改善を行っています。このページでは、モバイル SDK への依存関係を管理する方法について説明します。
リンクするバージョンの選び方
-
ミッション クリティカルなアプリの場合、使用しているメジャー バージョンの最新のドットリリース(X.*)にリンクし、1 年ごとに新しいメジャー バージョンにアップグレードします。
アプリケーションの新しいバージョンをリリースするとき、 年間を通して、Places SDK for Android の新しいドット バージョンを使い始めることができます。新しいドット バージョンには下位互換性があるため、これによってアプリケーションのアップデートが必要となることはありません。
メリット:
- Places SDK for Android に問題が見つかった場合、 メジャー バージョンの最初のリリースから 12 か月間、 モバイル サポート に関するポリシーに準拠する必要があります。修正のメリットを得るために、互換性のない SDK バージョンへのアップグレードを急ぐ必要はありません。
- 最新の SDK バージョンをベースにアプリを制作すれば、最新の改良点や機能を容易に導入できます。
- SDK のアップデートに合わせてアプリケーションの調整、書き換え、テスティングが必要になることがありますが、SDK の最新メジャー バージョンの年次差分アップデートに対応するだけであれば、複数のメジャー バージョン リリースで導入された下位互換性のない変更に対応するよりも軽い作業で済むことが予想されます。
重要性の低いアプリの場合、任意の修正済みバージョンにリンクします。その修正済みバージョンのサポート終了の案内を受けたら、12 か月以内にアプリのコードをアップデートしてユーザーに提供開始する必要があります。
メリット:
- メンテナンス作業の頻度を下げられます。
- アプリの新バージョンで、搭載 OS の古いモバイル デバイスへの対応を維持できる期間が延びます(新しい SDK バージョンにアップグレードする必要が生じるまで)。
モニタリング対象メールアドレスを持つプロジェクト オーナー様には、各プロジェクトに影響する変更を通知で事前にお知らせしています。メジャー アップデート、サービス終了、その他の変更に関する最新情報を把握する方法
インストール
アプリレベルの build.gradle.kts
または build.gradle
ファイルで、次のように指定します。
プレフィックス範囲(+
)や latest
の代わりにバージョンを指定する方がよいでしょう。
ビルドに応用するようになっていますPlaces SDK for Android は、
セマンティック バージョニング
メジャー バージョン リリースには互換性を破る変更が含まれる場合があります。サポートされる最小 API レベルは、
21。
dependencies { // If updating kotlin-bom version number above, also edit project-level build.gradle definition of $kotlin_version variable implementation(platform("org.jetbrains.kotlin:kotlin-bom:$kotlin_version")) implementation 'com.google.android.libraries.places:places:3.3.0' }
メンテナンスとアップグレード
Android Studio では、利用可能な新しいバージョンがあるかどうかが自動的に確認され、新しいバージョンの依存関係が利用可能になると警告が表示されます。技術的問題を最小限に抑えるために、できるだけ早く最新バージョンに更新してください。新しいメジャー バージョンに更新する場合は、下位互換性のない変更とコードの更新方法をリリースノートで確認してください。
Google Cloud プロジェクト オーナーは、新しいバージョンをポーリングするだけでなく、プロジェクトに影響するかもしれない下位互換性のない変更に関するメールも受信します。下位互換性のない変更について事前に通知を受けるには、モニタリング対象メールアドレスを使用してプロジェクトごとにオーナーの役割を割り当てます。
Places SDK for Android バージョン 3.2.0 以前からアップグレードする場合
新しい SDK に移行する場合、移行の必要はありません。次の操作のみ行います。
- アプリで使用する API キーで Places API(新版)を有効にします。 詳しくは、API キーを使用するをご覧ください。
モジュール レベルの
dependencies
セクションで、build.gradle
ファイル、places
依存関係を更新するkotlin-bom
依存関係を追加します。dependencies { implementation(platform("org.jetbrains.kotlin:kotlin-bom:1.8.0")) implementation 'com.google.android.libraries.places:places:3.5.0' }
kotlin-bom
依存関係の詳細については、以下をご覧ください。 推移的依存関係での最新の kotlin-stdlib バージョンの使用。- 既存のアプリを更新して、新しい
Places.initializeWithNewPlacesApiEnabled()
メソッドを使用してアプリを初期化します。詳細については、次をご覧ください: Places API クライアントを初期化します。
既存のアプリは引き続き機能しますが、 メリットを享受できます