行為變更：指定 Android 15 以上版本的應用程式

和先前版本一樣，Android 15 也包含可能會影響應用程式的行為變更。以下行為變更僅適用於指定 Android 15 以上版本的應用程式。如果應用程式指定 Android 15 以上版本，建議您視情況修改應用程式，以支援這些行為。

此外，無論應用程式的 targetSdkVersion 為何，請務必查看影響所有在 Android 15 上執行的應用程式行為變更清單。

核心功能

Android 15 修改或擴充 Android 系統的各種核心功能。

前景服務變更

我們即將針對 Android 15 的前景服務進行下列變更。

• 全新媒體處理前景服務類型
• BOOT_COMPLETED 個啟動前景服務的廣播接收器相關限制

資料同步處理前景服務逾時行為

Android 15 針對指定應用程式，為 dataSync 推出了新的逾時行為 搭載 Android 15 以上版本。這個行為也適用於新的 mediaProcessing 前景服務類型。

系統允許應用程式的 dataSync 服務執行總計 6 小時 24 小時期間，系統會呼叫執行中服務的 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]"

注意： 應用程式所有 dataSync 前景都共用 6 小時的時間限制 免費 Google Cloud 服務舉例來說，假設應用程式執行 dataSync 服務 4 小時， 接著啟動另一項 dataSync 服務，那第二個服務只會 執行兩小時的測試不過，如果使用者將應用程式 就會重設計時器，而且應用程式提供 6 小時期限。

為避免這種行為變更發生問題，您可以採取 包括：

1. 讓您的服務實作新的 Service.onTimeout(int, int) 方法。 應用程式收到回呼時，請務必在stopSelf() 幾秒內。(如果您沒有立即停止應用程式，系統會自動產生新的 失敗。)
2. 確認應用程式的 dataSync 服務執行時間不得超過 每 24 小時為 6 小時 (除非使用者與應用程式互動， 重設計時器)。
3. 只因直接使用者而啟動 dataSync 前景服務 互動；因為您的應用程式在服務啟動時位於前景。 並在應用程式進入背景的六小時後，獲得完整的服務存取權。
4. 不使用 dataSync 前景服務，而是改用 替代 API。

如果應用程式的 dataSync 前景服務在過去 6 小時內執行了 6 小時 24，「除非」使用者，否則您無法啟動另一項 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]"

注意： 6 小时的时间限制由应用的所有 mediaProcessing 前台服务共享。例如，如果某个应用将一项 mediaProcessing 服务运行 4 小时，然后启动了另一项 mediaProcessing 服务，则第二项服务将只能运行 2 小时。不过，如果用户将应用调到前台，计时器会重置，并且应用将有 6 小时的可用时间。

为避免出现异常，您可以执行以下操作之一：

1. 让您的服务实现新的 Service.onTimeout(int, int) 方法。当应用收到回调时，请务必在几秒钟内调用 stopSelf()。（如果您不立即停止应用，系统会生成故障。）
2. 确保应用的 mediaProcessing 服务在任何 24 小时内的运行时间都不超过 6 小时（除非用户与应用互动并重置计时器）。
3. 仅通过直接的用户互动来启动 mediaProcessing 前台服务；由于您的应用在服务启动时位于前台，因此服务会在应用进入后台后的 6 小时内完整运行。
4. 请使用替代 API（例如 WorkManager），而不是使用 mediaProcessing 前台服务。

如果您的应用的 mediaProcessing 前台服务在过去 24 天内运行了 6 个小时，除非用户将您的应用调到前台（这会重置计时器），否则您无法启动其他 mediaProcessing 前台服务。如果您尝试启动另一个 mediaProcessing 前台服务，系统会抛出 ForegroundServiceStartNotAllowedException，并显示类似“Time limit already exhausted for the service type 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 (我們已對 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 为目标平台的应用无法再更改设备上的全局状态或勿扰 (DND) 政策（通过修改用户设置或关闭 DND 模式）。相反，应用必须提供一个 AutomaticZenRule，系统会将后者合并到一个具有现有最严格的政策胜出方案的全局政策中。调用之前影响全局状态的现有 API（setInterruptionFilter、setNotificationPolicy）会导致创建或更新隐式 AutomaticZenRule，该 AutomaticZenRule 根据这些 API 调用的调用周期而开启或关闭。

请注意，只有在应用调用 setInterruptionFilter(INTERRUPTION_FILTER_ALL) 且预期调用会停用之前由其所有者激活的 AutomaticZenRule 时，此变更才会影响可观察的行为。

OpenJDK API 變更

Android 15 将继续更新 Android 的核心库， 最新 OpenJDK LTS 版本中的功能。

其中一些变更可能会影响应用定位的应用兼容性 Android 15（API 级别 35）：

• 字符串格式设置 API 变更：验证参数索引、标志、 现在，使用 String.format() 和 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 可能会影响应用的兼容性 当您在应用的 build 配置中更新 compileSdk 以使用 Android 15（API 级别 35）：

• 与 MutableList.removeFirst() 和 kotlin-stdlib 中的 MutableList.removeLast() 扩展函数

  Java 中的 List 类型会映射到 Kotlin 中的 MutableList 类型。 由于使用 List.removeFirst() 和 List.removeLast() API 已在 Android 15（API 级别 35）中引入，Kotlin 编译器 将函数调用（例如 list.removeFirst()）静态解析为 新的 List API，而不是对 API 中的扩展函数 kotlin-stdlib。

  重新编译应用时，如果 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 错误，removeFirst() 和 removeLast() 函数调用可替换为 removeAt(0)， removeAt(list.lastIndex)（在 Kotlin 中分别对应）。如果您使用的是 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.getLast();
  }
  

