Google は AI 技術を使用して、コンテンツをご希望の言語に翻訳しています。AI 翻訳には誤りが含まれる場合があります。

動作の変更点: Android 15 以上をターゲットとするアプリ

これまでのリリースと同様、Android 15 には、アプリに影響する可能性がある動作変更が含まれています。下記の動作変更は、Android 15 以上をターゲットとするアプリにのみ適用されます。アプリが Android 15 以上をターゲットとする場合は、必要に応じてアプリを変更し、下記の動作に適切に対応できるようにしてください。

アプリの targetSdkVersion に関係なく、Android 15 で実行されるすべてのアプリに影響する動作変更のリストも必ずご確認ください。

コア機能

Android 15 では、Android システムのさまざまなコア機能が変更または拡張されています。

フォアグラウンドサービスに関する変更

We are making the following changes to foreground services with Android 15.

Data sync foreground service timeout behavior
New media processing foreground service type
Restrictions on BOOT_COMPLETED broadcast receivers launching foreground services
Restrictions on starting foreground services while an app holds the SYSTEM_ALERT_WINDOW permission

Data sync foreground service timeout behavior

Android 15 では、Android 15（API レベル 35）以降をターゲットとするアプリに対して、dataSync に新しいタイムアウト動作が導入されます。この動作は、新しい mediaProcessing フォアグラウンドサービスタイプにも適用されます。

システムは、アプリの dataSync サービスを 24 時間以内に合計 6 時間実行することを許可します。その後、システムは実行中のサービスの Service.onTimeout(int, int) メソッド（Android 15 で導入）を呼び出します。この時点で、サービスは Service.stopSelf() を呼び出すために数秒間待機します。Service.onTimeout() が呼び出されると、サービスはフォアグラウンドサービスと見なされなくなります。サービスが Service.stopSelf() を呼び出さない場合、システムは内部例外をスローします。例外は Logcat に次のメッセージとともに記録されます。

Fatal Exception: android.app.RemoteServiceException: "A foreground service of
type dataSync did not stop within its timeout: [component name]"

この動作の変更による問題を回避するには、次のいずれかを行います。

サービスに新しい Service.onTimeout(int, int) メソッドを実装します。アプリがコールバックを受信したら、数秒以内に stopSelf() を呼び出します。（アプリをすぐに停止しないと、システムは障害を生成します）。
アプリの dataSync サービスが、24 時間で合計 6 時間を超えて実行されていないことを確認します（ユーザーがアプリを操作してタイマーをリセットする場合を除きます）。
dataSync フォアグラウンドサービスは、直接のユーザー操作の結果としてのみ起動します。サービスの開始時にアプリはフォアグラウンドにあるため、サービスはバックグラウンドに移行してから 6 時間すべてかかります。
dataSync フォアグラウンドサービスを使用する代わりに、代替の API を使用してください。

アプリの dataSync フォアグラウンドサービスが過去 24 時間以内に 6 時間実行されている場合、ユーザーがアプリをフォアグラウンドに表示した（これによりタイマーがリセットされる）場合を除き、別の dataSync フォアグラウンドサービスを開始することはできません。別の dataSync フォアグラウンドサービスを開始しようとすると、システムは ForegroundServiceStartNotAllowedException をスローし、「フォアグラウンドサービスタイプ dataSync の制限時間はすでに経過しています」などのエラーメッセージを出力します。

テスト

アプリの動作をテストするには、アプリが Android 15 をターゲットとしていない場合でも、データ同期のタイムアウトを有効にできます（アプリが Android 15 デバイスで実行されている場合）。タイムアウトを有効にするには、次の adb コマンドを実行します。

adb shell am compat enable FGS_INTRODUCE_TIME_LIMITS your-package-name

タイムアウト期間を調整して、上限に達したときアプリの動作を簡単にテストすることもできます。新しいタイムアウト期間を設定するには、次の adb コマンドを実行します。

adb shell device_config put activity_manager data_sync_fgs_timeout_duration duration-in-milliseconds

New media processing foreground service type

Android 15 では、新しいフォアグラウンドサービスタイプ mediaProcessing が導入されています。このサービスタイプは、メディアファイルのコード変換などのオペレーションに適しています。たとえば、メディアアプリが音声ファイルをダウンロードし、再生する前に別の形式に変換する必要がある場合があります。mediaProcessing フォアグラウンドサービスを使用すると、アプリがバックグラウンドにあっても変換を続行できます。

