The Android 15 Beta 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 開始，TextViews 可以根據文字 (而非字元) 自動換行，而不使用字元換行，讓應用程式更精美、易於理解。您可以將 android:lineBreakWordStyle="phrase" 與 TextView 搭配使用，藉此利用這個包裝。

萬國碼 (Unicode) 程式庫更新

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

以下為幾項重要異動：

英文 (加拿大) en‑CA 和英文 (菲律賓共和國) en‑PH 在沒有翻譯資源可用時，都會使用英文 (美國) en 翻譯資源，而非英文 (英國) en‑GB。
我們為西班牙文 es、義大利文 it、葡萄牙文 pt 和葡萄牙文 (葡萄牙) pt‑PT 推出了 many 複數類別。與 CLDR v38 中引入的法文類似，這適用於大型數字。

顏色向量字型

從 Android 13 開始，系統會支援 COLR 第 1 版 (COLRv1) 字型，並將系統表情符號更新為 COLRv1 格式。COLRv1 是高度精簡的字型格式，不論大小為何，都能快速清晰顯示。

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

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

快速設定刊登位置 API

通知欄中的「快速設定」可方便使用者變更設定或快速操作，不必離開應用程式內容。對於提供自訂資訊方塊的應用程式，我們會讓使用者更輕鬆地找到資訊方塊，並將其新增至「快速設定」。應用程式現在可以使用新的資訊方塊刊登位置 API，提示使用者直接將自訂圖塊加入有效的「快速設定」方塊組合。新的系統對話方塊可讓使用者不必離開應用程式，就能直接新增資訊方塊，不必前往「快速設定」新增資訊方塊。

這個對話方塊詢問使用者是否要在「快速設定」中新增資訊方塊。

剪貼簿預覽

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

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

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

預測返回手勢

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

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

藍牙 LE Audio

低功耗 (LE) 音訊是一種無線音訊功能，可取代傳統藍牙，並支援特定用途和連線拓撲。可讓使用者與親友分享及播送音訊，或是訂閱公開廣播以提供資訊、娛樂或無障礙用途。這項服務的設計可確保使用者能夠接收高保真的音訊，而不犧牲電池續航力，以及順暢地切換傳統藍牙不支援的不同用途。自 Android 13 起，系統內建 LE Audio 支援功能，因此開發人員可在相容裝置上免費取得這些功能。

MIDI 2.0

自 Android 13 起，系統支援 MIDI 2.0 標準，包括可透過 USB 連接 MIDI 2.0 硬體。這項標準提供了多項功能，例如提高控制器的解析度、改善非西方語調的支援功能，以及使用個別音符控制器更具表達力的效能。

改善啟動畫面效率

Android 13 改善了啟動畫面 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 簽署配置 3.1 版

Android 13 現已支援 APK 簽名配置 3.1 版，從而改進了現有的 APK 簽署配置 v3。這個配置可以解決 APK 簽名配置 v3 針對旋轉作業的部分已知問題。特別是 v3.1 簽名配置支援 SDK 版本指定功能，讓旋轉功能鎖定平台的較新版本。

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

搭載 Android 13 以上版本的裝置會使用 3.1 版區塊中的旋轉簽署者。
搭載舊版 Android 的裝置會忽略旋轉的簽署者，而是在 3.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 畫布中自訂繪製方式，以及篩選檢視畫面內容。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 到 cd/m2 的 1000 秒)。這讓視訊品質更貼近現實，呈現更豐富的色彩、更亮的高亮度和較暗的陰影。

如要進一步瞭解 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 導入的核心程式庫變更也會透過 ART Mainline 模組的 Google Play 系統更新一併提供給 Android 12 裝置。

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

支援本機變數和做為參數 lambda 的 var 關鍵字。
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 和/或其關係企業的商標或註冊商標。