安全性

Android 15 包含提升系統安全性的異動，可協助保護應用程式和使用者不受惡意應用程式侵擾。

啟動安全的背景活動

Android 15 可以保護使用者不受惡意應用程式侵擾，並新增多項變更，防止惡意背景應用程式將其他應用程式導入前景、提升權限及濫用使用者互動行為，讓使用者進一步控管裝置。背景活動啟動功能自 Android 10 (API 級別 29) 開始受到限制。

封鎖與堆疊上頂端 UID 不符的應用程式，禁止啟動活動

惡意應用程式可能會在同一工作中啟動其他應用程式的活動，然後將其疊放在另一個頂端，造成代表該應用程式的錯覺。這種「工作盜用」攻擊會略過目前的背景啟動限制，因為這類攻擊全都發生在相同的可見工作中。為降低這種風險，Android 15 新增了旗標，用於封鎖與堆疊上頂端 UID 不符的應用程式，停止啟動活動。如要為應用程式的所有活動選擇加入，請在應用程式的 AndroidManifest.xml 檔案中更新 allowCrossUidActivitySwitchFromBelow 屬性：

<application android:allowCrossUidActivitySwitchFromBelow="false" >

只要符合下列所有條件，系統就會啟用新的安全措施：

• 搭載 Android 15 的應用程式發布。
• 工作堆疊頂端的應用程式以 Android 15 為目標。
• 任何可見活動都啟用新的保護措施

如果啟用安全措施，應用程式完成自己的工作後可能會返回主畫面，而非上次顯示的應用程式。

其他異動

除了 UID 比對的限制外，下列其他變更也包括：

• 將 PendingIntent 建立者變更為預設封鎖背景活動啟動。這有助於防止應用程式意外建立可能會遭惡意人士濫用的 PendingIntent。
• 請勿讓應用程式在前景執行，除非 PendingIntent 傳送者允許應用程式。這項變更旨在避免惡意應用程式濫用在背景啟動活動的功能。根據預設，除非創作者允許背景活動啟動權限，或傳送者擁有背景活動啟動權限，否則應用程式不得將工作堆疊移至前景。
• 控管工作堆疊的頂端活動如何完成工作。如果頂層活動完成一項任務，Android 就會返回上次啟用的工作。此外，如果非頂端活動完成任務，Android 會返回主畫面，並不會阻止完成這項非頂層活動。
• 防止透過其他應用程式啟動任意活動到自己的工作中。這項變更會建立看似來自其他應用程式的活動，預防惡意應用程式使用者遭受網路釣魚攻擊。
• 封鎖背景活動啟動不可見的視窗。這有助於防止惡意應用程式濫用背景活動啟動程序，向使用者顯示不需要或惡意的內容。

更安全的意圖

Android 15 導入了新的安全措施，讓意圖更安全、更完善。這些變更的目的在於防範可能的安全漏洞和意圖濫用，可能遭惡意應用程式利用。Android 15 提供兩項主要強化意圖安全性：

• 比對目標意圖篩選器：如果意圖指定特定元件，就必須準確符合目標的意圖篩選器規格。如果您傳送意圖啟動其他應用程式的活動，目標意圖元件必須與接收活動的宣告意圖篩選器相符。
• 意圖必須包含動作：如果意圖不含任何動作，就無法再比對任何意圖篩選器。也就是說，用於啟動活動或服務的意圖必須具有明確定義的動作。
• 待處理意圖：待處理意圖的創作者會視為封閉意圖的傳送者，而非待處理意圖的傳送者

重要事項： 您可以啟用嚴格模式，協助找出應用程式的潛在問題。如要查看意圖用量違規的詳細記錄，請新增以下方法：

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 的視窗插邊有兩項變更：根據預設，系統會強制執行無邊框設計，以及設定變更 (例如系統列的預設設定)。

