Google 致力于为黑人社区推动种族平等。查看具体举措

窗口管理

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().screenWidthActivity.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 成员,或者使用内容视图来确定初始大小。
  • 当应用正在运行时,应监听 onContentRectChangedNativeonGlobalLayout 事件来响应大小变化。
  • 当应用的大小发生变化时,它应重新缩放或重新加载布局和图片并更新输入区域。

全屏模式

全屏模式与原生 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_KEYGUARDTYPE_APPLICATION_MEDIA
  • 通过缓存先前分配的对象来确保实现快速的 Activity 重启。
  • 如果您不希望用户调整应用的大小,请在清单文件中指定 android:resizeableActivity=false
  • 对您的应用进行测试,以确保其能够妥善处理窗口大小的变化。