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

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

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

核心功能

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

前景服務變更

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

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

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

系統允許應用程式的 dataSync 服務在 24 小時內總共執行 6 小時,之後系統會呼叫執行中服務的 Service.onTimeout(int, int) 方法 (於 Android 15 中導入)。目前,服務有幾秒鐘才能呼叫 Service.stopSelf()。一旦呼叫 Service.onTimeout(),服務就不再視為前景服務。如果服務未呼叫 Service.stopSelf(),就會發生錯誤,並顯示以下錯誤訊息:「<fgs_type> 的前景服務並未在逾時內停止:<component_name>」。在 Beta 版 2 中,失敗訊息會顯示為 ANR,但在日後的 Beta 版中,這個失敗訊息將擲回自訂例外狀況。

如要避免發生這項行為變更的問題,您可以執行下列一或多項操作:

  1. 讓您的服務實作新的 Service.onTimeout(int, int) 方法。應用程式收到回呼時,請務必在幾秒內呼叫 stopSelf()。(如果您未立即停止應用程式,系統會產生失敗)。
  2. 請確保應用程式的 dataSync 服務在 24 小時內最多執行超過 6 小時 (除非使用者與應用程式互動、重設計時器)。
  3. 只有在使用者直接互動後,才啟動 dataSync 前景服務;由於服務在服務啟動時位於前景,因此服務在應用程式進入背景後可持續六小時。
  4. 應使用替代 API,而非 dataSync 前景服務。

如果應用程式的 dataSync 前景服務在過去 24 內已執行 6 小時,則「除非」使用者將應用程式移至前景 (重設計時器),否則您無法啟動其他 dataSync 前景服務。如果您嘗試啟動另一個 dataSync 前景服務,系統會擲回 ForegroundServiceStartNotAllowedException 並顯示錯誤訊息,例如「Time limit has been outed for 前景 service type dataSync」。

新增媒體處理前景服務類型

Android 15 introduces a new foreground service type, mediaProcessing. This service type is appropriate for operations like transcoding media files. For example, a media app might download an audio file and need to convert it to a different format before playing it. You can use a mediaProcessing foreground service to make sure the conversion continues even while the app is in the background.

The system permits an app's mediaProcessing services to run for a total of 6 hours in a 24-hour period, after which the system calls the running service's Service.onTimeout(int, int) method (introduced in Android 15). At this time, the service has a few seconds to call Service.stopSelf(). If the service does not call Service.stopSelf(), a failure will occur with this error message: "A foreground service of <fgs_type> did not stop within its timeout: <component_name>". In Beta 2, the failure message is shown as an ANR, but in a future Beta release, this failure message will throw a custom exception.

