The Android 16 Developer Preview is now available. Try it out today and let us know what you think!

本頁面由 Cloud Translation API 翻譯而成。

功能與 API 總覽

Android 13 為開發人員推出了強大的新功能和 API。以下各節可協助您瞭解應用程式功能，並開始使用相關的 API。

如需新增、修改及移除 API 的詳細清單，請參閱 API 差異比較表。如要進一步瞭解新的 API，請參閱 Android API 參考資料 - 新的 API 會醒目顯示，以利於查看。此外，如要瞭解平台變更可能對應用程式造成的影響，請務必查看指定 Android 13 的應用程式和所有應用程式的 Android 13 行為變更。

開發人員工作效率和工具

主題化應用程式圖示

從 Android 13 開始，您可以選擇套用主題化的應用程式圖示。有了這項功能，支援的 Android 啟動器中的應用程式圖示就會套用色調，繼承使用者所選桌布和其他主題的配色。

如要支援這項功能，應用程式必須同時提供自適應圖示和單色應用程式圖示，並在資訊清單的 <adaptive-icon> 元素中指向單色應用程式圖示。如果使用者已啟用主題化應用程式圖示 (也就是在系統設定中開啟「主題化圖示」切換鈕)，且啟動器支援這項功能，系統就會根據使用者所選桌布和主題的配色，調整圖示的色調，然後套用至單色應用程式圖示。

在下列任何情況下，主畫面都不會顯示主題化應用程式圖示，而是顯示自適應或標準應用程式圖示：

如果使用者未啟用主題化應用程式圖示
如果您的應用程式未提供單色圖示
如果啟動器不支援主題化應用程式圖示

如需更多詳細資訊和操作說明，請參閱「自動調整圖示」。

個別應用程式語言偏好

在許多情況下，多語言使用者會將系統語言設為某種語言 (例如英文)，卻想在特定應用程式中選擇使用其他語言，例如荷蘭文、中文或北印度文。為了讓這類使用者在應用程式中享有更優質的體驗，Android 13 針對支援多種語言的應用程式推出下列功能：

系統設定：提供集中管理各項設定的頁面，使用者可在此為各應用程式選取偏好的語言。

應用程式必須在應用程式資訊清單中宣告 android:localeConfig 屬性，讓系統瞭解應用程式支援多種語言。詳情請參閱這份操作說明，瞭解如何建立資源檔案，並在應用程式的資訊清單檔案中進行宣告。
其他 API：利用這類公用 API (例如 LocaleManager 中的 setApplicationLocales() 和 getApplicationLocales() 方法)，應用程式可在執行階段設定與系統語言不同的語言。

這些 API 會自動與系統設定保持同步；因此，使用這些 API 建立自訂應用程式內語言選單的應用程式，無論使用者選擇的語言偏好設定為何，都能為使用者提供一致的使用者體驗。此外，公用 API 也有助於減少樣板程式碼的數量，可支援分割 APK，並支援應用程式自動備份功能來儲存應用程式層級的使用者語言設定。

為了提供與 Android 舊版本的回溯相容性，AndroidX 中也提供同等的 API。建議您使用 Appcompat 1.6.0-beta01 以上版本新增的 API。

不支援多種語言的應用程式不會受到這些異動影響。

改善文字和語言支援

Android 13 包含多項功能文字和語言改善項目，可協助您提供更精緻的體驗，請參閱以下各節：

更快的斷字

斷字可讓斷行文字更易讀，並有助於讓 UI 更具適應性。從 Android 13 開始，斷字功能的效能已提升至 200%，因此您可以在 TextView 中啟用這項功能，幾乎不會影響算繪效能。如要啟用更快速的斷字功能，請在 setHyphenationFrequency() 中使用 fullFast 或 normalFast 頻率。

文字轉換 API

日文和中文等語言的使用者會用拼音輸入法，這通常會降低搜尋和自動完成等功能的執行速度。在 Android 13 中，應用程式可以呼叫新的文字轉換 API，讓使用者更輕鬆快速地搜尋內容。舉例來說，先前日本使用者搜尋時必須執行下列步驟：

輸入平假字，作為搜尋字詞 (例如地點或應用程式名稱) 的音標
使用鍵盤將平假名轉換為漢字
使用漢字重新搜尋
最後取得搜尋結果

