手把手带你使用 DevEcoCli 和 DevEcoCode 快速接入 HarmonyOS7.0 新特性

前言

之前的章节中已经介绍了 DevEcoCli （集 HarmonyOS 开发全链路功能的终端工具） 和 DevEcoCode（类似 Claude Code 的鸿蒙官方的智能体），结合上述两个能力，开发者就可以使用自然语言快速开发 HarmonyOS APP 的功能了。

什么是 HarmonyOS 7.0

2026 年 6 月 12 日，华为在HDC 2026（华为开发者大会）上正式发布 HarmonyOS 7 开发者 Beta，并宣布鸿蒙迈入 Agent（智能体）时代。

都有哪些新特性

HarmonyOS 开发套件 26.0.0 Beta1（即 API 26）于 2026/06/12 在 HDC.2026 正式发布，本次发布对版本号格式进行了调整（26.0.0 对应此前的 HarmonyOS 7）。整体围绕 智能化 / Agent 时代 这一主线，在智能、空间化、UI 与多窗、安全、性能与通讯等方向均有大幅增强。

下面以官方 OS 新增和增强特性 文档为准，按主题归纳 API 26 的核心新特性。

先通过下图快速建立整体认知，再查看下方按 Kit 归类的详细清单：

模块/Kit名称	特性类型	主要新增/增强内容
Ability Kit	新增能力	• 新增支持AgentCard，提供配置、解析与持久化 • 新增支持基于ArkTS脚本的应用Skill开发 • 新增获取指定包名和分身索引的应用名称 • 新增用于脚本管理的ArkTS API模块 • 新增管理ModularObjectExtensionAbility的C API
Accessibility Kit	新增能力	• 新增支持应用接入系统关怀模式，提升长辈关怀功能及体验
Accessory Kit	全新Kit	• 【新增Kit】为合作配件设备及生态企业应用提供关联唤醒、系统服务联动、按需调度与安全授信管理等能力
Account Kit	增强功能	• LoginWithHuaweiIDButton组件新增自定义文本多语言显示、自定义动效加载
AR Engine	新增API	• 新增C API，支持控制相机闪光灯 • 新增ArkTS API，支持获取预览流图片数据 • 新增ArkTS API，支持加载3D高斯模型 • 新增ArkTS/C API，支持获取外部相机和传感器数据计算
ArkGraphics 2D	增强功能	• 绘制模块新增坐标点处理类，支持取反和设置偏移量
ArkUI	大幅增强	• 新增通用属性systemMaterial，所有组件支持系统材质 • Chip组件新增系统材质背景配置 • 弹窗类组件新增systemMaterial配置项（Tips/Toast/对话框/操作菜单/半模态/Popup等） • 新增ArkUI组件级沉浸光感，高品质视觉与动效体系 • 新增容器断点组件ContainerReader，基于容器尺寸自适应布局 • 新增懒加载垂直瀑布流布局容器LazyVWaterFlowLayout • 新增自定义组件全局复用能力 • 窗口管理新增闪控窗，悬浮小型窗口灵活管理
ArkWeb	升级+新增	• Chromium内核从132升级为144版本 • 新增安全特性选项配置类，用于设置网页安全属性
AVCodec Kit	增强功能	• H265硬件编码器新增CBRHQ（高质量恒定码率模式） • Audio Vivid能力新增支持Audio Vivid编码 • C API新增Audio Vivid相关函数和枚举
AVSession Kit	增强功能	• 枚举新增定义不同场景中使用的额外键的枚举
Background Tasks Kit	增强功能	• 提醒倒计时实例对象新增repeatInterval（重复周期）和repeatCount（重复次数）参数
Core Vision Kit	新增能力	• 新增图像超分能力，低分辨率图像超分辨率重建 • 新增文本语意搜索图片能力，通过文本从图片库搜索匹配图像
Core File Kit	多项增强	• 打开文件新增UNCACHE参数，支持不进行页缓存 • 新增listFileExt方法支持递归列出和文件名过滤 • 新增文件mmap能力集，实现高效读写访问 • 新增应用捐献沙箱目录设为共享的能力
Data Augmentation Kit	新增模块	• 知识加工新增邮件智能分析模块（Handler），支持邮件分类、摘要、待办抽取
Device Security Kit	大幅增强	• 新增星盾机密风控引擎能力，支持风险因子引入、联防联控 • 新增统一风控凭证能力 • 新增超级隐私策略化管控能力，支持对相机/麦克风/位置分别管控 • 新增按文件操作类型订阅文件事件 • 新增按文件路径正则表达式过滤文件事件
Driver Development Kit	新增能力	• 新增支持查询外接USB Hub并开发用户态驱动
Enterprise Data Guard Kit	增强功能	• 文件分级管控服务新增getPolicy接口，获取生效的管控策略 • 新增isKia接口，判断文件或文件夹是否是KIA
Enterprise Space Kit	新增能力	• 新增支持查询设备双空间状态、判断工作空间是否为企业空间
FAST Kit	新增算法	• 新增实数快速傅里叶变换（FFT）及其逆变换功能 • 新增智能序列预测功能，接收历史采样数据预测下一时刻序列值
Game Service Kit	增强功能	• 游戏近场快传新增免集成Game Service Kit实现安装包传输
Graphics Accelerate Kit	多项增强	• 游戏资源加速服务新增isSupportAssetDownload接口 • AppDownloadProgress新增resourceVersion参数 • 游戏启动加速服务新增预启动特性，系统资源充足时提前加载游戏
Image Kit	新增元数据类	• 新增GIF/JFIF/TIFF/PNG/AVIS图像元数据类 • 新增XMP（可扩展元数据平台）元数据
Input Kit	新增能力	• 新增输入事件注入模块，提供键盘和鼠标输入事件模拟能力
Live View Kit	增强功能	• 新增实况窗卡片辅助区模板，支持展示百分比进度环
NDK	增强功能	• JSVM新增支持从外部内存创建ArrayBuffer对象
Nearlink Kit	新增接口	• 新增startScan接口，支持扫描所有可发现的周边星闪设备
Network Boost Kit	新增接口	• 新增netBoost.setDataFlowDesc接口，支持应用根据五元组信息设置流描述
Notification Kit	增强功能	• 新增是否开启锁屏通知等字段 • 新增支持以半模态方式拉起应用的通知设置界面
Online Authentication Kit	新增能力	• 新增DID（去中心化身份）能力，支持密钥生成、数字凭证导入/查询/删除、数据签名
PDF Kit	新增能力	• 新增支持将多张页面的指定区域转化为一张图片
Push Kit	扩展支持	• 推送实况窗消息能力新增支持Wearable设备
Performance Analysis Kit	新增能力	• 新增应用灰度采集的管理，端云配合采集故障日志 • HiAppEvent新增应用冻屏告警事件订阅能力
Preview Kit	新增C API	• 新增C API支持扫描文件判断加速条件 • 新增C API定制文件预加载策略（动态配置后缀和大小范围） • 新增C API支持可用性查询和文件操作事件上报
Remote Communication Kit	多项增强	• 新增HttpVersionSelectCallback接口，支持选择HTTP版本 • 新增HMS_Rcp_SetRequestGetDataCallback()接口，支持流式上传 • 新增HMS_Rcp_SetFormOrder()接口，支持发送有序表单 • 新增C API，支持使用QUIC客户端进行数据传输
Scan Kit	新增查询	• 新增支持查询当前设备是否支持默认界面扫码 • 新增支持查询当前设备是否支持自定义界面扫码
Scenario Fusion Kit	增强功能	• 场景化分享Button新增参数，支持分享图片、视频、文本等格式
Share Kit	增强功能	• 手机与PC/2in1/Tablet碰一碰分享时，新增在PC/Tablet侧获取轻碰位置信息
Spatial Recon Kit	新增能力	• 新增编辑3DGS模型中的高斯球（选择、变换、上色、删除） • 新增空间照片能力，输入单张照片输出三维模型，支持新角度合成
UI Design Kit	增强功能	• 新增标题顶部自定义区域更新节点的配置能力 • 新增标题底部自定义区域是否更新节点的配置能力

