▶_MiniApp Toolkit

华为快服务/多端小程序

T3平台

华为提供的快服务(Quick Service)和多端小程序开发能力。基于HarmonyOS和华为手机生态,支持服务卡片(Widget)、负一屏、智慧助手等入口。可通过AppGallery Connect进行开发和管理。

华为快服务HarmonyOS多端小程序行业小程序

特性

  • 服务卡片(Widget/万能卡片)
  • 负一屏入口
  • 智慧助手
  • 华为登录
  • HarmonyOS适配
  • AppGallery Connect
  • 免安装秒开
  • 多端流转(1+8+N)

详细文档

华为快服务/多端小程序#

平台概述#

华为的「快服务」目前主推形态是 HarmonyOS 元服务(原名「原子化服务」)—— 一种免安装、秒开直达、可流转的轻量服务形态。它 不是 WXML 体系的小程序,而是用 ArkTS + ArkUI(HarmonyOS 原生技术栈)开发,运行在 HarmonyOS「1+8+N」设备上。服务卡片(万能卡片)是元服务最常见的信息外显形态。

核心优势:

  • 系统级入口:负一屏、智慧助手、应用市场元服务专区、桌面服务卡片
  • 免安装秒开:原生运行,性能接近原生 App
  • HarmonyOS 原生:ArkTS/ArkUI,与鸿蒙生态一致
  • 多端流转:手机/平板/智慧屏/车机等 1+8+N 设备

典型场景:

  • 服务卡片:天气、日程、快递、健康码等信息外显
  • 负一屏服务:快捷功能直达
  • 智慧助手:语音/场景触发服务
  • 轻量工具:免安装即用

设计规范#

技术模型(关键差异)#

  • 不是小程序框架:用 HarmonyOS 原生 ArkTS 语言 + ArkUI 声明式 UI
  • .ets 文件:非 .wxml/.axml,UI 用 ArkUI 装饰器语法编写
  • Stage 模型:用 module.json5 + app.json5 配置(非 app.json
  • 能力子集:元服务支持 HarmonyOS API 的一个子集(部分能力受限)

服务卡片#

  • 元服务的「万能卡片」呈现形态,信息外显、即用即走
  • ArkTS 卡片仅支持声明式范式的部分能力
  • 平台提供多种卡片模板,开发者提供素材

尺寸单位#

  • ArkUI 使用 vp/fp(非 rpx/px
  • 1vp ≈ 1/160 英寸fp 用于字号,支持系统字号缩放

审核规范#

常见被拒原因#

  1. 元服务规范:需符合 HarmonyOS 元服务能力范围与卡片规范
  2. 类目资质:金融、医疗等需相应资质
  3. 权限滥用:申请的权限需与功能匹配
  4. 隐私合规:用户数据收集需明示
  5. 性能体验:秒开/卡片加载需达标

审核周期#

  • 通常数个工作日
  • 通过 AppGallery Connect 提交

企业 vs 个人#

  • 支持个人与企业开发者
  • 部分能力(支付等)需企业资质

开发指南#

快速上手#

code
// pages/Index.ets(ArkUI 声明式)
@Entry
@Component
struct Index {
  @State message: string = 'Hello 元服务'

  build() {
    Column() {
      Text(this.message)
        .fontSize(24)
        .margin({ top: 40 })
      Button('点我')
        .onClick(() => {
          this.message = '已点击'
        })
    }
    .width('100%')
    .height('100%')
    .justifyContent(FlexAlign.Center)
  }
}

常见陷阱#

  1. 不是小程序:用 ArkTS/ArkUI,不能用 wx.*/my.*,无法从小程序直接迁移(Taro 等可输出鸿蒙原生)
  2. 能力子集:元服务不支持完整 HarmonyOS API,部分模块在卡片中不可用
  3. ArkTS 卡片限制:卡片中仅支持「可在 ArkTS 卡片中使用」的模块与部分声明式能力
  4. DevEco Studio:必须用华为官方 IDE,无法用普通前端工具链
  5. 配置文件:Stage 模型用 .json5module.json5/app.json5),非 app.json

与小程序的迁移#

华为元服务与小程序技术栈完全不同,无法直接迁移:

  • 已有 HarmonyOS 应用 → 删减为元服务子集,成本最低
  • 已有小程序 → 需用 Taro 等框架输出鸿蒙原生,或用 ArkTS 重写

生态资源#

推荐框架/工具#

工具说明
DevEco Studio华为官方 IDE(基于 IntelliJ)
ArkTS / ArkUIHarmonyOS 原生语言与 UI 框架
AppGallery Connect创建/管理/上架元服务
Taro可输出鸿蒙原生应用

社区资源#

版本更新#

近期重要变更#

  • HarmonyOS NEXT:纯血鸿蒙,元服务与 ArkTS 持续演进
  • 服务卡片增强:卡片模板与交互能力持续扩展
  • 多端流转:1+8+N 设备协同能力提升