窗口管理

ChromeOS 支持在多个窗口中使用 Android 应用。系统将应用渲染到窗口容器中，其大小由设备的外形尺寸决定，如图 1 所示。

图 1. 不同设备上的应用窗口。

重要的是要设计适用于不同屏幕尺寸的布局。如果您遵循 Android 指南来支持不同的屏幕尺寸，那么您的应用在 ChromeOS 上运行时也能很好地工作。

此页面介绍如何确保您的应用窗口正确启动、平滑调整大小并在其大小更改时显示其所有内容。

初始启动大小

应用可以通过以下方式请求其初始启动大小

  • 仅在桌面环境中使用启动大小。这有助于窗口管理器为您提供正确的边界和方向。要在桌面模式下使用时指示首选项，请在<activity>内部添加以下元标记
<meta-data android:name="WindowManagerPreference:FreeformWindowSize"
           android:value="[phone|tablet|maximize]" />
<meta-data android:name="WindowManagerPreference:FreeformWindowOrientation"
           android:value="[portrait|landscape]" />
  • 使用静态启动边界。在您的 activity 的清单条目内使用<layout> 来指定“固定”的起始大小，如下例所示
<layout android:defaultHeight="500dp"
            android:defaultWidth="600dp"
            android:gravity="top|end"
            android:minHeight="450dp"
            android:minWidth="300dp" />
  • 使用动态启动边界。activity 在创建新的 activity 时可以使用ActivityOptions.setLaunchBounds(Rect)。通过指定一个空矩形，您的应用可以最大化。

调整窗口大小

在 ChromeOS 中，用户可以通过通常的方式调整应用窗口的大小：拖动右下角，如图 2 所示。

图 2. 可调整大小的应用窗口。

使用View类处理窗口大小调整时，有两种选择

  • 通过调用onConfigurationChanged(..)动态响应配置更改。例如，您可以将android:configChanges="screenSize|smallestScreenSize|orientation|screenLayout"添加到 activity 的清单中。有关处理配置更改的更多信息，请阅读处理配置更改。
  • 让系统重新启动 activity。在这种情况下，实现onSaveInstanceState并使用ViewModel 架构组件来恢复先前保存的状态。

使用Jetpack Compose时，调整大小行为取决于 activity 的配置方式。如果它动态处理更改，则当窗口大小更改时会触发重新组合。如果 activity 由系统重新启动，则在重新启动后会发生初始组合。无论哪种方式，创建适应窗口大小变化的 Compose 布局都很重要。不要假设固定大小。

窗口尺寸

让您的 activity 每次启动时都读取其窗口尺寸，并根据当前配置排列其内容。

要确定当前配置，请在当前 activity 上调用getResources().getConfiguration()。不要使用后台 activity 或系统资源的配置。后台 activity 没有大小，系统配置可能包含多个具有冲突大小和方向的窗口，因此无法提取任何可用数据。

请注意，窗口大小和屏幕大小并不相同。要以 DP 获取窗口大小，请使用Activity.getResources().getConfiguration().screenWidth和Activity.getResources().getConfiguration().screenHeight。您可能永远不需要使用屏幕大小。

内容边界

窗口的内容边界在调整大小后可能会发生变化。例如，如果窗口变得太大而无法完全显示在屏幕上，应用程序使用的窗口区域可能会发生变化。请遵循以下指南

  • 使用 Android 布局流程的应用程序会自动在可用空间中进行布局。

  • 原生应用程序需要读取可用区域并监视大小变化，以避免出现不可访问的 UI 元素。请调用以下方法来确定此表面的初始可用大小

    • NativeActivity.mLastContent[X/Y/Width/Height]()
    • findViewById(android.R.id.content).get[Width/Height]()

    可以使用观察器进行持续监视

    • NativeActivity.onContentRectChangedNative()
    • NativeActivity.onGlobalLayout()
    • 向 view.addOnLayoutChangeListener(findViewById(android.R.id.content)) 添加侦听器

    如果应用程序正在预缩放其美术作品，请在每次分辨率更改时都执行此操作。

自由调整大小

