manifest.json 应用配置

manifest.json 文件是应用的配置文件，用于指定应用的名称、图标、权限等。HBuilderX 创建的工程此文件在根目录，CLI 创建的工程此文件在 src 目录。

配置项列表

属性	类型	默认值	描述	最低版本
name	String		应用名称
appid	String	新建 uni-app 项目时，DCloud 云端分配。用途详见	应用标识
description	String		应用描述
locale	String	auto	设置当前默认语言，具体参考 locale
versionName	String		版本名称，例如：1.0.0。详见下方Tips说明
versionCode	Number		版本号，例如：36
transformPx	Boolean	true	是否转换项目的px，为true时将px转换为rpx，为false时，px为传统的实际像素。为兼容历史项目默认值为 true。 此选项已废弃，仅部分平台支持，不推荐新项目启用此配置（新建项目模板一般配置为 false）
networkTimeout	Object		网络超时时间，详见
debug	Boolean	false	是否开启 debug 模式，开启后调试信息以 info 的形式给出，其信息有页面的注册，页面路由，数据更新，事件触发等
uniStatistics	Object		是否开启 uni 统计，全局配置	2.2.3+
sassImplementationName	dart-sass或node-sass		使用的scss预编译库，仅限vue2项目，默认值：dart-sass，HBuilderX Mac Arm版始终为dart-sass	4.56+
app-plus	Object		App 特有配置
app-harmony	Object		鸿蒙应用特有配置	4.27
h5	Object		H5 特有配置
quickapp	Object		快应用特有配置，即将支持
mp-weixin	Object		微信小程序特有配置
mp-alipay	Object		支付宝小程序特有配置
mp-baidu	Object		百度小程序特有配置
mp-toutiao	Object		抖音小程序特有配置	1.6.0
mp-lark	Object		飞书小程序特有配置	3.2.12
mp-qq	Object		qq 小程序特有配置	2.1.0
mp-kuaishou	Object		快手小程序特有配置	3.2.2
mp-harmony	Object		鸿蒙元服务特有配置	4.34

Tips

• uni-app 的 appid 由 DCloud 云端分配，主要用于 DCloud 相关的云服务，请勿自行修改。详见
• 注意区分 uni-app 的 appid 与微信小程序、iOS 等其它平台分配的 appid，以及第三方 SDK 的 appid。
• versionName在云打包App和生成wgt应用资源时会使用。如需升级App版本，先修改此处再云打包。导出wgt资源用于离线打包和热更新时也会以此版本为依据。
• 在本地打包时和热更新时，App版本和wgt应用资源版本将不再保持一致。此时通过plus.runtime.version可获取App版本，通过plus.runtime.getProperty获取wgt资源版本。

networkTimeout

各类网络请求的超时时间，单位均为毫秒。

属性	类型	必填	默认值	说明
request	Number	否	60000	uni.request 的超时时间，单位毫秒。
connectSocket	Number	否	60000	uni.connectSocket 的超时时间，单位毫秒。
uploadFile	Number	否	60000	uni.uploadFile 的超时时间，单位毫秒。
downloadFile	Number	否	60000	uni.downloadFile 的超时时间，单位毫秒。

自HBuilderX 2.5.10起，上述默认超时时间由6秒改为60秒，对齐微信小程序平台。

uniStatistics

uni 统计配置项

属性	类型	必填	默认值	说明
enable	Boolean	是	true	是否开启uni统计

app-plus

属性	类型	说明	最低版本
splashscreen	Object	App 启动界面信息，详见
screenOrientation	Array	重力感应、横竖屏配置，可取值："portrait-primary"：竖屏正方向；"portrait-secondary"：竖屏反方向；"landscape-primary"：横屏正方向；"landscape-secondary"：横屏反方向。
modules	Object	权限模块，详见
distribute	Object	App 发布信息，详见
nvueCompiler	String	切换 nvue 编译模式，可选值，weex ：老编译模式，uni-app： 新编译模式，默认为 weex 。编译模式区别详情	2.0.3+
nvueStyleCompiler	String	切换 nvue 样式编译模式，可选值，weex ：老编译模式，uni-app： 新编译模式，默认为 weex 。编译模式区别详情	3.1.1+
renderer	String	可不加载基于 webview 的运行框架，减少包体积、提升启动速度。可选值 native	App-nvue 2.2.0+
nvueLaunchMode	String	Nvue 首页启动模式，可选值：normal、fast 默认 normal（HBuilderX 2.4.4-2.4.9 固定为 fast） 详见	2.5.0+
nvue	Object	nvue 页面布局初始配置，详见	2.0.3+
optimization	Object	分包配置，可以减轻启动时加载的js数量，提升启动速度	2.7.12+
runmode	String	normal：默认模式，liberate：资源释放模式
uniStatistics	Object	App 是否开启 uni 统计，配置方法同全局配置	2.2.3+
webView	Object	当系统webview低于指定版本时，会弹出提示。或者下载x5内核后继续启动，仅Android支持，详情	3.5.0+

