Android 14 にアプリを移行する

このドキュメントでは、一般的な開発段階とテスト段階について概説し、プラットフォームのリリース スケジュールに沿って準備計画を立てるために役立つ情報を紹介します。それにより、Android 14 を使用するユーザーに快適なエクスペリエンスを提供できます。

Google は、Android をリリースするたびに、Android の利便性、安全性、パフォーマンスを高めることを目的とした新機能と動作変更を導入しています。多くの場合、アプリはそのままでも想定どおりに動作しますが、プラットフォームの変更に対応するためにアプリの更新が必要になる場合もあります。

AOSP(Android オープンソース プロジェクト)にソースコードがリリースされると、ユーザーはすぐに新しいプラットフォームの入手を開始できるので、それに向けて準備しておくことが重要です。アプリがユーザーの期待どおりに動作するだけでなく、新しい機能と API で新しいプラットフォームを最大限に活用できるようにするのが理想的です。

一般的な移行には、同時に進行できる次の 2 つの段階があります。

  • アプリの互換性を確認する(Android 14 の最終リリースまでに完了)
  • 新しいプラットフォームの機能と API をターゲットに設定する(最終リリース後、できるだけ早く完了)

Android 14 との互換性を確認する

既存のアプリの機能を Android 14 でテストすることは、Android の最新版にアップデートするユーザーに優れたエクスペリエンスを提供するために重要です。プラットフォームの変更の一部が、アプリの動作に影響を及ぼすことがあるので、早期に十分にテストして、アプリに必要な調整を行うことが重要です。

通常は、アプリの targetSdkVersion は変更せずに、アプリを調整して、アップデートを公開できます。同様に、新しい API の使用や、アプリの compileSdkVersion の変更は必須ではありません。ただし、アプリの構築方法や使用しているプラットフォームの機能に応じて状況は異なります。

テストを開始する前に、すべてのアプリの動作変更を必ず確認するようにしてください。これらの変更は、targetSdkVersion を変更しない場合もアプリに影響する可能性があります。

Android 14 を入手する

Android 14 システム イメージをデバイスに書き込むか、Android Emulator 用のシステム イメージをダウンロードします。

変更を確認する

システムの動作変更を確認して、アプリが影響を受ける可能性がある領域を特定します。

テスト

デバイスまたはエミュレータにアプリをインストールして、テストを実施します。システムの動作変更に重点を置き、すべてのアプリフローを実行します。

更新

動作変更への対応または問題の解決に必要なコード変更のみを行います。アプリが元来ターゲットとしていた API レベルで再コンパイルします。Android 14 をターゲットに設定する必要はありません。

公開

Android App Bundle または APK に署名し、アップロードし、公開します。

互換性テストを実施する

Android 14 の互換性テストのほとんどの部分は、通常のアプリテストと同様です。この段階で、アプリの中核品質ガイドラインテストに関するベスト プラクティスを確認することをおすすめします。

テストするには、Android 14 を搭載したデバイスに現在公開中のアプリをインストールし、すべてのフローと機能を実行して問題を探します。テストの対象を絞り込めるように、Android 14 で導入されたすべてのアプリの動作変更のうち、アプリの機能に影響するものとアプリのクラッシュを引き起こすものを確認します。

また、制限対象の非 SDK インターフェースを使用しているかどうかを確認し、テストします。アプリが使用している制限付きインターフェースは、すべて公開 SDK または NDK の同等のインターフェースに置き換える必要があります。こうしたアクセスを示す logcat 警告に注意し、StrictMode メソッド detectNonSdkApiUsage() を使用して、プログラムによって特定します。

最後に、アプリ内のライブラリと SDK の完全なテストを行い、Android 14 で想定どおりに動作することを確認します。また、プライバシー、パフォーマンス、UX、データ処理、権限に関するベスト プラクティスを適用します。問題が見つかった場合は、SDK を最新バージョンにアップデートするか、SDK のデベロッパーに対処方法を問い合わせます。

テストが完了し、必要な更新を加えた後は、互換性のあるアプリを速やかに公開することをおすすめします。これにより、ユーザーはアプリを早期にテストでき、Android 14 にアップデートする際にスムーズに移行できます。

アプリのターゲティングを更新し、新しい API でビルドする

互換性のあるバージョンのアプリを公開した後、次のステップとして、targetSdkVersion を更新することにより Android 14 の完全なサポートを追加し、Android 14 の新しい API と機能を利用できるようにします。新しいプラットフォームをターゲットに設定するための Google Play の要件を確認し、準備ができ次第、この更新を行うことができます。

