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

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

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

コア機能

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

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

我们将对 Android 15 中的前台服务进行以下更改。

• 数据同步前台服务超时行为
• 新的媒体处理前台服务类型
• 对启动前台服务的 BOOT_COMPLETED 广播接收器的限制
• 在应用拥有 SYSTEM_ALERT_WINDOW 权限时启动前台服务的限制

数据同步前台服务超时行为

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]"

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

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

新的媒体处理前台服务类型

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]"

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

1. サービスに新しい Service.onTimeout(int, int) メソッドを実装します。アプリがコールバックを受信したら、数秒以内に stopSelf() を呼び出します。（アプリをすぐに停止しないと、システムは障害を生成します）。
2. アプリの mediaProcessing サービスが 24 時間以内に合計 6 時間を超えて実行されないようにします（ユーザーがアプリを操作してタイマーをリセットする場合を除く）。
3. mediaProcessing フォアグラウンド サービスは、ユーザーが直接操作した結果としてのみ開始します。サービスが開始されたときにアプリはフォアグラウンドにあるため、アプリがバックグラウンドに移動した後も 6 時間間サービスは実行されます。
4. 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 接收器不能启动 以下类型的前台服务：

• dataSync
• camera
• mediaPlayback
• phoneCall
• mediaProjection
• microphone（自 Android 14 起，microphone 就受到此限制）

如果 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 を使用する場合、引数インデックス、フラグ、幅、精度の検証がより厳格になりました。

  • String.format(String, Object[])
  • String.format(Locale, String, Object[])
  • Formatter.format(String, Object[])
  • Formatter.format(Locale, String, Object[])

  たとえば、引数インデックス 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(long)
  • Random.ints(long, int, int)
  • Random.ints(int, int)
  • Random.ints()

  一般に、この変更によってアプリの動作が中断されることはありませんが、コードでは 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 では、悪意のあるアプリからユーザーを保護し、より細かく 悪意のあるバックグラウンド アプリが悪意のあるアクティビティを 他のアプリをフォアグラウンド表示させる、権限昇格させる、アプリを悪用する です。バックグラウンド アクティビティの起動は、それ以降、 Android 10（API レベル 29）。

その他の変更点

UID の一致に関する制限に加えて、次の変更も加えられています。

• PendingIntent クリエイターを変更し、デフォルトでバックグラウンド アクティビティの起動をブロックするようにしました。これにより、アプリが誤って IP アドレスを PendingIntent: 悪意のある人物によって悪用されるおそれがあります。
• PendingIntent 送信者が許可しない限り、アプリをフォアグラウンドに表示しないでください。この変更は、悪意のあるアプリがバックグラウンドでアクティビティを開始する機能を悪用することを防ぐことを目的としています。デフォルトでは、作成者がバックグラウンド アクティビティの起動権限を許可している場合、または送信者にバックグラウンド アクティビティの起動権限がある場合を除き、アプリはタスクスタックをフォアグラウンドに表示できません。
• タスクスタックの最上位アクティビティがタスクを終了する方法を制御する。最上位のアクティビティがタスクを完了すると、Android は最後にアクティブだったタスクに戻ります。また、トップ以外のアクティビティがタスクを終了すると、Android はホーム画面に戻ります。このトップ以外のアクティビティの終了はブロックされません。
• 他のアプリから任意のアクティビティを独自のタスクに起動できないようにする。この変更により、悪意のあるアプリがユーザーをフィッシング攻撃から 他のアプリからと思われるアクティビティ
• 非表示のウィンドウがバックグラウンド アクティビティの起動の対象と見なされないようにする。これにより、悪意のあるアプリがバックグラウンド アクティビティの起動を悪用して、望ましくないコンテンツや悪意のあるコンテンツをユーザーに表示するのを防ぐことができます。

より安全なインテント

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

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

要检查应用如何响应这些更改，请使用 StrictMode。要查看详细的 关于 Intent 使用违规行为的日志，请添加以下方法：

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

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

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

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

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

Android 15 中与窗口内边距相关的两项变更：默认强制执行边到边，此外还有配置变更，例如系统栏的默认配置。

全面实施政策

如果应用以 Android 15（API 级别 35）为目标平台，则在搭载 Android 15 的设备上默认以无边框显示。

这是一项重大变更，可能会对应用的界面产生负面影响。这些更改会影响以下界面区域：

• 手势柄导航栏
  • 默认透明。
  • 底部偏移量处于停用状态，因此内容会绘制在系统导航栏后面，除非应用了边衬区。
  • setNavigationBarColor 和 R.attr#navigationBarColor 已被弃用，不会影响手势导航。
  • setNavigationBarContrastEnforced 和 R.attr#navigationBarContrastEnforced 继续对基于手势的导航没有任何影响。
• “三按钮”导航
  • 默认情况下，不透明度设置为 80%，颜色可能与窗口背景颜色一致。
  • 底部偏移量处于停用状态，因此内容会绘制在系统导航栏后面，除非应用了边衬区。
  • 默认情况下，setNavigationBarColor 和 R.attr#navigationBarColor 设置为与窗口背景相匹配。窗口背景必须是颜色可绘制对象，才能应用此默认值。此 API 已弃用，但仍会影响三按钮导航。
  • setNavigationBarContrastEnforced 和 R.attr#navigationBarContrastEnforced 默认值为 true，这会在三按钮导航栏中添加 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 上可能会显示不同的内容。