PS：上表只列出了核心部分，App平台的配置其实非常多，完整内容请参考 完整的 manifest.json。

Tips

• manifest.json 文件的配置，推荐在 HBuilderX 提供的可视化操作界面完成。
• 部分配置在打包时的操作界面补全，例如：证书等信息。
• Native.js 权限部分会根据配置的模块权限，在打包后自动填充。
• 部分 modules 是默认的，不需要进行配置。
• 微信小程序的 appid 等信息，需要配置在 mp-weixin 节点下。不要配置在 app-plus下。sdkConfigs 下出现的 weixin 节点，配置的是 App 的第三方 SDK 信息。

App Splashscreen

splash（启动封面）是App必然存在的、不可取消的。

属性	类型	默认值	描述	最低版本
alwaysShowBeforeRender	Boolean	true	是否等待首页渲染完毕后再关闭启动界面	1.6.0
autoclose	Boolean	true	是否自动关闭启动界面，仅当alwaysShowBeforeRender设置为false时生效，如果需要手动关闭启动界面，需将 alwaysShowBeforeRender 及 autoclose 均设置为 false。
waiting	Boolean	true	是否在程序启动界面显示等待圈或雪花

alwaysShowBeforeRender和autoclose属性组合设置，可配置以下三种关闭启动界面（splash）策略，详见

注意

• 如果不配置自己的splash图，App端会默认把App的icon放到splash中
• splash只能是标准png，不要用jpg改名为png。也不支持gif等动画
• 相关改动，云打包生效，真机运行不生效。本地打包需自行在原生工程中配置
• App启动图中iOS的MAX等大屏设备的splash图若不配，会导致iOS认为此App没有为MAX优化，App将无法全屏，四周会有黑边
• Android的splash支持.9.png，详见

App Modules

模块选择是为了控制App的包体积，不需要的模块可以在打包时剔除。

名称	描述
Bluetooth	BLE蓝牙
Contacts	系统通讯录
Fingerprint	指纹识别
iBeacon	iBeacon
LivePusher	直播推流
Maps	地图
Messaging	短彩邮件消息
OAuth	登录授权
Payment	支付
Push	消息推送
Share	社交分享
Speech	语音识别
SQLite	SQLite数据库
Statistic	统计
VideoPlayer	视频播放

注意

• 仅App云打包生效。本地打包需自行在原生工程中配置。

App Distribute

属性	类型	描述
android	Object	Android 应用配置，详见: Android配置明细
ios	Object	iOS 应用配置，详见: iOS配置明细
sdkConfigs	Object	SDK配置，仅打包生效 详见
orientation	Array	同 screenOrientation 配置，仅打包生效，已废弃，推荐使用 screenOrientation

App SdkConfigs

三方原生SDK配置。三方SDK的使用需要向这些SDK提供商申请，并配置参数到此处。可在HBuilderX可视化界面（App SDK配置）输入配置，此配置仅云打包后生效，本地打包需自行在原生工程中配置。

属性	类型	描述
oauth	Object	授权登录，配置后可调用 uni.login 进行登录操作，目前支持的授权登录平台有：QQ、微信、新浪微博。
share	Object	分享，配置后可调用 uni.share 进行分享，目前支持QQ、微信、新浪微博等分享， 具体配置 详见。
push	Object	push配置，使用方式 详见，目前支持：uniPush、个推，注意App仅支持一种 push 方式，配置多个 push 无效，建议使用 uniPush，支持多厂商推送。
payment	Object	三方支付配置，配置后可调用 uni.payment 进行支付，目前支持微信支付、支付宝支付、苹果内购， 具体配置 详见。
statics	Object	统计配置，目前仅支付友盟统计，详见，在uni-app中只用 plus.statistic 进行调用。
speech	Object	语音识别配置，支持讯飞语音、百度语音，详见，在uni-app中只用 plus.speech 进行调用。
maps	Object	原生地图配置，目前仅支持 高德地图，申请方式可参考：地图插件配置。

optimization

可以减轻启动时加载的js数量，提升启动速度。

从uni-app 2.7.12+ 开始，App-vue平台也兼容了小程序的分包配置，但默认并不开启。