DevEcoCode 如何接入

这里还是以朋友圈文案 APP为例，可以使用DevEcoCode通过自然语言对话的方式，让它引导开发者来判断选择优先接入哪些新特性。

结合当前工程，请你帮我思考下，可以接入哪些api26新特性

---

可以看到，DevEcoCode便会结合需求，返回了内容

接下来，可以继续使用自然语言对话，来理解需求然后实现。

LazyVWaterFlowLayout

LazyVWaterFlowLayout 是 ArkUI 中用于实现懒加载垂直瀑布流布局的容器组件，从 API 26.0.0 起可用，需嵌套在可滚动父组件（List、Scroll、WaterFlow、FlowItem）内使用。

下图展示其核心排布逻辑——每个新子节点自动放入「当前总高度最小」的列，多列等高时从左到右，由此形成高度参差的瀑布流视觉：

以下是使用要点的总结：

---

基本用法

使用前需要先导入组件：

import { LazyVWaterFlowLayout } from '@kit.ArkUI';

创建时需确保父组件的布局方向为竖直方向，例如在 Scroll 中使用：

Scroll() {
  LazyVWaterFlowLayout() {
    // 子组件
  }
}
.scrollable(ScrollDirection.Vertical)

每个子节点会自动放置在当前总高度最小的列中；若多列高度相同，则从左到右依次填充。