有了新的文字轉換 API，日文使用者只要輸入平假名，就能立即看到漢字的搜尋結果，不必再進行步驟 2 和步驟 3。

改善非拉丁語系文字的行高

Android 13 會配合每個語言調整行高，以改善非拉丁語系文字的呈現方式，例如泰米爾文、緬甸文、泰盧固文和藏文。新的行高設定不僅可避免字元遭裁切，還能改善字元的排版位置。只要應用程式指定 Android 13，就能使用這些改善功能。這些變更可能會影響非拉丁語言的使用者介面，因此如果你使用新的行距設定，請務必測試應用程式。

在 Android 12 (上方) 中遭到裁剪的行高，現在已在 Android 13 (下方) 中獲得更佳的定位，且不會遭到裁剪。

改善日文文字換行

從 Android 13 開始，TextView 可以根據文節 (最小的文字組成單位，讀起來自然而且有意義) 或片語，而不是字元換行，讓你改善日文應用程式的閱讀體驗。如要運用這個換行功能，只要在 TextView 中使用 android:lineBreakWordStyle="phrase" 即可。

Unicode 程式庫更新

Android 13 新增了 Unicode ICU 70、Unicode CLDR 40 和 Unicode 14.0 中的最新改善項目、修正項目和變更。

以下是幾項重要變更：

當沒有可用的翻譯資源時，英文 (加拿大) en‑CA 和英文 (菲律賓) en‑PH 都會使用英文 (美國) en 翻譯資源，而非英文 (英國) en‑GB。
many 複數類別已針對西班牙文 es、義大利文 it、葡萄牙文 pt 和葡萄牙文 (葡萄牙) pt‑PT 推出。這與 CLDR v38 中引進的法文相似，用於表示大數字。

彩色向量字型

從 Android 13 開始，系統支援 COLR 1 版 (COLRv1) 字型的算繪功能，並將系統表情符號更新為 COLRv1 格式。COLRv1 是極為簡易的字型格式，任何大小都能讓系統輕鬆快速地進行算繪。

對於大多數應用程式，系統會自行處理一切，因此 COLRv1 就能正常運作。不過，如果應用程式採用自己的文字算繪功能並使用系統字型，建議您測試表情符號算繪。

如要進一步瞭解 COLRv1，請參閱下列資源：

Quick Settings placement API

通知面板中的「快速設定」功能，可讓使用者在不離開應用程式內容的情況下，輕鬆變更設定或執行快速動作。對於提供自訂資訊方塊的應用程式，我們會讓使用者更容易發現資訊方塊，並將資訊方塊新增至「快速設定」。使用新的資訊方塊放置 API，應用程式現在可以提示使用者直接將自訂資訊方塊新增至一組有效的「快速設定」資訊方塊。新的系統對話方塊可讓使用者在一個步驟中新增圖塊，無須離開應用程式，也不必前往快速設定新增圖塊。

對話方塊詢問使用者是否要將設定方塊新增至快速設定。

剪貼簿預覽

從 Android 13 開始，系統會在內容新增至剪貼簿時，以視覺形式顯示標準的確認內容。新的確認功能會執行以下作業：

確認已成功複製內容。
提供複製內容的預覽畫面。

這項功能可標準化應用程式複製後顯示的各種通知，讓使用者能進一步控管自己的剪貼簿。如需更多資訊，請參閱「複製及貼上」功能頁面。

預測返回手勢

Android 13 為手機、大螢幕裝置和折疊式裝置等 Android 裝置推出了預測返回手勢，您必須更新應用程式，才能支援這項功能。

如需詳細說明文件，請參閱「更新應用程式以支援預測返回手勢」。您也可以試試程式碼研究室。

藍牙 LE Audio

低功耗 (LE) 音訊技術是無線音訊技術，開發目的在於取代傳統藍牙技術及開發特定用途和連線拓撲。使用者可以透過這項技術，與親朋好友分享音訊內容及播放音訊給他們聽，也可以訂閱資訊、娛樂或無障礙用途的公共廣播內容。這項新技術不必耗費大量電力，就可以讓使用者接收高傳真音訊，同時也能在不同用途間流暢切換，這是傳統藍牙技術無法辦到的事。從 Android 13 開始，系統內建支援低功耗音訊技術，因此開發人員可在相容裝置上免費取得這些功能。

