▶_MiniApp Toolkit

快应用

T3平台

由小米、OPPO、vivo、华为等10家手机厂商联合推出的标准。快应用不是小程序，而是一种类原生应用的轻量形态，直接运行在手机系统层面（无需安装APP）。支持前端技术栈开发，覆盖联盟内所有厂商设备。与小程序相比，入口更深（桌面图标、应用商店、全局搜索），但开发生态较小。

官网文档
快应用类H5应用手机厂商联盟

特性

  • 无需安装
  • 桌面图标入口
  • 应用商店分发
  • 全局搜索
  • 前端技术栈
  • 10大厂商联盟
  • 系统级运行
  • 推送能力

详细文档

快应用#

平台概述#

快应用是由小米、华为、OPPO、vivo、魅族等 10 家手机厂商于 2018 年联合推出的 类原生轻量应用标准。它不是小程序 —— 直接运行在手机系统层面（厂商 ROM 内置运行平台），无需安装，即点即用。入口比小程序更深：桌面图标、应用商店、负一屏、全局搜索。

核心优势：

  • 系统级运行：原生渲染，性能接近原生 App
  • 无需安装：即点即用，桌面图标直达
  • 厂商分发：覆盖联盟内所有厂商设备
  • 前端技术栈：类 Vue 语法，前端开发者友好

与小程序的关键差异：

  • 不是 wxml/wxss 体系，而是 .ux 单文件（类 Vue 单文件组件）
  • 通过 import @system.* 模块调用能力，无 wx.*/my.* 命名空间
  • 分发依赖各厂商平台，需分别对接

设计规范#

技术模型（关键差异）#

  • .ux 单文件组件：每个页面/组件是一个 .ux 文件，含 <template> / <style> / <script> 三段（类 Vue SFC）
  • 无 wx/my 命名空间：能力通过 import xxx from '@system.xxx' 引入模块调用
  • manifest.json：声明 features（用到的系统接口）、permissions、路由等

尺寸单位#

  • 推荐使用 px：快应用中 px 会 自动按 750px 设计稿宽度适配（类似其他平台的 rpx）
  • 支持 Flex 布局（CSS 子集）

组件规范#

  • 内置组件：<div>, <text>, <image>, <list>, <input>, <swiper>, <tabs>, <web> 等
  • 数据绑定 {{}}、列表 for、条件 if/show

审核规范#

常见被拒原因#

  1. 各厂商标准差异：标准统一但各厂商有额外要求
  2. 类目资质：电商、金融等需对应资质
  3. 内容合规：违禁内容、诱导分享
  4. 性能/体验：首屏加载慢、交互异常
  5. 隐私权限：features 中声明的权限需与功能匹配

审核周期#

  • 各厂商独立审核，通常数个工作日
  • 需分别提交至华为、小米、OPPO、vivo 等平台

开发指南#

快速上手#

code
<!-- pages/index/index.ux -->
<template>
  <div class="container">
    <text>{{message}}</text>
    <input type="button" value="跳转" onclick="handleRoute" />
  </div>
</template>

<style>
  .container {
    flex-direction: column;
    align-items: center;
    justify-content: center;
  }
</style>

<script>
  import router from '@system.router'
  import network from '@system.network'

  export default {
    data: { message: 'Hello 快应用' },
    onInit() {
      network.getType({
        success: (data) => console.log('网络:', data.type)
      })
    },
    handleRoute() {
      router.push({ uri: '/pages/detail', params: { id: 1 } })
    }
  }
</script>
code
// manifest.json（声明用到的系统接口）
{
  "features": [
    { "name": "system.network" },
    { "name": "system.router" }
  ]
}

常见陷阱#

  1. 不是小程序：没有 wx.*/my.*/navigateTo，必须用 @system.* 模块，不能从小程序直接迁移
  2. features 必须声明：大部分 @system.*（除 router/app）需在 manifest.json 的 features 中声明才能用
  3. 厂商差异：各厂商对部分扩展接口（如支付、推送）实现不同，需分别适配
  4. px 自动适配：快应用的 px 等价于其他平台的 rpx（按 750px 设计稿），不要误用
  5. 分发各自独立：一次开发，但需向各厂商平台分别提交审核与上架

厂商扩展接口#

各厂商在标准之上提供扩展：

  • 华为：@service.push（推送）、华为支付
  • 小米：小米账号、小米支付
  • OPPO/vivo：各自账号与支付体系

生态资源#

推荐框架/工具#

工具说明
hap-toolkit官方构建工具（Node.js）
快应用 IDE官方可视化开发环境
VS Code 插件「快应用语法支持」插件（语法补全）
快应用调试器真机扫码调试

社区资源#

版本更新#

近期重要变更#

  • 标准演进：联盟持续更新快应用标准
  • IoT 扩展：小米 Vela 等将快应用扩展到 IoT 设备
  • 手表快应用：扩展到可穿戴设备（watchdoc.quickapp.cn）