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

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

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

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

コア機能

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

フォアグラウンドサービスの変更

Android 15 では、フォアグラウンドサービスに次の変更を加えます。

データ同期フォアグラウンドサービスのタイムアウト動作
新しいメディア処理フォアグラウンドサービスのタイプ
フォアグラウンドサービスを起動する BOOT_COMPLETED ブロードキャストレシーバに関する制限
アプリが SYSTEM_ALERT_WINDOW 権限を保持しているときにフォアグラウンドサービスを起動する場合の制限

データ同期フォアグラウンドサービスのタイムアウト動作

对于以 Android 15（API 级别 35）或更高版本为目标平台的应用，Android 15 为 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 小时内完整运行。
请改用替代 API，而不是使用 dataSync 前台服务。

如果您的应用的 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

新しいメディア処理フォアグラウンドサービスタイプ

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 コマンドを実行します。

adb shell device_config put activity_manager media_processing_fgs_timeout_duration duration-in-milliseconds

フォアグラウンドサービスを起動する `BOOT_COMPLETED` ブロードキャストレシーバの制限

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

アプリが `SYSTEM_ALERT_WINDOW` 権限を保持しているときにフォアグラウンドサービスを開始する場合の制限

以前は、アプリが 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）を使用してください。
ランダムな整数シーケンスの変更: 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 限制了对 TLS 版本 1.0 和 1.1 的使用。这些版本之前已在 Android 中被弃用，但现在不允许面向 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

In addition to the restriction for UID matching, these other changes are also included:

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 引入了新的可选安全措施，以提高 intent 的安全性和更强大的模型。这些变更旨在防范潜在的漏洞，可能会被恶意应用利用的 intent 滥用。Android 15 对 intent 的安全性进行了两项主要改进：

匹配目标 intent 过滤器：针对特定组件的 intent 准确匹配目标的 intent 过滤器规范。如果您发送 intent 来启动另一个应用的 activity，则目标 intent 组件需要与接收 activity 声明的 intent 过滤器保持一致。
intent 必须包含操作：不含操作的 intent 将不再与任何 intent 过滤器匹配。也就是说，用于启动 activity 或服务都必须有明确定义的操作。

要检查应用如何响应这些更改，请使用 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 つの変更があります。エッジツーエッジがデフォルトで適用され、システムバーのデフォルト構成などの構成も変更されています。

全面实施政策

アプリが 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 には、Material 2 の上部アプリバー、フローティングアクションボタン、リスト項目が含まれます。

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

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

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

LAYOUT_IN_DISPLAY_CUTOUT_MODE_ALWAYS の代わりに SHORT_EDGES、NEVER、DEFAULT を使用する Activity などの非フローティングウィンドウがあります。アプリが起動時にクラッシュする場合は、スプラッシュ画面が原因である可能性があります。コアスプラッシュ画面の依存関係を 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

稳定配置

如果您的应用以 Android 15（API 级别 35）或更高版本为目标平台，Configuration 不再排除系统栏。如果您在 Configuration 类中使用屏幕尺寸进行布局计算，则应根据需要将其替换为更好的替代方案，例如适当的 ViewGroup、WindowInsets 或 WindowMetricsCalculator。

Configuration 自 API 1 起便已开始提供。它通常从 Activity.onConfigurationChanged 中获取。它提供窗口密度、方向和大小等信息。从 Configuration 返回的窗口大小的一个重要特征是，它之前排除了系统栏。

配置大小通常用于资源选择，例如 /res/layout-h500dp，这仍然是一个有效的使用情形。不过，我们一直不建议使用它进行布局计算。如果您正在这样做，请立即远离该设备。您应根据自己的使用场景，将 Configuration 的使用替换为更合适的用法。

如果您使用它来计算布局，请使用适当的 ViewGroup，例如 CoordinatorLayout 或 ConstraintLayout。如果您使用它来确定系统导航栏的高度，请使用 WindowInsets。如果您想知道应用窗口的当前大小，请使用 computeCurrentWindowMetrics。

以下列表介绍了受此变更影响的字段：