在manifest配置以下节点，可以在App端启动分包。

属性	类型	说明
subPackages	Boolean	是否开启分包优化，目前仅 uni-app vue2 下生效

{
  "app-plus": {
    "optimization": {
      "subPackages": true
    },
    "runmode" : "liberate" // 开启分包优化后，必须配置资源释放模式
  }
}

在manifest中启动分包后，需要在pages.json中配置具体的分包规则，与小程序的配置相同，详见：https://uniapp.dcloud.io/collocation/pages?id=subpackages

也就是一旦在pages.json里配置分包，小程序一定生效，而app是否生效，取决于manifest里是否开启。

注意:

• App开启分包后，每个分包单独编译成一个js文件(都包含在app内，不会联网下载)，当App首页是vue时，可减小启动加载文件大小，提升启动速度。
• 首页是nvue时，分包不会提升启动速度，nvue本身启动速度就快于vue，也快于开启分包后的首页为vue的应用。如果追求极致启动速度，还是应该使用nvue做首页并在manifest开启fast模式。
• App页面较少时，分包对启动速度的优化不明显。

nvue

nvue 页面布局初始设置

属性	类型	描述
flex-direction	String	flex 成员项的排列方向，支持项，row：从左到右； row-reverse：从右到左；column：从上到下；column-reverse：与 column 相反，默认值 column。

webview

uni-app 3.5.0+

当App代码使用了低版本webview不支持的语法时（比如使用了vue3），可以在manifest配置本属性，来指定最低运行的webview版本。

当系统webview版本不符合需求时，uni-app引擎会自动弹框。同时开发者可以指定使用 x5引擎webview 来替代系统webview，以保障浏览器兼容性。详见x5文档

当你的应用强依赖x5时，比如需要vue页面的字体和tabbar等原生界面保持一致时，也可以在manifest配置本属性。

属性	类型	说明
minUserAgentVersion	String	最小webview版本，例如：64.0.3282.116。（当低于最小版本要求时，显示 WebView版本过低 弹框，点击确定退出应用。）
x5	Object	此属性需要在manifest模块配置中勾选 Android X5 Webview 模块，详细参见下面的说明

x5 属性说明

属性	类型	默认值	说明
timeOut	Number	3000	超时时间
showTipsWithoutWifi	Boolean	false	是否在非WiFi网络环境时，显示用户确认下载x5内核的弹窗。（如果为true时，在非WiFi网络下载x5模块，会显示用户确认弹框，内容为 当前处于非WiFi网络，是否允许下载x5模块？ ，false时不显示弹框 。）
allowDownloadWithoutWiFi	Boolean	false	是否允许用户在非WiFi网络时进行x5内核的下载。（如果为true，就不会显示用户确认的弹窗。false时，如果showTipsWithoutWifi为true，就会显示用户确认弹框；showTipsWithoutWifi为false时，不下载x5模块。）

webview示例

{
  "app-plus" : {
    "webView": {
      "minUserAgentVersion": "64.0.3282.116",
      "x5": {
        "timeOut": 3000,
        "showTipsWithoutWifi": true,
        "allowDownloadWithoutWiFi": false
      }
    }
  }
}

提示：vue3 vue页面 要求 Android 系统 webview 最低版本为 64.0.3282.116

app-harmony

鸿蒙应用项目设置，支持 distribute 属性，其值为一个 Object 对象：

属性	类型	说明
bundleName	String	应用包名
signingConfigs	Object	证书签名配置
icons	Object	应用图标
splashScreens	Object	启动界面配置
modules	Object	模块配置
useragent	Object	配置 UserAgent

signingConfigs 证书签名配置

此配置对象用于配置鸿蒙打包时使用的数字签名证书信息，可分别配置调试证书和发布证书两组信息。

可以通过可视化方式进行设置，支持自动获取调试证书。

调试证书的键名为 "default"，发布证书的键名为 "release"，其值为一个 Object：

属性	类型	说明
storeFile	String	私钥库文件
storePassword	String	私钥库访问密码
keyAlias	String	私钥库里面的私钥别名
keyPassword	String	私钥访问密码
signAlg	String	签名算法，固定为 "SHA256withECDSA"
certpath	String	证书文件
profile	String	签名描述文件

icons 应用图标

属性	类型	说明
foreground	String	前景图，以相对路径指向一个图片文件
background	String	背景图，以相对路径指向一个图片文件

splashScreens 启动界面配置

属性	类型	说明
startWindowBackground	String	启动界面背景色，格式为 #RRGGBB
startWindowIcon	String	启动界面中部图标，以相对路径指向一个图片文件

modules 模块配置