システムは、アプリの mediaProcessing サービスを 24 時間以内に合計 6 時間実行することを許可します。その後、システムは実行中のサービスの Service.onTimeout(int, int) メソッド（Android 15 で導入）を呼び出します。この時点で、サービスは Service.stopSelf() を呼び出すために数秒間待機します。サービスが Service.stopSelf() を呼び出さない場合、システムは内部例外をスローします。例外は Logcat に次のメッセージとともに記録されます。

Fatal Exception: android.app.RemoteServiceException: "A foreground service of
type mediaProcessing did not stop within its timeout: [component name]"

この例外を回避するには、次のいずれかを行います。

サービスに新しい Service.onTimeout(int, int) メソッドを実装します。アプリがコールバックを受信したら、数秒以内に stopSelf() を呼び出します。（アプリをすぐに停止しないと、システムは障害を生成します）。
アプリの mediaProcessing サービスが 24 時間以内に合計 6 時間を超えて実行されないようにします（ユーザーがアプリを操作してタイマーをリセットする場合を除く）。
mediaProcessing フォアグラウンドサービスは、ユーザーが直接操作した結果としてのみ開始します。サービスが開始されたときにアプリはフォアグラウンドにあるため、アプリがバックグラウンドに移動した後も 6 時間間サービスは実行されます。
mediaProcessing フォアグラウンドサービスを使用する代わりに、WorkManager などの代替 API を使用してください。

アプリの mediaProcessing フォアグラウンドサービスが過去 24 時間以内に 6 時間実行されている場合、ユーザーがアプリをフォアグラウンドに表示して（タイマーがリセットされる）場合を除き、別の mediaProcessing フォアグラウンドサービスを開始することはできません。別の mediaProcessing フォアグラウンドサービスを開始しようとすると、システムによって ForegroundServiceStartNotAllowedException がスローされ、「フォアグラウンドサービスタイプ mediaProcessing で時間制限がすでになくなりました」などのエラーメッセージが表示されます。

mediaProcessing サービスタイプについて詳しくは、Android 15 のフォアグラウンドサービスタイプの変更: メディア処理をご覧ください。

テスト

アプリの動作をテストするには、アプリが Android 15 をターゲットとしていない場合でも、メディア処理のタイムアウトを有効にできます（アプリが Android 15 デバイスで実行されている場合）。タイムアウトを有効にするには、次の adb コマンドを実行します。

adb shell am compat enable FGS_INTRODUCE_TIME_LIMITS your-package-name

adb shell device_config put activity_manager media_processing_fgs_timeout_duration duration-in-milliseconds

Restrictions on `BOOT_COMPLETED` broadcast receivers launching foreground services

BOOT_COMPLETED ブロードキャストレシーバに対する新しい制限事項がリリースされますフォアグラウンドサービスの場合。BOOT_COMPLETED レシーバーは、API 呼び出しを起動できないフォアグラウンドサービスのタイプを使用できます。

dataSync
camera
mediaPlayback
phoneCall
mediaProjection
microphone（この制限は、次の日付より microphone に適用されています） Android 14）

BOOT_COMPLETED レシーバーがこれらのタイプのフォアグラウンドのいずれかを起動しようとした場合サービスの場合、システムは ForegroundServiceStartNotAllowedException をスローします。

テスト

アプリの動作をテストするには、アプリが Android 15 をターゲットとしていない場合でも、これらの新しい制限を有効にできます（アプリが Android 15 デバイスで実行されている場合）。次の adb コマンドを実行します。

adb shell am compat enable FGS_BOOT_COMPLETED_RESTRICTIONS your-package-name

デバイスを再起動せずに BOOT_COMPLETED ブロードキャストを送信するには、次の操作を行います。次の adb コマンドを実行します。

adb shell am broadcast -a android.intent.action.BOOT_COMPLETED your-package-name

Restrictions on starting foreground services while an app holds the `SYSTEM_ALERT_WINDOW` permission

以前は、アプリが SYSTEM_ALERT_WINDOW 権限を保持している場合、アプリが現在バックグラウンドで実行されている場合でも、フォアグラウンドサービスを起動できました（バックグラウンドでの起動制限の免除で説明しています）。

