相容性架構異動 (Android 15)

CAMERA_MIC_INDICATORS_NOT_PRESENT

表示此裝置支援攝影機和麥克風指示燈。如果有顯示的話，將會是 false，因為如果未顯示變更 ID，則 CompatChanges#isChangeEnabled 方法會傳回 true。

CHECK_PARAMS_IN_IS_SESSION_CONFIGURATION_SUPPORTED

啟用後，isSessionConfigurationSupported 也會在 HAL 支援時檢查工作階段參數的相容性。

DEFAULT_RESCIND_BAL_PRIVILEGES_FROM_PENDING_INTENT_CREATOR

啟用後，PendingIntent 建立者預設會封鎖背景活動啟動程序。

如要進一步瞭解這項變更，請前往 Android 15 行為變更頁面參閱「 安全地從背景啟動活動」一節。

DEPRECATE_UI_FONT

啟用後，當應用程式在搭載 Android 15 以上版本的裝置上執行時，elegantTextHeight TextView 屬性預設會變成 true，將預設使用的精簡字型，替換成可讀性更高的字型，適用於垂直指標較大的部分指令碼。

如要進一步瞭解這項變更，請參閱 Android 15 行為變更頁面中的「 elegantTextHeight 屬性預設為 true」一節。

DOWNSCALED

這項變更可為所有依應用程式緩衝區降階的變更把關。啟用這項變更即可套用下列縮放比例係數：

• DOWNSCALE_30
• DOWNSCALE_35
• DOWNSCALE_40
• DOWNSCALE_45
• DOWNSCALE_50
• DOWNSCALE_55
• DOWNSCALE_60
• DOWNSCALE_65
• DOWNSCALE_70
• DOWNSCALE_75
• DOWNSCALE_80
• DOWNSCALE_85
• DOWNSCALE_90

為應用程式套件啟用這項變更後，應用程式就會強制將大小調整為已啟用的最高比例係數。舉例來說，如果同時啟用 80% 和 70% (DOWNSCALE_80 和 DOWNSCALE_70)，系統就會使用 80%。如果同時啟用這項變更和 DOWNSCALED_INVERSE，則 DOWNSCALED_INVERSE 會優先套用，且縮放比例係數會反向套用。

DOWNSCALED_INVERSE

這項變更可為所有依應用程式緩衝區反向降階的變更把關。啟用這項變更即可反向套用下列縮放比例係數 (也就是改為調高解析度)：

• DOWNSCALE_30
• DOWNSCALE_35
• DOWNSCALE_40
• DOWNSCALE_45
• DOWNSCALE_50
• DOWNSCALE_55
• DOWNSCALE_60
• DOWNSCALE_65
• DOWNSCALE_70
• DOWNSCALE_75
• DOWNSCALE_80
• DOWNSCALE_85
• DOWNSCALE_90

為應用程式套件啟用這項變更後，應用程式就會強制將大小調整為已啟用的最低比例係數。舉例來說，如果同時啟用 80% 和 70% (DOWNSCALE_80 和 DOWNSCALE_70)，系統會使用 80%，因為反向套用時，80% 的縮放比例係數等於 125%，小於反向套用 70% 縮放比例係數時的 142.86% 縮放比例。如果同時啟用這項變更和 DOWNSCALED，則 DOWNSCALED_INVERSE 會優先套用，且縮放比例係數會反向套用。

DOWNSCALE_30

如果也啟用了 DOWNSCALED，則此套件變更會使得應用程式假設當下運行螢幕的垂直和水平解析度為實際螢幕的 30%。如果也啟用了 DOWNSCALED_INVERSE，則此套件變更會使得應用程式假設當下運行螢幕的垂直和水平解析度為實際螢幕的 333.33%。

DOWNSCALE_35

如果也啟用了 DOWNSCALED，則此套件變更會使得應用程式假設當下運行螢幕的垂直和水平解析度為實際螢幕的 35%。如果也啟用了 DOWNSCALED_INVERSE，則此套件變更會使得應用程式假設當下運行螢幕的垂直和水平解析度為實際螢幕的 285.71%。

DOWNSCALE_40

如果也啟用了 DOWNSCALED，則此套件變更會使得應用程式假設當下運行螢幕的垂直和水平解析度為實際螢幕的 40%。如果也啟用了 DOWNSCALED_INVERSE，則此套件變更會使得應用程式假設當下運行螢幕的垂直和水平解析度為實際螢幕的 250%。

DOWNSCALE_45