属性	类型	说明
uni-location	Object	设置定位模块相关参数
uni-map	Object	设置地图模块相关参数
uni-oauth	Object	设置登录鉴权模块相关参数
uni-payment	Object	设置支付模块相关参数
uni-share	Object	设置分享模块相关参数

useragent

属性	类型	说明
value	String	可选，JSON对象，应用UserAgent相关配置，默认值为系统UserAgent
concatenate	Boolean	可选，Boolean类型，是否将value值作为追加值连接到系统默认userAgent值之后

其它支持的属性

• safearea

h5

属性	类型	说明
title	String	页面标题，默认使用 manifest.json 的 name
template	String	index.html 模板路径，相对于应用根目录，可定制生成的 html 代码。参考：自定义模板, Vue2 支持，Vue3 暂不支持
router	Object	参考：router
async	Object	参考：async
devServer	Object	开发环境 server 配置，参考：devServer
publicPath	String	引用资源的地址前缀，仅 Vue2 发布时生效。参考：publicPath
sdkConfigs	String	SDK配置，例如地图... 参考：sdkConfigs
optimization	Object	打包优化配置（HBuilderX 2.1.5 以上支持），参考optimization
uniStatistics	Object	H5 是否开启 uni 统计，配置方法同全局配置

自定义模板

目前 Vue2 支持， Vue3 暂不支持

需要使用自定义模板的场景，通常有以下几种情况：

• 调整页面 head 中的 meta 配置
• 补充 SEO 相关的一些配置（仅首页）
• 加入百度统计等三方js

使用自定义模板时，1. 工程根目录下新建一个html文件；2. 复制下面的基本模板内容，到这个html文件，在此基础上修改meta和引入js；3. 在 manifest.json->h5->template 节点中关联这个html文件的路径。

<!DOCTYPE html>
<html lang="zh-CN">
	<head>
		<meta charset="utf-8">
		<meta http-equiv="X-UA-Compatible" content="IE=edge">
		<title>
			<%= htmlWebpackPlugin.options.title %>
		</title>
		<!-- Open Graph data -->
		<!-- <meta property="og:title" content="Title Here" /> -->
		<!-- <meta property="og:url" content="http://www.example.com/" /> -->
		<!-- <meta property="og:image" content="http://example.com/image.jpg" /> -->
		<!-- <meta property="og:description" content="Description Here" /> -->
		<script>
			var coverSupport = 'CSS' in window && typeof CSS.supports === 'function' && (CSS.supports('top: env(a)') || CSS.supports('top: constant(a)'))
			document.write('<meta name="viewport" content="width=device-width, user-scalable=no, initial-scale=1.0, maximum-scale=1.0, minimum-scale=1.0' + (coverSupport ? ', viewport-fit=cover' : '') + '" />')
		</script>
		<link rel="stylesheet" href="<%= BASE_URL %>static/index.<%= VUE_APP_INDEX_CSS_HASH %>.css" />
	</head>
	<body>
		<noscript>
			<strong>Please enable JavaScript to continue.</strong>
		</noscript>
		<div id="app"></div>
		<!-- built files will be auto injected -->
	</body>
</html>

在hello uni-app示例中有一个template.h5.html文件，即是此用途。

关于SEO的补充说明

H5平台是SPA单页应用，普通的SEO信息即加meta字段只能在，自定义的模板html里配置首页。

但SEO的时代在变，现在更有效的方式，使用uni-app同时发布一版百度小程序，这个搜索权重更高。DCloud的ask社区的H5版也是uni-app做的，同时发布了百度小程序，权重更高，每天来自百度的搜索量非常多。是一个可现身说法的好案例。

router

属性	类型	默认值	说明
mode	String	hash	路由跳转模式，支持 hash、history
base	String	/	应用基础路径，例如，如果整个单页应用服务在 /app/ 下，然后 base 就应该设为 "/app/"，支持设置为相对路径 "./"

注意：

• history 模式部分浏览器器不支持，iOS微信内置浏览器无法观测到URL变动，默认分享（不使用微信JSSDK的情况下）的链接为入口页链接。
• history 模式发行需要后台配置支持，详见：history 模式的后端配置
• base 参数设置为空或者 /，应用运行在 / 根目录下。
• 参数设置为 ./ 时，应用运行在相对路径下，可配合 nginx 等工具运行在任意路径中。

async

属性	类型	默认值	说明
loading	String	AsyncLoading	页面 js 加载时使用的组件（需注册为全局组件）
error	String	AsyncError	页面 js 加载失败时使用的组件（需注册为全局组件）
delay	Number	200	展示 loading 加载组件的延时时间（页面 js 若在 delay 时间内加载完成，则不会显示 loading 组件）
timeout	Number	60000	页面 js 加载超时时间（超时后展示 error 对应的组件）