アプリが Android 15 をターゲットとしている場合、この免除はより限定的になりました。アプリには SYSTEM_ALERT_WINDOW 権限が必要になり、また、表示可能なオーバーレイウィンドウも必要になります。つまり、フォアグラウンドサービスを開始する前に、アプリがまず TYPE_APPLICATION_OVERLAY ウィンドウを起動し、そのウィンドウを表示する必要があります。

アプリがこれらの新しい要件を満たさずにバックグラウンドからフォアグラウンドサービスを起動しようとすると（他の例外がない限り）、システムは ForegroundServiceStartNotAllowedException をスローします。

アプリが SYSTEM_ALERT_WINDOW 権限を宣言し、バックグラウンドからフォアグラウンドサービスを起動する場合、この変更の影響を受ける可能性があります。アプリが ForegroundServiceStartNotAllowedException を取得した場合は、アプリの処理順序を確認し、バックグラウンドからフォアグラウンドサービスを開始する前に、アプリにアクティブなオーバーレイウィンドウがすでに存在することを確認します。オーバーレイウィンドウが現在表示されているかどうかを確認するには、View.getWindowVisibility() を呼び出します。また、View.onWindowVisibilityChanged() を上書きして、可視性が変更されるたびに通知を受け取ることもできます。

テスト

アプリの動作をテストするには、アプリが Android 15 をターゲットとしていない場合でも、これらの新しい制限を有効にできます（アプリが Android 15 デバイスで実行されている場合）。バックグラウンドからフォアグラウンドサービスを起動する際の新しい制限を有効にするには、次の adb コマンドを実行します。

adb shell am compat enable FGS_SAW_RESTRICTIONS your-package-name

アプリがサイレントモードのグローバル状態を変更できるタイミングの変更

Android 15（API レベル 35）以降をターゲットとするアプリは、デバイスのサイレント（DND）モードのグローバル状態やポリシーを変更できなくなりました（ユーザー設定の変更や DND モードのオフによる変更も含みます）。代わりに、アプリは AutomaticZenRule を提供する必要がある。システムは、既存の最も制限の厳しいポリシーが優先されるスキームで、これをグローバルポリシーに統合します。以前はグローバル状態に影響していた既存の API（setInterruptionFilter、setNotificationPolicy）を呼び出すと、暗黙的な AutomaticZenRule が作成または更新されます。この AutomaticZenRule は、API 呼び出しの呼び出しサイクルに応じてオンまたはオフに切り替わります。

この変更は、アプリが setInterruptionFilter(INTERRUPTION_FILTER_ALL) を呼び出し、その呼び出しによって所有者によって以前に有効にされた AutomaticZenRule が無効になることを想定している場合にのみ、検出可能な動作に影響します。

OpenJDK API の変更点

Android 15 では、最新の OpenJDK LTS リリースの機能に合わせて Android のコアライブラリを更新する取り組みが引き続き行われています。

これらの変更の一部は、Android 15（API レベル 35）をターゲットとするアプリの互換性に影響する可能性があります。

String Formatting API の変更: 以下の String.format() API と Formatter.format() API を使用する場合、引数のインデックス、フラグ、幅、精度の検証がより厳格になりました。
たとえば、引数インデックス 0（書式設定文字列の %0）が使用されている場合、次の例外がスローされます。
```
IllegalFormatArgumentIndexException: Illegal format argument index = 0
```
この場合、引数インデックス 1（フォーマット文字列の %1）を使用することで、問題を修正できます。
Arrays.asList(...).toArray() のコンポーネントタイプの変更: Arrays.asList(...).toArray() を使用する場合、結果の配列のコンポーネントタイプは、基になる配列の要素のタイプではなく、Object になりました。したがって、次のコードは ClassCastException をスローします。
```
String[] elements = (String[]) Arrays.asList("one", "two").toArray();
```
この場合、結果の配列でコンポーネントタイプとして String を保持するには、代わりに Collection.toArray(Object[]) を使用します。
```
String[] elements = Arrays.asList("two", "one").toArray(new String[0]);
```
言語コードの処理の変更: Locale API を使用する場合、ヘブライ語、イディッシュ語、インドネシア語の言語コードは、廃止された形式（ヘブライ語: iw、イディッシュ語: ji、インドネシア語: in）に変換されなくなりました。これらの言語 / 地域の言語コードを指定する場合は、代わりに ISO 639-1 のコード（ヘブライ語: he、イディッシュ語: yi、インドネシア語: id）を使用してください。
ランダムな int シーケンスの変更: https://bugs.openjdk.org/browse/JDK-8301574 で行われた変更に伴い、次の Random.ints() メソッドは、Random.nextInt() メソッドとは異なる数列を返すようになりました。
通常、この変更によってアプリの動作が中断されることはありませんが、Random.ints() メソッドから生成されたシーケンスが Random.nextInt() と一致することを想定したコードは作成しないでください。

