窗口管理器

声明依赖项

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

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

dependencies {
    implementation "androidx.window:window:1.0.0-alpha09"

    // For RxJava2 integration
    implementation "androidx.window:window-rxjava2:1.0.0-alpha09"

    // For RxJava3 integration
    implementation "androidx.window:window-rxjava3:1.0.0-alpha09"

    // For testing
    implementation "androidx.window:window-testing:1.0.0-alpha09"
}

dependencies {
    implementation("androidx.window:window:1.0.0-alpha09")

    // For RxJava2 integration
    implementation("androidx.window:window-rxjava2:1.0.0-alpha09")

    // For RxJava3 integration
    implementation("androidx.window:window-rxjava3:1.0.0-alpha09")

    // For testing
    implementation("androidx.window:window-testing:1.0.0-alpha09")
}

反馈

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

创建新问题

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

版本 1.0.0

版本 1.0.0-alpha09

2021 年 6 月 30 日

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

新功能

• 将整数常量更改为无界限枚举。
• 添加测试 util 以创建测试折叠功能。

API 变更

• 添加了辅助方法来创建测试显示功能。(I3cf54)
  • 将 occlusionMode 更改为 occlusionType。

bug 修复

• 当添加数据流的多个使用方时，发出初始值。

版本 1.0.0-alpha08

2021 年 6 月 16 日

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

新功能

• 发布了测试工件，以便在使用 WindowInfoRepository 时更轻松地进行测试。使用 WindowInfoRepository 可获取有关 DisplayFeature 和 WindowMetrics 的信息。（I57f66、Ida620）

版本 1.0.0-alpha07

2021 年 6 月 2 日

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

新功能

• 将核心窗口库迁移到了 Kotlin。今后将使用协程和挂起函数来公开异步数据。
• 将 WindowInfoRepo 添加为用于获取 WindowLayoutInfo 数据流和 WindowMetrics 的主交互点。
• 新增了 window-java 工件，可提供兼容 Java 的 API，用于注册和取消注册回调。
• 新增了 window-rxjava2 和 window-rxjava3 工件，可提供适配 RxJava 的 API。

API 变更

• 添加了 WindowServices，以统一提供依赖项。
  • 添加了基于协程的 API，以使用窗口布局信息。(Iab70f)
• 将核心窗口管理器库迁移到了 Kotlin。(Icca34)

bug 修复

• 添加了新的数据类，以表示功能边界。(I6dcd1)

版本 1.0.0-alpha06

2021 年 5 月 5 日

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

新功能

• 我们已开始迁移到 Kotlin，并将在下一版本中完成迁移。
• DeviceState 已从公共 API 中移除，请改用 FoldingFeature。
• 我们已从 FoldingFeature 状态中移除了 STATE_FLIPPED，因为目前任何用例都不支持它。
• 此外，我们还移除了其他已废弃的 API。

API 变更

• 添加 Kotlin 作为依赖项。
  • 将核心库迁移到 Kotlin。(Idd995)
• 移除了 DisplayFeature 构建器。(I61fa4)
• 从公共 API 中移除了 DeviceState，请改用 FoldingFeature。(Id6079)
• 从扩展程序中移除了设备状态回调。(I5ea83)
• 从 FoldingFeature 中移除了 STATE_FLIPPED。(I9c4e1)
• 移除了已废弃的注册方法。(Ib381b)

版本 1.0.0-alpha05

2021 年 3 月 24 日

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

新功能

我们为 FoldingFeature 添加了一些便捷方法，以便应用能够判断相应功能是否处于分离状态、遮蔽状态，以及确定合页的朝向。我们还将隐藏合页类型，以便

我们从 WindowManager 中移除同步读取方法。因存在隐式竞态条件，同步读取方法容易出错。注册监听器和回调，以在 WindowLayoutInfo 上接收更新。

API 变更

• 添加了可与 FoldingFeature 搭配使用的便捷方法 (Ie733f)
• 从 WindowManager 中移除了同步读取方法 (I96fd4)

版本 1.0.0-alpha04

2021 年 3 月 10 日

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

新功能

• 修复了在没有 OEM 实现的情况下不发出 WindowLayoutInfo 的错误。现在我们会发出一个空的 WIndodoLayoutInfo。
• 修复了因铰链状态在应用处于后台运行时发生更改而导致系统无法正确更新状态的错误。现在状态将会保持一致。
• 更新了 proguard 文件，以忽略运行时依赖项发出的警告。

bug 修复

• 当缺少 OEM 库时，发出一个空值。(Ide935)

版本 1.0.0-alpha03

2021 年 2 月 18 日

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

新功能

• 当 OEM 实现为空时，针对 WindowLayoutInfo 发出一个空值。这样可以更轻松地在更多设备上使用此库。由于这些 API 是异步的，因此我们仍建议应用编写一些防御性代码，并在超时后发出默认值。我们对 OEM 实现不作任何保证，并且初始值也可能会出现延迟。

bug 修复

• 当缺少 OEM 库时，发出一个空值。(Ide935)

版本 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)

bug 修复

• 更新 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 等）列表，提供手机当前的折叠状态