相容性架構異動 (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

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

ENABLE_MATCH_LOCAL_NETWORK

啟用後，應用程式預設會收到來自區域網路的網路回呼。指定 Android 14 (API 級別 34) 以下版本的應用程式仍需將 NetworkCapabilities.NET_CAPABILITY_LOCAL_NETWORK 新增至 NetworkRequest 的 NetworkCapabilities，才能接收來自區域聯播網的 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

啟用這項功能後，應用程式就無法再變更裝置上的勿擾模式 (DND) 全域狀態或政策 (無論是修改使用者設定，還是關閉勿擾模式)。相反地，應用程式必須提供 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 變更一節。