Places SDK for Android のバージョン

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

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

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

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

    メリット:

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

    メリット:

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

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

インストール

アプリレベルの build.gradle.kts または build.gradle ファイルでは、接頭辞の範囲(+)または latest ではなく、必ずバージョンを指定してください。そうしないと、ビルドが予測不能または繰り返し不能になる可能性があります。Places SDK for Android はセマンティック バージョニングに則っており、新たなメジャー バージョンのリリースには破壊的変更が含まれる場合があります。サポートされる最低 API レベルは 24 です。

dependencies {

    // Places and Maps SDKs
    implementation("com.google.android.libraries.places:places:6.0.2")
}

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

Android Studio では、利用可能な新しいバージョンがあるかどうかが自動的に確認され、新しいバージョンの依存関係が利用可能になると警告が表示されます。技術的問題を最小限に抑えるために、できるだけ早く最新バージョンに更新してください。新しいメジャー バージョンに更新する場合は、下位互換性のない変更とコードの更新方法をリリースノートで確認してください。

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

Places SDK for Android バージョン 3.2.0 以前からアップグレードする場合

新しい SDK に移行する際に、移行作業は必要ありません。必要な作業は次のとおりです。

  1. アプリで使用する API キーで Places API(新版)を有効にします。詳しくは、API キーの使用をご覧ください。
  2. モジュール レベルの build.gradle ファイルの dependencies セクションで、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 バージョンの使用をご覧ください。

  3. 既存のアプリを更新して、新しい Places.initializeWithNewPlacesApiEnabled() メソッドを呼び出してアプリを初期化します。詳しくは、Places API クライアントを初期化するをご覧ください。

既存のアプリは変更なしで引き続き動作しますが、新しい SDK のすべての機能を利用できるようになりました。