如果也啟用了 DOWNSCALED，則此套件變更會使得應用程式假設當下運行螢幕的垂直和水平解析度為實際螢幕的 45%。如果也啟用了 DOWNSCALED_INVERSE，則此套件變更會使得應用程式假設當下運行螢幕的垂直和水平解析度為實際螢幕的 222.22%。

DOWNSCALE_50

如果也啟用了 DOWNSCALED，則此套件變更會使得應用程式假設當下運行螢幕的垂直和水平解析度為實際螢幕的 50%。如果也啟用了 DOWNSCALED_INVERSE，則此套件變更會使得應用程式假設當下運行螢幕的垂直和水平解析度為實際螢幕的 200%。

DOWNSCALE_55

如果也啟用了 DOWNSCALED，則此套件變更會使得應用程式假設當下運行螢幕的垂直和水平解析度為實際螢幕的 55%。如果也啟用了 DOWNSCALED_INVERSE，則此套件變更會使得應用程式假設當下運行螢幕的垂直和水平解析度為實際螢幕的 181.82%。

DOWNSCALE_60

如果也啟用了 DOWNSCALED，則此套件變更會使得應用程式假設當下運行螢幕的垂直和水平解析度為實際螢幕的 60%。如果也啟用了 DOWNSCALED_INVERSE，則此套件變更會使得應用程式假設當下運行螢幕的垂直和水平解析度為實際螢幕的 166.67%。

DOWNSCALE_65

如果也啟用了 DOWNSCALED，則此套件變更會使得應用程式假設當下運行螢幕的垂直和水平解析度為實際螢幕的 65%。如果也啟用了 DOWNSCALED_INVERSE，則此套件變更會使得應用程式假設當下運行螢幕的垂直和水平解析度為實際螢幕的 153.85%。

DOWNSCALE_70

如果也啟用了 DOWNSCALED，則此套件變更會使得應用程式假設當下運行螢幕的垂直和水平解析度為實際螢幕的 70%。如果也啟用了 DOWNSCALED_INVERSE，則此套件變更會使得應用程式假設當下運行螢幕的垂直和水平解析度為實際螢幕的 142.86%。

DOWNSCALE_75

如果也啟用了 DOWNSCALED，則此套件變更會使得應用程式假設當下運行螢幕的垂直和水平解析度為實際螢幕的 75%。如果也啟用了 DOWNSCALED_INVERSE，則此套件變更會使得應用程式假設當下運行螢幕的垂直和水平解析度為實際螢幕的 133.33%。

DOWNSCALE_80

如果也啟用了 DOWNSCALED，則此套件變更會使得應用程式假設當下運行螢幕的垂直和水平解析度為實際螢幕的 80%。如果也啟用了 DOWNSCALED_INVERSE，則此套件變更會使得應用程式假設當下運行螢幕的垂直和水平解析度為實際螢幕的 125%。

DOWNSCALE_85

如果也啟用了 DOWNSCALED，則此套件變更會使得應用程式假設當下運行螢幕的垂直和水平解析度為實際螢幕的 85%。如果也啟用了 DOWNSCALED_INVERSE，則此套件變更會使得應用程式假設當下運行螢幕的垂直和水平解析度為實際螢幕的 117.65%。

DOWNSCALE_90

如果也啟用了 DOWNSCALED，則此套件變更會使得應用程式假設當下運行螢幕的垂直和水平解析度為實際螢幕的 90%。如果也啟用了 DOWNSCALED_INVERSE，則此套件變更會使得應用程式假設當下運行螢幕的垂直和水平解析度為實際螢幕的 111.11%。

DO_NOT_CLONE_IN_ARRAYS_AS_LIST

啟用後，使用 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]);

如要進一步瞭解這項變更，請參閱 Android 15 行為變更頁面中的「 OpenJDK API 變更」一節。

ENABLE_BUNDLE_LAUNCH_ACTIVITY_ITEM

啟用後，為避免現有應用程式因使用非 SDK 版本的 ClientTransaction#getActivityToken() 而發生應用程式相容性問題，請只允許捆綁 LaunchActivityItem。

ENABLE_MATCH_LOCAL_NETWORK

啟用後，應用程式預設會收到區域網路的網路回呼。如果應用程式指定 Android 14 (API 級別 34) 以下版本為目標，仍須在 NetworkRequest 的 NetworkCapabilities 中加入 NetworkCapabilities.NET_CAPABILITY_LOCAL_NETWORK，才能接收來自本機網路的 ConnectivityManager.NetworkCallback。

ENABLE_STRICT_FORMATTER_VALIDATION

