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

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

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

注意： 本頁面列出部分較重要的異動。詳情請參閱 Android 17 版本資訊。

使用者體驗和系統 UI

Android 17 包含下列異動項目，旨在打造更一致、直覺的使用者體驗。

記憶體限制小工具

自 Android 17 起，如果應用程式指定 Android 17 (API 級別 37) 以上版本為目標，系統會對 RemoteViews 更新強制執行嚴格的記憶體限制。當應用程式將 RemoteViews 物件傳遞至 AppWidgetManager.updateAppWidget 時，system_server 會計算酬載中所有方向和大小值區的所有圖片資料總記憶體用量。如果總記憶體超過系統上限 (mMaxWidgetBitmapMemory)，系統會拒絕更新並擲回 IllegalArgumentException：

java.lang.IllegalArgumentException: RemoteViews for widget update exceeds maximum bitmap memory usage (used: XXXXX, max: YYYYY)

如果應用程式指定 API 級別 36 以下，系統會將這項記憶體違規記錄為警告 (Slog.w)，不會擲回例外狀況。

Android 技能

前往 GitHub 查看

管理 AppWidget 更新和點陣圖記憶體

使用 AppWidget 更新和記憶體 Android 技能，對小工具點陣圖進行降取樣、簡化回應式圖片，並確保 Glance 和傳統 AppWidgetProvider 小工具的記憶體用量，符合 Android 17 RemoteViews 限制。

如要透過 Android CLI 安裝技能，請執行：

android skills add glance-appwidget-updates-and-memory

系統如何計算記憶體上限

系統會根據目前顯示設定，將小工具點陣圖記憶體預算設為 6 * width * height 位元組 (1.5 * 4 * width * height，相當於全螢幕 ARGB_8888 緩衝區大小的 1.5 倍)。在 API 級別 37 以上，這項計算會包含下列兩項：

• 儲存在 RemoteViews.mBitmapCache 中的記憶體內 Bitmap 和點陣圖支援的 Icon 物件 (Icon.TYPE_BITMAP 和 Icon.TYPE_ADAPTIVE_BITMAP)，例如呼叫 setImageViewBitmap、Icon.createWithBitmap、Icon.createWithAdaptiveBitmap 或 Jetpack Glance ImageProvider(bitmap)。mBitmapCache 中每個不重複的 Bitmap 或點陣圖支援的 Icon 例項，在每個 RemoteViews 階層中都會計入一次。
• URI 支援的圖片 (Icon.createWithContentUri、setImageViewUri 或 Glance ImageProvider(uri)) 不會計入 system_server 中的 RemoteViews IPC 位元組上限，但小工具主機程序會將參照的 content:// 檔案以完整解析度解碼至自己的堆積。請務必先將降取樣圖片寫入 context.cacheDir，再透過 FileProvider URI 公開。

緩解步驟

如要確保手機、平板電腦和摺疊式裝置的小工具更新不超過記憶體上限，請按照下列步驟操作：

1. 從 WindowMetrics 計算執行階段記憶體預算：在 API 級別 30 以上，請從 WindowManager.currentWindowMetrics.bounds 讀取有效視窗邊界，而非 resources.displayMetrics。在多解析度裝置和摺疊式裝置上，displayMetrics 可能會回報未啟用的螢幕尺寸。請將小工具圖片總預算估算為 6L * bounds.width() * bounds.height()，如以下範例所示：

   private const val FALLBACK_MAX_BYTES = 15_000_000L
   
   fun calculateWidgetMemoryCapBytes(context: Context): Long {
       if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.R) {
           val wm = context.getSystemService(WindowManager::class.java)
               ?: return FALLBACK_MAX_BYTES
           val bounds = wm.currentWindowMetrics.bounds
           return 6L * bounds.width().toLong() * bounds.height().toLong()
       }
       val dm = context.resources.displayMetrics
       return 6L * dm.widthPixels.toLong() * dm.heightPixels.toLong()
   }
   