MIDI 2.0

從 Android 13 開始，系統支援 MIDI 2.0 標準，包括透過 USB 連接 MIDI 2.0 硬體的功能。這項標準提供多項功能，例如提升控制器精度、改善非西方地區的音調支援程度，以及提高使用單一音符控制器時的表現力。

改善啟動畫面的效率

Android 13 可提高 SplashScreen API 中動畫啟動畫面的效率：

系統會直接從 AnimatedVectorDrawable 推斷動畫時間長度。在 Android 13 之前，您必須直接設定 windowSplashScreenAnimationDuration。
使用新的 windowSplashScreenBehavior 屬性，進一步控管應用程式是否會在 Android 13 以上版本的啟動畫面中一律顯示圖示。

如需詳細說明文件，請參閱「啟動畫面」。

ART 最佳化

在 Android 13 (API 級別 33) 以上版本中，ART 可讓原生程式碼的切換速度大幅提升，JNI 呼叫的速度現在最高可提升 2.5 倍。我們也重新調整了執行階段參照處理作業，讓大部分的作業不會造成阻斷，進一步減少卡頓情形。此外，您可以使用 Reference.refersTo() 公用 API 更快地回收無法存取的物件，您會發現，由於已最佳化類別和方法查詢，現在的轉譯器速度更快。ART 也會在安裝期間執行更多位元碼驗證，避免在執行階段進行驗證，並確保應用程式啟動速度快速。

隱私權與安全性

為已註冊使用情境的接收端提供更安全的匯出服務

為讓執行階段接收器更安全，Android 13 推出了應用程式可指定已註冊的廣播接收器是否應匯出，並向裝置上的其他應用程式顯示的功能。在舊版 Android 中，除非接收器受到簽章權限保護，否則裝置上的任何應用程式都能向動態註冊的接收器傳送未受保護的廣播訊息。

這項匯出設定可用於至少執行下列其中一項操作的應用程式：

使用 AndroidX Core 程式庫 1.9.0 以上版本的 ContextCompat 類別。
指定 Android 13 以上版本。

相片挑選工具

Android 13 (API 級別 33) 以上版本包含相片挑選工具體驗。當應用程式啟動相片挑選工具時，使用者會選取要與應用程式分享的特定圖片和影片 (例如個人資料相片)，而非授予應用程式查看整個媒體庫的存取權。這是存取使用者相片和影片的建議方式。

相片挑選工具可為使用者提供更完善的隱私權，因為應用程式不需要宣告任何執行階段權限。此外，相片挑選工具還為應用程式提供內建的標準化 UI，可打造更一致的使用者體驗。

鄰近 Wi-Fi 裝置的新執行階段權限

Android 13 (API 級別 33) 在 NEARBY_DEVICES 權限群組中推出新的執行階段權限，供管理裝置透過 Wi-Fi 連線至附近存取點的應用程式使用。這些應用程式必須在呼叫多個不同的 Wi-Fi API 時，宣告新的權限 NEARBY_WIFI_DEVICES。此外，只要應用程式不會從 Wi-Fi API 擷取實際位置資訊，在指定 Android 13 以上版本時，就不需要聲明 ACCESS_FINE_LOCATION 權限。

進一步瞭解鄰近 Wi-Fi 裝置權限。

使用精確鬧鐘的新權限

如果應用程式指定 Android 13 以上版本，您可以使用 USE_EXACT_ALARM 權限，系統會自動授予應用程式這項權限。不過，應用程式必須符合下列至少一項條件，才能使用這項權限：

您的應用程式是鬧鐘或計時器應用程式。
您的應用程式是日曆應用程式，會顯示即將舉行活動的通知。

如果應用程式設定精確鬧鐘，但不符合上述清單中的任何情況，請改為繼續宣告 SCHEDULE_EXACT_ALARM 權限，並為使用者拒絕存取應用程式權限的情況做好準備。

開發人員可降級權限

自 Android 13 起，應用程式可以撤銷未使用的執行階段權限存取權。這個 API 可讓應用程式執行以下提升隱私權的作業：

移除未使用的權限。
遵循權限最佳做法，提升使用者信任度。您可以考慮向使用者顯示對話方塊，列出您主動撤銷的權限。

APK Signature Scheme v3.1