To avoid getting an ANR, you can do one of the following:

  1. Have your service implement the new Service.onTimeout(int, int) method. When your app receives the callback, make sure to call stopSelf() within a few seconds. (If you don't stop the app right away, the system generates a failure.)
  2. Make sure your app's mediaProcessing services don't run for more than a total of 6 hours in any 24-hour period (unless the user interacts with the app, resetting the timer).
  3. Only start mediaProcessing foreground services as a result of direct user interaction; since your app is in the foreground when the service starts, your service has the full six hours after the app goes to the background.
  4. Instead of using a mediaProcessing foreground service, use an alternative API, like WorkManager.

If your app's mediaProcessing foreground services have run for 6 hours in the last 24, you cannot start another mediaProcessing foreground service unless the user has brought your app to the foreground (which resets the timer). If you try to start another mediaProcessing foreground service, the system throws ForegroundServiceStartNotAllowedException with an error message like "Time limit already exhausted for foreground service type mediaProcessing".

For more information about the mediaProcessing service type, see Changes to foreground service types for Android 15: Media processing.

BOOT_COMPLETED 個廣播接收器啟動前景服務的相關限制

针对启动前台服务的 BOOT_COMPLETED 广播接收器存在新的限制。BOOT_COMPLETED 接收器不能启动以下类型的前台服务:

如果 BOOT_COMPLETED 接收器尝试启动任何此类前台服务,系统会抛出 ForegroundServiceStartNotAllowedException

在應用程式擁有 SYSTEM_ALERT_WINDOW 權限時啟動前景服務的限制

Previously, if an app held the SYSTEM_ALERT_WINDOW permission, it could launch a foreground service even if the app was currently in the background (as discussed in exemptions from background start restrictions).

If an app targets Android 15, this exemption is now narrower. The app now needs to have the SYSTEM_ALERT_WINDOW permission and also have a visible overlay window. That is, the app needs to first launch a TYPE_APPLICATION_OVERLAY window and the window needs to be visible before you start a foreground service.

If your app attempts to start a foreground service from the background without meeting these new requirements (and it does not have some other exemption), the system throws ForegroundServiceStartNotAllowedException.

If your app declares the SYSTEM_ALERT_WINDOW permission and launches foreground services from the background, it may be affected by this change. If your app gets a ForegroundServiceStartNotAllowedException, check your app's order of operations and make sure your app already has an active overlay window before it attempts to start a foreground service from the background. You can check if your overlay window is currently visible by calling View.getWindowVisibility(), or you can override View.onWindowVisibilityChanged() to get notified whenever the visibility changes.

有關應用程式可修改「零打擾」模式全域狀態的時間異動

Apps that target Android 15 can no longer change the global state or policy of Do Not Disturb (DND) on a device (either by modifying user settings, or turning off DND mode). Instead, apps must contribute an AutomaticZenRule, which the system combines into a global policy with the existing most-restrictive-policy-wins scheme. Calls to existing APIs that previously affected global state (setInterruptionFilter, setNotificationPolicy) result in the creation or update of an implicit AutomaticZenRule, which is toggled on and off depending on the call-cycle of those API calls.

Note that this change only affects observable behavior if the app is calling setInterruptionFilter(INTERRUPTION_FILTER_ALL) and expects that call to deactivate an AutomaticZenRule that was previously activated by their owners.

OpenJDK 17 變更

Android 15 會繼續更新 Android 核心程式庫,以便與最新版 OpenJDK LTS 中的功能保持一致。

其中一項變更可能會影響指定 Android 15 的應用程式相容性:

  • 字串格式 API 變更:現在使用下列 String.format()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、Yiddish:ji 和印尼文:in)。 指定其中一個語言代碼的語言代碼時,請改用 ISO 639ish-1 和 印尼文 (希伯來文):he、印尼文、印尼文 (12)。yiid

  • 隨機連續序列的變更:完成 https://bugs.openjdk.org/browsing/JDK-8301574 變更後,下列 Random.ints() 方法會傳回與 Random.nextInt() 方法不同的數字序列:

    一般而言,這項變更應該不會導致應用程式破壞行為,但您的程式碼不應預期從 Random.ints() 方法產生的順序與 Random.nextInt() 相符。

安全性

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).

Block apps that don't match the top UID on the stack from launching activities

Malicious apps can launch another app's activity within the same task, then overlay themselves on top, creating the illusion of being that app. This "task hijacking" attack bypasses current background launch restrictions because it all occurs within the same visible task. To mitigate this risk, Android 15 adds a flag that blocks apps that don't match the top UID on the stack from launching activities. To opt in for all of your app's activities, update the allowCrossUidActivitySwitchFromBelow attribute in your app's AndroidManifest.xml file:

<application android:allowCrossUidActivitySwitchFromBelow="false" >

The new security measures are active if all of the following are true:

  • The app performing the launch targets Android 15.
  • The app on top of the task stack targets Android 15.
  • Any visible activity has opted in to the new protections

If the security measures are enabled, apps might return home, rather than the last visible app, if they finish their own task.

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 introduces new security measures to make intents safer and more robust. These changes are aimed at preventing potential vulnerabilities and misuse of intents that can be exploited by malicious apps. There are two main improvements to the security of intents in Android 15:

  • Match target intent-filters: Intents that target specific components must accurately match the target's intent-filter specifications. If you send an intent to launch another app's activity, the target intent component needs to align with the receiving activity's declared intent-filters.
  • Intents must have actions: Intents without an action will no longer match any intent-filters. This means that intents used to start activities or services must have a clearly defined action.

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 為目標版本,則應用程式預設即無邊框的應用程式。

適用於指定 Android 14,且在 Android 15 裝置沒有無邊框的應用程式。