2. 將圖片降取樣至小工具的可檢視尺寸，並使用 RGB_565： 使用 2 的乘冪 BitmapFactory.Options.inSampleSize 值解碼點陣圖，其大小應為小工具的最大顯示尺寸 (maxWidthDp 乘以 maxHeightDp)，並針對不透明相片和縮圖使用 Bitmap.Config.RGB_565 (每個像素 2 位元組)，而非 ARGB_8888 (每個像素 4 位元組)。

3. 在 Jetpack Glance 中，將點陣圖解碼作業移至 provideContent 外部：使用 SizeMode.Responsive 或 SizeMode.Exact 時，Glance 會針對每個大小值區叫用一次 provideContent lambda。在呼叫 provideContent 之前，在 provideGlance 內解碼每個共用的 Bitmap 一次，讓所有大小值區都參照 RemoteViews.mBitmapCache 中的同一個 Bitmap 執行個體。

4. 替換圖片時，請使用完整的 updateAppWidget 呼叫：在傳統 AppWidgetProvider 實作中，請避免呼叫 AppWidgetManager.partiallyUpdateAppWidget 來切換 Bitmap 或 Icon 檢視畫面。部分更新會將新動作合併至 system_server 中現有的 RemoteViews 樹狀結構，不會移除先前快取的映像檔動作。請建構完整的 RemoteViews 版面配置，並改為呼叫 updateAppWidget。

5. 提供錯誤備用版面配置：在 Jetpack Glance 中，覆寫 onCompositionError，在更新失敗時轉譯零點陣圖 RemoteViews 備用版面配置。

如要檢查已連結裝置上小工具目前的序列化點陣圖記憶體用量，請執行下列指令：

adb shell dumpsys appwidget

核心功能

Android 17 包含下列異動項目，這類變更會修改或擴充 Android 系統的各種核心功能。

MessageQueue 的新無鎖定實作

從 Android 17 開始，指定 Android 17 (API 級別 37) 以上版本的應用程式會收到新的無鎖定 android.os.MessageQueue 實作。新實作方式可提升效能並減少影格遺漏，但可能會破壞反映 MessageQueue 私人欄位和方法的用戶端。

如需更多資訊 (包括緩解策略)，請參閱 MessageQueue 行為變更指南。

靜態最終欄位現在無法修改

在 Android 17 以上版本執行的應用程式，如果指定 Android 17 (API 級別 37) 以上版本，則無法變更 static final 欄位。如果應用程式嘗試使用反射功能變更 static final 欄位，會導致 IllegalAccessException。如果嘗試透過 JNI API (例如 SetStaticLongField()) 修改其中一個欄位，會導致應用程式當機。

無障礙設定

Android 17 進行下列變更，提升無障礙功能。

支援複雜輸入法實體鍵盤輸入的無障礙功能

這項功能導入了新的 AccessibilityEvent 和 TextAttribute API，可強化 CJKV 語言輸入的螢幕閱讀器互動朗讀功能。中日韓越文輸入法應用程式現在可以指出，在文字組合期間是否已選取文字轉換候選字。具有編輯欄位的應用程式，可在傳送文字變更無障礙事件時，指定文字變更類型。舉例來說，應用程式可以指定在文字組合期間發生文字變更，或文字變更是由修訂版本造成。這樣一來，螢幕閱讀器等無障礙服務就能根據文字修改的性質，提供更精確的回饋。

應用程式採用數

• IME 應用程式：在編輯欄位中設定撰寫文字時，IME 可以使用 TextAttribute.Builder.setTextSuggestionSelected() 指出是否已選取特定轉換候選字。

• 具有編輯欄位的應用程式：維護自訂 InputConnection 的應用程式可以呼叫 TextAttribute.isTextSuggestionSelected() 擷取候選字詞選取資料。這類應用程式應在調度 TYPE_VIEW_TEXT_CHANGED 事件時呼叫 AccessibilityEvent.setTextChangeTypes()。如果應用程式指定 Android 17 (API 級別 37) 為目標，並使用標準 TextView，則預設會啟用這項功能。(也就是說，TextView 會處理從 IME 擷取資料，並在傳送事件至無障礙服務時設定文字變更類型)。