devServer

属性	类型	默认值	说明
https	Boolean	false	启用 https 协议
port	Number	Vue2 8080；Vue3 3000	前端开发服务端口
disableHostCheck	Boolean	false	禁用 Host 检查

Tips：uni-app 中 manifest.json->h5->devServer，vue2 实际上对应 webpack 的 devServer，vue3 实际上对应 vite 的 server，鉴于 manifest 为 json 文件，故 webpack.config.js->devServer 及 vite.config.js->server 配置项下的简单类型属性均可在manifest.json->h5->devServer节点下配置，funciton 等复杂类型暂不支持。

publicPath

配置 publicPath 为 cdn 资源地址前缀，这样编译出来的 html 文件，引用的 js，css 路径会自动变成 cdn 上的地址。

注意：如果想对图片生效，image组件的图片地址需要使用相对路径

示例

以 hello-uniapp 发布 H5 时为例

未配置 publicPath 时，发布时 index.html 中的结果：

<script src=/h5/static/js/chunk-vendors.803ce52d.js></script>
<script src=/h5/static/js/index.34e8497d.js>

配置 publicPath 为 https://www.cdn.com/h5/（无效地址仅用作示例） 后，发布时 index.html 中的结果：

<script src=https://www.cdn.com/h5/static/js/chunk-vendors.803ce52d.js></script>
<script src=https://www.cdn.com/h5/static/js/index.34e8497d.js>

注意

• 打包部署后，在服务器上开启 gzip 可以进一步压缩文件。具体的配置，可以参考网上的分享：服务器端开启GZIP压缩

sdkconfig

三方SDK配置。三方SDK的使用需要向这些SDK提供商申请，并配置参数到此处。可在HBuilderX可视化界面（H5 配置）输入配置。

属性	类型	描述
maps	Object	地图或位置相关SDK

maps

地图服务商 SDK 配置，使用地图以及位置（IP 定位及坐标转换）需要配置此项。

示例

{
"h5": {
	"sdkConfigs": {
		// 使用地图或位置相关功能必须填写其一
		"maps": {
            "qqmap": { // HBuilderX 4.36以下版本腾讯地图配置项
                // 腾讯地图秘钥 https://lbs.qq.com/dev/console/key/manage
                "key": ""
            },
            "tencent": { // HBuilderX 4.36及以上版本腾讯地图配置项
                // 腾讯地图秘钥 https://lbs.qq.com/dev/console/key/manage
                "key": ""
            },
            "google": {
                // 谷歌地图秘钥（HBuilderX 3.2.10+）https://developers.google.com/maps/documentation/javascript/get-api-key
                "key": ""
            },
            "amap": {
                // 高德地图秘钥（HBuilderX 3.6.0+）https://console.amap.com/dev/key/app
                "key": "",
                // 高德地图安全密钥（HBuilderX 3.6.0+）https://console.amap.com/dev/key/app
                "securityJsCode": "",
                // 高德地图安全密钥代理服务器地址（HBuilderX 3.6.0+）https://lbs.amap.com/api/jsapi-v2/guide/abc/prepare
                "serviceHost": "",
            },
            "bmap": {
                // 百度地图秘钥（HBuilderX 3.99+）http://lbsyun.baidu.com/apiconsole/key#/home
                "key": ""
            }
		}
	}
}
}

optimization

属性	类型	默认值	说明
prefetch	Boolean	false	资源预取
preload	Boolean	false	资源预加载
treeShaking	Object		摇树优化，根据项目需求，动态打包框架所需的组件及API，保持框架代码最精简化，参考treeShaking

treeShaking

属性	类型	默认值	说明
enable	Boolean	false	是否启用摇树优化

示例：

{
    "h5": {
        "optimization": {
            "treeShaking": {
                "enable": true
            }
        }
    }
}

Tips：关于摇树优化（treeShaking）原理及优化结果，参考：https://ask.dcloud.net.cn/article/36279

mp-weixin