啟用後，使用 String.format() 和 Formatter.format() API 時，系統會更嚴格地驗證引數索引、旗標、寬度和精確度。

如要進一步瞭解這項變更，請參閱 Android 15 行為變更頁面中的「 OpenJDK API 變更」一節。

ENFORCE_EDGE_TO_EDGE

啟用後，在搭載 Android 15 以上版本的裝置上，應用程式預設會顯示無邊框模式。

如要進一步瞭解這項變更，請參閱 Android 15 行為變更頁面中的「 無邊框強制執行」一節。

ENFORCE_STRICT_QUERY_BUILDER

啟用之後，SQLiteQueryBuilder 會針對惡意引數驗證所有 CalendarProvider2 查詢選取項目。

FGS_BOOT_COMPLETED_RESTRICTIONS

啟用後，系統會針對以下類型以外的所有類型，停用從 BOOT_COMPLETED 廣播啟動的前景服務：

• ServiceInfo.FOREGROUND_SERVICE_TYPE_LOCATION
• ServiceInfo.FOREGROUND_SERVICE_TYPE_CONNECTED_DEVICE
• ServiceInfo.FOREGROUND_SERVICE_TYPE_REMOTE_MESSAGING
• ServiceInfo.FOREGROUND_SERVICE_TYPE_HEALTH
• ServiceInfo.FOREGROUND_SERVICE_TYPE_SYSTEM_EXEMPTED
• ServiceInfo.FOREGROUND_SERVICE_TYPE_SPECIAL_USE

如要進一步瞭解這項變更，請前往 Android 15 行為變更頁面參閱「 限制 BOOT_COMPLETED 廣播接收器啟動前景服務」一節。

FGS_INTRODUCE_TIME_LIMITS

啟用後，特定類型的前景服務會有時間限制。如果違規類型的前景服務未在指定時間內停止，系統會使用 Service.onTimeout(int, int) 傳送回呼，服務必須在幾秒內停止。如果應用程式無法在時限內完成，系統就會宣告發生 ANR。

如要進一步瞭解這項變更，請參閱 Android 15 行為變更頁面中，有關 資料同步和 媒體處理前景服務類型逾時行為的部分。

FGS_SAW_RESTRICTIONS

啟用後，系統會針對所有類型停用「系統警示視窗」中的前景服務背景啟動作業，除非該服務已具備「系統疊加視窗」。

如要進一步瞭解這項變更，請前往 Android 15 行為變更頁面參閱「 應用程式持有 SYSTEM_ALERT_WINDOW 權限時啟動前景服務的限制」一節。

FORCE_DISABLE_HEVC_SUPPORT

強制停用應用程式支援 HEVC 媒體功能。 應用程式應該在其資訊清單中宣告支援的媒體功能，不過這個標記可用來強制禁止應用程式支援 HEVC，進而在存取以 HEVC 編碼的媒體時執行強制轉碼。設定此標記後，系統將會覆寫應用程式所有 OS 級別的預設值。此設定依預設為停用狀態，表示系統會優先採用 OS 預設值。如果同時啟用這個標記和 FORCE_ENABLE_HEVC_SUPPORT，OS 會忽略這兩個標記。

FORCE_ENABLE_HEVC_SUPPORT

強制允許應用程式支援 HEVC 媒體功能 應用程式應該在其資訊清單中宣告支援的媒體功能，不過這個標記可用來強制要求應用程式支援 HEVC，進而避免在存取以 HEVC 編碼的媒體時進行轉碼。設定此標記後，系統將會覆寫應用程式所有 OS 級別的預設值。此設定依預設為停用狀態，表示系統會優先採用 OS 預設值。如果同時啟用此標記和 FORCE_DISABLE_HEVC_SUPPORT，OS 會忽略這兩個標記。

FORCE_NON_RESIZE_APP

強制要求已套用的套件禁止調整大小操作。

FORCE_RESIZE_APP

強制要求已套用的套件啟用調整大小操作。我們僅允許在全螢幕模式下調整視窗大小，不會強制要求應用程式套用可調整大小的多視窗模式。

GWP_ASAN

在應用程式中啟用取樣的原生記憶體錯誤偵測功能。

如要進一步瞭解如何使用 GWP-ASan，請參閱 GWP-ASan 指南。

IS_DEVICE_OWNER_USER_AWARE

啟用後，isDeviceOwnerApp(String) 方法會使用內容中包含的使用者。如果是指定 Android 14 (API 級別 34) 以下為目標版本的應用程式，系統會使用呼叫程序的擁有者 (Process.myUserHandle())。

