目录

多设备新闻阅读界面

概述

本文以新闻阅读应用为例,介绍如何基于三层架构、断点监听和自适应布局,实现一套代码在直板机、折叠屏、平板和电脑上的多端部署。目前该应用已适配设备包括:直板机、阔折叠、双折叠、三折叠、平板和电脑。

在阅读本文前,建议开发者先了解ArkUI(方舟UI框架)和一次开发,多端部署概览相关知识。

下文将从UX设计、工程管理、移动端页面和电脑端页面四个方面,系统介绍新闻阅读应用在实际开发中的最佳实践,为开发者提供可借鉴的实现思路。

UX设计

新闻阅读应用的UX设计可参考新闻阅读类设计指南。应用在直板机上采用单列纵向布局,在折叠屏和平板上以双列栅格展示,在电脑上采用侧边栏加内容区的分栏布局。多设备新闻阅读界面在不同设备形态下的效果如下所示:

工程管理

考虑到“一多”工程代码的复用性和可维护性,推荐开发者使用分层架构组织代码工程。分层架构将项目工程划分为产品定制层(products)、基础特性层(features)和公共能力层(common)三个层级,各层级权责清晰、各司其职,为开发者提供了一套清晰、高效且可扩展的设计架构。关于分层架构的具体设计细节,可参考分层架构设计。

[h2]创建工程

建议开发者参考多设备工程部署与发布相关内容,掌握分层架构工程的创建与配置方法后,创建出模板项目工程。然后根据新闻阅读应用的开发需求进行针对性修改,确保工程架构贴合实际业务需求。

[h2]工程结构

在创建“一多”工程时,开发者会面临工程结构目录的划分问题。考虑到复用性和可维护性,本文以新闻阅读应用为例,提供推荐的参考方案。

HarmonyOS的分层架构主要包括三个层次:产品定制层、基础特性层和公共能力层,为开发者构建了一个清晰、高效、可扩展的设计架构。更多详情请参考分层架构设计的逻辑设计。

新闻阅读应用根据一多推荐的products、features、common的“三层工程架构”划分目录。各层级设计如下:

工程结构如下:

├──common                          // 公共能力层 
│  └──src/main/ets
│     ├──components                // 公共 UI 组件(NewsCard 等)
│     ├──constants                 // 公共常量(断点等)
│     ├──types                     // 数据契约接口
│     └──utils                     // 窗口、断点、日志等工具
├──features                        // 基础特性层
│  ├──recommendation               // 首页推荐
│  │  └──src/main/ets
│  │     ├──constants              // 推荐常量
│  │     ├──model                  // 推荐数据
│  │     ├──view                   // 首页 UI 组件
│  │     └──viewmodel              // 首页状态
│  └──newsdetail                   // 新闻详情
│     └──src/main/ets
│        ├──constants              // 详情常量
│        ├──model                  // 详情数据
│        ├──view                   // 详情页 UI 组件
│        └──viewmodel              // 详情页状态
└──products                        // 产品定制层
   ├──default                      // 默认(直板机/折叠屏/平板)产品
   │  └──src/main/ets
   │     ├──defaultability         // 默认入口 Ability
   │     └──pages                  // 页面(首页、详情等)
   └──pc                           // 电脑端产品
      └──src/main/ets
         ├──pages                  // 电脑页面
         ├──pcability              // 电脑入口 Ability
         ├──view                   // 电脑标题栏组件
         ├──viewmodel              // 电脑视图模型
         └──window                 // 电脑窗口管理

移动端页面

本章介绍如何针对直板机、阔折叠、双折叠、三折叠和平板设备,使用“一多”布局能力,实现新闻阅读应用页面层级“一套代码、多端适配”。同时,介绍上述设备的窗口适配方案,以及各页面的交互开发和功能开发方案。

[h2]窗口适配

[h2]首页推荐页

首页推荐页包含热点要闻、大图轮播、上文下图卡片和新闻列表等多个内容区块。在直板机上这些区块纵向单列排列,在折叠屏展开态和平板上需要以双列栅格展示并控制摘要内容的显隐,同时顶部搜索栏和子Tab栏的排列方式也需随横向断点切换。

设备效果图如下:

横向(/纵向)断点

