HarmonyOS 7.0（API 26）于 2026 年 9 月 7 日正式发布，这篇文章（来自阿里云开发者社区/博

客园/OSChina 等多个平台，作者 aqi00）结合《鸿蒙HarmonyOS 6应用开发》一书梳理了十大 API 

重要升级。[citation:17.1][citation:17.4][citation:17.8]

---

十大 API 升级速览

| # | Kit / 模块 | 核心升级 | 对开发者的价值 |

|:-:|-----------|---------|--------------|

| 1️⃣ | ArkUI | 新增组件级沉浸光感（材质滤镜/折射/高光/阴影） | 弹窗/菜单等组件从纯色背景升级为半透明材质效果，一行元数据配置开启 |

| 2️⃣ | Background Tasks Kit | 倒计时提醒新增 repeatInterval + repeatCount | 倒计时可重复执行，不再一次完事，适用于定时循环提醒场景 |

| 3️⃣ | Core File Kit | listFileExt 支持递归列出 + 自定义文件过滤 | 文件搜索告别扁平 list，支持递归遍历目录树 |

| 4️⃣ | Core File Kit | C/C++ 新增文件归档压缩/解压（OHArchive*） | NDK 场景下高性能压缩解压，无需走 ArkTS 慢路径 |

| 5️⃣ | Core Vision Kit | 新增文本语义搜图（textSearchImage） | 端侧图片库可按文本语义检索，无需上传云端 |

| 6️⃣ | Image Kit | 新增 GIF/JFIF/TIFF/PNG/AVIS 图像元数据类 | 更多图片格式的原数据读写，接力 WebP/Heif 的格式扩展路线 |

| 7️⃣ | Map Kit | 折线支持添加文字（addLineText/removeLineText） | 地图折线可标注含义，路径/轨迹可视化更直观 |

| 8️⃣ | Media Kit | 新增广告插播控制器 AVAdsController | 音视频播放中按进度插入/跳过广告资源 |

| 9️⃣ | Notification Kit | 通知设置可查询锁屏通知/横幅通知/角标开关状态 | APP 可获知用户是否关闭了某类通知，推送更有针对性 |

| 🔟 | Scan Kit | 新增 isDefaultScanSupported / isCustomScanSupported | 提前检测设备对扫码能力的支持情况，降级处理 |

---

值得展开的几项

1️⃣ 沉浸光感：一句话开启的全新视觉层

不再需要在每个弹窗组件上写背景色和阴影代码。在 module.json5 中加入：

"metadata": [{

 "name": "ohos.arkui.UIMaterial.state",

 "value": "enable"

}]

应用内的弹窗、菜单、对话框自动获得材质滤镜、折射、高光、阴影叠加效果，底层内容透过半透明材质层自然渗透。

这是从 API 23（HarmonyOS 6.1）的 HDS 底部页签沉浸材质到 API 26 升级为组件级沉浸光感 的关键跨越。[citation:17.5]

4️⃣ C/C++ 归档压缩：NDK 高性能路径

之前只有 ArkTS 的 @ohos.zlib，在高性能场景下压缩速度偏慢。7.0 新增的 C/C++ 归档接口（OHArchiveWriter_

OpenFile → Add → Close）直接面向 NDK 开发，适用于：

文件打包分发

减少存储占用

加速网络传输

5️⃣ 文本搜图：端侧视觉 AI 能力下沉

textSearchImage 是 Core Vision Kit 的新入口，四步流程：

init() → insertImage(提取特征) → search(文本搜索) → deleteImage

完全在端侧完成，不需要上传图片到云端。和 HarmonyOS 7 系统级 Core Vision 视觉能力（内置图像理解模型）配套，

让 App 直接调用系统级的语义理解，不用自己集成大模型。[citation:17.15]

6️⃣ 图片元数据格式大幅扩展

从 Heif（6.1）→ WebP（6.1.1）→ GIF/JFIF/TIFF/PNG/AVIS（7.0），按图像格式逐一补齐元数据读写能力，标志着 

Image Kit 进入多格式全面覆盖阶段。

9️⃣ 通知状态可查询：告别"盲推"

之前 APP 无法知道用户是否在系统设置里关闭了锁屏通知或横幅通知，推送时只能"盲发"。getNotificationSetting() 返回

的 NotificationSetting 现在包含 lockScreenEnabled、bannerEnabled、badgeNumberEnabled、notificationEnabled 

四个字段——APP 可以根据用户的实际开关状态决定推送策略，而不是每次都弹一个用户永远看不到的通知。

---

升级建议

API 26 vs API 23/25 的关键差异：

沉浸光感从 HDS 组件级升级为 ArkUI 组件级（需开启 metadata）

C/C++ 归档压缩是新能力，无存量兼容问题

通知状态查询是新增 readonly 字段，不影响原有推送逻辑

文本搜图需要新导入 @kit.CoreVisionKit

如果当前应用目标是 API 26，建议优先升级：沉浸光感（配置即生效）→ 通知状态查询（优化推送体验）→ 文件递归过滤（改

善文件操作体验）——这三项迁移成本最低、用户体验改善最直接。