属性	类型	说明
appid	String	微信小程序的AppID，登录 https://mp.weixin.qq.com 申请
projectname	String	项目名称
setting	Object	微信小程序项目设置，参考setting
functionalPages	Boolean	微信小程序是否启用插件功能页，默认关闭
requiredBackgroundModes	Array	微信小程序需要在后台使用的能力,详见
plugins	Object	使用到的插件，详见
resizable	Boolean	在iPad上小程序是否支持屏幕旋转，默认关闭
navigateToMiniProgramAppIdList	Array	需要跳转的小程序列表，详见
permission	Object	微信小程序接口权限相关设置，比如申请位置权限必须填此处详见
workers	String	Worker 代码放置的目录。 详见
optimization	Object	对微信小程序的优化配置
cloudfunctionRoot	String	配置云开发目录，参考setting
uniStatistics	Object	微信小程序是否开启 uni 统计，配置方法同全局配置
scopedSlotsCompiler	String	Vue2 作用域插槽编译模式，uni-app 3.1.19+ 开始支持，可选：legacy、auto、augmented，默认：auto
mergeVirtualHostAttributes	Boolean	合并由 Vue 组件编译而成的小程序组件虚拟节点外层属性，目前仅支持 id（v4.42+）、style（v3.5.1+）、class（v3.5.1+）以及 v-show 指令生成的 hidden（v4.41+） 属性
slotMultipleInstance	Boolean	模拟单个作用域插槽渲染为多个实例，此配置仅限 Vue2 环境 3.7.12+，Vue3 环境已默认支持
embeddedAppIdList	Array	要半屏跳转的小程序appid。详见
requiredPrivateInfos	Array	地理位置相关接口。详见
lazyCodeLoading	String	目前仅支持值 requiredComponents，代表开启小程序按需注入特性，详见
nativeTags	Array	微信小程序平台的原生组件 (4.81+)

setting

编译到微信小程序平台下的项目设置。

属性	类型	说明
urlCheck	Boolean	是否检查安全域名和 TLS 版本
es6	Boolean	ES6 转 ES5
postcss	Boolean	上传代码时样式是否自动补全
minified	Boolean	上传代码时是否自动压缩
bigPackageSizeSupport	Boolean	预览及真机调试时包体积上限是否调整为4M，默认为true（HBuilderX 3.5.5+）。

注意: 使用微信小程序手势组件会强制开启 ES6 转 ES5

optimization

对微信小程序的优化配置

属性	类型	说明
subPackages	Boolean	是否开启分包优化

cloudfunctionRoot

如果需要使用微信小程序的云开发，需要在 mp-weixin 配置云开发目录

"mp-weixin":{
  // ...
   "cloudfunctionRoot": "cloudfunctions/", // 配置云开发目录
  // ...
}

配置目录之后，需要在项目根目录新建 vue.config.js 配置对应的文件编译规则

{
 plugins: [
     new CopyWebpackPlugin([
       {
         from: path.join(__dirname, '../cloudfunctions'),
         to: path.join(__dirname, 'unpackage', 'dist', process.env.NODE_ENV === 'production' ? 'build' : 'dev', process.env.UNI_PLATFORM, 'cloudfunctions'),
       },
     ]),
   ],
}

mp-alipay

属性	类型	说明
plugins	Object	使用到的插件，详见
component2	Boolean	是否启用 component2 编译，默认为true，查看详情
enableAppxNg	Boolean	是否启用 enableAppxNg 小程序基础库 2.x 构建，默认为true，查看详情，HBuilderX 3.2.10+
axmlStrictCheck	Boolean	是否启用 axml 严格语法检查，默认为false
enableParallelLoader	Boolean	是否启用多进程编译，默认为false
enableDistFileMinify	Boolean	是否压缩编译产物（仅在真机预览/真机调试时生效），默认为false
enableNodeModuleBabelTransform	Boolean	appx 2.0 特性，对 node_modules 中的模块做 babel 编译，默认值：true
uniStatistics	Object	支付宝小程序是否开启 uni 统计，配置方法同全局配置
scopedSlotsCompiler	String	Vue2 作用域插槽编译模式，uni-app 3.1.19+ 开始支持，可选：legacy、auto、augmented，默认：auto
mergeVirtualHostAttributes	Boolean	合并由 Vue 组件编译而成的小程序组件虚拟节点外层属性，目前仅支持 id（v4.42+）、style（v3.5.1+）、class（v3.5.1+）以及 v-show 指令生成的 hidden（v4.41+） 属性
slotMultipleInstance	Boolean	模拟单个作用域插槽渲染为多个实例，此配置仅限 Vue2 环境 3.7.12+，Vue3 环境已默认支持
lazyCodeLoading	String	是否开启代码按需执行
styleIsolation	String	组件样式隔离方式，默认值为 apply-shared，具体配置 详见。 uni-app 3.99+ 开始支持
nativeTags	Array	支付宝小程序平台的原生组件 (4.81+)

Tips

小程序开发者工具 IDE 3.0.1+ 版本开始支持新版配置，查看详情