---

设置列数（columnsTemplate）

通过 columnsTemplate 属性控制列数和列宽占比，支持三种方式：

方式	示例	说明
固定比例	'1fr 1fr 1fr'（3列等宽）	数字表示各列宽度占比
repeat 关键字	'repeat(auto-fit, 80vp)'	自动计算列数，支持 auto-fit / auto-fill / auto-stretch
断点适配	ItemFillPolicy.BREAKPOINT_DEFAULT	根据组件宽度对应的栅格断点自动确定列数（sm→2列，md→3列，lg→5列）

其中 ItemFillPolicy.BREAKPOINT_DEFAULT 是 LazyVWaterFlowLayout 独有的能力，LazyVGridLayout 不支持。

---

设置行列间距

使用 rowsGap（行间距）和 columnsGap（列间距），默认值均为 0：

LazyVWaterFlowLayout() {
  // 子组件
}
.rowsGap(LengthMetrics.vp(10))
.columnsGap(LengthMetrics.vp(10))

---

监听可视区域变化

通过 onVisibleIndexesChange 事件可以获取当前可视区域内子组件的起始和终止索引，常用于实现无限滚动加载：

LazyVWaterFlowLayout() {
  LazyForEach(this.flowData, (item: number) => {
    // 子组件
  }, (item: number) => item.toString())
}
.onVisibleIndexesChange((start: number, end: number) => {
  // 即将触底时提前加载更多数据
  if (end + 20 >= this.flowData.totalCount()) {
    let currentCount = this.flowData.totalCount();
    for (let i = currentCount; i < currentCount + 100; i++) {
      this.flowData.pushData(i);
    }
  }
})

---

约束与限制

使用时需要注意以下几点：

• 不要设置固定高度：组件高度默认自适应内容，设置 height、constraintSize、aspectRatio、layoutWeight 等约束垂直方向的属性会导致显示异常或无法正常滚动。
• 父组件必须为竖直方向：在 List 下要求 listDirection 为 Axis.Vertical，在 Scroll 下要求 scrollable 为 ScrollDirection.Vertical，否则会导致崩溃。
• List 中部分属性会使懒加载失效：当 List 设置了 lanes、chainAnimation、scrollSnapAlign 中任意一个时，懒加载功能失效。
• WaterFlow 多列模式下懒加载失效：在 WaterFlow 的多列模式或多列分段中，懒加载功能不生效。

---

混合布局

LazyVWaterFlowLayout 可以与 LazyVGridLayout 等其他懒加载布局容器组合在同一个父组件中，各自独立配置列数和间距，共享父组件的统一滚动，非常适合电商首页、社交信息流等需要混合多种布局的场景。

沉浸光感

使用步骤

沉浸光感是 ArkUI（API 26.0.0+）提供的一套高品质视觉与动效体系，核心是通过沉浸式系统材质（ImmersiveMaterial）为组件带来通透、有层次的视觉表现。以下是完整的使用流程：

五种材质厚度（ImmersiveStyle）从通透到厚重的直观对比——透过彩色背景可以感受到模糊与遮挡程度的递进：

---

应用级开启（全局控制）

在 module.json5 中配置 metadata，一键为整个应用开启沉浸光感。value 可选 enable、disable、default 三种状态：

{
  "module": {
    "metadata": [{
      "name": "ohos.arkui.UIMaterial.state",
      "value": "enable"
    }]
  }
}

开启后，Dialog、Toast、Chip、Select、菜单、bindSheet 等组件会默认生效，无需额外代码。

---

组件级开启（精细控制）

如果需要为特定组件单独设置材质，有两种方式：

方式 1：通过通用属性 systemMaterial

适用于所有支持通用属性的组件（如 Column、Row、Button 等）：

Column()
  .systemMaterial(new uiMaterial.ImmersiveMaterial({
    style: uiMaterial.ImmersiveStyle.ULTRA_THIN
  }))

方式 2：通过组件独有接口

弹窗类组件（Toast、Popup、Tips、bindSheet、bindMenu 等）通过各自的 Options 参数传入 systemMaterial：