ChromeOS 允许自由调整任何窗口的大小：用户可以更改窗口的宽度、高度和屏幕上的位置。许多 Android 应用程序在编写时并未考虑自由调整大小。请考虑以下问题

  • 屏幕位置可能会发生变化。始终使用系统执行窗口到屏幕和屏幕到窗口的坐标转换。
  • 如果您使用的是 Android 的视图系统，则窗口大小发生变化时，其窗口布局会自动更改。
  • 如果您不使用视图系统并接管表面，则您的应用程序必须自行处理大小更改。
  • 对于原生应用程序，请使用 mLastContent 成员或使用内容视图来确定初始大小。
  • 当应用程序运行时，请侦听 onContentRectChangedNative 或 onGlobalLayout 事件以响应大小更改。
  • 当应用程序的大小发生变化时，请重新缩放或重新加载布局和美术作品，并更新输入区域。

全屏模式

全屏模式的工作方式与原生 Android 上相同。如果窗口没有覆盖整个屏幕，则忽略全屏请求（隐藏所有系统 UI 元素）。当应用程序最大化时，将执行正常的全屏方法、布局和功能。这将隐藏系统 UI 元素（窗口控制栏和底架）。

屏幕方向

Android 应用程序最常见的方向是纵向，因为大多数手机都是这样握持的。纵向模式对于手机来说很好，但对于笔记本电脑和平板电脑来说却很糟糕，因为它们更喜欢横向模式。为了获得最佳效果，请考虑同时支持两种方向。

一些 Android 应用程序假设当设备以纵向模式握持时，旋转值为 Surface.ROTATION_0。这对于大多数 Android 设备来说可能是正确的。但是，当应用程序处于某种 ARC 模式时，纵向方向的旋转值可能不是 Surface.ROTATION_0。

要在读取加速度计或类似传感器时获得准确的旋转值，请使用 Display.getRotation() 方法并相应地交换轴。

根活动和方向

Chromebook 窗口由一堆活动窗口组成。堆栈中的每个窗口都具有相同的大小和方向。

在桌面环境中，突然的方向和大小变化会令人困惑。Chromebook 窗口管理器通过类似于 Android 并排模式的方式避免了这种情况：堆栈底部的活动控制其上方所有活动的属性。这可能会导致意外情况，例如新启动的纵向且不可调整大小的活动变成横向且可调整大小的活动。

设备模式在这里会产生影响：在平板电脑模式下，方向不会被锁定，并且每个窗口都会保留其自身的方向，这在 Android 上是正常的。

方向指南

请遵循以下指南来处理方向

  • 如果您只支持一种方向，请将信息添加到清单中，以便窗口管理器在启动应用程序之前了解它。当您指定方向时，也请尽可能指定传感器方向。Chromebook 通常是可转换设备，而倒置的应用程序会给用户带来糟糕的体验。
  • 尽量保持单个选定的方向。避免在清单中请求一种方向，然后稍后以编程方式设置另一种方向。
  • 小心根据窗口大小更改方向。用户可能会卡在一个小的纵向窗口中，无法返回到更大的横向窗口。
  • Chrome 中有窗口控件可以切换所有可用的布局。通过选择正确的方向选项，您可以确保用户在启动应用程序后拥有正确的布局。如果应用程序支持纵向和横向，则尽可能将其默认设置为横向。设置此选项后，它将按每个应用程序进行记住。
  • 尽量避免不必要的方向更改。例如，如果活动方向为纵向，但应用程序在运行时调用 setRequestedOrientation(LANDSCAPE)，这会导致不必要的窗口大小调整，这会让用户感到厌烦，并可能导致应用程序重启（如果应用程序无法处理）。最好只设置一次方向，例如在清单中，并且只有在必要时才更改它。

其他注意事项

在 ChromeOS 中使用 Android 应用程序时，还有一些其他事项需要考虑

  • 不要在活动的 onDestroy 方法中调用 finish()。这会导致应用程序在调整大小时关闭并且不会重新启动。
  • 不要使用不兼容的窗口类型，例如 TYPE_KEYGUARD 和 TYPE_APPLICATION_MEDIA。
  • 通过缓存先前已分配的对象来加快活动重启速度。
  • 如果您不希望用户调整应用程序的大小，请在清单文件中指定 android:resizeableActivity=false。
  • 测试您的应用程序，以确保它能够适当地处理窗口大小的变化。
上一页
Chromebook 上的应用程序渲染差异
下一页
在 ChromeOS 上调整游戏