MANAGE_GLOBAL_ZEN_VIA_IMPLICIT_RULES

啟用這項政策後，應用程式就無法再變更裝置的「請勿打擾」模式全域狀態或政策 (無論是修改使用者設定或關閉「請勿打擾」模式)。應用程式必須提供 AutomaticZenRule，系統會根據現有的「最嚴格政策優先」機制，將這項政策與其他政策合併為全域政策。

如要進一步瞭解這項變更，請參閱 Android 15 行為變更頁面中的「 應用程式可修改『請勿打擾』模式全域狀態的時間異動」一節。

NATIVE_HEAP_ZERO_INIT

啟用原生堆積記憶體配置的自動零初始化功能。

NATIVE_MEMTAG_ASYNC

在此程序中啟用非同步 (ASYNC) 記憶體標記檢查。 此標記只會影響支援 ARM Memory Tagging Extension (MTE) 的硬體。

NATIVE_MEMTAG_SYNC

在此程序中啟用同步 (SYNC) 記憶體標記檢查。 此標記只會影響支援 ARM Memory Tagging Extension (MTE) 的硬體。若同時啟用 NATIVE_MEMTAG_ASYNC 和此選項，則會以此選項為優先，並在 SYNC 模式下啟用 MTE。

OVERRIDE_ANY_ORIENTATION

啟用這項變更後，無論活動要求哪個方向，系統都會套用下列方向覆寫：

• OVERRIDE_LANDSCAPE_ORIENTATION_TO_REVERSE_LANDSCAPE
• OVERRIDE_UNDEFINED_ORIENTATION_TO_NOSENSOR
• OVERRIDE_UNDEFINED_ORIENTATION_TO_PORTRAIT

OVERRIDE_ANY_ORIENTATION_TO_USER

啟用後，系統會啟用 SCREEN_ORIENTATION_USER，覆寫活動要求的任何方向。如果啟用這項覆寫功能，固定方向的應用程式在大螢幕裝置上可以覆寫為全螢幕模式。ignoreOrientationRequest

OVERRIDE_CAMERA_COMPAT_DISABLE_FREEFORM_WINDOWING_TREATMENT

啟用後，系統會將套用覆寫值的套件從相機相容性處置中排除，適用於固定方向應用程式的任意形式視窗模式。

在任意形式視窗模式中，相容性處理方式會模擬在直向裝置上執行應用程式，方法是將應用程式視窗加上上下黑邊，並將相機特性變更為應用程式在直向裝置上通常預期的特性：後置和前置鏡頭的感應器旋轉角度分別為 90 度和 270 度，並將螢幕旋轉角度設為 0。

如果應用程式無法妥善處理相容性問題，請使用這個標記停用相容性處理程序。

OVERRIDE_CAMERA_RESIZABLE_AND_SDK_CHECK

啟用後，此變更會強制其套用的套件忽略 android:resizeableActivity 當前的值，並且鎖定與 Android 6.0 (API 級別 23) 相等或更低的 SDK，然後將活動視為無法調整大小。在此情況下，基於目前螢幕旋轉方向的考量，相機旋轉和裁剪的值將僅取決於所需的補償。

OVERRIDE_CAMERA_ROTATE_AND_CROP_DEFAULTS

啟用後，此變更會強制其套用的套件覆寫預設的相機旋轉和裁剪行為，並且一律會傳回 CaptureRequest.SCALER_ROTATE_AND_CROP_NONE。

OVERRIDE_DISABLE_MEDIA_PROJECTION_SINGLE_APP_OPTION

啟用後，使用者啟動 MediaProjection 工作階段時，系統會確保他們可以選擇擷取單一應用程式或整個畫面，並覆寫 MediaProjectionConfig#createConfigForDefaultDisplay 的使用情形。

OVERRIDE_LANDSCAPE_ORIENTATION_TO_REVERSE_LANDSCAPE

為套用該修飾符的應用程式啟用 SCREEN_ORIENTATION_REVERSE_LANDSCAPE 。除非也啟用 OVERRIDE_ANY_ORIENTATION，否則只有在活動指定橫向時，系統才會使用 SCREEN_ORIENTATION_REVERSE_LANDSCAPE。啟用這項變更後，您就能測試應用程式在橫向螢幕方向對應於 Surface.ROTATION_90 的裝置上，與對應於 Surface.ROTATION_270 的裝置上，行為是否有所差異。

OVERRIDE_LAYOUT_IN_DISPLAY_CUTOUT_MODE

啟用後，系統會覆寫螢幕凹口模式行為中的版面配置。只有在系統未強制採用無邊框設計時，才會套用這項設定。