mp-baidu

属性	类型	说明
appid	String	百度小程序的 AppID，登录 https://smartprogram.baidu.com/docs/introduction/enter_application/ 申请
projectname	String	项目名称
requiredBackgroundModes	Array	小程序需要在后台使用的能力，目前支持背景音频播放，"requiredBackgroundModes": ["audio"]，详见
prefetches	Array	预请求的所有url的列表，详见
optimization	Object	对百度小程序的优化配置
uniStatistics	Object	百度小程序是否开启 uni 统计，配置方法同全局配置
scopedSlotsCompiler	String	Vue2 作用域插槽编译模式，uni-app 3.1.19+ 开始支持，可选：legacy、auto、augmented，默认：auto
slotMultipleInstance	Boolean	模拟单个作用域插槽渲染为多个实例，此配置仅限 Vue2 环境 3.7.12+，Vue3 环境已默认支持
dynamicLib	Object	引入动态库，详情请参考使用动态库
nativeTags	Array	百度小程序平台的原生组件 (4.81+)

optimization

对百度小程序的优化配置

属性	类型	说明
subPackages	Boolean	是否开启分包优化

mp-toutiao

属性	类型	说明
appid	String	抖音小程序的 AppID，登录 https://microapp.bytedance.com/ 申请
projectname	String	项目名称
setting	Object	抖音小程序项目设置，参考抖音小程序项目设置
navigateToMiniProgramAppIdList	Array	需要跳转的小程序列表，详见
uniStatistics	Object	抖音小程序是否开启 uni 统计，配置方法同全局配置
scopedSlotsCompiler	String	Vue2 作用域插槽编译模式，uni-app 3.1.19+ 开始支持，可选：legacy、auto、augmented，默认：auto
slotMultipleInstance	Boolean	模拟单个作用域插槽渲染为多个实例，此配置仅限 Vue2 环境 3.7.12+，Vue3 环境已默认支持
nativeTags	Array	抖音小程序平台的原生组件 (4.81+)

抖音小程序项目设置

属性	类型	说明
urlCheck	Boolean	是否检查安全域名和 TLS 版本
es6	Boolean	ES6 转 ES5
postcss	Boolean	上传代码时样式是否自动补全
minified	Boolean	上传代码时是否自动压缩

mp-lark

属性	类型	说明
appid	String	飞书小程序的 AppID，登录 https://open.feishu.cn 申请
projectname	String	项目名称
setting	Object	飞书小程序项目设置，参考飞书小程序项目设置
uniStatistics	Object	飞书小程序是否开启 uni 统计，配置方法同全局配置
scopedSlotsCompiler	String	Vue2 作用域插槽编译模式，uni-app 3.1.19+ 开始支持，可选：legacy、auto、augmented，默认：auto
slotMultipleInstance	Boolean	模拟单个作用域插槽渲染为多个实例，此配置仅限 Vue2 环境 3.7.12+，Vue3 环境已默认支持
nativeTags	Array	飞书小程序平台的原生组件 (4.81+)

飞书小程序项目设置

属性	类型	说明
urlCheck	Boolean	是否检查安全域名和 TLS 版本
es6	Boolean	ES6 转 ES5
postcss	Boolean	上传代码时样式是否自动补全
minified	Boolean	上传代码时是否自动压缩

mp-qq

属性	类型	说明
appid	String	qq 小程序的 AppID，登录 https://q.qq.com 申请
projectname	String	项目名称
requiredBackgroundModes	Array	小程序需要在后台使用的能力，目前支持背景音频播放，"requiredBackgroundModes": ["audio"]，详见
navigateToMiniProgramAppIdList	Array	需要跳转的小程序列表，详见
permission	Object	小程序接口权限相关设置，比如申请位置权限必须填此处详见
workers	String	Worker 代码放置的目录。 详见
groupIdList	String Array	需要打开群资料卡的群号列表，详见button的open-type
optimization	Object	对QQ小程序的优化配置
uniStatistics	Object	QQ小程序是否开启 uni 统计，配置方法同全局配置
scopedSlotsCompiler	String	Vue2 作用域插槽编译模式，uni-app 3.1.19+ 开始支持，可选：legacy、auto、augmented，默认：auto
slotMultipleInstance	Boolean	模拟单个作用域插槽渲染为多个实例，此配置仅限 Vue2 环境 3.7.12+，Vue3 环境已默认支持
nativeTags	Array	QQ小程序平台的原生组件 (4.81+)

optimization

对QQ小程序的优化配置

属性	类型	说明
subPackages	Boolean	是否开启分包优化

mp-kuaishou