Android 13 新增了對 APK Signature Scheme v3.1 的支援，該配置可改善現有的 APK Signature Scheme v3。這個配置方案解決了 APK Signature Scheme v3 的部分已知問題，這些問題與旋轉功能有關。具體來說，v3.1 簽章配置支援 SDK 版本指定，可讓輪替指定較新的平台版本。

v3.1 簽署方案使用的區塊 ID 在 12L 以下版本中無法辨識。因此，平台會套用下列簽署者行為：

搭載 Android 13 以上版本的裝置會使用 v3.1 區塊中的輪替簽署者。
搭載舊版 Android 的裝置會忽略輪替簽署者，改用 v3.0 區塊中的原始簽署者。

尚未輪替簽署金鑰的應用程式不需要採取任何額外行動。每當這些應用程式選擇旋轉時，系統預設會套用 v3.1 簽署方案。

如果應用程式已輪替，且想繼續在 v3.0 簽署區塊中使用輪替的簽署金鑰，就必須更新 apksigner 叫用：

apksigner sign --ks keystore.jks |
  --key key.pk8 --cert cert.x509.pem
  --rotation-min-sdk-version API_LEVEL
  [signer_options] app-name.apk

...其中 API_LEVEL 為 32 以下。

改善 Keystore 和 KeyMint 中的錯誤回報

對於產生金鑰的應用程式，KeyStore 和 KeyMint 現在提供更詳細且準確的錯誤指標。我們已在 java.security.ProviderException 下方新增例外狀況類別階層，其中包含 Android 專屬例外狀況，包括 Keystore/KeyMint 錯誤代碼，以及錯誤是否可重試。您也可以修改金鑰產生和使用方法 (簽署、加密)，以擲回新的例外狀況。改良後的錯誤回報功能不限於金鑰產生，現在應會提供重試金鑰產生作業所需的資訊。

支援平板電腦和大螢幕

Android 13 以 Android 12 和 12L 功能推送中推出的平板電腦最佳化功能為基礎，包括系統 UI 最佳化、更完善的多工處理功能，以及改善的相容性模式。在測試過程中，請確認應用程式在平板電腦和其他大螢幕裝置上顯示的效果最佳。

如要進一步瞭解新功能和測試項目，請參閱「平板電腦和大螢幕支援」頁面。

圖形

可程式化著色器

從 Android 13 開始，系統支援可程式化的 RuntimeShader 物件，並使用 Android 圖形著色語言 (AGSL) 定義行為。AGSL 的語法大部分與 GLSL 相同，但 AGSL 是在 Android 算繪引擎中運作，可自訂 Android 畫布中的繪圖方式，以及篩選 View 內容。Android 會在內部使用這些著色器來實作波紋效果、模糊效果和延伸超出捲動。您可以使用 Android 13 以上版本為應用程式建立類似的進階效果。

Choreographer 改善項目

Android 13 為 Choreographer 和 ASurfaceControl 引入了公開 API 方法，可為應用程式提供有關可能影格時間表的更多資訊，並為 SurfaceFlinger 的圖像生命週期新增更多背景資訊。和先前一樣，應用程式可以將回呼發布至 Choreographer，並接收影格時間軸資訊。在 Android 13 (API 級別 33) 中，Choreographer 會傳回多個可能的呈現時間和相應的影格截止時間。應用程式可以選擇呈現時間，並隨後通知 SurfaceFlinger 所選時間。SurfaceFlinger 接著不會在所需的顯示時間前，嘗試套用交易或鎖定緩衝區。

如果應用程式使用新的 Choreographer 和 SurfaceControl 方法，您可以在 Perfetto 追蹤記錄中查看應用程式的影格生命週期。

相機

HDR 影片擷取

自 Android 13 起，Camera2 API 支援高動態範圍 (HDR) 影片擷取功能，可讓您使用相機預覽及錄製 HDR 影片內容。相較於標準動態範圍 (SDR)，HDR 可提供更廣泛的色彩，並提高亮度元件的動態範圍 (從目前的 100 cd/m2 到 1000 個 cd/m2)。這樣一來，影片品質會更貼近真實生活，色彩更豐富、亮部更明亮，陰影也更深邃。

如要進一步瞭解 HDR 影片擷取功能，請參閱 HDR 影片擷取說明文件。

媒體

空間音訊

