每次發布新版本時,特定的 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();