「不想上班」鸿蒙实战系列 :两份配置零代码,平行视界把工位搬上大屏

折叠屏展开的那一刻,「不想上班」的工位面板被拉成了一条横贯屏幕的横幅:卡片还是那几张卡片,只是每一张都宽得离谱,窝囊费的数字孤零零地悬在屏幕左角,像在抗议什么。

还没完成大屏适配的应用,在平板和折叠屏上基本都逃不过两种命运:要么被强行拉伸变形,要么两边留着大黑边假装自己是台老式电视机。本文记录我们用鸿蒙 平行视界(EasyGo) 给「不想上班」兜底大屏体验的完整过程——两份配置文件、零行业务代码,亲测从打开文档到折叠屏真机看到分栏效果,成本约等于喝杯咖啡的时间。
在这里插入图片描述

一、从一个翻车现场说起:什么是平行视界

平行视界(EasyGo / Parallel View)是华为为大屏设备(折叠屏展开态、平板)准备的系统级应用显示技术。它的核心思路很直白:既然一个页面铺不满大屏,那就让同一个应用在一个窗口里同时显示两个页面——一级页面固定在左,二级页面在右侧打开,形成左右分栏。

1.1 系统怎么决定"要不要分栏"

并不是屏幕够大就一定分栏,系统看的是窗口宽度和宽高比两个条件(同时满足):

  • 长方形宽屏窗口:宽度 ≥ 600vp,且宽/高 > 1.2。折叠屏完全展开、平板横屏都在此列;
  • 方形宽屏窗口:宽度 ≥ 600vp,且高/宽 ≤ 1.2、宽/高 ≤ 1.2。双折叠展开态大致落在这里。

换句话说,平行视界认的是"窗口形态"而不是"设备型号"。这也解释了为什么自由多窗(自由悬浮小窗)场景下它默认不生效——窗口不够宽,分栏没有意义。

1.2 两种路由模式:一个像工位,一个像货架

平行视界目前提供两种页面排布策略:

  • 导航模式:左侧主页钉死不动,右侧持续刷新二级页面。像工位——桌面(主页)永远在那儿,你只是在桌面上不断摊开新的文件。适合"左侧目录树、右侧看详情"的办公类应用;
  • 购物模式:右侧永远显示路由栈栈顶页面,左侧显示次栈顶页面,页面随跳转一路向右推。像逛货架——走完一个货架自然来到下一个,回退时原路折返。适合浏览路径层层深入的应用。

从 API 26 开始,这两种模式可以通过 mode 字段显式指定(0 购物 / 1 导航,默认导航模式)。

1.3 对工具类应用意味着什么

官方文档举的例子多为购物、邮件、IM。落到「不想上班」这种打工人工具箱上,价值同样直接:

  • 左侧挂着工位面板(窝囊费照常按秒跳动),右侧点开今日待办逐条勾选;
  • 左侧停留在随手记列表,右侧翻看某条日志的完整内容;
  • 左侧是设置项清单,右侧直接调整当前项,改完即见效果。

共性就一条:把"返回上一页"这个高频动作从交互路径里抹掉。

二、选型:为什么是平行视界,而不是手写分栏

鸿蒙生态里做双栏,绕不开 Navigation 的 Split 模式(配合 systemRouteTable 支持 Router)。两者不是竞争关系,先对齐定位再谈选择:

维度平行视界(EasyGo)手写 Navigation 分栏
本质系统级兼容兜底方案应用级 UI 布局方案
改动量纯配置,业务代码零改动需要改造页面与路由结构
控制力系统统一接管,可控项有限比例、栈管理、联动全部可定制
生效范围满足条件的宽屏窗口自动触发跟随应用自身的断点与布局逻辑

「不想上班」的选择过程其实很简单:我们的一多适配主线(断点 + GridRow/GridCol,见系列外篇《一多适配实战》)负责"认真做"的大屏体验,而平行视界负责在还没轮到精细适配的页面上兜住底线。两份配置换全量页面的大屏兜底。

顺带说清三条接入边界,免得踩空:

  1. 先开分栏显示,再谈平行视界。打开系统设置里的"平行视界"开关是配置生效的前置条件(系统默认开启状态);
  2. 只在满足条件的宽屏窗口生效。直板机竖屏、折叠态外屏、自由小窗,都还是原来的单栏布局,不影响存量体验;
  3. 二级页面的宽度被压缩了。分栏后右侧页面拿到的是"右半屏"的宽度,页面里按窗口宽度算断点的逻辑会看到更窄的值(这个行为的开关在后面配置里讲)。