空間音訊提供身歷其境的聽覺饗宴，讓媒體內容變得更加逼真。如要進一步瞭解如何整合這項功能，請參閱空間音訊說明文件。

預測音訊路由

為協助媒體應用程式識別音訊的路由方式，Android 13 在 AudioManager 類別中導入音訊路由 API。getAudioDevicesForAttributes() API 可讓您擷取可用於播放指定音訊的裝置清單，而 getDirectProfilesForAttributes() API 則可協助您瞭解音訊串流是否可直接播放。使用這些 API 判斷最適合用於音訊軌道的 AudioFormat。

無障礙設定

口述影像

Android 13 (API 級別 33) 推出了新的系統層級無障礙偏好設定，讓使用者在所有應用程式中啟用音訊描述。口述影像是額外的旁白音軌，由旁白員在簡報過程中講解，並在音訊自然暫停時說明畫面上發生的情況。應用程式可以使用 isAudioDescriptionRequested() 查詢使用者偏好的音訊描述聲軌，如以下程式碼片段所示：

Kotlin


private lateinit var accessibilityManager: AccessibilityManager

// In onCreate():
accessibilityManager = getSystemService(AccessibilityManager::class.java)

// Where your media player is initialized
if (accessibilityManager.isAudioDescriptionRequested) {
    // User has requested to enable audio descriptions
}

Java


private AccessibilityManager accessibilityManager;

// In onCreate():
accessibilityManager = getSystemService(AccessibilityManager.class);

// Where your media player is initialized
if(accessibilityManager.isAudioDescriptionRequested()) {
    // User has requested to enable audio descriptions
}

應用程式可以透過在 AccessbilityManager 中新增事件監聽器，監控使用者的偏好設定變更：

Kotlin

private val listener =
    AccessibilityManager.AudioDescriptionRequestedChangeListener { enabled ->
        // Preference changed; reflect its state in your media player
    }

override fun onStart() {
    super.onStart()

    accessibilityManager.addAudioDescriptionRequestedChangeListener(mainExecutor, listener)
}

override fun onStop() {
    super.onStop()

    accessibilityManager.removeAudioDescriptionRequestedChangeListener(listener)
}

Java

private AccessibilityManager.AudioDescriptionRequestedChangeListener listener = enabled -> {
    // Preference changed; reflect its state in your media player
};

@Override
protected void onStart() {
    super.onStart();

    accessibilityManager.addAudioDescriptionRequestedChangeListener(getMainExecutor(), listener);
}

@Override
protected void onStop() {
    super.onStop();

    accessibilityManager.removeAudioDescriptionRequestedChangeListener(listener);
}

核心功能

OpenJDK 11 更新

Android 13 開始更新 Android 核心程式庫，以便與 OpenJDK 11 LTS 版本保持一致，其中包括程式庫更新以及應用程式和平台開發人員的 Java 11 語言支援。Android 13 中推出的核心程式庫變更，也將透過 Google Play 系統更新至 ART Mainline 模組，提供給 Android 12 裝置使用。

Android 13 對核心程式庫進行了下列變更：

支援 var 關鍵字，可用於本機變數和參數 lambda。
String 類別的新方法：
- isBlank()
- lines()
- repeat()
- strip()
- stripLeading()
- stripTrailing()
支援 Collection.toArray(IntFunction)，方便將集合轉換為陣列。
支援 java.util 類別 Optional、OptionalDouble、OptionalInt 和 OptionalLong 中的 ifPresentOrElse()、isEmpty()、orElseThrow() 和 stream()。
擴充 SocketOptions 的支援功能，包括重新使用通訊端。
NullReader、NullWriter、InputStream、OutputStream 和 transferTo() Reader 功能，可將讀取的字元轉移至 Writer。
新增使用 Charsets 進行網址編碼和解碼的功能。
FileReader、FileWriter、PrintStream 和 PrintWriter 的 Charset 功能。
針對 ByteArrayInput 或 OutputStream 和 Input 或 OutputStream 提供新的 transferTo()、readNBytes()、readAllBytes() 和 writeBytes() 函式。
java.lang.invoke.VarHandle 的執行階段和編譯器支援。
在內部使用 VarHandle 將 java.util.concurrent 更新為 OpenJDK 11 API。

Java 和 OpenJDK 是 Oracle 和/或其關係企業的商標或註冊商標。