Android 13 にアプリを移行する

このドキュメントでは、一般的な開発フェーズとテストフェーズの概要を説明します。これにより、プラットフォームのリリース スケジュールに合わせて準備計画を立て、Android 13 のユーザーに優れたエクスペリエンスを提供できます。

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

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

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

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

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

既存のアプリの機能を Android 13 でテストすることは、Android の最新版にアップデートするユーザーに優れたエクスペリエンスを提供するために重要です。プラットフォームの変更によってアプリの動作に影響する可能性があるため、早い段階で徹底的にテストを行い、アプリに必要な調整を加えることが重要です。

通常は、アプリの targetSdkVersion を変更せずに、アプリを調整してアップデートを公開できます。同様に、新しい API の使用や、アプリの compileSdkVersion の変更も必要ありません。ただし、これはアプリのビルド方法や使用しているプラットフォームの機能によって異なります。

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

Android 13 を入手する

Android 13 システム イメージをデバイスにフラッシュするか、Android Emulator 用のシステム イメージをダウンロードします。

変更を確認する

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

テスト

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

更新

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

公開する

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

互換性テストを実施する

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

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

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

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

テストが完了し、変更を加えたら、互換性のあるアプリを直ちに公開することをおすすめします。これにより、ユーザーはアプリを早期にテストでき、Android 13 にアップデートする際にスムーズに移行できます。

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

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

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

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

Android 13 SDK を入手する

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

動作変更を確認する

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

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

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

Android 13 の機能を導入する

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

テスト

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

最終更新を行う

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

公開する

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

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

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

Android 13 アプリをテストする

アプリをコンパイルして Android 13 を搭載したデバイスにインストールしたら、Android 13 をターゲットとする場合にアプリが正しく動作することを確認します。一部の動作変更は、アプリが新しいプラットフォームをターゲットにしている場合にのみ適用されるため、開始する前にそれらの変更を確認する必要があります。

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

該当する可能性がある制限付きの非 SDK インターフェースの使用を確認し、テストしてください。このようなアクセスを示す logcat 警告に注意し、StrictMode メソッド detectNonSdkApiUsage() を使用して、プログラムによって特定します。

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

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

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

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

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