Window Manager

Window Manager

  

API 参考文档
androidx.window

Window Manager 旨在帮助应用开发者为新的设备类型提供支持，并为新旧版本平台上的不同 Window Manager 功能提供通用的 API 接口。初始版本以可折叠设备为目标，未来版本将扩展到更多屏幕类型和窗口功能。

最近更新时间	当前稳定版	下一候选版本	Beta 版	Alpha 版
2021 年 1 月 27 日	-	-	-	1.0.0-alpha02

声明依赖项

如需添加 Window Manager 的依赖项，您必须将 Google Maven 代码库添加到项目中。如需了解详情，请阅读 Google 的 Maven 代码库。

在应用或模块的 build.gradle 文件中添加所需工件的依赖项：

dependencies {
    implementation "androidx.window:window:1.0.0-alpha02"
}

反馈

您的反馈将帮助我们改进 Jetpack。如果您发现了新问题，或对库的改进有某些建议，请告诉我们。创建新问题前，请先查看此库中的现有问题。您可以点击星标按钮，为现有问题投票。

创建新问题

如需了解详情，请参阅问题跟踪器文档。

版本 1.0.0

版本 1.0.0-alpha02

2021 年 1 月 27 日

发布了 androidx.window:window:1.0.0-alpha02。版本 1.0.0-alpha02 中包含这些提交内容。

新功能

• 我们弃用了一些 API，以帮助简化 API 并减少错误。一些值得注意的示例包括从 WindowManager 中移除同步读取操作，以及弃用 DeviceState。同步读取操作可能会导致出现竞态条件并且界面错误。

• 我们已将 DisplayFeature 转换为一个今后将实现其他功能的接口。我们的第一个功能是 FoldingFeature，现在是屏幕折叠或合页的表示形式。该部分还包含取代 DeviceState 的合页的状态。

• Android 11 中引入了 WindowMetrics，可让开发者轻松查询与窗口相关的指标，例如，窗口的位置和大小，以及任何系统边衬区。我们在此版本中向后移植了 API，以便开发者能够利用 WindowMetrics，并继续支持旧版 Android。可以通过 WindowManager#getCurrentWindowMetrics() 和 WindowManager#getMaximumWindowMetrics() API 获取 WindowMetrics。

API 变更

• 弃用将在下一个 Alpha 版中移除的 API (Ib7cc4)
• 更新 ExtensionInterface 以接受显式 Activity 引用。(I07ded)
• 引入 WindowMetrics API。(I3ccee)
• 从 WindowManager 中移除同步读取方法 (I69983)
• 保护 ExtensionWindowBackend 软件包。(Ied208)

问题修复

• 更新 ExtensionInterface API 以接受视觉上下文。(I8e827)

外部贡献

• 合并 DeviceState 和 WindowLayoutInfo，以便更轻松地访问数据。(Id34f4)

版本 1.0.0-alpha01

2020 年 2 月 27 日

发布了 androidx.window:window:1.0.0-alpha01 和 androidx.window:window-extensions:1.0.0-alpha01。版本 1.0.0-alpha01 中包含这些提交内容 这是 Window Manager 库的第一个版本。

新功能

• DisplayFeature：这一新的 API 可识别一整块屏幕平面上的中断处，如合页或折叠线
• DeviceState：这一新的 API 可根据定义的折叠状态（例如 CLOSED、OPENED、HALF_OPENED 等）列表，提供手机当前的折叠状态