ChromeOS 支持在多个窗口中运行 Android 应用。系统会将应用呈现到窗口容器中,窗口容器的大小由设备的外形规格决定,如图 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 所示。
使用 View
类时,有两个选项可用于处理窗口大小调整:
- 通过调用
onConfigurationChanged(..)
动态响应配置更改。例如,您可以向 activity 的清单中添加android:configChanges="screenSize|smallestScreenSize|orientation|screenLayout"
。如需详细了解如何处理配置变更,请参阅处理配置变更。 - 让系统重启 Activity。在这种情况下,请实现
onSaveInstanceState
并使用 ViewModel 架构组件恢复先前保存的状态。
使用 Jetpack Compose 时,大小调整行为取决于 activity 的配置方式。如果它会动态处理更改,则会在窗口大小发生变化时触发重组。如果系统重启了 activity,则会在重启后进行初始组合。无论采用哪种方式,您都必须创建能够适应不断变化的窗口大小的 Compose 布局。不要假定尺寸固定。
窗口尺寸
让您的 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))
添加监听器
如果应用预缩放其图片,请在每次分辨率发生变化时执行此操作。
自由式大小调整
ChromeOS 允许随意调整任何窗口的大小:用户可以更改窗口的宽度、高度和在屏幕上的位置。许多 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)
,则会导致不必要的窗口大小调整,这会让用户感到厌烦,而且可能会重启应用无法处理的应用。最好设置一次屏幕方向(例如,在清单中设置),只有在必要时才进行更改。
其他注意事项
在 ChromeOS 中使用 Android 应用时,还需要考虑以下事项:
- 不要在 Activity 的
onDestroy
方法中调用finish()
。这会导致应用在调整大小时关闭而不是重启。 - 不要使用不兼容的窗口类型,如
TYPE_KEYGUARD
和TYPE_APPLICATION_MEDIA
。 - 通过缓存先前分配的对象,使 activity 能够快速重启。
- 如果您不希望用户调整应用的大小,请在清单文件中指定
android:resizeableActivity=false
。 - 对您的应用进行测试,以确保其能够妥善处理窗口大小的变化。