弃用

随着每个版本的发布,特定的 Android API 可能会过时或需要进行重构,以提供更好的开发者体验或支持新的平台功能。在这些情况下,我们会正式废弃过时的 API,并引导开发者改用替代 API。

废弃意味着我们已结束对这些 API 的正式支持,但它们将继续可供开发者使用。本页重点介绍此 Android 版本中废弃的一些重要 API。如需查看废弃的其他 API,请参阅 API 差异报告

使用 Spatializer 而非 Virtualizer

Spatializer 类最早在 Android 12(API 级别 32)中添加,可让应用查询设备上的声音空间化功能和行为。在 Android 15 中,Virtualizer 类已废弃。请改用 AudioAttributes.Builder.setSpatializationBehavior 来描述您希望在支持空间化时如何播放内容。

AndroidX media3 ExoPlayer 1.0 会在设备支持的情况下,默认为多声道音频启用空间音频。如需了解详情(包括用于控制此功能的 API),请参阅这篇近期博文空间音频文档

WebSQL 已在 Android WebView 中废弃

The setDatabaseEnabled and getDatabaseEnabled methods from WebSettings are now deprecated. These settings activated support for WebSQL inside Webview. WebSQL is now removed in Chrome and is now deprecated on Android Webview. These methods will become a no-op on all Android versions in the next 12 months.

The World Wide Web Consortium (W3C) encourages apps needing web databases to adopt Web Storage API technologies like localStorage and sessionStorage, or IndexedDB. SQLite Wasm in the browser backed by the Origin Private File System outlines a replacement set of technologies based on the SQLite database, compiled to Web Assembly (Wasm), and backed by the origin private file system to enable more direct migration of WebSQL code.