以 Android 15 為目標版本,且在 Android 15 裝置上無邊框的應用程式。這個應用程式主要使用會自動套用插邊的 Material 3 Compose 元件。這個畫面不會受到 Android 15 邊緣強制執行的負面影響。

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

  • 手勢操控導覽列
    • 預設為透明。
    • 底部偏移已停用,因此除非套用插邊,否則內容會在系統導覽列後方繪製。
    • setNavigationBarColorR.attr#navigationBarColor 已淘汰,且不會影響手勢操作。
    • setNavigationBarContrastEnforcedR.attr#navigationBarContrastEnforced 並不會對手勢操作造成任何影響。
  • 三按鈕操作
    • 透明度預設為 80%,且顏色可能與視窗背景相符。
    • 已停用底部偏移,除非套用插邊,否則內容會在系統導覽列後方繪製。
    • 根據預設,setNavigationBarColorR.attr#navigationBarColor 會設為與視窗背景一致。視窗背景必須是可繪項目的顏色,才能套用此預設值。此 API 已淘汰,但會繼續影響三按鈕操作。
    • setNavigationBarContrastEnforcedR.attr#navigationBarContrastEnforced 預設為 true,會在 3 按鈕導覽中新增 80% 不透明背景。
  • 狀態列
    • 預設為透明。
    • 頂端偏移已停用,因此除非套用插邊,否則內容會在狀態列後方繪製。
    • setStatusBarColorR.attr#statusBarColor 已淘汰,對 Android 15 沒有影響。
    • setStatusBarContrastEnforcedR.attr#statusBarContrastEnforced 已淘汰,但仍會在 Android 15 上正常運作。
  • 螢幕凹口
    • 非浮動視窗的 layoutInDisplayCutoutMode 必須為 LAYOUT_IN_DISPLAY_CUTOUT_MODE_ALWAYSSHORT_EDGESNEVERDEFAULT 會被解讀為 ALWAYS,讓使用者不會因螢幕凹口造成的黑條而無邊框顯示。

以下範例顯示指定 Android 15 前後和套用插邊之後的應用程式。

適用於指定 Android 14,且在 Android 15 裝置沒有無邊框的應用程式。
以 Android 15 為目標版本,且在 Android 15 裝置上無邊框的應用程式。不過,由於 Android 15 無邊框強制執行,因此許多元素現在都會遮蓋住狀態列、三按鈕導覽列或顯示凹口。遮蔽的 UI 包含 Material 2 頂端應用程式列、懸浮動作按鈕和清單項目。
以 Android 15 為目標版本的應用程式,在 Android 15 裝置的邊緣邊緣到邊緣並套用插邊,因此 UI 不會遭到遮蔽。
如何檢查應用程式是否已採用無邊框設計

如果您的應用程式已採用無邊框設計並套用插邊,則大部分不受影響,但以下情況除外。不過,如果您認為自己並未受到影響,我們仍建議您測試應用程式。

  • 您有一個非浮動視窗,例如 Activity 使用 SHORT_EDGESNEVERDEFAULT,而非 LAYOUT_IN_DISPLAY_CUTOUT_MODE_ALWAYS。如果應用程式在啟動時當機,可能是因為啟動畫面所致。您可以將核心啟動畫面依附元件升級為 1.2.0-alpha01 或後續版本,或是設定 window.attributes.layoutInDisplayCutoutMode = WindowManager.LayoutInDisplayCutoutMode.always
  • 可能有流量較少的畫面,並會遮住 UI。確認這些不曾造訪的畫面沒有遮蔽的 UI。流量較低的螢幕包括:
    • 新手上路或登入畫面
    • 設定頁面
如何檢查應用程式是否已採用無邊框設計