属性	类型	说明
appid	String	快手小程序的 AppID，登录 https://mp.kuaishou.com 申请
projectname	String	项目名称
optimization	Object	对快手小程序的优化配置
uniStatistics	Object	快手小程序是否开启 uni 统计，配置方法同全局配置
scopedSlotsCompiler	String	Vue2 作用域插槽编译模式，uni-app 3.1.19+ 开始支持，可选：legacy、auto、augmented，默认：augmented
slotMultipleInstance	Boolean	模拟单个作用域插槽渲染为多个实例，此配置仅限 Vue2 环境 3.7.12+，Vue3 环境已默认支持
nativeTags	Array	快手小程序平台的原生组件 (4.81+)

optimization

对快手小程序的优化配置

属性	类型	说明
subPackages	Boolean	是否开启分包优化

mp-xhs

属性	类型	说明
appid	String	项目的 appId
projectname	String	项目名称
description	String	项目描述
compileType	String	项目的编译模式
libVersion	String	基础库版本
condition	Object	启用条件编译
setting	Object	项目设置，详见：setting配置说明
packOptions	Object	打包配置选项
nativeTags	Array	小红书小程序平台的原生组件 (4.81+)

mp-harmony

鸿蒙元服务项目设置，目前只支持一个 distribute 属性，其值为一个 Object 对象：

属性	类型	说明
bundleName	String	元服务包名(固定格式为 com.atomicservice.[纯数字 appId])
signingConfigs	Object	证书签名配置
nativeTags	Array	鸿蒙元服务平台的原生组件 (4.81+)

signingConfigs 证书签名配置

此配置对象用于配置鸿蒙打包时使用的数字签名证书信息，可分别配置调试证书和发布证书两组信息。

可以通过可视化方式进行设置，支持自动获取调试证书。

调试证书的键名为 "default"，发布证书的键名为 "release"，其值为一个 Object：

属性	类型	说明
storeFile	String	私钥库文件
storePassword	String	私钥库访问密码
keyAlias	String	私钥库里面的私钥别名
keyPassword	String	私钥访问密码
signAlg	String	签名算法，固定为 "SHA256withECDSA"
certpath	String	证书文件
profile	String	签名描述文件

自定义小程序项目配置

HBuilderX 3.6.16+ 支持项目根目录(cli 项目为 src 目录)下创建配置文件自定义小程序项目配置。平台对应文件名如下：

小程序平台	文件名
微信	project.wx.json、project.config.json
QQ	project.qq.json、project.config.json
百度	project.swan.json
支付宝	mini.project.json、project.my.json
抖音	project.tt.json
飞书	project.lark.json
快手	project.ks.json
京东	project.config.json
小红书	project.xhs.json、project.config.json

关于分包优化的说明

• 在对应平台的配置下添加"optimization":{"subPackages":true}开启分包优化
• 目前只支持mp-weixin、mp-qq、mp-baidu、mp-toutiao、mp-kuaishou的分包优化
• 分包优化具体逻辑：
  • 静态文件：分包下支持 static 等静态资源拷贝，即分包目录内放置的静态资源不会被打包到主包中，也不可在主包中使用
  • js文件：当某个 js 仅被一个分包引用时，该 js 会被打包到该分包内，否则仍打到主包（即被主包引用，或被超过 1 个分包引用）
  • 自定义组件：若某个自定义组件仅被一个分包引用时，且未放入到分包内，编译时会输出提示信息

分包内静态文件示例

"subPackages": [{
	"root": "pages/sub",
	"pages": [{
		"path": "index/index"
	}]
}]

以上面的分包为例，放在每个分包root对应目录下的静态文件会被打包到此分包内。

快应用

属性	类型	说明
icon	String	应用图标，华为推荐 192x192
package	String	应用包名
minPlatformVersion	Number	最小平台运行支持(华为最低 1070，vivo 1063)
versionName	String	版本名称
versionCode	Number	版本号

manifest.json配置

{
  "quickapp-webview": {// 快应用通用配置
    "icon": "/static/logo.png",
    "package": "com.example.demo",
    "versionName": "1.0.0",
    "versionCode": 100
  },
  "quickapp-webview-union": {// 快应用联盟，目前仅支持 vivo、oppo
    "minPlatformVersion": 1063 //最小平台支持
  },
  "quickapp-webview-huawei": {// 快应用华为
    "minPlatformVersion": 1070 //最小平台支持
  }
}

FAQ

Q：iOS 应用调用相机等权限时，弹出的提示语如何修改？ A：在 manifest.json 可视化界面-App模块权限配置-iOS隐私信息访问的许可描述