窗口管理

Chrome 操作系统在多个窗口中支持 Android 应用。系统会将应用呈现到窗口容器中，窗口容器的大小由设备类型决定，如图 1 所示。

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

调整窗口大小

在 Chrome 操作系统中，用户可按常规方式（即拖动右下角）调整应用窗口的大小，如图 2 所示。

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

处理窗口大小调整的方式有两种：

通过调用 onConfigurationChanged(..) 并向 Activity 的清单中添加诸如 android:configChanges="screenSize|smallestScreenSize|orientation|screenLayout" 之类的内容，动态响应配置更改。如需详细了解如何处理配置更改，请阅读处理配置更改文档。
让系统重启 Activity。在这种情况下，您应实现 onSaveInstanceState 并使用 ViewModel 架构组件恢复先前保存的状态。

本页介绍如何确保应用窗口正确启动、顺畅地调整大小，并且在其大小发生变化时可以显示全部内容。

窗口尺寸

Activity 应在每次启动时读取其窗口尺寸，并根据当前配置排列其内容。

如需确定当前配置，请对当前 Activity 调用 getResources().getConfiguration()。请勿使用后台 Activity 或系统资源的配置。后台 Activity 没有大小，而系统配置可能会包含大小和方向冲突的多个窗口，因此无法提取可用的数据。

请注意，窗口大小与屏幕大小不同。如需获取窗口大小（以 DP 为单位），请使用 Activity.getResources().getConfiguration().screenWidth 和 Activity.getResources().getConfiguration().screenHeight。您或许永远都不需要使用屏幕大小。

内容边界

窗口的内容边界可能会随着大小调整而发生变化。例如，如果窗口太大以致屏幕容纳不下，那么应用使用的窗口区域就可能会发生变化。请遵循以下准则：

使用 Android 布局过程的应用会自动在可用空间中进行布局。
原生应用应读取可用区域并监控大小变化，以避免出现无法访问的界面元素。您可以调用以下方法来确定相应界面的初始可用大小：
- 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)) 添加监听器。如果应用预缩放其图片，则每次分辨率发生变化时都应执行此操作。

自由式大小调整

Chrome 操作系统允许自由地调整任何窗口的大小：用户可以改变窗口的宽度、高度以及在屏幕上的位置。许多 Android 应用在编写时没有考虑到自由式大小调整。请考虑以下问题：

屏幕位置可能会发生变化。请务必使用系统执行窗口到屏幕和屏幕到窗口坐标转换。
如果您使用 Android 的视图系统，则当窗口大小发生变化时，窗口布局会自动发生变化。
如果您不使用视图系统并接管界面，则您的应用必须自行处理大小变化。
原生应用应使用 mLastContent 成员，或者使用内容视图来确定初始大小。
当应用正在运行时，应监听 onContentRectChangedNative 或 onGlobalLayout 事件来响应大小变化。
当应用的大小发生变化时，它应重新缩放或重新加载布局和图片并更新输入区域。

全屏模式

全屏模式与原生 Android 上的工作方式一样。如果窗口未覆盖全屏，则对全屏显示（隐藏所有系统界面）的请求会被忽略。当应用最大化时，会执行常规全屏方法、布局和功能。这样会隐藏系统界面元素（窗口控制栏和任务栏）。

屏幕方向

Android 应用最常见的屏幕方向是纵向，因为大多数用户都是这样拿手机的。虽然纵向很合适手机，但非常不适合笔记本电脑和平板电脑，因为这些设备通常是横向使用的。为了让您的应用获得最佳呈现效果，您应考虑支持这两种屏幕方向。

某些 Android 应用假设当设备处于纵向模式时，旋转值始终为 Surface.ROTATION_0。对于大多数 Android 设备而言，可能确实如此。不过，当应用处于某种 ARC 模式时，纵向的旋转值可能不是 Surface.ROTATION_0。

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

根 Activity 和方向

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

在桌面环境中，突然的方向和大小变化会让用户感到困惑。Chromebook 窗口管理器采用一种与 Android 的并排模式类似的方式来避免此问题：堆栈底部的 Activity 控制上面所有 Activity 的属性。这可能会导致意外情况：新启动的一个纵向不可调整大小的 Activity 可能会变为横向可调整大小。

设备模式作用如下：在平板电脑模式下，方向未锁定，每个窗口保持其在 Android 上的正常方向。

屏幕方向准则

处理屏幕方向时，请遵循以下准则：

如果仅支持一种屏幕方向，请将该信息添加到清单中，以便窗口管理器在启动应用之前了解这一点。指定屏幕方向时，如有可能，还应指定传感器方向。Chromebook 通常是可转换设备，而颠倒的应用会让用户感到厌烦。
尽量保持选定的一种屏幕方向。避免先在清单中请求一种屏幕方向，而后又以编程方式设置另一种屏幕方向。
根据窗口大小改变屏幕方向时应格外小心。用户可能会卡在小的纵向窗口中，无法回到较大的横向窗口中。
Chrome 中有用于在所有可用布局之间切换的窗口控件。通过选择正确的屏幕方向选项，您可以确保用户在启动应用时获得正确的布局。如果应用支持纵向和横向模式，则默认为横向模式（如有可能）。设置此选项后，系统会记住每个应用的相应设置。
设法避免不必要的屏幕方向变化。例如，如果 Activity 方向为“纵向”，但应用在运行时调用 setRequestedOrientation(LANDSCAPE)，就会导致不必要的窗口大小调整，这样会让用户感到厌烦，而且如果您无法处理，还可能会重启应用。最好设置一次屏幕方向（例如，在清单中设置），只有在必要时才进行更改。

初始启动大小

应用可以通过以下方式指定其初始启动大小：

仅在桌面环境中使用启动大小。这有助于窗口管理器为您提供适当的边界和方向。如需在桌面模式下使用时指明偏好设置，请在 <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)。通过指定一个空矩形，您的应用可以最大化。

其他注意事项

下面是在 Chrome 操作系统中使用 Android 应用时需要考虑的其他一些方面：

不要在 Activity 的 onDestroy 方法中调用 finish()。这样做会导致应用在调整大小时关闭而不是重启（假定应用必须重启）。
不要使用不兼容的窗口类型，如 TYPE_KEYGUARD 和 TYPE_APPLICATION_MEDIA。
通过缓存先前分配的对象来确保实现快速的 Activity 重启。
如果您不希望用户调整应用的大小，请在清单文件中指定 android:resizeableActivity=false。
对您的应用进行测试，以确保其能够妥善处理窗口大小的变化。

App 在 Chromebook 上的顯示差異

提供適合 Chrome OS 的遊戲