窗口管理器

Jetpack WindowManager 库使应用开发者能够支持新的设备外形尺寸和多窗口环境。该库为 API 版本 14 及更高版本提供了通用的 API 接口。初始版本针对可折叠设备，但未来版本将扩展到更多显示类型和窗口功能。
最新更新 稳定版 候选版本 Beta 版 Alpha 版
2024 年 9 月 4 日 1.3.0 - - 1.4.0-alpha02

声明依赖项

要添加对 WindowManager 的依赖项，您必须将 Google Maven 存储库添加到您的项目中。阅读Google 的 Maven 存储库以获取更多信息。

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

Groovy

dependencies {
    implementation "androidx.window:window:1.3.0"

    // For Java-friendly APIs to register and unregister callbacks
    implementation "androidx.window:window-java:1.3.0"

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

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

    // For testing
    implementation "androidx.window:window-testing:1.3.0"
}

Kotlin

dependencies {
    implementation("androidx.window:window:1.3.0")

    // For Java-friendly APIs to register and unregister callbacks
    implementation("androidx.window:window-java:1.3.0")

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

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

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

反馈

您的反馈有助于使 Jetpack 变得更好。如果您发现新的问题或有改进此库的想法，请告诉我们。在创建新的问题之前，请查看此库中现有的问题。您可以通过点击星形按钮为现有问题添加您的投票。

创建新问题

有关更多信息，请参阅问题跟踪器文档。

版本 1.4

版本 1.4.0-alpha02

2024 年 9 月 4 日

androidx.window:window-*:1.4.0-alpha02 已发布。版本 1.4.0-alpha02 包含这些提交。

新功能

添加对自定义WindowSizeClass的支持。

  • 打开WindowSizeClass的构造函数，以便开发人员可以使用自己的构造函数。
  • 添加isAtLeast实用程序方法，以便开发人员可以处理一系列WindowSizeClass值。
  • 在Set<WindowSizeClass>上添加扩展函数，以计算来自 Set 的最佳匹配。
  • 添加 Android 建议的断点的常量。
  • 添加与 Android 建议的断点相对应的断点集。

API 更改

  • 更新WindowSizeClass的边界方法名称。（If89a6）
  • 更新WindowSizeClass API 以支持将来添加新的断点值。我们不使用绝对边界，而是使用下限，并建议开发人员在处理WindowSizeClass时使用下限检查。现有的WindowWidthSizeClass和WindowHeightSizeClass将被弃用，因为它们将不再得到进一步开发。（I014ce）

版本 1.4.0-alpha01

2024 年 8 月 7 日

androidx.window:window-*:1.4.0-alpha01 已发布。版本 1.4.0-alpha01 包含 这些提交。

新功能

  • 活动栈固定 (ActivityStack Pinning) 允许应用固定一个容器中的内容，并使其导航与其他容器隔离。
  • 交互式分隔线 (Interactive Divider) 允许应用在分屏显示的两个活动之间显示一个固定或可拖动的分隔线。
  • 全屏对话框暗化 (Fullscreen Dialog Dimming) 允许应用指定对话框暗化区域，可以选择暗化整个任务窗口或仅暗化显示对话框的容器。
  • 嵌入式活动窗口信息回调 (Embedded Activity Window Info Callback) 允许应用持续接收嵌入式活动窗口的更新。
  • 嵌入动画背景 (Embedding Animation Background) 允许应用指定动画背景，在使用 ActivityEmbedding 时提高过渡动画质量。
  • 改进的活动栈管理 (Improved ActivityStack Management) 允许应用在使用 ActivityEmbedding 时对 ActivityStacks 有更多控制权，包括
  • 将活动启动到指定的 ActivityStack 中
  • 结束一个 ActivityStack

API 更改

  • 一个新的 API WindowInfoTracker#supportedPostures

    • 一个用于确定设备是否支持折叠屏的 TableTop 模式的 API。添加了 WindowAreaSessionPresenter#getWindow

  • 添加 API 以支持 ActivityStack 固定

    • SplitPinRule 类
    • SplitController#pinTopActivityStack
    • SplitController#unpinTopActivityStack

  • 添加 API 以启用和配置交互式分隔线

    • DividerAttributes 类
    • SplitAttributes.Builder#setDividerAttributes

  • 添加 API 以为对话框设置 EmbeddingConfiguration 和 DimAreaBehavior

    • EmbeddingConfiguration 类
    • DimAreaBehavior 类
    • ActivityEmbeddingController#setEmbeddingConfiguration

  • 添加 API 以接收嵌入式活动窗口信息更新

    • EmbeddedActivityWindowInfo 类
    • ActivityEmbeddingController#embeddedActivityWindowInfo

  • 添加 API 以设置嵌入动画背景

    • EmbeddingAnimationBackground
    • SplitAttributes.Builder#setAnimationBackground

  • 添加 API 以结束 ActivityStacks

    • ActivityEmbeddingController#finishActivityStacks

  • 添加 API 以设置启动 ActivityStack

    • ActivityEmbeddingOptions#setLaunchingActivityStack

  • 以下 API 现已稳定，不再是实验性 API

    • ActivityEmbeddingController#invalidateVisibleActivityStacks（已从 SplitController#invalidateTopVisibleSplitAttributes 移动）
    • ActivityEmbeddingController#getActivityStack
    • SplitController#updateSplitAttributes

  • 添加 1.4 版的 API。（I56774）

错误修复

  • 修复了某些设备上在会话处于活动状态时返回 UNAVAILABLE 而不是 ACTIVE 的错误。
  • 由于 API 支持不稳定，删除了对 vendorApiLevel 为 2 的设备上 transferActivityToWindowArea 的支持。
  • 引入 API 以启用活动嵌入可拖动分隔线的拖动到全屏功能。（I645c9）
  • 允许应用通过 SplitAttributes 的动画参数禁用 ActivityEmbedding 动画。（Idc01a）
  • 删除了手动概述对新平台 API 的访问，因为在使用 R8 和 AGP 7.3 或更高版本（例如 R8 版本 3.3）时，以及在使用 AGP 8.1 或更高版本（例如 D8 版本 8.1）时，所有构建都会通过 API 建模自动执行此操作。建议未使用 AGP 的客户端更新到 D8 版本 8.1 或更高版本。有关更多详细信息，请参阅 这篇文章。（Ia60e0，b/345472586）
  • 允许扩展程序获取 SplitAttributes 的动画参数，以便设备可以将其用于动画过渡。（Iede00）
  • 隐藏覆盖层 API（Ic4251）
  • 引入 API 以配置分屏的固定或可拖动分隔线。（Ia7a78）
  • 在 WindowMetrics 中添加了密度。（Id6723）
  • 添加 API 以获取 SupportedPostures。（If557a）
  • 从实验性 API 中删除 setLaunchingActivityStack。（I191cf）
  • 引入 ActivityEmbeddingController#embeddedActivityWindowInfo。（I24312）
  • 弃用 #getToken 并添加 #getActivityStackToken。（Ie0471）
  • 为 embeddedActivityWindowInfo 流 API 引入回调适配器。（Ida77f）
  • 为 overlayInfo 流 API 添加回调适配器。（I7264f）
  • 引入 WindowSdkExtensionsRule 以覆盖测试的 extensionsVersion。（Ifb928）
  • - 将 #setLaunchingActivityStack 迁移到 Bundle 以与 ActivityOptionsCompat 的用法兼容。
    • 用户应传递 activityOptions.toBundle 而不是 ActvityOptions 本身。
    • 删除 #setLaunchingActivityStack(Activity)。用户应迁移到使用 ActivityEmbeddingController#getActivityStac(Activity) 获取 ActivityStack，并将 ActivityStack 传递给 #setLaunchingActivityStack。（Ie0ccc）
  • - 引入 ActivityStack.Token 和 SpltInfo.Token 作为 WM Jetpack 和扩展程序之间通信的标识符。
    • 弃用/替换 API 以获取/返回 Token 而不是 IBinder。（I12b24）
  • - 引入 ActivityEmbeddingController#invalidateVisibleActivityStacks
    • 删除 SplitController#invalidateTopVisibleSplitAttributes，因为该功能已合并到 #invalidateVisibleActivityStacks 中。（I02ef5）
  • - 添加 API 以设置嵌入配置。（I59a4a）
  • - 添加固定/取消固定顶部 ActivityStack androidx.Window API
    • 更新演示应用程序以允许固定/取消固定顶部 ActivityStack。（I24dd3）
  • 重新添加 #finishActivityStacks 和 ActivityEmbeddingOptions。（Ic1ab3）
  • 删除不稳定的 API。（Ibc534，b/302380585）

版本 1.3

版本 1.3.0

2024 年 5 月 29 日

androidx.window:window-*:1.3.0 已发布。版本 1.3.0 包含 这些提交。

自 1.2.0 以来重要的更改

  • 窗口大小类 (Window Size Classes) 的 Kotlin 多平台支持。

版本 1.3.0-rc01

2024 年 5 月 14 日

WindowManager Jetpack 1.3 带来了 WindowSizeClass 功能的 Kotlin 多平台支持以及多个错误修复。

androidx.window:window-*:1.3.0-rc01 已发布。版本 1.3.0-rc01 包含 这些提交。

版本 1.3.0-beta02

2024 年 5 月 1 日

androidx.window:window-*:1.3.0-beta02 已发布。版本 1.3.0-beta02 包含 这些提交。

API 更改

  • 删除了创建和使用自定义 WindowSizeClass 的支持。（Id1143）

错误修复

  • 修复了由 ProGuard 在某些设备实现上剥离某些文件导致的 KotlinReflectionInternalError。（I01b02）

版本 1.3.0-beta01

2024 年 4 月 3 日

androidx.window:window-*:1.3.0-beta01 已发布。版本 1.3.0-beta01 包含 这些提交。

版本 1.3.0-alpha03

2024 年 3 月 6 日

androidx.window:window-*:1.3.0-alpha03 已发布。版本 1.3.0-alpha03 包含 这些提交。

API 更改

  • 将 WindowSizeClassUtil 拆分为更专注的方法。（Ie9292）
  • 恢复 WindowSizeClass#compute。（I21355，b/324293374）

错误修复

  • 修复了提供的上下文未被正确解包导致的崩溃。（94d10ce，b/318787482）

版本 1.3.0-alpha02

2024 年 2 月 7 日

androidx.window:window-*:1.3.0-alpha02 已发布。版本 1.3.0-alpha02 包含这些提交。

新功能

  • 对窗口大小类 API 的 API 表面进行了更新，以提高希望使用自己大小类的开发人员的灵活性。

API 更改

  • 向宽度选择器添加高度约束。（I23393）
  • 添加用于从集合中选择 WindowSizeClass 的实用程序函数。添加实验性评分函数，以便开发人员可以编写自己的选择器。添加一个选择器扩展函数以在给定范围内选择最宽的 WindowSizeClass。（I0c944）
  • 打开 WindowSizeClass 构造函数，以便可以添加自定义断点。（Ic1ff3）
  • 添加便利函数以根据宽度、高度和密度创建大小类。（If67f4）

错误修复

  • 修复浮点值被截断为 0 时发生的异常。（272ffac）

版本 1.3.0-alpha01

2023 年 11 月 15 日

androidx.window:window-*:1.3.0-alpha01 已发布。版本 1.3.0-alpha01 包含这些提交。

新功能

  • 公开用于访问后屏幕的实验性窗口 API。
  • 创建 FoldingFeature 的测试 API 现在已稳定。

  • 用于设置伪造 ActivityEmbedding 值的测试 API 现已稳定。
  • WindowLayoutInfoPublisherRule 现在会在从 UiContext 获取值时报告覆盖。
  • WindowInfoTracker 将折叠功能数据报告给 UiContext 参数。
  • 公开设备上的扩展版本。
  • WindowProperties 常量，用于用户每个应用的覆盖。
    • PROPERTY_COMPAT_ALLOW_USER_ASPECT_RATIO_OVERRIDE — 通知系统应用已选择退出用户界面纵横比兼容性覆盖。
    • PROPERTY_COMPAT_ALLOW_USER_ASPECT_RATIO_FULLSCREEN_OVERRIDE — 通知系统应用已选择退出用户纵横比兼容性覆盖设置的全屏选项。

版本 1.2

版本 1.2.0

2023 年 11 月 15 日

androidx.window:window-*:1.2.0 已发布。 版本 1.2.0 包含这些提交。

自 1.1.0 以来的重要更改

  • 公开用于访问后屏幕的实验性窗口 API。
  • 创建 FoldingFeature 的测试 API 现在已稳定。

  • 用于设置伪造 ActivityEmbedding 值的测试 API 现已稳定。
  • WindowLayoutInfoPublisherRule 现在会在从 UiContext 获取值时报告覆盖。
  • WindowInfoTracker 将折叠功能数据报告给 UiContext 参数。
  • 公开设备上的扩展版本。

版本 1.2.0-rc01

2023 年 11 月 1 日

androidx.window:window-*:1.2.0-rc01 已发布。 版本 1.2.0-rc01 包含这些提交。

新功能

  • 公开用于访问后屏幕的实验性窗口 API。
  • 创建 FoldingFeature 的测试 API 现在已稳定。

  • 用于设置伪造 ActivityEmbedding 值的测试 API 现已稳定。
  • WindowLayoutInfoPublisherRule 现在会在从 UiContext 获取值时报告覆盖。
  • WindowInfoTracker 将折叠功能数据报告给 UiContext 参数。
  • 公开设备上的扩展版本。

版本 1.2.0-beta04

2023 年 10 月 18 日

androidx.window:window-*:1.2.0-beta04 已发布。 版本 1.2.0-beta04 包含这些提交。

API 更改

版本 1.2.0-beta03

2023 年 9 月 20 日

androidx.window:window-*:1.2.0-beta03 已发布。 版本 1.2.0-beta03 包含这些提交。

新功能

  • 添加 RequiresApi 检查，用于需要特定扩展版本才能正确运行的 API。
  • 添加一个 API 来公开设备上的扩展版本。

API 更改

  • 在公共 API 上注释所需的窗口 SDK 扩展版本。
    • 删除活动嵌入组件中的 isXXXSupported。（Ie3dae）
  • 引入 WindowSdkExtensions 以报告设备上的扩展版本。
    • 引入 RequiresWindowSdkExtension 以注释所需的最低扩展版本。（I05fd4）
  • 使 WindowAreaInfo#getCapability 不可为空。（I17048）

版本 1.2.0-beta01

2023 年 7 月 26 日

androidx.window:window-*:1.2.0-beta01 已发布。 版本 1.2.0-beta01 包含这些提交。

新功能

  • 公开用于访问后屏幕的实验性窗口 API。
  • 创建 FoldingFeature 的测试 API 现在已稳定。

  • 用于设置伪造 ActivityEmbedding 值的测试 API 现已稳定。
  • WindowLayoutInfoPublisherRule 现在会在从 UiContext 获取值时报告覆盖。
  • WindowInfoTracker 将折叠功能数据报告给 UiContext 参数。

API 更改

  • 将 WindowArea API 标记为实验性，以便允许 API 更改继续进行，并在 1.3 中发布稳定版本（I857f5）
  • 更新 API 文件以注释兼容性抑制（I8e87a，b/287516207）

版本 1.2.0-alpha03

2023 年 6 月 21 日

androidx.window:window-*:1.2.0-alpha03 已发布。 版本 1.2.0-alpha03 包含这些提交。

新功能

  • 从 API 表面删除已弃用的 API。
  • 添加 API 以支持并发显示。
  • 添加一个属性以选择退出强制调整大小覆盖。
  • 添加属性以选择退出最小纵横比覆盖。
  • 稳定 ActivityEmbeddingRule 以支持围绕活动嵌入的单元测试。

API 更改

  • 删除已弃用的 API（I18d39）
  • 添加对并发显示的支持。（Ifcbb0）

错误修复

  • 添加强制调整大小覆盖的退出兼容属性（Ie7ab1）
  • 从扩展接口中删除 SESSION_STATE_CONTENT_INVISIBLE。（I6ed19）
  • 稳定 ActivityEmbeddingRule 以支持围绕活动嵌入的单元测试。（I8d6b6）
  • 添加最小纵横比覆盖的退出兼容属性。（I66390）
  • 删除已弃用的 WindowArea API（Ieb67c）
  • 将方向请求循环属性重命名为 PROPERTY_COMPAT_ALLOW_IGNORING_ORIENTATION_REQUEST_WHEN_LOOP_DETECTED。（Ie2fbd）
  • 更新窗口区域会话常量名称（I83675）
  • 添加退出兼容属性，在检测到方向请求循环时忽略它（I0a7a2）
  • 添加 WindowAreaComponent#STATUS_ACTIVE 以表示该功能已处于活动状态。（I62bc3）
  • 添加 RearDisplayPresentationMode API（I0401c）
  • 删除稳定版本的背景颜色 API。（I34c3e）
  • 隐藏窗口区域 API。（I39de0）
  • 添加方法以覆盖 SplitController 中的 SplitInfo。添加测试方法以创建 SplitInfo 和 ActivityStack 的双倍。（Icd69f）
  • 使 ActivityRule.Builder 的标签可选。（Ib0b44）
  • 删除 RatioSplitType、ExpandContainersSplit 和 HingeSplitType。它们现在是 SplitType。
    • 将 #splitEqually()、#expandContainers() 和 #splitByHinge 替换为常量 SplitType SPLIT_TYPE_EQUAL、SPLIT_TYPE_EXPAND 和 SPLIT_TYPE_HINGE。
    • 删除设置铰链分割类型回退类型的功能。如果由于当前设备或窗口状态无法应用铰链分割类型，则会回退到平均分割父任务容器。使用 SplitController#setSplitAttributesCalculator 自定义回退分割类型。（Ifcc59）
  • 弃用 add/removeSplitCallback
    • 将 add/removeSplitCallback 移动到 SplitControllerCallbackAdapter
    • 添加 Flow 支持以获取 SplitInfo 列表（I7f1b6）
  • 为 ActivityEmbeddingController 添加测试规则（I42e9b）
  • 将 ActivityOptionsCompat 重命名为 ActivityEmbeddingOptions（I89301）
  • 添加 splitSupportStatus 以指示活动嵌入是否可用。（I10024）
  • 引入 SplitAttributes.BackgroundColor 以更好地表示 DEFAULT 值。阐明不支持不透明动画背景颜色，因此任何不透明颜色将被视为默认值，这意味着使用当前主题窗口背景颜色。（Ic6b95）
  • 将 alwaysAllow() 和 alwaysDisallow() 替换为 ALWAYS_ALLOW 和 ALWAYS_DISALLOW。（I3057b）
  • 添加 SplitRule、SplitAttributes、SplitAttributesCalculator 的 API。（I92d23）
  • 添加 TestActivityStack 以创建用于测试的 ActivityStack。
    • 添加 TestSplitInfo 以创建用于测试的 SplitInfo。（I8e779）
  • 添加一种创建伪造 SplitAttributesCalculatorParams 的方法，以便开发人员可以验证其自定义的 SplitAttributesCalculator（Id4a6e）
  • 添加 WindowMetricsCalculator#computeCurrentWindowMetrics(@UiContext context: Context) 和 WindowMetricsCalculator#computeMaximumWindowMetrics(@UiContext context: Context)（I66c7f）

版本 1.2.0-alpha02

2023 年 6 月 7 日

androidx.window:window-*:1.2.0-alpha02 已发布。 版本 1.2.0-alpha02 包含这些提交。

新功能

  • 更新测试 API 以获取未指定折叠功能的常量。
  • 使用 WindowLayoutInfoPublishRule 覆盖将覆盖 windowLayoutInfo 的所有值，包括基于上下文的 API。

API 更改

  • 添加未指定中心折叠功能的常量。（I7530c）

错误修复

  • 更新 WindowLayoutInfoPublishRule 以支持基于 Context 的 WindowLayoutInfo 的覆盖。（I2037a）

版本 1.2.0-alpha01

2023 年 5 月 24 日

androidx.window:window-*:1.2.0-alpha01 已发布。 版本 1.2.0-alpha01 包含这些提交。

新功能

稳定围绕活动嵌入和 WindowLayoutInfoTracker 的测试 API。ActivityEmbeddingRule 已提升至稳定状态。WindowMetricsCalculatorRule 已提升至稳定状态。用于创建测试 FoldingFeature 的实用程序函数已提升至稳定状态。

API 更改

  • 稳定 ActivityEmbeddingRule 以支持围绕活动嵌入的单元测试。（I8d6b6）
  • WindowMetrisCalculatorTestRule 稳定，允许为 JVM 测试存根指标。我们建议使用模拟器以获得准确的结果。
  • 稳定 WindowLayoutInfo 的测试 API 以支持 JVM 测试。（Ie036e）
  • 添加用于测试折叠功能值的 IntRange。（I69f7d）

版本 1.1

版本 1.1.0

2023 年 6 月 7 日

androidx.window:window-*:1.1.0 已发布。 版本 1.1.0 包含这些提交。

自 1.0.0 以来的重要更改

活动嵌入

  • 添加 PROPERTY_ACTIVITY_EMBEDDING_SPLITS_ENABLED 作为应用清单中 <application> 标签的布尔属性。
  • 弃用 isSplitSupported 并替换为 splitSupportStatus 以提供有关分割功能不可用的更详细信息。
  • 添加 SplitController.SplitSupportStatus 嵌套类以提供 splitSupportStatus 属性的状态常量。
  • 将 SplitController 重构为多个模块
    • ActivityEmbeddingController 模块，用于与 Activity 或 ActivityStack 相关的 API。

    • 将 isActivityEmbedded 从 SplitController 移动到 ActivityEmbeddingController。
    • RuleController 模块用于 EmbeddingRule 相关的操作
    • 移除 SplitController API
    • clearRegisteredRules()
    • getSplitRules()
    • initialize()
    • registerRule()
    • unregisterRule()
    • 添加 RuleController API
    • addRule() — 添加规则或更新具有相同标签的规则。
    • removeRule() — 从已注册规则集合中移除规则。
    • setRules() — 建立规则集合。
    • clearRules() — 移除所有已注册规则。
    • parseRules() — 从 XML 规则定义中解析规则。
  • 所有模块都需要通过 #getInstance() 方法初始化上下文，包括
    • ActivityEmbeddingController#getInstance(Context)
    • SplitController#getInstance(Context)
    • RuleController#getInstance(Context)
  • 添加 EmbeddingAspectRatio 类以定义与显示纵横比相关的枚举式行为常量。
  • 添加 SplitAttributes 类以定义分割布局。
  • 将 SplitAttributes 计算器函数添加到 SplitController 以自定义分割布局
    • setSplitAttributesCalculator(Function)
    • clearSplitAttributesCalculator()
    • isSplitAttributesCalculatorSupported() 用于检查设备上是否支持 SplitAttributesCalculator API
  • 添加 EmbeddingRule#tag 字段。
  • SplitRule 中的 API 更新
    • 添加 defaultSplitAttributes — 定义分割的默认分割布局；替换 splitRatio 和 layoutDirection。
    • 将 XML 属性 splitRatio 和 splitLayoutDirection 转换为 defaultSplitAttributes。
    • 更改最小尺寸定义，使用与密度无关的像素 (dp) 而不是像素。
    • 添加 minHeightDp，默认值为 600dp。
    • 将 minWidth 更改为 minWidthDp，默认值为 600dp。
    • 将 minSmallestWidth 更改为 minSmallestWidthDp，默认值为 600dp。
    • 添加 maxAspectRatioInHorizontal，默认值为 ALWAYS_ALLOW。
    • 添加 maxAspectRatioInPortrait，默认值为 1.4。
    • 定义 FinishBehavior 嵌套类以替换完成行为常量。
    • 将属性更改应用于 SplitPairRule 和 SplitPlaceholderRule 的 Builder 嵌套类。
  • 将 SplitInfo#getSplitRatio() 替换为 SplitInfo#getSplitAttributes() 以提供其他与分割相关的信息。

WindowLayout

  • 将实验性非活动 UI 上下文支持添加到 WindowInfoTracker。
  • 将实验性非活动 UI 上下文添加到 WindowMetricsCalculator。

迁移步骤

  • 要启用活动嵌入以在分割中显示活动，应用必须将 PROPERTY_ACTIVITY_EMBEDDING_SPLITS_ENABLED 属性添加到清单 <application> 标签：xml <property android:name="android.window.PROPERTY_ACTIVITY_EMBEDDING_SPLITS_ENABLED" android:value="true" /> 这允许系统提前优化应用的分割行为。
  • SplitInfo 比例
    • 检查当前分割是否为堆叠：kotlin SplitInfo.splitAttributes.splitType is SplitAttributes.SplitType.ExpandContainersSplitType
    • 检查当前比例：kotlin if (SplitInfo.splitAttributes.splitType is SplitAttributes.SplitType.RatioSplitType) { val ratio = splitInfo.splitAttributes.splitType.ratio } else { // 其他类型比例无意义。 }
  • SplitController 迁移
    • SplitController.getInstance() 更改为 SplitController.getInstance(Context)。
    • SplitController.initialize(Context, @ResId int) 更改为 RuleController.getInstance(Context).setRules(RuleController.parse(Context, @ResId int))。
    • SplitController.getInstance().isActivityEmbedded(Activity) 更改为 ActivityEmbeddingController.getInstance(Context).isActivityEmbedded(Activity)。
    • SplitController.getInstance().registerRule(rule) 更改为 RuleController.getInstance(Context).addRule(rule)。
    • SplitController.getInstance().unregisterRule(rule) 更改为 RuleController.getInstance(Context).removeRule(rule)。
    • SplitController.getInstance().clearRegisteredRules() 更改为 RuleController.getInstance(Context).clearRules()。
    • SplitController.getInstance().getSplitRules() 更改为 RuleController.getInstance(Context).getRules()。
  • SplitRule 属性迁移
    • minWidth 和 minSmallestWidth 现在使用 dp 单位而不是像素。应用可以使用以下调用：kotlin TypedValue.applyDimension( COMPLEX_UNIT_DIP, minWidthInPixels, resources.displayMetrics ) 或简单地将像素中的 minWith 除以 displayMetrics#density。
  • 完成行为常量必须迁移到 FinishBehavior 枚举式类常量
    • FINISH_NEVER 更改为 FinishBehavior.NEVER。
    • FINISH_ALWAYS 更改为 FinishBehavior.ALWAYS。
    • FINISH_ADJACENT 更改为 FinishBehavior.ADJACENT。
  • 布局方向必须迁移到 SplitAttributes.LayoutDirection
    • ltr 更改为 SplitAttributes.LayoutDirection.LEFT_TO_RIGHT。
    • rtl 更改为 SplitAttributes.LayoutDirection.RIGHT_TO_LEFT。
    • locale 更改为 SplitAttributes.LayoutDirection.LOCALE。
    • splitRatio 必须迁移到 SplitAttributes.SplitType.ratio(splitRatio)。
  • SplitPairRule.Builder 迁移
    • SplitPairRule.Builder(filters, minWidth, minSmallestWidth) 更改为 kotlin SplitPairRule.Builder(filters) .setMinWidthDp(minWidthInDp) // 如果 minWidthInDp 为 600，则可选。 .setMinSmallestWidthDp(minSmallestWidthDp) // 如果 minSmallestWidthInDp 为 600，则可选。
    • setLayoutDirection(layoutDirection) 和 setSplitRatio(ratio) 更改为 kotlin setDefaultSplitAttributes( SplitAttributes.Builder() .setLayoutDirection(layoutDirection) .setSplitType(SplitAttributes.SplitType.ratio(ratio)) .build() )
    • setFinishPrimaryWithSecondary 和 setFinishSecondaryWithPrimary 使用 FinishBehavior 枚举式常量。有关详细信息，请参阅“SplitRule 迁移”。
    • 使用 setMaxAspectRatioInPortrait(EmbeddingAspectRatio.ALWAYS_ALLOW) 在纵向设备上显示分割。
  • SplitPlaceholder.Builder 迁移
    • 只有 filters 和 placeholderIntent 参数。其他属性移动到 setter。有关详细信息，请参阅“SplitPairRule.Builder 迁移”。
    • setFinishPrimaryWithPlaceholder 使用 FinishBehavior 枚举式常量。有关详细信息，请参阅“SplitRule 迁移”。
    • setLayoutDirection(layoutDirection) 和 setSplitRatio(ratio) 更改为：kotlin setDefaultSplitAttributes( SplitAttributes.Builder() .setLayoutDirection(layoutDirection) .setSplitType(SplitAttributes.SplitType.ratio(ratio)) .build() )
    • 使用 setMaxAspectRatioInPortrait(EmbeddingAspectRatio.ALWAYS_ALLOW) 在纵向设备上显示分割。

版本 1.1.0-rc01

2023 年 5 月 10 日

androidx.window:window-*:1.1.0-rc01 已发布。 版本 1.1.0-rc01 包含这些提交。

新功能

  • 发布 ActivityEmbedding 作为稳定 API。
  • 各种错误修复。

版本 1.1.0-beta02

2023 年 4 月 5 日

androidx.window:window-*:1.1.0-beta02 已发布。 版本 1.1.0-beta02 包含这些提交。

新功能

  • 内部修复和清理。

版本 1.1.0-beta01

2023 年 3 月 22 日

androidx.window:window-*:1.1.0-beta01 已发布。 版本 1.1.0-beta01 包含这些提交。

活动嵌入

  • 添加 PROPERTY_ACTIVITY_EMBEDDING_SPLITS_ENABLED 作为应用清单中 <application> 标签的布尔属性。
  • 弃用 isSplitSupported 并替换为 splitSupportStatus 以提供有关分割功能不可用的更详细信息。
  • 添加 SplitController.SplitSupportStatus 嵌套类以提供 splitSupportStatus 属性的状态常量。
  • 将 SplitController 重构为多个模块
    • ActivityEmbeddingController 模块，用于与 Activity 或 ActivityStack 相关的 API。

    • 将 isActivityEmbedded 从 SplitController 移动到 ActivityEmbeddingController。
    • RuleController 模块用于 EmbeddingRule 相关的操作
    • 移除 SplitController API
      • clearRegisteredRules()
      • getSplitRules()
      • initialize()
      • registerRule()
      • unregisterRule()
    • 添加 RuleController API
      • addRule() — 添加规则或更新具有相同标签的规则。
      • removeRule() — 从已注册规则集合中移除规则。
      • setRules() — 建立规则集合。
      • clearRules() — 移除所有已注册规则。
      • `parseRules() — 从 XML 规则定义中解析规则。
  • 所有模块都需要通过 #getInstance() 方法初始化上下文，包括
    • ActivityEmbeddingController#getInstance(Context)
    • SplitController#getInstance(Context)
    • RuleController#getInstance(Context)
  • 添加 EmbeddingAspectRatio 类以定义与显示纵横比相关的枚举式行为常量。
  • 添加 SplitAttributes 类以定义分割布局。
  • 将 SplitAttributes 计算器函数添加到 SplitController 以自定义分割布局
    • setSplitAttributesCalculator(Function)
    • clearSplitAttributesCalculator()
    • isSplitAttributesCalculatorSupported() 用于检查设备上是否支持 SplitAttributesCalculator API
  • 添加 EmbeddingRule#tag 字段。
  • SplitRule 中的 API 更新
    • 添加 defaultSplitAttributes — 定义分割的默认分割布局；替换 splitRatio 和 layoutDirection。
    • 将 XML 属性 splitRatio 和 splitLayoutDirection 转换为 defaultSplitAttributes。
    • 更改最小尺寸定义，使用与密度无关的像素 (dp) 而不是像素。
    • 添加 minHeightDp，默认值为 600dp。
    • 将 minWidth 更改为 minWidthDp，默认值为 600dp。
    • 将 minSmallestWidth 更改为 minSmallestWidthDp，默认值为 600dp。
    • 添加 maxAspectRatioInHorizontal，默认值为 ALWAYS_ALLOW。
    • 添加 maxAspectRatioInPortrait，默认值为 1.4。
    • 定义 FinishBehavior 嵌套类以替换完成行为常量。
    • 将属性更改应用于 SplitPairRule 和 SplitPlaceholderRule 的 Builder 嵌套类。
  • 将 SplitInfo#getSplitRatio() 替换为 SplitInfo#getSplitAttributes() 以提供其他与分割相关的信息。

WindowLayout

  • 将非活动 UI 上下文支持添加到 WindowInfoTracker。
  • 将非活动 UI 上下文添加到 WindowMetricsCalculator。

迁移步骤

  • 要启用活动嵌入以在分割中显示活动，应用必须将 PROPERTY_ACTIVITY_EMBEDDING_SPLITS_ENABLED 属性添加到清单 <application> 标签：xml <property android:name="android.window.PROPERTY_ACTIVITY_EMBEDDING_SPLITS_ENABLED" android:value="true" /> 这允许系统提前优化应用的分割行为。
  • SplitInfo 比例
    • 检查当前分割是否为堆叠：kotlin SplitInfo.splitAttributes.splitType is SplitAttributes.SplitType.ExpandContainersSplitType
    • 检查当前比例：kotlin if (SplitInfo.splitAttributes.splitType is SplitAttributes.SplitType.RatioSplitType) { val ratio = splitInfo.splitAttributes.splitType.ratio } else { // 其他类型比例无意义。 }
  • SplitController 迁移
    • SplitController.getInstance() 更改为 SplitController.getInstance(Context)。
    • SplitController.initialize(Context, @ResId int) 更改为 RuleController.getInstance(Context).setRules(RuleController.parse(Context, @ResId int))。
    • SplitController.getInstance().isActivityEmbedded(Activity) 更改为 ActivityEmbeddingController.getInstance(Context).isActivityEmbedded(Activity)。
    • SplitController.getInstance().registerRule(rule) 更改为 RuleController.getInstance(Context).addRule(rule)。
    • SplitController.getInstance().unregisterRule(rule) 更改为 RuleController.getInstance(Context).removeRule(rule)。
    • SplitController.getInstance().clearRegisteredRules() 更改为 RuleController.getInstance(Context).clearRules()。
    • SplitController.getInstance().getSplitRules() 更改为 RuleController.getInstance(Context).getRules()。
  • SplitRule 属性迁移
    • minWidth 和 minSmallestWidth 现在使用 dp 单位而不是像素。应用可以使用以下调用：kotlin TypedValue.applyDimension( COMPLEX_UNIT_DIP, minWidthInPixels, resources.displayMetrics ) 或简单地将像素中的 minWith 除以 displayMetrics#density。
  • 完成行为常量必须迁移到 FinishBehavior 枚举式类常量
    • FINISH_NEVER 更改为 FinishBehavior.NEVER。
    • FINISH_ALWAYS 更改为 FinishBehavior.ALWAYS。
    • FINISH_ADJACENT 更改为 FinishBehavior.ADJACENT。
  • 布局方向必须迁移到 SplitAttributes.LayoutDirection
    • ltr 更改为 SplitAttributes.LayoutDirection.LEFT_TO_RIGHT。
    • rtl 更改为 SplitAttributes.LayoutDirection.RIGHT_TO_LEFT。
    • locale 更改为 SplitAttributes.LayoutDirection.LOCALE。
    • splitRatio 必须迁移到 SplitAttributes.SplitType.ratio(splitRatio)。
  • SplitPairRule.Builder 迁移
    • SplitPairRule.Builder(filters, minWidth, minSmallestWidth) 更改为 kotlin SplitPairRule.Builder(filters) .setMinWidthDp(minWidthInDp) // 如果 minWidthInDp 为 600，则可选。 .setMinSmallestWidthDp(minSmallestWidthDp) // 如果 minSmallestWidthInDp 为 600，则可选。
    • setLayoutDirection(layoutDirection) 和 setSplitRatio(ratio) 更改为 kotlin setDefaultSplitAttributes( SplitAttributes.Builder() .setLayoutDirection(layoutDirection) .setSplitType(SplitAttributes.SplitType.ratio(ratio)) .build() )
    • setFinishPrimaryWithSecondary 和 setFinishSecondaryWithPrimary 使用 FinishBehavior 枚举式常量。有关详细信息，请参阅“SplitRule 迁移”。
    • 使用 setMaxAspectRatioInPortrait(EmbeddingAspectRatio.ALWAYS_ALLOW) 在纵向设备上显示分割。
  • SplitPlaceholder.Builder 迁移
    • 只有 filters 和 placeholderIntent 参数。其他属性移动到 setter。有关详细信息，请参阅“SplitPairRule.Builder 迁移”。
    • setFinishPrimaryWithPlaceholder 使用 FinishBehavior 枚举式常量。有关详细信息，请参阅“SplitRule 迁移”。
    • setLayoutDirection(layoutDirection) 和 setSplitRatio(ratio) 更改为：kotlin setDefaultSplitAttributes( SplitAttributes.Builder() .setLayoutDirection(layoutDirection) .setSplitType(SplitAttributes.SplitType.ratio(ratio)) .build() )
    • 使用 setMaxAspectRatioInPortrait(EmbeddingAspectRatio.ALWAYS_ALLOW) 在纵向设备上显示分割。

版本 1.1.0-alpha06

2023 年 2 月 22 日

androidx.window:window-*:1.1.0-alpha06 已发布。 版本 1.1.0-alpha06 包含这些提交。

新功能

  • 公开获取 UI 上下文中 WindowLayoutInfo 的实验版本。

API 更改

  • 添加 splitSupportStatus 以指示活动嵌入是否可用。（I10024）
  • 将 UI 上下文 WindowLayoutInfo API 设为实验性。（I58ee0）
  • 引入 WindowAreaController 和 API 以启用 RearDisplay 模式，将当前窗口移动到与后置摄像头对齐的显示器。（Iffcbf）
  • 更新默认背景颜色。（I1ac1b）
  • 添加 SplitAttributes 参数。（I18bdd）
  • 添加 SplitRule、SplitAttributes、SplitAttributesCalculator 的 API。（I92d23）
  • 改进围绕 maxAspectRatio 的 API
    1. 将 alwaysAllow() 和 alwaysDisallow() 替换为 ALWAYS_ALLOW 和 ALWAYS_DISALLOW。
    2. 更新 @see 的 API 文档，使用独立文档。（I3057b）
  • 以下构造函数已从公共 API 中移除，因为应用不应调用它们。
    • SplitInfo 构造函数
    • ActivityStack 构造函数 (Ide534)
  • SplitRule 现在采用 maxAspectRatioInPortrait/Landscape。它仅允许在父边界纵横比小于或等于请求的 maxAspectRatio 时分割活动。（Ia5990）
  • 更改 RuleController#parseRules 为静态方法 (I785df)
  • 改进围绕 ActivityEmbedding 的 API
    1. 统一 API 命名 - 对多个实例使用 add/remove
    2. registerRule 更改为 addRule
    3. unregisterRule 更改为 removeRule

    4. 将 getSplitRules 替换为 getRules，因为 ActivityRule 不是分割规则。
    5. 添加 RuleController#setRules 来设置一组规则。
    6. 将与规则相关的 API 从 SplitController 提取到单例 RuleController。它们是：
    7. addRule
    8. removeRule
    9. getRules
    10. setRules
    11. clearRules
    12. parseRules
    13. 将 #isActivityEmbedded 从 SplitController 提取到单例 ActivityEmbeddingController。它们是：
    14. isActivityEmbedded
    15. 移除 SplitController#initialize。要从 XML 文件设置规则，请使用 RuleController#parseRules 和 #setRules。更改前：SplitController.initialize(context, R.xml.static_rules) 更改后：val ruleController = RuleController.getInstance(context) val rules = ruleController.parseRules(R.xml.static_rules) ruleController.setRules(rules)
    16. 我们不再区分静态规则和运行时规则。也就是说，调用 #clearRules 会清除所有规则，无论它们是使用静态 XML 规则定义还是在运行时注册的。要获得 SplitController#clearRegisteredRules 的遗留行为，请使用 XML 资源 ID 调用 RuleController#parseRules，并调用 RuleController#setRules 重新设置规则。更改前：SplitController.getInstance(context).clearRegisteredRules() 更改后：val ruleController = RuleController.getInstance(context) val rules = ruleController.parseRules(R.xml.static_rules) ruleController.setRules(rules) (Ib3967)
  • 改进 SplitRule API。
    1. 对于 SplitRule，使用 DP 而不是像素作为最小尺寸。
    2. 重构 SplitRule 构建器，使其将最小尺寸作为可选参数。(I95f17)
  • 传递一个 Context 来初始化 SplitController (I42549)
  • 将 SplitRule#layoutDir 重命名为 #layoutDirection，并将 SplitRule Builder#setLayoutDir 重命名为 Builder#setLayoutDirection。(I3f6d1)

版本 1.1.0-alpha04

2022年11月9日

androidx.window:window-*:1.1.0-alpha04 已发布。 版本 1.1.0-alpha04 包含这些提交。

新功能

  • 公开一个方法来确定 ActivityStack 是否为空，用于 ActivityEmbedding。
  • 从 ActivityEmbedding API 中删除实验性 API 标签。
  • 隐藏 ActivityRule 构造函数，因为 Builder 是首选的构造方式。
  • 添加一个实验性方法来获取 WindowInsets 上的 WindowMetrics。
  • 更新 SplitPlaceholderFinishBehavior 以防止完成占位符。完成占位符会导致一些令人困惑的行为。

API 更改

  • 将 val isEmpty 设为 public 以替换 fun isEmpty。
  • 将 ActivityStack 参数 activities 重命名为 activitiesInProcess。(Ia5055)
  • 移除 ActivityFilter#matchesClassName 和 ActivityFilter#matchesClassNameOrWildCard，因为它们容易造成混淆。
  • 添加 ActivityFilter#componentName 和 ActivityFilter#intentAction 以允许调用者区分不同的过滤器 (I41f22)
  • 从实验性 API 中移除 @Deprecated API (I216b3)
  • 移除 Activity Embedding API 的 @ExperimentalWindowApi (I69ebe)
  • 隐藏 ActivityRule 构造函数，使用 Builder 代替。(If4eb6)
  • 添加 API 以检查 Activity 是否是 ActivityFilter 的一部分。(Ia43cf)
  • 更新 API 文件以反映 WindowMetrics 和 WindowMetricsCalculatorCompat 类中的更改 (I667fe)
  • 更新 ActivityEmbedding 属性 Javadoc 和类名 (Ia1386)
  • 添加 ActivityEmbedding 属性标签名称，用于在 AndroidManifest.xml 中使用 (Id1ad4)
  • 添加了新的 API SplitPlaceholderFinishBehavior 和 SplitPlaceholderRule.finishPrimaryWithPlaceholder，它替换了现有的 SplitPlaceholderRule.finishPrimaryWithSecondary，该 API 定义了何时完成占位符 Activity，以及 Activity Embedding 中关联的 Activity 应该如何表现。(I64647)

错误修复

  • 引入了 WindowAreaController 和 API，以启用 RearDisplay 模式，将当前窗口移动到与后置摄像头对齐的显示屏上。(I388ab)

版本 1.1.0-alpha03

2022年7月27日

androidx.window:window-*:1.1.0-alpha03 已发布。 版本 1.1.0-alpha03 包含这些提交。

新功能

  • 更新嵌入规则的默认值。

API 更改

  • 更新嵌入规则属性的默认值。(Ic4d35)

版本 1.1.0-alpha02

2022年5月11日

androidx.window:window-*:1.1.0-alpha02 已发布。 版本 1.1.0-alpha02 包含这些提交。

新功能

  • 发布适配器库以支持 Java 和 RxJava。

版本 1.1.0-alpha01

2022年5月11日

androidx.window:window-*:1.1.0-alpha01 已发布。 版本 1.1.0-alpha01 包含这些提交。

新功能

  • 发布适配器以支持 Java 和 RxJava

版本 1.1.0-alpha01

2022年4月20日

androidx.window:window:1.1.0-alpha01 已发布。 版本 1.1.0-alpha01 包含这些提交。

新功能

  • 修复了一个错误，该错误会导致应用转到后台时停止发出折叠功能。
  • 扩展实验性 ActivityEmbedding API。

API 更改

  • 一个公共 API，用于检查 Activity 是否正在嵌入。(I39eb7)

错误修复

  • 添加 API 以自定义 Activity 分割中容器的完成行为 (I1a1e4)
  • 添加了 Activity 分割规则的新配置选项。(Iec6af)

版本 1.0

版本 1.0.0

2022年1月26日

androidx.window:window-*:1.0.0 已发布。 版本 1.0.0 包含这些提交。

1.0.0 的主要功能

  • 通过 WindowInfoTracker 和 FoldingFeature 支持折叠手机。 WindowMetricsCalculator 帮助计算当前的 WindowMetrics。

版本 1.0.0-rc01

2021年12月15日

androidx.window:window-*:1.0.0-rc01 已发布。 版本 1.0.0-rc01 包含这些提交。

新功能

  • 添加对通过 WindowInfoTracker 支持折叠手机。
  • 添加方法来计算当前和最大 WindowMetrics。
  • 添加支持测试 API。

版本 1.0.0-beta04

2021年11月17日

androidx.window:window-*:1.0.0-beta04 已发布。 版本 1.0.0-beta04 包含这些提交。

新功能

  • 将 WindowInfoRepository 重命名为 WindowInfoTracker。
  • 使 Activity 成为 WindowInfoTracker 的显式方法依赖项。
  • 为 WindowMetricsCalculator 添加一个简单的 TestRule，以支持使用 Robolectric 的开发者。

API 更改

  • 提取扩展 (I25a5f)
  • 在 ActivityStack 中添加 isEmpty (I5a4e6)
  • 将 WindowInfoRepository 重命名为 WindowInfoTracker。
    • 更新 java/rxjava/testing 依赖项以匹配。(I0da63)
  • 为简单的 WindowMetricsCalculator 添加测试规则。(Ibacdb)

版本 1.0.0-beta03

2021年10月27日

androidx.window:window-*:1.0.0-beta03 已发布。 版本 1.0.0-beta03 包含这些提交。

新功能

  • 添加实验性 Activity Embedding API。此初始布局版本允许并排显示两个 Activity。

API 更改

  • 移除 currentWindowMetrics API，因为我们无法准确地提供它。请改用 WindowMetricsCalculator (Icda5f)
  • 更新扩展 API。(Ica92b)
  • 添加了一个新功能的接口，该功能允许嵌入 Activity 并将其并排显示在父任务窗口中。(I5711d)
  • 隐藏了 WindowMetrics 和 WindowLayoutInfo 的构造函数，请改用测试 API。(I5a1b5)
  • 添加一个 API 来创建伪造的 WindowLayoutInfo 对象。(I4a2fd)

错误修复

版本 1.0.0-beta02

2021年9月1日

androidx.window:window-*:1.0.0-beta02 已发布。 版本 1.0.0-beta02 包含这些提交。

新功能

  • 添加一个实验性注释来注释实验性 API。(I9f1b6)
  • 添加一个测试方法来创建一个接受 Rect 的测试 FoldingFeature。与实际的 Activity 相比，这将使使用 Robolectric 进行测试变得更容易。(Id1cca)

版本 1.0.0-beta01

2021年8月18日

androidx.window:window-*:1.0.0-beta01 已发布。 版本 1.0.0-beta01 包含这些提交。

新功能

  • 移除旧常量并将 FoldingFeature 转换为接口。

API 更改

  • 移除旧常量并将 FoldFeature 转换为接口。(I9a2d5)

错误修复

  • 依赖于 Test Core 库的库已升级到版本 1.4.0，现在可以与 Android 平台版本 S 兼容。(I88b72, b/189353863)

版本 1.0.0-alpha10

2021年8月4日

androidx.window:window-*:1.0.0-alpha10 已发布。 版本 1.0.0-alpha10 包含这些提交。

新功能

  • 将 WindowInfoRepo 重命名为 WindowInfoRepository 并调整相应的类/文件。
  • 将当前窗口指标转换为 WindowInfoRepository 中的 Flow，因为该值会随时间变化。
  • 将 WindowInfoRepoJavaAdapter 重命名为 WindowInfoRepoCallbackAdapter
  • 添加辅助方法来创建测试 FoldingFeature 对象

  • 更新包以根据类支持的功能对类进行分组。

API 更改

  • 将 ActivityExt 重命名为 ActivityExtensions，将 Repo 重命名为 Repository。（I61a16）
  • 更新类的包名。（I23ae2）
  • 从 WindowInfoRepo 中移除 WindowMetrics （I24663）
  • 移除 WindowManager 并使用 WindowInfoRepo
    • 将 WindowBackend 设为内部类。（I06d9a）
  • 将窗口指标转换为 Flow。
    • 将 Java 适配器重命名为 WindowInfoRepoCallbackAdapter
    • 移除 callbackFlow，不再使用实验性 API。（Ia4d15）
  • 添加辅助方法以创建测试显示功能。
    • 将 occlusionMode 更改为 occlusionType （If4cff）

错误修复

  • 修复核心库被移除导致的 ProGuard 错误。
  • 修复 WindowLayoutInfo 未传递给其他订阅者的错误。
  • 修复配置更改不会触发折叠功能更新的错误。

版本 1.0.0-alpha09

2021 年 6 月 30 日

androidx.window:window-*:1.0.0-alpha09 已发布。版本 1.0.0-alpha09 包含这些提交。

新功能

  • 将整数常量更改为无界枚举。
  • 添加一个测试实用程序来创建测试折叠功能。

API 更改

  • 添加辅助方法以创建测试显示功能。（I3cf54）
    • 将 occlusionMode 更改为 occlusionType。

错误修复

  • 在添加多个数据流消费者时发出初始值。

版本 1.0.0-alpha08

2021 年 6 月 16 日

androidx.window:window-*:1.0.0-alpha08 已发布。版本 1.0.0-alpha08 包含这些提交。

新功能

  • 发布了一个测试工件，以便在使用 WindowInfoRepository 时更容易进行测试。使用 WindowInfoRepository 获取有关 DisplayFeatures 和 WindowMetrics 的信息。（I57f66，Ida620）

版本 1.0.0-alpha07

2021 年 6 月 2 日

androidx.window:window-*:1.0.0-alpha07 已发布。版本 1.0.0-alpha07 包含这些提交。

新功能

  • 将核心窗口库迁移到 Kotlin。未来将使用协程和挂起函数来公开异步数据。
  • 添加 WindowInfoRepo 作为获取 WindowMetrics 和 WindowLayoutInfo 流的主要交互点。
  • 新的 window-java 工件，用于公开对 Java 友好的 API 来注册和注销回调。
  • 新的 window-rxjava2 和 window-rxjava3 工件，用于公开 RxJava 适配的 API。

API 更改

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

错误修复

  • 添加新的数据类来表示功能边界。（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 更改

  • 添加用于处理 FoldingFeatures 的便捷方法（Ie733f）
  • 从 WindowManager 中移除同步读取方法（I96fd4）

版本 1.0.0-alpha04

2021 年 3 月 10 日

androidx.window:window:1.0.0-alpha04 已发布。版本 1.0.0-alpha04 包含这些提交。

新功能

  • 修复了一个错误，即如果没有 OEM 实现，则不会发出 WindowLayoutInfo。现在我们发出一个空的 WIndowLayoutInfo。
  • 修复了一个错误，即如果在应用处于后台时铰链状态发生更改，则状态不会正确更新。现在状态应该保持一致。
  • 更新我们的 ProGuard 文件以忽略运行时依赖项的警告。

错误修复

  • 在缺少 OEM 库时发出空值。（Ide935）

版本 1.0.0-alpha03

2021 年 2 月 18 日

androidx.window:window:1.0.0-alpha03 已发布。版本 1.0.0-alpha03 包含这些提交。

新功能

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

错误修复

  • 在缺少 OEM 库时发出空值。（Ide935）

版本 1.0.0-alpha02

2021 年 1 月 27 日

androidx.window:window:1.0.0-alpha02 已发布。版本 1.0.0-alpha02 包含这些提交。

新功能

  • 我们已弃用一些 API，以帮助简化 API 并减少错误。一些值得注意的示例是从 WindowManager 中移除同步读取操作以及弃用 DeviceState。同步读取操作会导致竞争条件并出现不正确的 UI。

  • 我们将 DisplayFeature 转换为一个接口，其他功能将在未来实现该接口。我们的第一个功能是 FoldingFeature，它现在是屏幕折叠或铰链的表示形式。它还包含替换 DeviceState 的铰链状态。

  • WindowMetrics 在 Android 11 中引入，为开发者提供了一种简单的方法来查询有关窗口的指标，例如它在屏幕上的位置和大小以及任何系统插入。我们已在此版本中向后移植了 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 包含这些提交。 这是窗口管理器库的第一个版本。

新功能

  • DisplayFeature：此新 API 识别连续平面屏幕表面（如铰链或折叠）中的中断
  • DeviceState：此新 API 提供手机的当前姿势，姿势来自定义姿势列表（例如，CLOSED、OPENED、HALF_OPENED 等）