Android 14 の完全なサポートに向けた作業を計画するにあたっては、Android 14 をターゲットとするアプリに影響する動作変更を確認します。これらのターゲット固有の動作変更によって機能的な問題が発生し、対処が必要になる場合があります。場合によっては大規模な開発が必要になるため、できるだけ早く確認して対処することをおすすめします。アプリに影響する動作変更を特定するため、互換性の切り替えで選択した変更を有効にしてアプリをテストできます。

Android 14 を完全にサポートする手順は次のとおりです。

Android 14 SDK を入手する

Android 14 でビルドするため、Android Studio プレビューの最新バージョンをインストールします。Android 14 のデバイスまたはエミュレータを用意します。
targetSdkVersion およびその他のビルド構成を更新します。

動作変更を確認する

Android 14 をターゲットとするアプリに適用される動作変更を確認します。アプリが影響を受ける領域を特定し、それに対応する方法を計画します。

プライバシーに関する新しい変更をチェックする

Android 14 のユーザー プライバシーに関する変更に対応するために必要な変更をコードとアーキテクチャに加えます。

Android 14 の機能を導入する

Android 14 の API を利用して、アプリに新しい機能を組み込みます。Android 14 に向けて再コンパイルします。

テスト

Android 14 のデバイスまたはエミュレータでテストします。動作変更がアプリに影響する可能性がある領域に集中して、新しい API を使用する機能を試します。プラットフォームと API に関するフィードバックを送信します。プラットフォーム、API、サードパーティの SDK に関する問題を報告します。

最終更新を行う

Android 14 の API 最終版が提供された時点で、targetSdkVersion およびその他のビルド構成をもう一度更新し、追加の更新を行って、アプリをテストします。

公開

Android App Bundle または APK に署名し、アップロードし、公開します。

SDK を入手し、ターゲット設定を変更し、新しい API を使ってビルドする

Android 14 の完全なサポートのテストを開始するには、Android Studio の最新プレビュー版を使用して、Android 14 SDK とその他の必要なツールをダウンロードします。次に、アプリの targetSdkVersioncompileSdkVersion を更新し、アプリを再コンパイルします。詳しくは、SDK 設定ガイドをご覧ください。

Android 14 アプリをテストする

アプリをコンパイルして Android 14 搭載デバイスにインストールした後、Android 14 をターゲットに設定したときにアプリが正しく動作することを確認します。動作変更の中には、アプリが新しいプラットフォームをターゲットとする場合にのみ適用されるものがあります。テストを開始する前に、そのような変更を確認してください。

基本的な互換性テストを行う場合と同様に、すべてのフローと機能を実行して問題を探します。Android 14 をターゲットとするアプリに影響する動作変更に重点を置いてテストを行います。この段階で、アプリの中核品質ガイドラインテストに関するベスト プラクティスに対するアプリの対応状況をチェックすることをおすすめします。

制限対象となる非 SDK インターフェースを使用しているかどうかをテストして確認してください。こうしたアクセスを示す logcat 警告に注意し、StrictMode メソッド detectNonSdkApiUsage() を使用して、プログラムによって特定します。

最後に、アプリ内のライブラリと SDK を完全にテストして、Android 14 で想定どおりに動作することを確認します。また、プライバシー、パフォーマンス、UX、データ処理、権限に関するベスト プラクティスに従ってください。問題が見つかった場合は、SDK を最新バージョンにアップデートするか、SDK のデベロッパーに対処方法を問い合わせます。

アプリの互換性切り替えを使用してテストする

Android 14 は互換性の切り替えに対応しており、ターゲット固有の動作変更についてアプリを簡単にテストできます。デバッグ可能なアプリでは、この切り替えによって次のことが可能になります。

  • アプリの targetSdkVersion を実際には変更せずに、ターゲット固有の変更をテストする。切り替えを使用して、特定のターゲット固有の動作変更を強制的に有効にし、既存のアプリに対する影響を評価できます。
  • 特定の変更にテストを集中させる。切り替えを使用することで、テスト対象以外のターゲット固有の変更をすべて無効にできます。これにより、一度にすべてのターゲット固有の変更に対処する必要がなくなります。
  • adb を介して切り替えを管理する。adb コマンドを使用すると、切り替え可能な変更を自動テスト環境で有効または無効にできます。
  • 標準の変更 ID を使用して迅速にデバッグする。切り替え可能な変更にはそれぞれ一意の ID と名前が付けられており、ログ出力から問題の根本原因を速やかにデバッグできます。

アプリのターゲット設定を変更する場合や、Android 14 のサポートに向けて開発を行っているときは、この切り替え機能が役立ちます。詳細については、互換性フレームワークの変更(Android 14)をご覧ください。