相容性架構異動 (Android 15)

CAMERA_MIC_INDICATORS_NOT_PRESENT

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

CHECK_PARAMS_IN_IS_SESSION_CONFIGURATION_SUPPORTED

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

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) 以下版本，仍須將 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) 以下版本為目標，系統會使用呼叫程序的 user (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 設為 true，固定螢幕方向的應用程式會在大螢幕裝置上覆寫為全螢幕。

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 異動」一節。