全面强制执行

在搭載 Android 15 的裝置上，應用程式預設為無邊框設計 指定 Android 15 (API 級別 35) 為目標。

注意： 使用 Material 3 Compose 元件的應用程式可能不會受到負面影響 因為大多數元件都會套用插邊使用 Material 2 Compose 元件的應用程式 Material 2 元件不會自動 並套用插邊。

以 Android 14 為目標版本，且非採用無邊框設計的應用程式

Android 15 裝置。

採用無邊框設計，指定 Android 15 (API 級別 35) 的應用程式 安裝在 Android 15 裝置上這個應用程式大多使用 Material 3 Compose 元件 系統會自動套用插邊這個畫面不會受 Android 15 強制採用的無邊框措施。

這項破壞性變更可能會對應用程式的 UI 造成負面影響。 變更會影響下列 UI 區域：

• 手勢控點導覽列
  • 預設為透明。
  • 已停用底部偏移，因此內容會在系統導覽後繪製 除非套用插邊
  • 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 14 為目標版本，且非採用無邊框設計的應用程式

Android 15 裝置。

採用無邊框設計，指定 Android 15 (API 級別 35) 的應用程式 安裝在 Android 15 裝置上不過，許多元素現在會由狀態隱藏 工具列、三按鈕導覽列，或螢幕凹口。 採取無邊框措施隱藏的 UI 包含 Material 2 頂端應用程式列、懸浮動作按鈕和清單項目。

以 Android 15 (API 級別 35) 為目標版本的應用程式採用無邊框設計。

Android 15 裝置並套用插邊，因此 UI 不會 隱藏。

要檢查應用程式是否已採用無邊框設計

如果您的應用程式已經採用無邊框設計，並套用插邊，那麼您 影響程度最高，不過下列情況除外。即使您認為 您不妨測試應用程式。

• 您有非浮動視窗，例如使用Activity 使用 SHORT_EDGES、NEVER 或 DEFAULT 取代 LAYOUT_IN_DISPLAY_CUTOUT_MODE_ALWAYS。如果您的應用程式在啟動時異常終止， 這可能是因為啟動畫面所致您可將核心肌群 splashscreen 依附元件至 1.2.0-alpha01 或之後設定 window.attributes.layoutInDisplayCutoutMode = WindowManager.LayoutInDisplayCutoutMode.always。
• 部分流量較低的畫面可能會遭遮蔽，驗證這些 較少造訪的畫面沒有遮蔽 UI。低流量畫麵包括：
  • 登入或登入畫面
  • 設定頁面

檢查應用程式是否為無邊框應用程式的方法

如果您的應用程式尚未採用無邊框設計，那麼您很有可能受到影響。於 除了採用無邊框設計的應用程式相關情境外 請考慮以下幾點：

• 如果您的應用程式使用 Material 3 元件 ( androidx.compose.material3) 在 Compose 中，例如 TopAppBar BottomAppBar 和 NavigationBar，這些元件可能不 會自動處理插邊。
• 如果應用程式使用 Material 2 元件 ( androidx.compose.material) 就不會自動處理插邊不過，您可以存取插邊 並手動套用在 androidx.compose.material 1.6.0 中 然後，使用 windowInsets 參數手動套用插邊 BottomAppBar、TopAppBar、 BottomNavigation和 NavigationRail。 同樣地，對以下項目使用 contentWindowInsets 參數： Scaffold.
• 如果應用程式使用檢視畫面和 Material 元件 (com.google.android.material)，多數以檢視畫面為基礎的 Material BottomNavigationView、BottomAppBar 等元件 NavigationRailView 或 NavigationView，處理插邊，且不需要 其他作業不過，您需要新增 android:fitsSystemWindows="true" 若使用 AppBarLayout。
• 如果是自訂可組合項，請手動將插邊套用為邊框間距。如果您的 在 Scaffold 內的內容，您可以使用 Scaffold 取用插邊 邊框間距值。否則，請使用 WindowInsets.
• 如果應用程式使用 View 和 BottomSheet、SideSheet 或自訂 來套用邊框間距 ViewCompat.setOnApplyWindowInsetsListener。適用對象 RecyclerView，使用這個事件監聽器套用邊框間距，同時新增 clipToPadding="false"。

檢查應用程式是否必須提供自訂背景保護的事項

如果您的應用程式必須在三按鈕操作模式下提供自訂背景保護措施 狀態列時，應用程式應將可組合項或檢視畫面放置在系統列後方 使用 WindowInsets.Type#tappableElement() 取得 3 按鈕 導覽列高度或 WindowInsets.Type#statusBars。

其他無邊框資源

詳情請參閱「Edge to Edge View」和「Edge to Edge Compose」 指南。