• 無障礙服務：處理 TYPE_VIEW_TEXT_CHANGED 事件的無障礙服務可以呼叫 AccessibilityEvent.getTextChangeTypes()，以識別修改的性質並相應調整其回饋策略。

隱私權

Android 17 包含下列異動，可提升使用者隱私。

已啟用 ECH (Encrypted Client Hello)

Android 17 導入了對加密用戶端 Hello (ECH) 的平台支援，這是一種 TLS 擴充功能，可加密 TLS 握手程序中的伺服器名稱指示 (SNI)，進而強化使用者隱私。這項加密功能可防止網路觀察者輕易識別應用程式連線的特定網域。

如果應用程式指定 Android 17 (API 級別 37) 以上版本，則會使用 ECH 建立 TLS 連線。只有在應用程式使用的網路程式庫 (例如 HttpEngine、WebView 或 OkHttp) 整合 ECH 支援，且遠端伺服器也支援 ECH 通訊協定時，ECH 才會啟用。如果無法協商 ECH，用戶端會傳送含有隨機內容的 ECH 擴充功能 (這項機制稱為 ECH GREASE)。如要進一步瞭解 ECH GREASE 的運作方式，請參閱 RFC 9849。

為了讓應用程式自訂這項行為，Android 17 在網路安全性設定檔中新增了 <domainEncryption> 元素。開發人員可以在 <base-config> 或 <domain-config> 標記中使用 <domainEncryption>，在全域或個別網域層級選取 ECH 模式 (例如 "enabled" 或 "disabled")。

詳情請參閱加密用戶端 Hello 說明文件。

指定 Android 17 的應用程式需要區域網路權限

Android 17 推出 ACCESS_LOCAL_NETWORK 執行階段權限，保護使用者免受未經授權的區域網路存取。由於這屬於現有的 NEARBY_DEVICES 權限群組，因此已授予其他 NEARBY_DEVICES 權限的使用者不會再次收到提示。這項新規定可防止惡意應用程式利用不受限制的區域網路存取權，暗中追蹤使用者及收集數位指紋。只要宣告並要求這項權限，應用程式就能探索及連線至區域網路 (LAN) 上的裝置，例如智慧住宅裝置或投放接收器。

如果應用程式指定 Android 17 (API 級別 37) 以上版本，現在有兩種方式可與區域網路裝置保持通訊：採用系統中介、隱私權保護的裝置挑選器，略過權限提示，或在執行階段明確要求這項新權限，以維持區域網路通訊。

詳情請參閱區域網路權限說明文件。

注意： 在 Android 16 中，應用程式可以選擇加入區域網路權限。自 Android 17 起，指定 Android 17 (API 級別 37) 以上版本的應用程式必須強制執行。

在實體裝置上隱藏密碼

如果應用程式指定 Android 17 (API 級別 37) 以上版本，且使用者使用實體輸入裝置 (例如外接鍵盤)，Android 作業系統會將新的 show_passwords_physical 設定套用至密碼欄位中的所有字元。根據預設，這項設定會隱藏所有密碼字元。

Android 系統會顯示最後輸入的密碼字元，協助使用者確認是否輸入錯誤。不過，如果使用較大的外接鍵盤，就不太需要這麼做。此外，配備外接鍵盤的裝置通常螢幕較大，因此輸入的密碼更容易被他人看到。

如果使用者正在使用裝置的觸控螢幕，系統會套用新的 show_passwords_touch 設定。

標準簡訊動態密碼防護

