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

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 バージョンをベースにアプリを制作すれば、最新の改良点や機能を容易に導入できます。
- SDK のアップデートに合わせてアプリケーションの調整、書き換え、テスティングが必要になることがありますが、SDK の最新メジャーバージョンの年次差分アップデートに対応するだけであれば、複数のメジャーバージョンリリースで導入された下位互換性のない変更に対応するよりも軽い作業で済むことが予想されます。
重要性の低いアプリの場合、任意の修正済みバージョンにリンクします。その修正済みバージョンのサポート終了の案内を受けたら、12 か月以内にアプリのコードをアップデートしてユーザーに提供開始する必要があります。

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

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

インストール

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

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 クライアントを初期化するをご覧ください。

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