新しい SequencedCollection API は、アプリのビルド構成で compileSdk を更新して Android 15（API レベル 35）を使用するようにした後、アプリの互換性に影響する可能性があります。

kotlin-stdlib の MutableList.removeFirst() 拡張関数と MutableList.removeLast() 拡張関数との競合

Java の List 型は、Kotlin の MutableList 型にマッピングされます。List.removeFirst() API と List.removeLast() API が Android 15（API レベル 35）で導入されたため、Kotlin コンパイラは、list.removeFirst() などの関数呼び出しを、kotlin-stdlib の拡張関数ではなく、新しい List API に静的に解決します。

compileSdk を 35 に設定し、minSdk を 34 以下に設定してアプリを再コンパイルし、Android 14 以前でアプリを実行すると、ランタイムエラーがスローされます。
```
java.lang.NoSuchMethodError: No virtual method
removeFirst()Ljava/lang/Object; in class Ljava/util/ArrayList;
```
Android Gradle プラグインの既存の NewApi lint オプションを使用すると、これらの新しい API の使用を検出できます。
```
./gradlew lint

MainActivity.kt:41: Error: Call requires API level 35 (current min is 34): java.util.List#removeFirst [NewApi]
      list.removeFirst()
```
ランタイム例外と lint エラーを修正するには、Kotlin で removeFirst() 関数呼び出しと removeLast() 関数呼び出しをそれぞれ removeAt(0) と removeAt(list.lastIndex) に置き換えます。Android Studio Ladybug | 2024.1.3 以降を使用している場合は、これらのエラーに対するクイックフィックスオプションも提供されます。

lint オプションが無効になっている場合は、@SuppressLint("NewApi") と lintOptions { disable 'NewApi' } の削除を検討してください。

Java の他のメソッドとの競合

既存の型（List、Deque など）に新しいメソッドが追加されました。これらの新しいメソッドは、他のインターフェースやクラスの同じ名前と引数型のメソッドと互換性がない可能性があります。メソッドシグネチャが競合して互換性がない場合、javac コンパイラはビルド時にエラーを出力します。次に例を示します。

エラーの例 1:

javac MyList.java