OVERRIDE_MIN_ASPECT_RATIO

這項變更負責為所有強制執行特定最小顯示比例的變更把關。啟用這項變更即可套用下列最小顯示比例：

• OVERRIDE_MIN_ASPECT_RATIO_LARGE
• OVERRIDE_MIN_ASPECT_RATIO_MEDIUM
• OVERRIDE_MIN_ASPECT_RATIO_PORTRAIT_ONLY

為應用程式套件啟用此變更後，除非應用程式資訊清單中的值較大，否則應用程式資訊清單中指定的最小顯示比例將被覆寫為可啟用的最大顯示比例。

OVERRIDE_MIN_ASPECT_RATIO_EXCLUDE_PORTRAIT_FULLSCREEN

啟用後，系統會覆寫直向全螢幕模式的最小顯示比例限制，以便使用所有可用的螢幕空間。

OVERRIDE_MIN_ASPECT_RATIO_LARGE

此時如果也啟用了 OVERRIDE_MIN_ASPECT_RATIO，則此套件變更會將活動的最小顯示比例設定為由 OVERRIDE_MIN_ASPECT_RATIO_LARGE_VALUE 所定義的較大值。

OVERRIDE_MIN_ASPECT_RATIO_MEDIUM

此時如果也啟用了 OVERRIDE_MIN_ASPECT_RATIO，則此套件變更會將活動的最小顯示比例設定為由 OVERRIDE_MIN_ASPECT_RATIO_MEDIUM_VALUE 所定義的中間值。

OVERRIDE_MIN_ASPECT_RATIO_ONLY_FOR_CAMERA

啟用後，系統會限制強制執行特定最小顯示比例的處置，只在應用程式連上相機時套用。

OVERRIDE_MIN_ASPECT_RATIO_PORTRAIT_ONLY

此時如果也啟用了 OVERRIDE_MIN_ASPECT_RATIO，則此變更便會針對同樣具備直向螢幕方向的活動，限制其他任何強制將活動最小顯示比例設定為特定值的變更，例如 OVERRIDE_MIN_ASPECT_RATIO_LARGE 和 OVERRIDE_MIN_ASPECT_RATIO_MEDIUM。

OVERRIDE_RESPECT_REQUESTED_ORIENTATION

啟用後，這項變更會從裝置製造商可設定的忽略方向限制中，排除套用的套件。

OVERRIDE_UNDEFINED_ORIENTATION_TO_NOSENSOR

為套用該修飾符的應用程式啟用 SCREEN_ORIENTATION_NOSENSOR 。除非也啟用 OVERRIDE_ANY_ORIENTATION，否則只有在活動未指定其他固定方向時，系統才會使用 SCREEN_ORIENTATION_NOSENSOR。

OVERRIDE_UNDEFINED_ORIENTATION_TO_PORTRAIT

為套用該修飾符的應用程式啟用 SCREEN_ORIENTATION_PORTRAIT 。除非也啟用 OVERRIDE_ANY_ORIENTATION，否則只有在活動未指定其他固定方向時，系統才會使用 SCREEN_ORIENTATION_PORTRAIT。

PARSE_CONTENT_DISPOSITION_USING_RFC_6266

啟用後，系統會允許剖析符合 RFC 6266 的 Content-Disposition 標頭。具體來說，這項功能可剖析使用不同字元編碼的 filename* 值。

RATE_LIMIT_TOASTS

對 Toast.show() 的呼叫次數啟用頻率限制，以免使用者在某段時間內收到大量浮動式訊息。若嘗試在特定時間範圍內顯示超過許可數量的浮動式訊息時，系統將會捨棄浮動式訊息。

STREAM_INT_DIFFERS_FROM_NEXT_INT

啟用後，Random.ints() 方法現在會傳回與 Random.nextInt() 方法不同的數字序列。這是因為 https://bugs.openjdk.org/browse/JDK-8301574 的變更。

如要進一步瞭解這項變更，請參閱 Android 15 行為變更頁面中的「 OpenJDK API 變更」一節。

USE_EXPERIMENTAL_COMPONENT_ALIAS

啟用後，系統將允許「android」套件使用元件別名。

USE_NEW_ISO_LOCALE_CODES

啟用後，希伯來文、意第緒文和印尼文的語言代碼將不再轉換為舊版形式 (希伯來文：iw、意第緒文：ji，以及印尼文：in)。

如要進一步瞭解這項變更，請參閱 Android 15 行為變更頁面中的「 OpenJDK API 變更」一節。