sm/md

sm/lg

md

lg、xl

首页推荐页

界面开发

移动端首页推荐页各区域介绍及实现方案如下表所示:

区域编号

简介

实现方案

1

顶部页签及搜索框

使用GridRow栅格组件实现,在不同横向断点下,通过设置GridCol的span和order,实现搜索框和页签的上下或左右布局:直板机设备搜索框占满整行在上、页签在下;PuraX外屏或横向断点为md及以上时页签居左、搜索框居右。

2

热点要闻

使用List组件实现,通过lanes属性按断点分栏:横向断点为sm时1列、md时2列、lg/xl时3列。

3

大图轮播

使用Swiper组件实现,通过displayCount按断点切换显示数量(横向断点下sm为1,md为2,lg/xl为3)。

4

上文下图卡片

使用Column纵向排布标题和多张图片实现上文下图卡片。横向断点为sm/md时展示1条,lg/xl断点下通过Row并排展示2条。

5

新闻列表

横向断点为sm时单列展示,md及以上断点使用GridRow双列栅格展示。

6

底部/侧边页签

使用Tabs组件实现,配置barFloatingStyle悬浮样式和沉浸光感材质(通过uiMaterial (系统材质)创建),API 26及以上设备生效,低版本降级为经典底部页签栏。

[h2]新闻详情页

新闻详情页包含文章正文和评论区两部分。在直板机设备上,正文与评论区需纵向排列;在大屏设备上,二者并排展示,评论区作为侧栏可独立滚动。底部悬浮工具栏使用背景模糊材质悬浮展示。

横向(/纵向)断点

sm/md

sm/lg

md

lg、xl

新闻详情页

界面开发

移动端新闻详情页各区域介绍及实现方案如下表所示:

区域编号

简介

实现方案

1

新闻标题和作者区

使用Column纵向排布新闻标题和作者行,作者行使用Row横排头像、名称、发布时间和关注按钮,内边距按断点调整。

2

内容区

正文图文使用Scroll承载滚动展示。小屏下与标题、评论区纵向堆叠统一滚动。

3

评论区

使用List展示评论列表。横向断点为md及以上时置于SideBarContainer右侧侧栏独立滚动;横向断点为sm时堆叠于正文下方。

4

底部悬浮工具栏

使用Stack悬浮于内容上方,通过backgroundBlurStyle()应用背景模糊材质。

电脑端页面

本章介绍如何基于现有移动端界面开发方案,实现代码逻辑与布局复用,高效完成新闻阅读应用在电脑设备上的界面开发。电脑端的新闻阅读应用大部分交互逻辑与移动端应用类似,本章只展示两者的差异。

[h2]窗口适配

[h2]首页推荐页

电脑端首页推荐页的页签栏展示在左侧,右侧承载内容区。效果图如下所示:

界面开发

电脑端首页推荐页与移动端大屏布局基本一致,主要包含以下区域:

区域编号

简介

实现方案

1

沉浸式标题栏

通过window.setWindowLayoutFullscreen()让内容占据标题栏区域,window.setWindowDecorVisible()隐藏默认装饰。页面由标准Navigation/NavDestination承载,标题栏置于NavDestination的title槽位并设置BarStyle.STACK沉浸模式。左侧展示应用图标和名称,右侧依次放置顶部页签、加号按钮和搜索框,同时避让三键区。

2

左侧tab栏

左侧Tabs组件设置vertical(true)使页签栏竖向展示。

3

内容区

与xl断点下的移动端布局一致,实现方案可参考移动端首页推荐页。

[h2]新闻详情页

电脑端新闻详情页左侧为新闻内容、右侧展示评论区,底部嵌入工具栏。运行效果如下所示:

界面开发

电脑端新闻详情页与移动端大屏布局基本一致,主要包含以下区域:

区域编号

简介

实现方案

1

内容区

左侧部分,和xl断点下的移动端布局一致,实现方案可参考移动端新闻详情页。

2

底部功能区

将功能按钮横排在内容区底部,作为内嵌工具栏参与正常布局,不再悬浮遮挡内容。

3

评论区

右侧部分,和xl断点下的移动端布局一致,实现方案可参考移动端新闻详情页。

示例代码