淘汰項目

每次發布新版本時，特定的 Android API 可能會過時，或需要重構才能提供更優質的開發人員體驗，或支援新的平台功能。在這種情況下，Android 將正式淘汰過時的 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();