uni-app 支持快应用需显式配置 manifest.json 的 quickapp 字段,package 为反向域名,name 纯中英文,icon 路径以 /static/ 开头且尺寸 192x192,splash 启动图需 720x1280、无透明通道,QUICKAPP 与 QUICKAPP-NATIVE 条件编译不可混用,三端包名必须完全一致。

uni-app 支持快应用,但必须用 quickapp 或 quickapp-native 条件编译块包裹专属配置和代码,直接写在普通 <script></script> 或 里不会生效。
manifest.json 中必须添加 quickapp 配置块
快应用不是靠平台自动识别,而是依赖 manifest.json 里显式声明的 quickapp 字段。CLI 项目该文件在 src/manifest.json,HBuilderX 项目在根目录。不加这个字段,哪怕写了条件编译,最终打包也不会生成快应用产物。
-
package是必填项,格式为反向域名(如com.example.myapp),不能含下划线或大写字母 -
name必须是纯中文或英文,不能含空格或特殊符号,否则华为快应用商店审核会拒收 -
icon路径必须以/static/开头,且图片尺寸建议为192x192PNG,带透明背景可能被 vivo 平台截断 -
minPlatformVersion建议设为110(对应快应用引擎 1.10+),低于此值在新机型上无法安装 - 权限声明要写进
features数组,比如剪贴板要用{"name": "system.clipboard"},漏写会导致 API 调用静默失败
#ifdef QUICKAPP 和 #ifdef QUICKAPP-NATIVE 不可混用
这两个条件编译宏对应不同渲染模式,行为差异极大:QUICKAPP 指 WebView 渲染(Light 版),兼容大部分 uni. API;QUICKAPP-NATIVE 指原生组件直出,性能高但 uni.showToast 等通用 API 不可用,必须改用 quickapp-native 提供的 system.toast。
- 同一份代码里同时出现两个宏时,HBuilderX 编译只会保留匹配当前构建目标的那个分支
- 误把
QUICKAPP-NATIVE的代码放在QUICKAPP块里,会导致运行时报错ReferenceError: system is not defined - 华为快应用平台只认
QUICKAPP-NATIVE模式,vivo/OPPO 则两种都支持,但默认走QUICKAPP
图标与启动图必须按快应用规范单独准备
快应用对资源路径和尺寸有硬性要求,复用 H5 或小程序的图标会失败。manifest 中的 icon 只用于桌面图标,启动图需额外配置在 quickapp 对象下:
- 启动图字段是
splash,不是launchImage,值为对象:{"image": "/static/splash.png"} - 启动图尺寸必须为
720x1280(竖屏)或1280x720(横屏),PNG 格式,无透明通道,否则小米快应用启动白屏 -
/static/下的文件不会被编译,所以图标路径写错(如多写一个斜杠//static/logo.png)会导致构建成功但运行时图标不显示
快应用最易忽略的是包名一致性:manifest 中的 package、HBuilderX 云打包时填写的包名、华为开发者联盟后台创建应用时填的包名,三者必须完全一致,差一个字母都会导致签名验证失败,安装后打不开。