this.promptAction.showToast({
  message: '提示内容',
  systemMaterial: new uiMaterial.ImmersiveMaterial({
    style: uiMaterial.ImmersiveStyle.THIN
  })
})

---

选择材质样式

根据场景需要从五种 ImmersiveStyle 中选择合适的厚度：

样式	特点	典型场景
ULTRA_THIN	强透明	浮动工具栏
THIN	较强透明	搜索框、Toast、Popup
REGULAR	常规厚度	通用场景
THICK	强模糊	菜单
ULTRA_THICK	最强模糊	弹窗、半模态面板

---

可选增强配置

在创建 ImmersiveMaterial 时，可按需附加以下参数：

• interactive: true — 按压时产生弹性形变，松手自动恢复。
• lightEffect: { color: undefined } — 触摸时产生流光跟随效果。
• colorInvert: true — 自动反色，确保薄材质下文字始终可读（仅对资源接口设置的颜色生效）。
• materialColor — 为材质层赋色，混合纯色效果。
• applyShadow — 控制是否添加材质阴影。

---

关闭某个组件的材质

在应用级开启后，若想单独关闭某组件的沉浸光感，设置 uiMaterial.Material.empty 即可：

Select([...])
  .systemMaterial(uiMaterial.Material.empty)

---

总结

本文围绕 HarmonyOS 7（API 26.0.0 Beta1） 的新特性接入，从「认知 → 选型 → 落地」三个层面给出完整路径。

一、认知：API 26 带来了什么

HarmonyOS 7 以 Agent（智能体）时代 为主线，在智能、UI 与多窗、视觉媒体、安全、性能通讯五大方向全面增强，开放 102 个 Kit、8 万+ API。版本号格式从 26.0.0 起调整，大小关系为 26.0.0 > 6.1.1(24) > 6.1.0(23)，接入前需先把工程 SDK 升到 26.0.0。

二、选型：内容型 App（以朋友圈文案为例）优先接入

优先级	特性	价值点
★★★	LazyVWaterFlowLayout 瀑布流	灵感内容流按需加载，告别 ForEach 全量渲染
★★★	沉浸光感 systemMaterial	卡片/弹窗视觉升级，部分组件零代码自动生效
★★★	Chip 双材质 / 全局组件复用	分类标签质感 + 长列表性能
★★☆	闪控窗 / 实况窗进度环	异步 AI 生成进度常驻桌面展示
★★☆	碰一碰精准分享 / 场景化分享	「生成 → 写入文档」链路闭环
★☆☆	应用 Skill 开发 + AgentCard	小艺语音调度直达功能（需企业资质）

三、落地：用 DevEcoCode + DevEcoCli 提效

不再逐条翻文档——通过自然语言对话让 DevEcoCode 结合工程上下文分析适用特性、生成接入方案，再用 DevEcoCli 完成构建与部署。本文已展开 LazyVWaterFlowLayout（列填充机制、columnsTemplate 配置、约束限制、混合布局）与沉浸光感（应用级/组件级开启、五种材质样式、增强配置与关闭）两个最常用的接入示例。

接入前置清单

• [ ] DevEco Studio 升级到 26.0.0 Beta1（26.0.0.461）
• [ ] compatibleSdkVersion / targetSdkVersion 升到 26.0.0
• [ ] 沉浸光感：module.json5 配置 ohos.arkui.UIMaterial.state = enable（需 targetAPIVersion >= 26.0.0）
• [ ] 新 API 统一用 canIUse() 做能力查询，不支持时优雅降级

💡 一句话：先升 SDK，再挑与业务最贴的 2~3 个特性（瀑布流 + 沉浸光感 最稳），用 DevEcoCode 对话式接入，DevEcoCli 验证部署。

参考文献

1. DevEco Studio 工具概览：https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-tools-overview
2. DevEcoCode：鸿蒙专属AI智能体：https://atomgit.com/openharmony-sig/deveco-code
3. @deveco/deveco-cli · npm：https://www.npmjs.com/package/@deveco/deveco-cli
4. HarmonyOS 7新特性：https://developer.huawei.com/consumer/cn/features/?ha_source=51cto&ha_sourceId=70000008
5. HarmonyOS AI开发提效工具：DevEco Code & DevEco CLI：https://developer.huawei.com/consumer/cn/forum/topic/0202216647056043902?ha_source=51cto&ha_sourceId=70000008
6. 社区干货合集：一帖看全，高效查阅 https://developer.huawei.com/consumer/cn/forum/topic/0201215860119833282?ha_source=51cto&ha_sourceId=70000008