三、两步接入:配置长什么样

整个接入只有两步:建一份 easy_go.json,在 module.json5 里指一下。官方环境要求是 SDK 版本不低于 6.1.0(23)——「不想上班」的 compatibleSdkVersion 正好是 6.1.0(23)、targetSdkVersion 26.0.0,踩在门槛上,mode 等 API 26 扩展字段也都能用。

3.1 配置结构速览

easy_go.json 是一份两层结构的 JSON:

  • 第一层选设备:common(通用,必填)/phone / tablet,设备级配置一旦存在就覆盖 common;
  • 第二层选显示模式:displayModeOptions 里用 wideWindowMode(长方形窗口,必填)和 squareWindowMode(方形窗口,可选)声明路由实现方式,取值三选一:
    • navigationSplit:路由由 Navigation 组件实现(须搭配 navigationSplitOptions);
    • routerSplit:路由由 Router 模块实现(搭配 routerSplitOptions);
    • original:关闭兼容行为,恢复原始显示。

「不想上班」全量页面都跑在 Navigation 上,所以两个窗口模式都填 navigationSplit。注意 routerSplitOptions 和 navigationSplitOptions 不能同时存在,官方也不建议在开启平行视界的应用里混用两种路由框架。

3.2 本项目用到的字段

navigationSplitOptions 下可选字段不少,我们最终只用了 6 个,每个的选择理由在第四章展开:

  • homePage:主页名称。Navigation 路由下,若主页是 Navigation 首页本身,固定填 "navBar";若主页是某个 NavDestination,则填它的 name;
  • relatedPage:关联页名称,进入分栏时直接和主页一起摆出;
  • mode:路由模式,0 购物 / 1 导航(API 26 起);
  • enableReducedContainerSize:分栏时窗口宽度、横向断点等是否按"右半屏尺寸"计算;
  • fullScreenPages:全屏页名单,进入即退出分栏;
  • supportLandscapeFullscreen:应用主动请求横屏时是否退出分栏全屏显示(默认 true)。

另有 3 个我们没用但值得知道的:pagePairs(导航模式下配置 from→to 的自定义分栏跳转关系)、transPages(购物模式下固定右侧显示的过渡页)、wideSplit/squareSplit(API 26 起配置左右比例 ratio 或开启分割线拖拽 isDraggable)。

3.3 第二步:挂到模块上

在 entry 模块的 module.json5 中声明配置路径,应用级生效(仅 entry 模块支持,取值不超过 255 字节):

{
  "module": {
    "easyGo": "$profile:easy_go"
  }
}

至此收工。重签名、装到折叠屏设备、展开,就能看到分栏。

四、「不想上班」的落地配置

先上完整配置,再逐项说为什么。

4.1 实际配置

entry/src/main/resources/base/profile/easy_go.json:

{
  "common": {
    "displayModeOptions": {
      "wideWindowMode": "navigationSplit",
      "squareWindowMode": "navigationSplit",
      "navigationSplitOptions": {
        "homePage": "navBar",
        "relatedPage": "TodoPage",
        "mode": 0,
        "enableReducedContainerSize": true,
        "fullScreenPages": [
          "PicturePreviewPage"
        ],
        "supportLandscapeFullscreen": true
      }
    }
  }
}

module.json5 侧:

{
  "module": {
    // ... 其余字段略
    "easyGo": "$profile:easy_go"
  }
}

4.2 逐项选型理由

homePage 为什么是 "navBar"。「不想上班」的主页(工位面板)本身就是 Navigation 的首页内容,而不是某个下钻的 NavDestination。按官方约定,这种情况 homePage 填固定值 "navBar" 即可。如果哪天主页重构成独立 NavDestination,这里改成它的 name 就行。

relatedPage 为什么是 TodoPage。 官方对关联页的建议是"配置无需动态参数的静态页面"。今日待办完美符合:打开频率高、内容基本静态、不需要传参。用户在大屏上展开应用的瞬间,左边工位、右侧待办,第一眼就是"今天还要干什么"——这比摆个空白占位页有诚意得多。