從 Android 17 開始，Android 將擴大簡訊動態密碼保護功能，適用於標準簡訊 (包含動態密碼，但不使用 WebOTP 或簡訊擷取器格式的簡訊)。對於大多數指定 Android 17 (API 級別 37) 以上版本的應用程式，這些簡訊在收到後三小時內無法使用。這項延遲措施旨在防止動態密碼遭劫持。在這三小時的延遲期間，系統會保留 SMS_RECEIVED_ACTION 廣播，並篩選簡訊供應商資料庫查詢。延遲時間過後，這些應用程式就能取得簡訊。

某些應用程式 (例如預設簡訊小幫手應用程式、連結裝置隨附應用程式等) 不受這項延遲限制。所有需要讀取簡訊來擷取動態密碼的應用程式，都應改用 SMS Retriever 或 SMS User Consent API，確保功能持續運作。

注意： 無論目標 API 級別為何，所有應用程式都必須針對 WebOTP 和簡訊擷取器格式訊息，採取額外的簡訊動態密碼保護措施。詳情請參閱「所有應用程式的行為變更」說明文件中的「簡訊動態密碼保護」一節。

安全性

Android 17 對裝置和應用程式安全性進行了以下改善。

Activity 安全性

在 Android 17 中，平台持續朝向「預設安全」架構發展，推出一系列強化功能，旨在緩解高嚴重性漏洞，例如網路釣魚、互動劫持和混淆代理攻擊。開發人員必須明確選擇加入新的安全性標準，才能維持應用程式相容性並保護使用者。

對開發人員的主要影響包括：

• 強化 BAL 並改善選擇加入機制：我們正在調整背景活動啟動 (BAL) 限制，將保護措施擴展至 IntentSender。開發人員必須停止使用舊版 MODE_BACKGROUND_ACTIVITY_START_ALLOWED 常數。建議改用 MODE_BACKGROUND_ACTIVITY_START_ALLOW_IF_VISIBLE 等精細控制項，限制只有在呼叫端應用程式可見時，才能啟動活動，大幅縮小攻擊面。
• 採用工具：開發人員應使用嚴格模式和更新後的 Lint 檢查，找出舊版模式，確保能因應未來的目標 SDK 規定。

預設啟用 CT

如果應用程式指定 Android 17 (API 級別 37) 以上版本，系統會預設啟用憑證透明化 (CT)。(在 Android 16 中，CT 可用，但應用程式必須選擇加入)。

更安全的原生 DCL - C

如果應用程式指定 Android 17 (API 級別 37) 以上版本，則 Android 14 針對 DEX 和 JAR 檔案推出的更安全動態程式碼載入 (DCL) 保護措施，現在也適用於原生程式庫。

使用 System.load() 載入的所有原生檔案都必須標示為唯讀。否則系統會擲回 UnsatisfiedLinkError。

我們建議應用程式盡量避免使用動態載入程式碼，否則應用程式很可能會因為程式碼插入或竄改程式碼而無法正常運作。

限制 CP2 資料檢視中的 PII 欄位

如果應用程式指定 Android 17 (API 級別 37) 以上版本，聯絡人供應程式 2 (CP2) 會限制資料檢視中包含個人識別資訊 (PII) 的特定資料欄。這項異動生效後，系統會從資料檢視中移除這些資料欄，進一步保護使用者隱私。受限制的資料欄包括：

• ACCOUNT_NAME
• ACCOUNT_TYPE
• ACCOUNT_TYPE_AND_DATA_SET

如果應用程式使用 ContactsContract.Data 中的這些資料欄，可以改為與 RAW_CONTACT_ID 彙整，從 ContactsContract.RawContacts 擷取這些資料欄。

在 CP2 中強制執行嚴格的 SQL 檢查

如果應用程式指定 Android 17 (API 級別 37) 以上版本，在沒有 READ_CONTACTS 權限的情況下存取 ContactsContract.Data 資料表時，Contacts Provider 2 (CP2) 會強制執行嚴格的 SQL 查詢驗證。

