开启全面屏体验 | 手势导航 (一)

做者 / Chris Banes, Android 开发者关系团队工程师

本文是手势导航连载的第一篇文章，在接下来的时间里，咱们将会为你们带来一系列手势导航的话题，敬请关注！

咱们在 Android 10 中添加了新的系统导航模式，用户能够经过手势交互执行后退、返回至主屏以及打开设备助手等操做。

△ Android 10 中新加入的手势交互

经过使用手势交互来执行系统导航，应用可使用到更多的屏幕空间。这有助于您为用户打造更加沉浸的体验。

在大多数设备上，用户都能选择他们喜欢的导航模式。现有的三键导航模式 (包含后退、返回首页以及切换最近使用的应用) 会被保留。搭载 Android 10 及以上版本系统的全部设备都要求保留这一导航模式。

您能够经过 Android 系统 UI 产品经理的文章《Android 10 手势导航背后的故事》了解手势导航的研究和决策过程。

这篇文章是本次连载的第一篇。本系列文章会着重为开发者们介绍如何让应用支持手势导航，涵盖的主题以下:

1. 开启全面屏体验，让应用的内容铺满整个屏幕
2. 处理与系统 UI 的视觉冲突
3. 处理与系统手势之间的冲突
4. 各类全面屏体验场景，以及如何适配它们

如今就让咱们开启 "边到边" 的全面屏体验之旅。

全面屏幕体验

我使用 "边到边" (edge-to-edge) 一词来描述那种将内容铺满整个屏幕，以实现更沉浸视觉体验的应用。默认状况下，应用内容的绘制范围从顶部状态栏下方开始，延伸至底部导航栏上方。(状态栏和导航栏统称为系统栏)

实现从边到边的全面屏体验后，系统栏会覆盖在应用内容前方。应用也得以经过更大幅面的内容为用户带来更具备冲击力的体验。

具体来讲，这意味着应用须要作两件事:

在导航栏后面绘制内容

想要支持手势导航，应用须要考虑的第一个因素是在导航栏后面绘制内容。因为导航栏自身的大小和突出程度已经相比之前缩小了，所以咱们如今强烈建议，当应用在 Android 10 及以上设备中运行时，将内容拓展至导航栏后方，以提供更具吸引力的现代化 UX。

在搭载 Android 9 及如下的设备上运行时，导航栏后绘制内容是可选的，方便应用根据状况酌情选择。作到这些事情所需的 API 也都向前兼容至 API 21 (或 AndroidX 的对应版本)，所以支持 Android 10 如下设备所需的额外工做量很小。使用 Android 10 如下设备的用户一样能得到更加沉浸的体验。咱们将它设置为可选，仅仅是为了最大程度地减小开发者的工做量和测试量。

在状态栏后面绘制内容

接下来，咱们来看看屏幕顶部的状态栏。只要您的内容和布局容许，咱们建议尽可能把内容也拓展到状态栏的后方。举个具体的例子，好比像下图那样把一张背景图铺在状态栏后面，具体的技术实现能够参考相似 AppBarLayout 等布局，并将其放在屏幕顶部。

但若是应用的 UI 包含一个列表，并且列表顶端还固定放着一个 Toolbar 的话，那把内容绘制在状态栏后面就可能不合适了。一样，有些时候把内容绘制在导航栏下面也不合适。再强调一次: 是否扩展应用内容的绘制区域彻底取决于开发者，是可选的。

如何实现

想实现 "边到边" 全面屏体验分三步:

1. 请求进行全屏布局

第一步是让系统将咱们应用布局扩展至系统栏后方。须要使用的 API 是视图上的 setSystemUiVisibility()，它接受一些值，这里咱们主要关注这么几个值:

view.systemUiVisibility = 
    // Tells the system that the window wishes the content to
    // be laid out at the most extreme scenario. See the docs for
    // more information on the specifics
    View.SYSTEM_UI_FLAG_LAYOUT_STABLE or
    // Tells the system that the window wishes the content to
    // be laid out as if the navigation bar was hidden
    View.SYSTEM_UI_FLAG_LAYOUT_HIDE_NAVIGATION
复制代码

设置完毕后能够看到应用的内容出如今导航栏的后面:

△ 应用内容在全屏范围内渲染，并且在导航栏后面

2. 更改系统栏颜色

咱们的应用布局如今已经拓展至全屏范围，所以须要同步更改一下系统栏的颜色，以便看清其后面的应用内容。

Android 10

在 Android 10 上，咱们只须要将系统栏颜色设为彻底透明便可:

<!-- values-v29/themes.xml -->
<style name="Theme.MyApp">
    <item name="android:navigationBarColor">
        @android:color/transparent
    </item>

    <!-- Optional, if drawing behind the status bar too -->
    <item name="android:statusBarColor">
        @android:color/transparent
    </item>
</style>
复制代码

在 Android 10 上，系统会负责在全部导航模式下确保系统栏的内容可见 (包括时间、图标、拖拽条等)。这意味着这些事情再也不须要咱们操心。具体来讲，系统会执行如下两项操做之一:

1. 动态颜色适配

系统栏里的内容会根据其后面的内容改变颜色。若是拖拽条位于浅色内容前方，它将变为深色，在深色内容前方时则变为浅色。

△ Android 10 上的动态颜色适配

2. 半透明遮盖

另外，系统也能够在系统栏后面放置一层半透明遮盖。对此咱们最想提醒您注意的是，仅当您的应用声明 targetSdkVersion 为 29 时，才会发生这种状况。若是您的应用针对的是 SDK 28 或更低版本，则系统不会显示遮盖，而是提供透明的导航栏。

△ 在 Android 10 上选择按键导航模式时，系统会在按钮后方提供半透明遮盖

这两种操做都是为了确保用户始终能够看到系统栏的内容。系统选择采用哪一种作法取决于多个因素。若是知足如下条件，系统将使用遮盖:

• 启用了两键或三键导航模式。
• 设备制造商在手势导航模式下禁用了动态颜色适配。制造商这么作的缘由多是设备的性能不足以支持动态色彩适配。

△ 使用手势导航模式时系统提供的半透明遮盖

不然，系统将使用动态色彩适应。上文中列出的条件是目前系统用来判断的依据，在未来可能会更改。

在 Android 10 上禁用系统栏视觉保护

若是您不想让系统执行任何自动内容视觉保护，则能够经过在主题中将 android:enforceNavigationBarContrast 和/或 android:enforceStatusBarContrast 的值设置为 false。

Android 9 及更早版本

若是您决定在 Android 10 如下的设备上实现全面屏应用，则应将系统栏颜色设置为半透明，从而确保其内容可见。好比针对深色主题的系统栏，能够先试试使用 70％ 不透明度的黑色进行遮盖:

<!-- values/themes.xml -->
<style name="Theme.MyApp">
    <item name="android:navigationBarColor">
        #B3FFFFFF
    </item>
</style>

<!-- values-night/themes.xml -->
<style name="Theme.MyApp">
    <item name="android:navigationBarColor">
        #B3000000
    </item>
</style>
复制代码

您可能须要根据系统栏后面显示的内容来调整遮盖的不透明度。对于浅色主题，能够试试使用半透明浅色遮盖 (如 #B3FFFFFF)。

△ 深浅两种主题的遮盖示例

3. 处理视觉冲突

按照本文的说明将应用设置为全面屏后，您可能会发现应用里有一些视图/控件被系统栏遮住了。接下来咱们就须要处理视觉冲突，请关注咱们的微信公众帐号，接下来将为您推送本系列更多的文章。

本文鸣谢: Nick Butcher

点击这里进一步了解 Android 手势导航