mode 为什么是 0(购物模式)。「不想上班」的典型路径是"首页 → 功能页 → 编辑/预览页"层层深入:从工位点进随手记,再点进某条日志。购物模式下右侧永远是栈顶页、左侧是上一个页面,正好把这条深入路径摊开成双栏;导航模式那种"左侧永远钉死主页"的摆法,反而会浪费左半屏。

fullScreenPages 为什么只有 PicturePreviewPage。 大图预览页要双指缩放看细节,右半屏的宽度会让图片先天吃亏,进预览页时退出分栏全屏展示、返回后自动恢复,体验顺承。注意名单里的页面不能和 homePage、relatedPage 重复。

enableReducedContainerSize 为什么开。 开启后,分栏态下页面拿到的窗口宽度、横向断点都按右半屏尺寸计算——功能页里基于断点的布局(比如我们一多适配做的 GridRow 档位)会按"窄屏"逻辑正确收敛,而不是拿整屏宽度把卡片拉宽。退出分栏(比如进入全屏页)时该行为自动失效,不用自己写状态判断。

supportLandscapeFullscreen 为什么保持 true。 这是默认值,主动横屏(如果有这类页面)时理当全屏,分栏硬扛横屏没有意义。

4.3 实践小结

配置完成后,在折叠屏设备上的实测表现:
在这里插入图片描述

  1. 展开态冷启动,左侧工位面板 + 右侧今日待办同时摆出;
    在这里插入图片描述

  2. 从右侧随手记全部记录页面点击具体的记录,购物模式生效,全部记录页左移、记录详情页在右侧打开;
    在这里插入图片描述

  3. 从随手记进入图片预览,全屏展示,返回后分栏恢复;

  4. 折叠回外屏,一切回到单栏,无任何残留状态。

五、踩坑与自查清单

三条我们自己验证过的,加两条官方反复强调的:

  1. Router 与 Navigation 不要混用。混用会导致部分页面分栏异常,官方明确不建议;我们全量 Navigation,这条是白捡的合规。
  2. 全屏页名单别贪多。只把"半屏一定看不好"的页面放进去(大图预览、视频播放这类)。放多了用户会在分栏和全屏之间反复横跳。
  3. 主页识别别赌系统默认策略。系统默认识别机制有失败概率,homePage 显式配置上,一行配置买个确定性。
  4. (官方提醒)别在打开过的应用上静态改配置后假装生效。平行视界配置在应用启动时读取,改完 easy_go.json 要杀进程重启才能看到效果。
  5. (官方提醒)模块归属。easyGo 只能配在 entry 模块的 module.json5,feature 模块里配了也没用。

如果业务里真的需要感知"当前是否处于平行视界分栏"(比如按分栏态调整某块 UI),可以查询 display.isEasySplit()——「不想上班」没有这类诉求,这个方法我们只验证了存在性,未投入使用。

六、总结:一次提交换来的大屏体验

回头看这次接入,全部工作量是:一份 20 行的 easy_go.json,加 module.json5 里的一行引用。

  • 对未完成大屏精细适配的应用,平行视界是目前鸿蒙生态里成本最低的兜底方案,没有之一;
  • 对「不想上班」而言,它让折叠屏用户提前用上了"左边工位、右边待办"的双栏工位,而我们的一多适配主线可以继续按自己的节奏打磨;
  • 两张清单值得带走:主页/关联页/路由模式三个字段想清楚再填,全屏页名单克制一点。

大屏不是把页面拉宽,是把动线缩短。下一篇聊图片:随手记里的图既要省空间存、又要看得清——压缩与超分是怎么在「不想上班」里共存的。


参考文档

  1. HarmonyOS 官方最佳实践《平行视界》:https://developer.huawei.com/consumer/cn/doc/best-practices/bpta-easygo-parallel
  2. HarmonyOS 官方设计指南《平行视界》:https://developer.huawei.com/consumer/cn/doc/design-guides/parallel_view-0000002588655180
  3. 官方示例代码(easygo-parallel-shopping):https://gitcode.com/HarmonyOS_Samples/easygo-parallel-shopping
Logo

作为“人工智能6S店”的官方数字引擎,为AI开发者与企业提供一个覆盖软硬件全栈、一站式门户。

更多推荐