如果您的應用程式尚未採用無邊框設計,那麼您很有可能受到影響。除了已採用無邊框的應用程式適用情況之外,您還應考慮下列事項:

  • 如果應用程式在 Compose 中使用 Material 3 元件 (androidx.compose.material3),例如 TopAppBarBottomAppBarNavigationBar,這些元件會自動處理插邊,因此可能沒有影響。
  • 如果您的應用程式在 Compose 中使用 Material 2 元件 (androidx.compose.material),這些元件不會自動處理插邊。不過,您可以存取插邊並手動套用。在 androidx.compose.material 1.6.0 及以上版本中,使用 windowInsets 參數手動套用 BottomAppBarTopAppBarBottomNavigationNavigationRail 的插邊。同樣地,請將 Scaffold 使用 contentWindowInsets 參數。
  • 如果您的應用程式使用檢視畫面和 Material 元件 (com.google.android.material),大部分的以檢視畫面為基礎的 Material 元件 (例如 BottomNavigationViewBottomAppBarNavigationRailViewNavigationView) 都會處理插邊,因此不需要額外工作。不過,如果您使用 AppBarLayout,就必須新增 android:fitsSystemWindows="true"
  • 如果是自訂可組合項,請手動套用插邊做為邊框間距。如果內容位於 Scaffold 中,您可以使用 Scaffold 邊框間距值使用插邊。否則,請使用任一個 WindowInsets 套用邊框間距。
  • 如果您的應用程式使用檢視畫面和 BottomSheetSideSheet 或自訂容器,請使用 ViewCompat.setOnApplyWindowInsetsListener 套用邊框間距。如果是 RecyclerView,請使用這個事件監聽器套用邊框間距,並新增 clipToPadding="false"
檢查應用程式是否必須提供自訂背景防護功能

如果應用程式必須為三按鈕導覽或狀態列提供自訂背景保護功能,則應使用 WindowInsets.Type#tappableElement() 將可組合項或檢視畫面放置在系統列後方,以取得 3 按鈕導覽列的高度或 WindowInsets.Type#statusBars

其他邊緣資源

如要進一步瞭解套用插邊的其他注意事項,請參閱「Edge to Edge View」(邊緣檢視畫面) 和「Edge to Edge Compose」(邊緣 Compose) 指南。

已淘汰的 API

下列 API 現已淘汰:

穩定版設定

如果您的应用以 Android 15 或更高版本为目标平台,Configuration 将不再排除系统栏。如果您在 Configuration 类中使用屏幕尺寸计算布局,则应根据需要将其替换为合适的 ViewGroupWindowInsetsWindowMetricsCalculator 等更好的替代方案。

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

配置大小通常用于资源选择(如 /res/layout-h500dp),这仍然是一个有效的用例。不过,我们一直不建议将其用于布局计算。如果这样做,您应该立即离开。您应该根据自己的使用场景,将 Configuration 替换为更合适的代码。

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

以下列表介绍了受此更改影响的字段:

典雅 TextHeight 屬性預設為 true

For apps targeting Android 15, the elegantTextHeight TextView attribute becomes true by default, replacing the compact font used by default with some scripts that have large vertical metrics with one that is much more readable. The compact font was introduced to prevent breaking layouts; Android 13 (API level 33) prevents many of these breakages by allowing the text layout to stretch the vertical height utilizing the fallbackLineSpacing attribute.

In Android 15, the compact font still remains in the system, so your app can set elegantTextHeight to false to get the same behavior as before, but it is unlikely to be supported in upcoming releases. So, if your app supports the following scripts: Arabic, Lao, Myanmar, Tamil, Gujarati, Kannada, Malayalam, Odia, Telugu or Thai, test your app by setting elegantTextHeight to true.

elegantTextHeight behavior for apps targeting Android 14 (API level 34) and lower.
elegantTextHeight behavior for apps targeting Android 15.

針對複雜的字母形狀變更 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

如果前台服务的类型为 mediaPlaybackcameramicrophonephoneCall,则会被视为与音频相关。

如需详细了解音频焦点,请参阅管理音频焦点

更新非 SDK 限制

基於與 Android 開發人員合作及最新的內部測試,Android 15 包含更新後的受限制非 SDK 介面清單。在限制非 SDK 介面之前,我們盡可能確保公開替代方案的可得性。

如果您的應用程式並不是以 Android 15 為目標版本,則此處所述的某些變更可能不會立即對您造成影響。不過,視應用程式的目標 API 級別而定,應用程式可以存取部分非 SDK 介面,但使用任何非 SDK 方法或欄位時,都會面臨應用程式停止運作的高度風險。

如果不確定應用程式是否使用非 SDK 介面,可測試應用程式以便確認。如果您的應用程式仰賴非 SDK 介面,則建議您開始規劃遷移至 SDK 替代方案。我們瞭解有些應用程式可使用非 SDK 介面的有效用途。如果您除了為應用程式中的某個功能使用非 SDK 介面外,已別無他法,則應要求新的公用 API

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