已淘汰的 API

下列 API 現已淘汰：

• R.attr#enforceStatusBarContrast
• R.attr#navigationBarColor
• R.attr#navigationBarDividerColor
• R.attr#statusBarColor
• Window#getNavigationBarColor
• Window#getNavigationBarDividerColor
• Window#getStatusBarColor
• Window#isStatusBarContrastEnforced
• Window#setDecorFitsSystemWindows
• Window#setNavigationBarColor
• Window#setNavigationBarDividerColor
• Window#setStatusBarColor
• Window#setStatusBarContrastEnforced

稳定配置

如果您的应用以 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 已废弃。
• 从 API 级别 33 开始，Display.getMetrics() 已采用这种方式。

routeTextHeight 屬性預設為 true

对于以 Android 15 为目标平台的应用，elegantTextHeight TextView 属性默认变为 true，将默认使用的紧凑字体替换为一些具有较大垂直指标的脚本，并且这种字体更易于阅读。紧凑字体的引入是为了防止破坏布局；Android 13（API 级别 33）允许文本布局利用 fallbackLineSpacing 属性拉伸垂直高度，以防止许多此类破坏。

在 Android 15 中，紧凑字体仍保留在系统中，因此您的应用可以将 elegantTextHeight 设置为 false，以获得与之前相同的行为，但即将在未来版本中提供支持。因此，如果您的应用支持以下文字：阿拉伯语、老挝语、缅甸、泰米尔语、古吉拉特语、卡纳达语、马拉雅拉姆语、奥里亚语、泰卢固语或泰语，请将 elegantTextHeight 设置为 true，以测试应用。

以 Android 14（API 级别 34）及更低版本为目标平台的应用的 elegantTextHeight 行为。

以 Android 15 为目标平台的应用的 elegantTextHeight 行为。

針對複雜的字母形狀變更 TextView 寬度

在舊版 Android 中，某些具有複雜形狀的草寫字型或語言，可能會從上一個或下一個字元的區域中繪製出字母。在某些情況下，這類字母會在開頭或結束位置遭到截斷。自 Android 15 起，TextView 會分配足夠空間供這類字母使用，並允許應用程式在左側要求額外的邊框間距，以免遭到裁剪。

由於這項變更會影響 TextView 決定寬度的方式，因此如果應用程式指定 Android 15 以上版本，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 元素的大小仍一致，如下圖所示：

三個方塊代表 EditText 元素，可包含英文 (en)、日文 (ja) 和緬甸文 (my)。EditText 的高度相同，即使這些語言的行高也不同。

對於指定 Android 15 為目標版本的應用程式，系統現在會為 EditText 保留最小行高，以便符合指定語言代碼的參考字型，如下圖所示：

三個方塊代表 EditText 元素，可包含英文 (en)、日文 (ja) 和緬甸文 (my)。EditText 的高度現在包含空間，以配合這些語言字型的預設行高。

如有需要，應用程式可將 useLocalePreferredLineHeightForMinimum 屬性指定為 false，藉此還原先前的行為，應用程式則可在 Kotlin 和 Java 中使用 setMinimumFontMetrics API，設定自訂的最小垂直指標。

相機與媒體

Android 15 針對指定 Android 15 以上版本為目標的應用程式，對相機和媒體行為做出下列變更。

要求音訊焦點的限制

以 Android 15 为目标平台的应用必须是顶级应用或运行前台服务，才能请求音频焦点。如果应用在不符合其中任何一项要求时尝试请求焦点，该调用将返回 AUDIOFOCUS_REQUEST_FAILED。

您可以参阅管理音频焦点，详细了解音频焦点。

更新非 SDK 限制

Android 15 包含更新后的受限非 SDK 列表 基于与 Android 开发者之间的协作以及最新的 内部测试在限制使用非 SDK 接口之前，我们会尽可能确保有可用的公开替代方案。

如果您的应用并非以 Android 15 为目标平台，其中一些变更 可能不会立即对您产生影响。不过，虽然您的应用可以 访问某些非 SDK 接口 具体取决于应用的目标 API 级别，使用任何非 SDK 均可 方法或字段总是很有破坏应用的风险。

如果您不确定自己的应用是否使用了非 SDK 接口，可以 测试您的应用，找出答案。如果您的应用依赖于非 SDK 接口，则应开始计划迁移到 SDK 替代方案。 尽管如此，我们了解到，某些应用具有 非 SDK 接口。如果您无法找到使用非 SDK 的替代方案 应用某项功能的界面，您应该 请求新的公共 API。

如要進一步瞭解此 Android 版本中的變更，請參閱 Android 15 的非 SDK 介面限制更新內容。如要進一步瞭解非 SDK 介面的一般資訊，請參閱非 SDK 介面的限制。