MyList.java:135: error: removeLast() in MyList cannot implement removeLast() in List
  public void removeLast() {
              ^
  return type void is not compatible with Object
  where E is a type-variable:
    E extends Object declared in interface List

エラーの例 2:

javac MyList.java

MyList.java:7: error: types Deque<Object> and List<Object> are incompatible;
public class MyList implements  List<Object>, Deque<Object> {
  both define reversed(), but with unrelated return types
1 error

エラーの例 3:

javac MyList.java

MyList.java:43: error: types List<E#1> and MyInterface<E#2> are incompatible;
public static class MyList implements List<Object>, MyInterface<Object> {
  class MyList inherits unrelated defaults for getFirst() from types List and MyInterface
  where E#1,E#2 are type-variables:
    E#1 extends Object declared in interface List
    E#2 extends Object declared in interface MyInterface
1 error

これらのビルドエラーを修正するには、これらのインターフェースを実装するクラスで、互換性のある戻り値の型を使用してメソッドをオーバーライドする必要があります。次に例を示します。

@Override
public Object getFirst() {
    return List.super.getFirst();
}

セキュリティ

Android 15 には、悪意のあるアプリからアプリとユーザーを保護するために、システムセキュリティを強化する変更が含まれています。

制限付き TLS バージョン

Android 15 restricts the usage of TLS versions 1.0 and 1.1. These versions had previously been deprecated in Android, but are now disallowed for apps targeting Android 15.

バックグラウンドアクティビティの起動を保護

Android 15 protects users from malicious apps and gives them more control over their devices by adding changes that prevent malicious background apps from bringing other apps to the foreground, elevating their privileges, and abusing user interaction. Background activity launches have been restricted since Android 10 (API level 29).

Other changes

Change PendingIntent creators to block background activity launches by default. This helps prevent apps from accidentally creating a PendingIntent that could be abused by malicious actors.
Don't bring an app to the foreground unless the PendingIntent sender allows it. This change aims to prevent malicious apps from abusing the ability to start activities in the background. By default, apps are not allowed to bring the task stack to the foreground unless the creator allows background activity launch privileges or the sender has background activity launch privileges.
Control how the top activity of a task stack can finish its task. If the top activity finishes a task, Android will go back to whichever task was last active. Moreover, if a non-top activity finishes its task, Android will go back to the home screen; it won't block the finish of this non-top activity.
Prevent launching arbitrary activities from other apps into your own task. This change prevents malicious apps from phishing users by creating activities that appear to be from other apps.
Block non-visible windows from being considered for background activity launches. This helps prevent malicious apps from abusing background activity launches to display unwanted or malicious content to users.

より安全なインテント

Android 15 では、インテント用に StrictMode が導入されています。

Intent の使用違反に関する詳細なログを表示するには、次の方法を使用します。

Kotlin

fun onCreate() {
    StrictMode.setVmPolicy(VmPolicy.Builder()
        .detectUnsafeIntentLaunch()
        .build()
    )
}

Java

public void onCreate() {
    StrictMode.setVmPolicy(new VmPolicy.Builder()
            .detectUnsafeIntentLaunch()
            .build());
}

ユーザーエクスペリエンスとシステム UI

Android 15 には、より一貫性のある直感的なユーザーエクスペリエンスを実現するための変更がいくつか含まれています。

ウィンドウインセットの変更

Android 15 では、ウィンドウの切り欠きに関連する 2 つの変更があります。エッジツーエッジがデフォルトで適用され、システムバーのデフォルト構成などの構成も変更されています。

Edge-to-edge enforcement

Android 15（API レベル 35）をターゲットとしているアプリについては、Android 15 を搭載しているデバイスではデフォルトでエッジツーエッジ表示となります。

Android 14 をターゲットとし、Android 15 デバイスでエッジツーエッジではないアプリ。

Android 15（API レベル 35）をターゲットとし、Android 15 デバイスでエッジツーエッジ表示されるアプリ。このアプリは、インセットを自動的に適用するマテリアル 3 Compose コンポーネントを主に使用しています。この画面は、Android 15 のエッジツーエッジの適用による悪影響を受けません。

これは、アプリの UI に悪影響を及ぼす可能性がある互換性を破る変更です。この変更は、次の UI 領域に影響します。

ジェスチャーハンドルナビゲーションバー
- デフォルトで透明。
- 下部のオフセットが無効になっているため、インセットが適用されない限り、コンテンツはシステムナビゲーションバーの背後に描画されます。
- setNavigationBarColor と R.attr#navigationBarColor は非推奨であり、ジェスチャーナビゲーションには影響しません。
- setNavigationBarContrastEnforced と R.attr#navigationBarContrastEnforced は、引き続きジェスチャーナビゲーションに影響しません。
3 ボタンナビゲーション
- 不透明度はデフォルトで 80% に設定され、色はウィンドウの背景と一致する可能性があります。
- 下部のオフセットが無効になっているため、インセットが適用されない限り、コンテンツはシステムナビゲーションバーの背後に描画されます。
- setNavigationBarColor と R.attr#navigationBarColor は、デフォルトでウィンドウの背景と一致するように設定されています。このデフォルトを適用するには、ウィンドウ背景が色ドローアブルである必要があります。この API は非推奨ですが、3 ボタンナビゲーションには引き続き影響します。
- setNavigationBarContrastEnforced と R.attr#navigationBarContrastEnforced はデフォルトで true に設定されており、3 ボタンナビゲーション全体に 80% の不透明度の背景が追加されます。
ステータスバー
- デフォルトで透明。
- 上部オフセットが無効になっているため、インセットが適用されない限り、コンテンツはステータスバーの背後に描画されます。
- setStatusBarColor と R.attr#statusBarColor は非推奨となり、Android 15 では効果がありません。
- setStatusBarContrastEnforced と R.attr#statusBarContrastEnforced は非推奨ですが、Android 15 では引き続き有効です。
ディスプレイカットアウト
- 非フローティングウィンドウの layoutInDisplayCutoutMode は LAYOUT_IN_DISPLAY_CUTOUT_MODE_ALWAYS にする必要があります。SHORT_EDGES、NEVER、DEFAULT は ALWAYS として解釈されるため、ディスプレイカットアウトによる黒いバーは表示されず、エッジツーエッジで表示されます。

次の例は、Android 15（API レベル 35）をターゲットとする前後のアプリと、インセットを適用する前後のアプリを示しています。この例は包括的なものではなく、Android Auto では異なる場合があります。

Android 15（API レベル 35）をターゲットとし、Android 15 デバイスでエッジツーエッジ表示されるアプリ。しかし、Android 15 のエッジツーエッジの適用により、多くの要素がステータスバー、3 ボタンナビゲーションバー、ディスプレイカットアウトによって隠れるようになりました。非表示の UI には、マテリアル 2 のトップアプリバー、フローティングアクションボタン、リストアイテムが含まれます。

Android 15（API レベル 35）をターゲットとするアプリは、Android 15 デバイスでエッジツーエッジで表示され、UI が隠れないようにインセットが適用されます。

アプリがすでにエッジツーエッジになっている場合に確認すること

アプリがすでにエッジツーエッジで、インセットを適用している場合、次のシナリオを除き、ほとんど影響はありません。ただし、影響を受けないと思われる場合でも、アプリをテストすることをおすすめします。

LAYOUT_IN_DISPLAY_CUTOUT_MODE_ALWAYS ではなく SHORT_EDGES、NEVER、DEFAULT を使用する Activity などの非フローティングウィンドウがある。アプリが起動時にクラッシュする場合は、スプラッシュ画面が原因である可能性があります。core splashscreen の依存関係を 1.2.0-alpha01 以降にアップグレードするか、window.attributes.layoutInDisplayCutoutMode = WindowManager.LayoutInDisplayCutoutMode.always を設定します。
トラフィックの少ない画面で UI が隠れている可能性があります。これらのあまりアクセスされない画面に、隠れている UI がないことを確認します。トラフィックの少ない画面には、次のようなものがあります。
- オンボーディング画面またはログイン画面
- 設定ページ

アプリがまだエッジツーエッジでない場合に確認すべきこと

アプリがまだエッジツーエッジに対応していない場合は、影響を受ける可能性が高くなります。すでにエッジツーエッジになっているアプリのシナリオに加えて、次の点を考慮する必要があります。

アプリが Compose でマテリアルデザイン 3 のコンポーネント（androidx.compose.material3）（TopAppBar、BottomAppBar、NavigationBar など）を使用している場合、これらのコンポーネントはインセットを自動的に処理するため、影響を受けない可能性が高いです。
アプリが Compose でマテリアルデザイン 2 のコンポーネント（androidx.compose.material）を使用している場合、コンポーネントはインセットを自動的には処理しません。ただし、インセットにアクセスして手動で適用することはできます。androidx.compose.material 1.6.0 以降では、windowInsets パラメータを使用して、BottomAppBar、TopAppBar、BottomNavigation、NavigationRail にインセットを手動で適用します。同様に、Scaffold には contentWindowInsets パラメータを使用します。
アプリでビューとマテリアルコンポーネント（com.google.android.material）を使用する場合、ビューベースのマテリアルコンポーネントの多く（BottomNavigationView、BottomAppBar、NavigationRailView、NavigationView など）はインセットを処理します。追加の作業は不要です。ただし、AppBarLayout を使用する場合は android:fitsSystemWindows="true" を追加する必要があります。
カスタムコンポーザブルの場合は、インセットをパディングとして手動で設定します。コンテンツが Scaffold 内にある場合は、Scaffold パディング値を使用してインセットを消費できます。それ以外の場合は、WindowInsets のいずれかを使用してパディングを適用します。
アプリがビューと BottomSheet、SideSheet、またはカスタムコンテナを使用する場合、ViewCompat.setOnApplyWindowInsetsListener を使用してパディングを適用します。RecyclerView については、このリスナーを使用してパディングを適用して、さらに clipToPadding="false" を追加します。

アプリでカスタムバックグラウンド保護を提供する必要がある場合に確認すべきこと

アプリが 3 ボタンナビゲーションまたはステータスバーにカスタムの背景保護を提供する必要がある場合は、WindowInsets.Type#tappableElement() を使用して 3 ボタンナビゲーションバーの高さを取得するか、WindowInsets.Type#statusBars を使用して、システムバーの背後にコンポーザブルまたはビューを配置する必要があります。

エッジツーエッジに関するその他のリソース

インセットの適用に関するその他の考慮事項については、エッジツーエッジのビューとエッジツーエッジの Compose のガイドをご覧ください。

非推奨 API

次の API は非推奨ですが、無効にはなっていません。

R.attr#enforceStatusBarContrast
R.attr#navigationBarColor（3 ボタンナビゲーション用、アルファ値 80%）
Window#isStatusBarContrastEnforced
Window#setNavigationBarColor（3 ボタンナビゲーション用、アルファ値 80%）
Window#setStatusBarContrastEnforced

次の API は非推奨となり、無効になっています。

R.attr#navigationBarColor（ジェスチャーナビゲーション用）
R.attr#navigationBarDividerColor
R.attr#statusBarColor
Window#setDecorFitsSystemWindows
Window#getNavigationBarColor
Window#getNavigationBarDividerColor
Window#getStatusBarColor
Window#setNavigationBarColor（ジェスチャーナビゲーション用）
Window#setNavigationBarDividerColor
Window#setStatusBarColor

Stable configuration

アプリが Android 15（API レベル 35）以降をターゲットとしている場合、Configuration でシステムバーが除外されなくなりました。レイアウト計算に Configuration クラスの画面サイズを使用している場合は、必要に応じて、適切な ViewGroup、WindowInsets、WindowMetricsCalculator などのより適切な代替手段に置き換える必要があります。

Configuration は API 1 以降で利用可能です。通常は Activity.onConfigurationChanged から取得されます。ウィンドウの密度、向き、サイズなどの情報を提供します。Configuration から返されるウィンドウサイズの重要な特性の 1 つは、以前はシステムバーが除外されていたことです。

構成サイズは通常、/res/layout-h500dp などのリソース選択に使用されます。これは引き続き有効なユースケースです。ただし、レイアウト計算での使用は常に推奨されていません。その場合は、今すぐ離れてください。ユースケースに応じて、Configuration の使用をより適切なものに置き換える必要があります。

レイアウトの計算に使用する場合は、CoordinatorLayout や ConstraintLayout などの適切な ViewGroup を使用します。システムナビゲーションバーの高さを決定するために使用する場合は、WindowInsets を使用します。アプリウィンドウの現在のサイズを確認するには、computeCurrentWindowMetrics を使用します。

この変更の影響を受けるフィールドは次のとおりです。

Configuration.screenWidthDp サイズと screenHeightDp サイズで、システムバーが除外されなくなりました。
Configuration.smallestScreenWidthDp は、screenWidthDp と screenHeightDp の変更によって間接的に影響を受けます。
Configuration.orientation は、正方形に近いデバイスでの screenWidthDp と screenHeightDp の変更によって間接的に影響を受けます。
Configuration の変更は Display.getSize(Point) に間接的に影響します。このメソッドは API レベル 30 で非推奨になりました。
Display.getMetrics() は、API レベル 33 以降、すでにこのように動作しています。

elegantTextHeight 属性のデフォルトが true に

Android 15（API レベル 35）をターゲットとするアプリの場合、elegantTextHeight TextView 属性はデフォルトで true になります。これにより、デフォルトで使用されるコンパクトなフォントが、読みやすく大きな縦方向の測定値を持つスクリプトに置き換えられます。コンパクトフォントは、レイアウトの分割を防ぐために導入されました。Android 13（API レベル 33）では、fallbackLineSpacing 属性を使用してテキストレイアウトの垂直方向の高さを伸ばすことで、このような分割の多くを防ぐことができます。

Android 15 では、コンパクトフォントは引き続きシステムに残るため、アプリで elegantTextHeight を false に設定して以前と同じ動作を実現できますが、今後のリリースでサポートされる可能性は低いです。そのため、アプリがアラビア語、ラオス語、ミャンマー語、タミル語、グジャラート語、カンナダ語、マラヤーラム語、オディア語、テルグ語、タイ語のスクリプトをサポートしている場合は、elegantTextHeight を true に設定してアプリをテストします。

Android 15 をターゲットとするアプリの `elegantTextHeight` の動作。

複雑な文字形状に対応するための TextView の幅の変更

In previous versions of Android, some cursive fonts or languages that have complex shaping might draw the letters in the previous or next character's area. In some cases, such letters were clipped at the beginning or ending position. Starting in Android 15, a TextView allocates width for drawing enough space for such letters and allows apps to request extra paddings to the left to prevent clipping.

Because this change affects how a TextView decides the width, TextView allocates more width by default if the app targets Android 15 (API level 35) or higher. You can enable or disable this behavior by calling the setUseBoundsForWidth API on TextView.

Because adding left padding might cause a misalignment for existing layouts, the padding is not added by default even for apps that target Android 15 or higher. However, you can add extra padding to preventing clipping by calling setShiftDrawingOffsetForStartOverhang.

The following examples show how these changes can improve text layout for some fonts and languages.

Standard layout for English text in a cursive font. Some of the letters are clipped. Here is the corresponding XML:

<TextView
    android:fontFamily="cursive"
    android:text="java" />

Layout for the same English text with additional width and padding. Here is the corresponding XML:

<TextView
    android:fontFamily="cursive"
    android:text="java"
    android:useBoundsForWidth="true"
    android:shiftDrawingOffsetForStartOverhang="true" />

Standard layout for Thai text. Some of the letters are clipped. Here is the corresponding XML:

<TextView
    android:text="คอมพิวเตอร์" />

Layout for the same Thai text with additional width and padding. Here is the corresponding XML:

<TextView
    android:text="คอมพิวเตอร์"
    android:useBoundsForWidth="true"
    android:shiftDrawingOffsetForStartOverhang="true" />

EditText の言語 / 地域に対応したデフォルトの行の高さ

In previous versions of Android, the text layout stretched the height of the text to meet the line height of the font that matched the current locale. For example, if the content was in Japanese, because the line height of the Japanese font is slightly larger than the one of a Latin font, the height of the text became slightly larger. However, despite these differences in line heights, the EditText element was sized uniformly, regardless of the locale being used, as illustrated in the following image:

Three boxes representing `EditText` elements that can contain text from English (en), Japanese (ja), and Burmese (my). The height of the `EditText` is the same, even though these languages have different line heights from each other.

For apps targeting Android 15 (API level 35), a minimum line height is now reserved for EditText to match the reference font for the specified Locale, as shown in the following image:

Three boxes representing `EditText` elements that can contain text from English (en), Japanese (ja), and Burmese (my). The height of the `EditText` now includes space to accommodate the default line height for these languages' fonts.

If needed, your app can restore the previous behavior by specifying the useLocalePreferredLineHeightForMinimum attribute to false, and your app can set custom minimum vertical metrics using the setMinimumFontMetrics API in Kotlin and Java.

カメラとメディア

Android 15 では、Android 15 以降をターゲットとするアプリのカメラとメディアの動作が次のように変更されています。

音声フォーカスのリクエストに関する制限

Android 15（API レベル 35）をターゲットとするアプリが音声フォーカスをリクエストするには、最上位のアプリであるか、フォアグラウンドサービスを実行している必要があります。アプリがこれらの要件のいずれかを満たしていないときにフォーカスをリクエストしようとすると、呼び出しは AUDIOFOCUS_REQUEST_FAILED を返します。

音声フォーカスの詳細については、音声フォーカスを管理するをご覧ください。

非 SDK の制限の更新

Android 15 では、Android デベロッパーの協力と直近の内部テストに基づいて、制限を受ける非 SDK インターフェースのリストが更新されています。Google は、非 SDK インターフェースを制限する前に、可能な限り、その代わりとなる公開インターフェースを利用可能にしています。

Android 15 をターゲットとしないアプリでは、この変更の一部はすぐには影響しない可能性があります。ただし、アプリの対象 API レベルに応じて、アプリが一部の非 SDK インターフェースにアクセスできる場合でも、非 SDK のメソッドまたはフィールドをそのまま使用し続けると、将来的にアプリが機能しなくなるリスクが高くなります。

アプリが非 SDK インターフェースを使用しているかどうか不明な場合は、アプリをテストして確認できます。アプリが非 SDK インターフェースに依存している場合は、SDK の代替手段への移行を計画してください。それでも、アプリによっては非 SDK インターフェースを使用する正当なユースケースがあることを承知しています。アプリの機能に使用している非 SDK インターフェースの代わりが見つからない場合は、新しい公開 API をリクエストしてください。

To learn more about the changes in this release of Android, see Updates to non-SDK interface restrictions in Android 15. To learn more about non-SDK interfaces generally, see Restrictions on non-SDK interfaces.