Configuration.screenWidthDp 和 screenHeightDp 尺寸不再排除系统栏。
Configuration.smallestScreenWidthDp 会受到 screenWidthDp 和 screenHeightDp 更改的间接影响。
Configuration.orientation 会受到近乎方形的设备上 screenWidthDp 和 screenHeightDp 更改的间接影响。
Display.getSize(Point) 间接受到 Configuration 中的更改影响。此方法已从 API 级别 30 开始弃用。
自 API 级别 33 以来，Display.getMetrics() 一直以这种方式运行。

elegantTextHeight 属性のデフォルト値が true になりました

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

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

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

複雑な文字の形状に合わせて TextView の幅が変更される

在以前的 Android 版本中，某些具有复杂形状的手写字体或语言可能会在上一个或下一个字符的区域绘制字母。在某些情况下，此类字母会在开头或结尾处被剪裁。从 Android 15 开始，TextView 会分配宽度，以便为此类字母绘制足够的空间，并允许应用请求向左额外添加内边距以防止剪裁。

由于此更改会影响 TextView 确定宽度的方式，因此如果应用以 Android 15（API 级别 35）或更高版本为目标平台，TextView 会默认分配更多宽度。您可以通过对 TextView 调用 setUseBoundsForWidth API 来启用或停用此行为。

由于添加左内边距可能会导致现有布局未对齐，因此默认情况下不会添加内边距，即使以 Android 15 或更高版本为目标平台的应用也是如此。不过，您可以通过调用 setShiftDrawingOffsetForStartOverhang 添加额外的内边距以防止剪裁。

以下示例展示了这些更改如何改进某些字体和语言的文本布局。

采用手写体字体的英语文本的标准布局。部分字母被截断。对应的 XML 如下：

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

相同英语文本的布局，增加了宽度和内边距。以下是相应的 XML：

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

泰语文本的标准布局。部分字母被截断。以下是相应的 XML：

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

相同泰语文本的布局，增加了宽度和内边距。以下是相应的 XML：

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

EditText のロケール対応のデフォルトの行の高さ

以前のバージョンの Android では、テキストレイアウトは、現在の言語 / 地域に一致するフォントの行の高さに合うようにテキストの高さを伸ばしていました。たとえば、コンテンツが日本語の場合、日本語フォントの行間がラテン文字フォントよりも少し大きいため、テキストの高さが少し大きくなっていました。ただし、次の画像に示すように、このような行の高さの違いにもかかわらず、EditText 要素は、使用されている言語 / 地域に関係なく、均一にサイズ設定されていました。

英語（en）、日本語（ja）、ビルマ語（my）のテキストを含めることができる `EditText` 要素を表す 3 つのボックス。これらの言語の行の高さは異なりますが、`EditText` の高さは同じです。

Android 15（API レベル 35）をターゲットとするアプリの場合、指定されたロケールの参照フォントに合わせて、EditText の最小行の高さが予約されるようになりました。これは次の図に示すとおりです。

英語（en）、日本語（ja）、ビルマ語（my）のテキストを含めることができる `EditText` 要素を表す 3 つのボックス。`EditText` の高さに、これらの言語のフォントのデフォルトの行の高さに対応するスペースが追加されました。

必要に応じて、useLocalePreferredLineHeightForMinimum 属性を false に指定することで、以前の動作を復元できます。また、Kotlin と Java で setMinimumFontMetrics API を使用して、カスタムの最小垂直指標を設定することもできます。

カメラとメディア

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

音声フォーカスリクエストの制限

Apps that target Android 15 (API level 35) must be the top app or running a foreground service in order to request audio focus. If an app attempts to request focus when it does not meet one of these requirements, the call returns AUDIOFOCUS_REQUEST_FAILED.

You can learn more about audio focus at Manage audio focus.

非 SDK の制限の更新

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

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

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

Android の今回のリリースの変更について詳しくは、非 SDK インターフェースの制限に関する Android 15 での変更点をご覧ください。非 SDK インターフェース全般について詳しくは、非 SDK インターフェースの制限をご覧ください。