淘汰項目

每次發布版本時，特定 Android API 可能會過時或必須重構，以提供更優質的開發人員體驗或支援新的平台功能。在這種情況下，Android 會正式淘汰過時的 API，並引導開發人員改用新 API。

淘汰意味著我們已終止對 API 的官方支援，但開發人員仍可以繼續使用這些 API。本頁面會列出這個 Android 版本中已淘汰的部分項目。如要查看其他淘汰項目，請參閱 API 差異比較報表。

RenderScript

自 Android 12 起，RenderScript API 已淘汰。這類 API 仍可繼續運作，但我們預期裝置和元件製造商會逐漸停止提供硬體加速支援功能。如要充分利用 GPU 加速功能，建議您從 RenderScript 遷移。

Android 播放清單

Android 播放清單已淘汰。系統不會再維護這個 API，但現有功能仍保有相容性。

建議您讀取及儲存播放清單為 m3u 檔案。

Display API 淘汰

Android 裝置有多種板型規格，例如大螢幕、平板電腦和折疊式裝置。為了針對每部裝置適當轉譯內容，您的應用程式需要判斷螢幕或顯示器大小。隨著時間推移，Android 提供不同的 API 來擷取這項資訊。在 Android 11 中，我們推出了 WindowMetrics API，並淘汰了以下方法：

在 Android 12 中，我們仍建議使用 WindowMetrics，並且已淘汰下列方法：

應用程式應使用 WindowMetrics API 查詢視窗邊界，或使用 Configuration.densityDpi 查詢目前的密度。

請注意，Jetpack WindowManager 程式庫包含支援 Android 4.0.1 (API 級別 14) 以上版本的 WindowMetrics 類別。

範例

以下列舉幾個 WindowMetrics 的使用範例。

首先，請確認您的應用程式可以讓活動完全可調整大小。

活動應依賴活動內容中的 WindowMetrics 執行任何 UI 相關工作，特別是 WindowManager.getCurrentWindowMetrics()。

如果應用程式建立 MediaProjection，則邊界必須有正確的大小，因為投影會擷取螢幕畫面。如果應用程式可完全調整大小，活動內容會傳回正確的邊界。

Kotlin

val projectionMetrics = activityContext
        .getSystemService(WindowManager::class.java).maximumWindowMetrics

Java

WindowMetrics projectionMetrics = activityContext
        .getSystemService(WindowManager.class).getMaximumWindowMetrics();

如果應用程式無法完全調整大小，則必須從 WindowContext 例項查詢邊界，並使用 WindowManager.getMaximumWindowMetrics() 擷取應用程式可用的最大顯示區域的 WindowMetrics。

Kotlin

val windowContext = context.createWindowContext(mContext.display!!,
      WindowManager.LayoutParams.TYPE_APPLICATION, null)
val projectionMetrics = windowContext.getSystemService(WindowManager::class.java)
      .maximumWindowMetrics

Java

Context windowContext = mContext.createWindowContext(mContext.getDisplay(),
      WindowManager.LayoutParams.TYPE_APPLICATION, null;
WindowMetrics projectionMetrics = windowContext.getWindowManager()
      .getMaximumWindowMetrics();