如果应用已实现全屏显示，需要检查哪些方面

如果您的应用已实现全屏显示并应用边衬区，则在大多数情况下不会受到影响，但以下情形除外。不过，即使您认为自己不受影响，我们仍建议您测试应用。

• 您有一个非浮动窗口，例如使用 SHORT_EDGES、NEVER 或 DEFAULT 而不是 LAYOUT_IN_DISPLAY_CUTOUT_MODE_ALWAYS 的 Activity。如果您的应用在启动时崩溃，这可能是由启动画面引起的。您可以将核心启动画面依赖项升级到 1.2.0-alpha01 或更高版本，也可以设置 window.attributes.layoutInDisplayCutoutMode = WindowManager.LayoutInDisplayCutoutMode.always。
• 可能存在流量较低且界面被遮挡的屏幕。验证这些访问频率较低的界面是否没有被遮挡的界面。低流量界面包括：
  • 初始配置或登录界面
  • “设置”页面

如果您的应用尚未实现全屏显示，需要检查哪些方面

如果您的应用尚未实现全屏显示，则很可能会受到影响。除了已经实现全屏显示的 app 的场景之外，您还应考虑以下事项：

• 如果您的应用在 Compose 中使用 Material 3 组件 (androidx.compose.material3)，例如 TopAppBar、BottomAppBar 和 NavigationBar，这些组件很可能不会受到影响，因为它们会自动处理边衬区。
• 如果您的应用使用的是 Compose 中的 Material 2 组件 (androidx.compose.material)，这些组件不会自动处理边衬区。不过，您可以获得边衬区的访问权限，然后手动应用边衬区。在 androidx.compose.material 1.6.0 及更高版本中，使用 windowInsets 参数可为 BottomAppBar、TopAppBar、BottomNavigation 和 NavigationRail 手动应用边衬区。 同样，请为 Scaffold 使用 contentWindowInsets 参数。
• 如果您的应用使用视图和 Material 组件 (com.google.android.material)，则大多数基于视图的 Material 组件（例如 BottomNavigationView、BottomAppBar、NavigationRailView 或 NavigationView）都会处理边衬区，因此不需要执行额外的操作。不过，如果使用的是 AppBarLayout，则需要添加 android:fitsSystemWindows="true"。
• 对于自定义可组合项，请手动应用边衬区作为内边距。如果您的内容位于 Scaffold 内，则可以使用 Scaffold 内边距值来使用插边。否则，请使用 WindowInsets 之一应用内边距。
• 如果应用使用的是视图和 BottomSheet、SideSheet 或自定义容器，请使用 ViewCompat.setOnApplyWindowInsetsListener 应用内边距。对于 RecyclerView，请使用此监听器应用内边距，同时添加 clipToPadding="false"。

如果应用必须提供自定义后台保护，需要检查哪些方面

如果您的应用必须为三按钮导航或状态栏提供自定义背景保护，则应使用 WindowInsets.Type#tappableElement() 或 WindowInsets.Type#statusBars 将可组合项或视图放置在系统栏后面，以获取三按钮导航栏高度。

其他全屏显示资源

如需了解有关应用边衬区的其他注意事项，请参阅全屏视图和全屏 Compose 指南。

已弃用的 API

以下 API 已弃用，但未停用：

• R.attr#enforceStatusBarContrast
• R.attr#navigationBarColor（适用于三按钮导航，alpha 为 80%）
• Window#isStatusBarContrastEnforced
• Window#setNavigationBarColor（适用于三按钮导航，透明度为 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 から返されるウィンドウ サイズの重要な特徴の 1 つは、以前はシステムバーが除外されていたことです。

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

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

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

• Configuration.screenWidthDp サイズと screenHeightDp サイズでシステムバーが除外されなくなりました。
• Configuration.smallestScreenWidthDp は、screenWidthDp と screenHeightDp の変更の影響を間接的に受けます。
• Configuration.orientation は、ほぼ正方形のデバイスで screenWidthDp と screenHeightDp の変更の影響を間接的に受けます。
• Display.getSize(Point) は、Configuration の変更の影響を間接的に受けます。これは 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 14（API レベル 34）以前をターゲットとするアプリの

複雑な文字の形状に合わせて 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 元素的大小都是统一的，如下图所示：

对于以 Android 15（API 级别 35）为目标平台的应用，现在为 EditText 预留了最小行高，以匹配指定语言区域的参考字体，如下图所示：

如有需要，您的应用可以将 useLocalePreferredLineHeightForMinimum 属性指定为 false，以恢复之前的行为；您的应用还可以在 Kotlin 和 Java 中使用 setMinimumFontMetrics API 设置自定义最小垂直指标。

カメラとメディア

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 の代替インターフェースへの移行を計画してください。ただし Google も、一部のアプリには非 SDK インターフェースを使用する正当なユースケースがあると承知しています。アプリの機能に使用している非 SDK インターフェースの代わりが見つからない場合は、新しい公開 API をリクエストしてください。

如需详细了解此 Android 版本中的变更，请参阅 Android 15 中有关限制非 SDK 接口的更新。如需全面了解有关非 SDK 接口的详细信息，请参阅对非 SDK 接口的限制。