這項異動生效後，如果應用程式沒有 READ_CONTACTS 權限，系統會在查詢 ContactsContract.Data 資料表時設定 StrictColumns 和 StrictGrammar 選項。如果查詢使用的模式與這些模式不相容，系統會拒絕查詢並擲回例外狀況。

情報

Android 17 對系統智慧功能進行了下列變更。

setContentCaptureEnabled 淘汰

部分裝置預設會啟用內容擷取功能，讓裝置端 AI 功能分析畫面內容，提供智慧型體驗。

自 Android 17 起，ContentCaptureManager.setContentCaptureEnabled(boolean) API 方法已淘汰。如果應用程式指定 Android 17 (API 級別 37) 以上版本，呼叫 setContentCaptureEnabled(false) 不會再停用內容擷取功能。

如果應用程式需要繼續停用內容擷取功能，或限制系統擷取螢幕內容，請改用 FLAG_SECURE 視窗版面配置參數。

如要停用內容擷取功能，請在視窗中設定 FLAG_SECURE 標記，如以下範例所示：

Kotlin

window.setFlags(
    WindowManager.LayoutParams.FLAG_SECURE,
    WindowManager.LayoutParams.FLAG_SECURE
)

Java

getWindow().setFlags(
    WindowManager.LayoutParams.FLAG_SECURE,
    WindowManager.LayoutParams.FLAG_SECURE
);

詳情請參閱 WindowManager.LayoutParams.FLAG_SECURE 參考文件。

媒體

Android 17 包含下列媒體行為變更。

背景音訊強化

從 Android 17 開始，音訊架構會對背景音訊互動強制執行限制，包括音訊播放、音訊焦點要求和音量變更 API，確保這些變更是由使用者刻意啟動。

部分音訊限制適用於所有應用程式。不過，如果應用程式指定 Android 17 (API 級別 37)，限制會更嚴格。如果其中一個應用程式在背景執行時與音訊互動，則必須執行前景服務。此外，應用程式必須符合下列一或兩項規定：

• 前景服務必須具備使用期間 (WIU) 功能。
• 應用程式必須具備精確鬧鐘權限，並與 USAGE_ALARM 音訊串流互動。

如需更多資訊 (包括緩解策略)，請參閱「背景音訊強化」。

裝置板型規格

Android 17 包含下列異動項目，可改善各種裝置尺寸和板型規格的使用者體驗。

平台 API 異動：在大螢幕 (sw>=600dp) 上忽略螢幕方向、大小調整和顯示比例限制

我們在 Android 16 中變更平台 API，針對指定目標 API 級別 36 以上版本的應用程式，忽略大螢幕 (sw >= 600dp) 的螢幕方向、大小調整和顯示比例限制。開發人員可以選擇不採用 SDK 36 的這些變更，但如果應用程式指定 Android 17 (API 級別 37) 以上版本，就無法再選擇不採用。

詳情請參閱「系統會忽略螢幕方向和大小調整限制」。

連線能力

Android 17 推出下列異動，提升藍牙 RFCOMM 通訊端的一致性，並與標準 Java InputStream 行為保持一致。

RFCOMM 的 BluetoothSocket read() 行為一致

如果應用程式指定 Android 17 (API 級別 37) 為目標版本，當通訊端關閉或連線中斷時，從 RFCOMM 型 BluetoothSocket 取得的 InputStream 的 read() 方法現在會傳回 -1。

這項異動可讓 RFCOMM 通訊端行為與 LE CoC 通訊端保持一致，並符合標準 InputStream.read() 說明文件，其中指出到達串流結尾時會傳回 -1。

如果應用程式僅依賴擷取 IOException 來中斷讀取迴圈，可能會受到這項異動影響，因此應更新 BluetoothSocket 讀取迴圈，明確檢查傳回值是否為 -1。這可確保遠端裝置中斷連線或通訊端關閉時，迴圈能正確終止。如需建議導入方式的範例，請參閱「傳輸藍牙資料」指南中的程式碼片段。