Update manifest.md

5430b2c9 · D-GSQ · 2be0515d · 5430b2c9
隐藏空白更改
内联并排

Showing with 639 addition and 638 deletion

docs/collocation/manifest.md docs/collocation/manifest.md +639 -638

未找到文件。
--- a/docs/collocation/manifest.md
+++ b/docs/collocation/manifest.md
 `manifest.json` 文件是应用的配置文件，用于指定应用的名称、图标、权限等。HBuilderX 创建的工程此文件在根目录，CLI 创建的工程此文件在 src 目录。
 ### 配置项列表
 |属性|类型|默认值|描述|最低版本|
 |:-|:-|:-|:-|:-|
 |name|String||应用名称||
 |appid|String|新建 uni-app 项目时，DCloud 云端分配。用途[详见](https://ask.dcloud.net.cn/article/35907)|应用标识||
 |description|String||应用描述||
 |locale|String|auto|设置当前默认语言，具体参考 [locale](/api/ui/locale)||
 |versionName|String||版本名称，例如：1.0.0。详见下方Tips说明||
 |versionCode|String||版本号，例如：36||
 |transformPx|Boolean|true|是否转换项目的px，为true时将px转换为rpx，为false时，px为传统的实际像素。为兼容历史项目默认值为 true，但不推荐新项目启用此配置（新建项目模板一般配置为 false）||
 |networkTimeout|Object||网络超时时间，[详见](/collocation/manifest?id=networktimeout)||
 |debug|Boolean|false|是否开启 debug 模式，开启后调试信息以 ``info`` 的形式给出，其信息有页面的注册，页面路由，数据更新，事件触发等||
 |uniStatistics|Object||[是否开启 uni 统计，全局配置](/collocation/manifest?id=uniStatistics)|2.2.3+|
 |app-plus|Object||[App 特有配置](/collocation/manifest?id=app-plus)||
 |h5|Object||[H5 特有配置](/collocation/manifest?id=h5)||
 |quickapp|Object||快应用特有配置，即将支持||
 |mp-weixin|Object||[微信小程序特有配置](/collocation/manifest?id=mp-weixin)||
 |mp-alipay|Object||[支付宝小程序特有配置](/collocation/manifest?id=mp-alipay)|
 |mp-baidu|Object||[百度小程序特有配置](/collocation/manifest?id=mp-baidu)||
 |mp-toutiao|Object||[字节跳动小程序特有配置](/collocation/manifest?id=mp-toutiao)|1.6.0|
 |mp-lark|Object||[飞书小程序特有配置](/collocation/manifest?id=mp-lark)|3.2.12|
 |mp-qq|Object||[qq 小程序特有配置](/collocation/manifest?id=mp-qq)|2.1.0|
+|mp-kuaishou|Object||[快手小程序特有配置](/collocation/manifest.html#mp-kuaishou)|3.2.2|
-**Tips**
+**Tips**
- uni-app 的 `appid` 由 DCloud 云端分配，主要用于 DCloud 相关的云服务，请勿自行修改。[详见](https://ask.dcloud.net.cn/article/35907)
- 注意区分 uni-app 的 `appid` 与微信小程序、iOS 等其它平台分配的 `appid`，以及第三方 SDK 的 `appid`。
+- uni-app 的 `appid` 由 DCloud 云端分配，主要用于 DCloud 相关的云服务，请勿自行修改。[详见](https://ask.dcloud.net.cn/article/35907)
- versionName在云打包App和生成wgt应用资源时会使用。如需升级App版本，先修改此处再云打包。导出wgt资源用于离线打包和热更新时也会以此版本为依据。
+- 注意区分 uni-app 的 `appid` 与微信小程序、iOS 等其它平台分配的 `appid`，以及第三方 SDK 的 `appid`。
- 在本地打包时和热更新时，App版本和wgt应用资源版本将不再保持一致。此时通过[plus.runtime.version](https://www.html5plus.org/doc/zh_cn/runtime.html#plus.runtime.version)可获取App版本，通过[plus.runtime.getProperty](https://www.html5plus.org/doc/zh_cn/runtime.html#plus.runtime.getProperty)获取wgt资源版本。
+- versionName在云打包App和生成wgt应用资源时会使用。如需升级App版本，先修改此处再云打包。导出wgt资源用于离线打包和热更新时也会以此版本为依据。
+- 在本地打包时和热更新时，App版本和wgt应用资源版本将不再保持一致。此时通过[plus.runtime.version](https://www.html5plus.org/doc/zh_cn/runtime.html#plus.runtime.version)可获取App版本，通过[plus.runtime.getProperty](https://www.html5plus.org/doc/zh_cn/runtime.html#plus.runtime.getProperty)获取wgt资源版本。
-#### networkTimeout
+#### networkTimeout
-各类网络请求的超时时间，单位均为毫秒。
+各类网络请求的超时时间，单位均为毫秒。
-|属性|类型|必填|默认值|说明|
-|--|--|--|--|--|
+|属性|类型|必填|默认值|说明|
-|request|Number|否|60000|uni.request 的超时时间，单位毫秒。|
+|--|--|--|--|--|
-|connectSocket|Number|否|60000|uni.connectSocket 的超时时间，单位毫秒。|
+|request|Number|否|60000|uni.request 的超时时间，单位毫秒。|
-|uploadFile|Number|否|60000|uni.uploadFile 的超时时间，单位毫秒。|
+|connectSocket|Number|否|60000|uni.connectSocket 的超时时间，单位毫秒。|
-|downloadFile|Number|否|60000|uni.downloadFile 的超时时间，单位毫秒。|
+|uploadFile|Number|否|60000|uni.uploadFile 的超时时间，单位毫秒。|
+|downloadFile|Number|否|60000|uni.downloadFile 的超时时间，单位毫秒。|
-自`HBuilderX 2.5.10`起，上述默认超时时间由6秒改为60秒，对齐微信小程序平台。
+自`HBuilderX 2.5.10`起，上述默认超时时间由6秒改为60秒，对齐微信小程序平台。
-#### uniStatistics
-uni 统计配置项
+#### uniStatistics
+uni 统计配置项
-|属性|类型|必填|默认值|说明|
-|--|--|--|--|--|
+|属性|类型|必填|默认值|说明|
-|enable|Boolean|是|true|是否开启uni统计|
+|--|--|--|--|--|
+|enable|Boolean|是|true|是否开启uni统计|
-### app-plus
+### app-plus
-|属性|类型|说明|最低版本|
-|:-|:-|:-|:-|
+|属性|类型|说明|最低版本|
-|splashscreen|Object|App 启动界面信息，[详见](/collocation/manifest?id=splashscreen)||
+|:-|:-|:-|:-|
-|screenOrientation|Array|重力感应、横竖屏配置，可取值："portrait-primary"：竖屏正方向；"portrait-secondary"：竖屏反方向；"landscape-primary"：横屏正方向；"landscape-secondary"：横屏反方向。||
+|splashscreen|Object|App 启动界面信息，[详见](/collocation/manifest?id=splashscreen)||
-|modules|Object|权限模块，[详见](/collocation/manifest?id=modules)||
+|screenOrientation|Array|重力感应、横竖屏配置，可取值："portrait-primary"：竖屏正方向；"portrait-secondary"：竖屏反方向；"landscape-primary"：横屏正方向；"landscape-secondary"：横屏反方向。||
-|distribute|Object|App 发布信息，[详见](/collocation/manifest?id=distribute)||
+|modules|Object|权限模块，[详见](/collocation/manifest?id=modules)||
-|nvueCompiler|String|切换 nvue 编译模式，可选值，`weex` ：老编译模式，`uni-app`： 新编译模式，默认为 `weex` 。[编译模式区别详情](http://ask.dcloud.net.cn/article/36074)|2.0.3+|
+|distribute|Object|App 发布信息，[详见](/collocation/manifest?id=distribute)||
-|nvueStyleCompiler|String|切换 nvue 样式编译模式，可选值，`weex` ：老编译模式，`uni-app`： 新编译模式，默认为 `weex` 。[编译模式区别详情](https://ask.dcloud.net.cn/article/38751)|3.1.1+|
+|nvueCompiler|String|切换 nvue 编译模式，可选值，`weex` ：老编译模式，`uni-app`： 新编译模式，默认为 `weex` 。[编译模式区别详情](http://ask.dcloud.net.cn/article/36074)|2.0.3+|
-|renderer|String|可不加载基于 webview 的运行框架，减少包体积、提升启动速度。可选值 `native`| App-nvue 2.2.0+|
+|nvueStyleCompiler|String|切换 nvue 样式编译模式，可选值，`weex` ：老编译模式，`uni-app`： 新编译模式，默认为 `weex` 。[编译模式区别详情](https://ask.dcloud.net.cn/article/38751)|3.1.1+|
-|nvueLaunchMode|String|Nvue 首页启动模式，可选值：normal、fast 默认 normal（HBuilderX 2.4.4-2.4.9 固定为 fast） [详见](https://ask.dcloud.net.cn/article/36749)|2.5.0+|
+|renderer|String|可不加载基于 webview 的运行框架，减少包体积、提升启动速度。可选值 `native`| App-nvue 2.2.0+|
-|nvue|Object|nvue 页面布局初始配置，[详见](/collocation/manifest?id=nvue)|2.0.3+|
+|nvueLaunchMode|String|Nvue 首页启动模式，可选值：normal、fast 默认 normal（HBuilderX 2.4.4-2.4.9 固定为 fast） [详见](https://ask.dcloud.net.cn/article/36749)|2.5.0+|
-|optimization|Object|分包配置，可以减轻启动时加载的js数量，提升启动速度|2.7.12+|
+|nvue|Object|nvue 页面布局初始配置，[详见](/collocation/manifest?id=nvue)|2.0.3+|
-|uniStatistics|Object|[App 是否开启 uni 统计，配置方法同全局配置](/collocation/manifest?id=uniStatistics)|2.2.3+|
+|optimization|Object|分包配置，可以减轻启动时加载的js数量，提升启动速度|2.7.12+|
-|webView|Object|当系统webview低于指定版本时，会弹出提示。或者下载x5内核后继续启动，仅Android支持，[详情](/collocation/manifest?id=appwebview)|3.5.0+|
+|uniStatistics|Object|[App 是否开启 uni 统计，配置方法同全局配置](/collocation/manifest?id=uniStatistics)|2.2.3+|
+|webView|Object|当系统webview低于指定版本时，会弹出提示。或者下载x5内核后继续启动，仅Android支持，[详情](/collocation/manifest?id=appwebview)|3.5.0+|
-PS：上表只列出了核心部分，App平台的配置其实非常多，完整内容请参考 [完整的 manifest.json](/collocation/manifest-app?id=full-manifest)。
+PS：上表只列出了核心部分，App平台的配置其实非常多，完整内容请参考 [完整的 manifest.json](/collocation/manifest-app?id=full-manifest)。
-**Tips**
+**Tips**
- manifest.json 文件的配置，推荐在 HBuilderX 提供的可视化操作界面完成。
- 部分配置在打包时的操作界面补全，例如：证书等信息。
+- manifest.json 文件的配置，推荐在 HBuilderX 提供的可视化操作界面完成。
- Native.js 权限部分会根据配置的模块权限，在打包后自动填充。
+- 部分配置在打包时的操作界面补全，例如：证书等信息。
- 部分 modules 是默认的，不需要进行配置。
+- Native.js 权限部分会根据配置的模块权限，在打包后自动填充。
- 微信小程序的 `appid` 等信息，需要配置在 `mp-weixin` 节点下。不要配置在 `app-plus`下。`sdkConfigs` 下出现的 `weixin` 节点，配置的是 App 的第三方 SDK 信息。
+- 部分 modules 是默认的，不需要进行配置。
+- 微信小程序的 `appid` 等信息，需要配置在 `mp-weixin` 节点下。不要配置在 `app-plus`下。`sdkConfigs` 下出现的 `weixin` 节点，配置的是 App 的第三方 SDK 信息。
-#### App Splashscreen@splashscreen
+#### App Splashscreen@splashscreen
-splash（启动封面）是App必然存在的、不可取消的。
-|属性|类型|默认值|描述|最低版本|
+splash（启动封面）是App必然存在的、不可取消的。
-|:-|:-|:-|:-|:-|
+|属性|类型|默认值|描述|最低版本|
-|alwaysShowBeforeRender|Boolean|true|是否等待首页渲染完毕后再关闭启动界面|1.6.0|
+|:-|:-|:-|:-|:-|
-|autoclose|Boolean|true|是否自动关闭启动界面，仅当alwaysShowBeforeRender设置为false时生效，如果需要[手动关闭](https://www.html5plus.org/doc/zh_cn/navigator.html#plus.navigator.closeSplashscreen)启动界面，需将 alwaysShowBeforeRender 及 autoclose 均设置为 false。||
+|alwaysShowBeforeRender|Boolean|true|是否等待首页渲染完毕后再关闭启动界面|1.6.0|
-|waiting|Boolean|true|是否在程序启动界面显示等待圈或雪花||
+|autoclose|Boolean|true|是否自动关闭启动界面，仅当alwaysShowBeforeRender设置为false时生效，如果需要[手动关闭](https://www.html5plus.org/doc/zh_cn/navigator.html#plus.navigator.closeSplashscreen)启动界面，需将 alwaysShowBeforeRender 及 autoclose 均设置为 false。||
+|waiting|Boolean|true|是否在程序启动界面显示等待圈或雪花||
-alwaysShowBeforeRender和autoclose属性组合设置，可配置以下三种关闭启动界面（splash）策略，[详见](tutorial/app-splashscreen)
+alwaysShowBeforeRender和autoclose属性组合设置，可配置以下三种关闭启动界面（splash）策略，[详见](tutorial/app-splashscreen)
-**注意**
- 如果不配置自己的splash图，App端会默认把App的icon放到splash中
+**注意**
- splash只能是标准png，不要用jpg改名为png。也不支持gif等动画
+- 如果不配置自己的splash图，App端会默认把App的icon放到splash中
- 相关改动，云打包生效，真机运行不生效。本地打包需自行在原生工程中配置
+- splash只能是标准png，不要用jpg改名为png。也不支持gif等动画
- App启动图中iOS的MAX等大屏设备的splash图若不配，会导致iOS认为此App没有为MAX优化，App将无法全屏，四周会有黑边
+- 相关改动，云打包生效，真机运行不生效。本地打包需自行在原生工程中配置
- Android的splash支持.9.png，[详见](tutorial/app-splashscreen?id=9png)
+- App启动图中iOS的MAX等大屏设备的splash图若不配，会导致iOS认为此App没有为MAX优化，App将无法全屏，四周会有黑边
+- Android的splash支持.9.png，[详见](tutorial/app-splashscreen?id=9png)
-#### App Modules@modules
-模块选择是为了控制App的包体积，不需要的模块可以在打包时剔除。
+#### App Modules@modules
+模块选择是为了控制App的包体积，不需要的模块可以在打包时剔除。
-|名称|描述|
-|:-|:-|
+|名称|描述|
-|Bluetooth|BLE蓝牙|
+|:-|:-|
-|Contacts|系统通讯录|
+|Bluetooth|BLE蓝牙|
-|Fingerprint|指纹识别|
+|Contacts|系统通讯录|
-|iBeacon|iBeacon|
+|Fingerprint|指纹识别|
-|LivePusher|直播推流|
+|iBeacon|iBeacon|
-|Maps|地图|
+|LivePusher|直播推流|
-|Messaging|短彩邮件消息|
+|Maps|地图|
-|OAuth|登录授权|
+|Messaging|短彩邮件消息|
-|Payment|支付|
+|OAuth|登录授权|
-|Push|消息推送|
+|Payment|支付|
-|Share|社交分享|
+|Push|消息推送|
-|Speech|语音识别|
+|Share|社交分享|
-|SQLite|SQLite数据库|
+|Speech|语音识别|
-|Statistic|统计|
+|SQLite|SQLite数据库|
-|VideoPlayer|视频播放|
+|Statistic|统计|
+|VideoPlayer|视频播放|
-**注意**
- 仅App云打包生效。本地打包需自行在原生工程中配置。
+**注意**
+- 仅App云打包生效。本地打包需自行在原生工程中配置。
-#### App Distribute@distribute
+#### App Distribute@distribute
-|属性|类型|描述|
-|:-|:-|:-|
+|属性|类型|描述|
-|android|Object|Android 应用配置，详见: [Android配置明细](/collocation/manifest-app?id=android)|
+|:-|:-|:-|
-|ios|Object|iOS 应用配置，详见: [iOS配置明细](/collocation/manifest-app?id=ios)|
+|android|Object|Android 应用配置，详见: [Android配置明细](/collocation/manifest-app?id=android)|
-|sdkConfigs|Object|SDK配置，仅打包生效 [详见](/collocation/manifest?id=sdkConfigs)|
+|ios|Object|iOS 应用配置，详见: [iOS配置明细](/collocation/manifest-app?id=ios)|
-|orientation|Array|同 screenOrientation 配置，仅打包生效，已废弃，推荐使用 screenOrientation|
+|sdkConfigs|Object|SDK配置，仅打包生效 [详见](/collocation/manifest?id=sdkConfigs)|
+|orientation|Array|同 screenOrientation 配置，仅打包生效，已废弃，推荐使用 screenOrientation|
-#### App SdkConfigs@sdkConfigs
+#### App SdkConfigs@sdkConfigs
-三方原生SDK配置。三方SDK的使用需要向这些SDK提供商申请，并配置参数到此处。可在HBuilderX可视化界面（App SDK配置）输入配置，此配置仅**云打包后生效**，本地打包需自行在原生工程中配置。
+三方原生SDK配置。三方SDK的使用需要向这些SDK提供商申请，并配置参数到此处。可在HBuilderX可视化界面（App SDK配置）输入配置，此配置仅**云打包后生效**，本地打包需自行在原生工程中配置。
-|属性|类型|描述|
-|:-|:-|:-|
+|属性|类型|描述|
-|oauth|Object|授权登录，配置后可调用 [uni.login](/api/plugins/login?id=login) 进行登录操作，目前支持的授权登录平台有：[QQ](http://open.qq.com/)、[微信](https://open.weixin.qq.com/)、[新浪微博](http://open.weibo.com/)。|
+|:-|:-|:-|
-|share|Object|分享，配置后可调用 [uni.share](/api/plugins/share?id=share) 进行分享，目前支持QQ、微信、新浪微博等分享， 具体配置 [详见](/api/plugins/share?id=app-端各平台分享配置说明)。|
+|oauth|Object|授权登录，配置后可调用 [uni.login](/api/plugins/login?id=login) 进行登录操作，目前支持的授权登录平台有：[QQ](http://open.qq.com/)、[微信](https://open.weixin.qq.com/)、[新浪微博](http://open.weibo.com/)。|
-|push|Object|push配置，使用方式 [详见](/unipush)，目前支持：[uniPush](http://ask.dcloud.net.cn/article/35716)、[个推](http://www.igetui.com/)，注意App仅支持一种 push 方式，配置多个 push 无效，建议使用 uniPush，支持多厂商推送。|
+|share|Object|分享，配置后可调用 [uni.share](/api/plugins/share?id=share) 进行分享，目前支持QQ、微信、新浪微博等分享， 具体配置 [详见](/api/plugins/share?id=app-端各平台分享配置说明)。|
-|payment|Object|三方支付配置，配置后可调用 [uni.payment](/api/plugins/payment?id=payment) 进行支付，目前支持微信支付、支付宝支付、苹果内购， 具体配置 [详见](/api/plugins/payment?id=uni-app-app-平台支付流程)。|
+|push|Object|push配置，使用方式 [详见](/unipush)，目前支持：[uniPush](http://ask.dcloud.net.cn/article/35716)、[个推](http://www.igetui.com/)，注意App仅支持一种 push 方式，配置多个 push 无效，建议使用 uniPush，支持多厂商推送。|
-|statics|Object|统计配置，目前仅支付友盟统计，[详见](/tutorial/app-statistic)，在uni-app中只用 [plus.statistic](http://www.html5plus.org/doc/zh_cn/statistic.html) 进行调用。|
+|payment|Object|三方支付配置，配置后可调用 [uni.payment](/api/plugins/payment?id=payment) 进行支付，目前支持微信支付、支付宝支付、苹果内购， 具体配置 [详见](/api/plugins/payment?id=uni-app-app-平台支付流程)。|
-|speech|Object|语音识别配置，支持讯飞语音、百度语音，[详见](/tutorial/app-speech)，在uni-app中只用 [plus.speech](http://www.html5plus.org/doc/zh_cn/speech.html) 进行调用。|
+|statics|Object|统计配置，目前仅支付友盟统计，[详见](/tutorial/app-statistic)，在uni-app中只用 [plus.statistic](http://www.html5plus.org/doc/zh_cn/statistic.html) 进行调用。|
-|maps|Object|原生地图配置，目前仅支持 [高德地图](http://lbs.amap.com/)，申请方式可参考：[地图插件配置](/tutorial/app-maps)。|
+|speech|Object|语音识别配置，支持讯飞语音、百度语音，[详见](/tutorial/app-speech)，在uni-app中只用 [plus.speech](http://www.html5plus.org/doc/zh_cn/speech.html) 进行调用。|
+|maps|Object|原生地图配置，目前仅支持 [高德地图](http://lbs.amap.com/)，申请方式可参考：[地图插件配置](/tutorial/app-maps)。|
-#### optimization@app-vue-optimization
+#### optimization@app-vue-optimization
-可以减轻启动时加载的js数量，提升启动速度。
+可以减轻启动时加载的js数量，提升启动速度。
-从uni-app 2.7.12+ 开始，App-vue平台也兼容了小程序的分包配置，但默认并不开启。
+从uni-app 2.7.12+ 开始，App-vue平台也兼容了小程序的分包配置，但默认并不开启。
-在manifest配置以下节点，可以在App端启动分包。
+在manifest配置以下节点，可以在App端启动分包。
-|属性|类型|说明|
-|:-|:-|:-|
+|属性|类型|说明|
-|subPackages|Boolean|是否开启分包优化|
+|:-|:-|:-|
+|subPackages|Boolean|是否开启分包优化|
-```
-"app-plus": {
+```
-  "optimization": {
+"app-plus": {
-    "subPackages": true
+  "optimization": {
-  },
+    "subPackages": true
-  "runmode" : "liberate" // 开启分包优化后，必须配置资源释放模式
+  },
-}
+  "runmode" : "liberate" // 开启分包优化后，必须配置资源释放模式
-```
+}
+```
-在manifest中启动分包后，需要在pages.json中配置具体的分包规则，与小程序的配置相同，详见：[https://uniapp.dcloud.io/collocation/pages?id=subpackages](https://uniapp.dcloud.io/collocation/pages?id=subpackages)
+在manifest中启动分包后，需要在pages.json中配置具体的分包规则，与小程序的配置相同，详见：[https://uniapp.dcloud.io/collocation/pages?id=subpackages](https://uniapp.dcloud.io/collocation/pages?id=subpackages)
-也就是一旦在pages.json里配置分包，小程序一定生效，而app是否生效，取决于manifest里是否开启。
+也就是一旦在pages.json里配置分包，小程序一定生效，而app是否生效，取决于manifest里是否开启。
-注意:
-* App开启分包后，每个分包单独编译成一个js文件(都包含在app内，不会联网下载)，当App首页是vue时，可减小启动加载文件大小，提升启动速度。
+注意:
-* 首页是nvue时，分包不会提升启动速度，nvue本身启动速度就快于vue，也快于开启分包后的首页为vue的应用。如果追求极致启动速度，还是应该使用nvue做首页并在manifest开启fast模式。
+* App开启分包后，每个分包单独编译成一个js文件(都包含在app内，不会联网下载)，当App首页是vue时，可减小启动加载文件大小，提升启动速度。
-* App页面较少时，分包对启动速度的优化不明显。
+* 首页是nvue时，分包不会提升启动速度，nvue本身启动速度就快于vue，也快于开启分包后的首页为vue的应用。如果追求极致启动速度，还是应该使用nvue做首页并在manifest开启fast模式。
+* App页面较少时，分包对启动速度的优化不明显。
-#### nvue@nvue
-`nvue` 页面布局初始设置
+#### nvue@nvue
+`nvue` 页面布局初始设置
-|属性|类型|描述|
-|:-|:-|:-|
+|属性|类型|描述|
-|flex-direction|String| flex 成员项的排列方向，支持项，row：从左到右； row-reverse：从右到左；column：从上到下；column-reverse：与 column 相反，默认值 column。|
+|:-|:-|:-|
+|flex-direction|String| flex 成员项的排列方向，支持项，row：从左到右； row-reverse：从右到左；column：从上到下；column-reverse：与 column 相反，默认值 column。|
-#### webview@appwebview
+#### webview@appwebview
-> uni-app 3.5.0+
+> uni-app 3.5.0+
-当App代码使用了低版本webview不支持的语法时（比如使用了vue3），可以在manifest配置本属性，来指定最低运行的webview版本。
+当App代码使用了低版本webview不支持的语法时（比如使用了vue3），可以在manifest配置本属性，来指定最低运行的webview版本。
-当系统webview版本不符合需求时，uni-app引擎会自动弹框。同时开发者可以指定使用 x5引擎webview 来替代系统webview，以保障浏览器兼容性。详见[x5文档](/tutorial/app-android-x5.html)
+当系统webview版本不符合需求时，uni-app引擎会自动弹框。同时开发者可以指定使用 x5引擎webview 来替代系统webview，以保障浏览器兼容性。详见[x5文档](/tutorial/app-android-x5.html)
-当你的应用强依赖x5时，比如需要vue页面的字体和tabbar等原生界面保持一致时，也可以在manifest配置本属性。
+当你的应用强依赖x5时，比如需要vue页面的字体和tabbar等原生界面保持一致时，也可以在manifest配置本属性。
-|属性|类型|说明|
-|:-|:-|:-|
+|属性|类型|说明|
-|minUserAgentVersion|String|最小webview版本，例如：95.0.4638.75。（当低于最小版本要求时，显示 `WebView版本过低`  弹框，点击确定退出应用。）|
+|:-|:-|:-|
-|x5|Object|此属性需要在manifest模块配置中勾选 Android X5 Webview 模块，详细参见下面的说明|
+|minUserAgentVersion|String|最小webview版本，例如：95.0.4638.75。（当低于最小版本要求时，显示 `WebView版本过低`  弹框，点击确定退出应用。）|
+|x5|Object|此属性需要在manifest模块配置中勾选 Android X5 Webview 模块，详细参见下面的说明|
-x5 属性说明
+x5 属性说明
-|属性|类型|默认值|说明|
-|:-|:-|:-|:-|
+|属性|类型|默认值|说明|
-|timeOut|Number|3000|超时时间|
+|:-|:-|:-|:-|
-|showTipsWithoutWifi|Boolean|false|是否在非WiFi网络环境时，显示用户确认下载x5内核的弹窗。（如果为true时，在非WiFi网络下载x5模块，会显示用户确认弹框，内容为 `当前处于非WiFi网络，是否允许下载x5模块？` ，false时不显示弹框 。）|
+|timeOut|Number|3000|超时时间|
-|allowDownloadWithoutWiFi|Boolean|false|是否允许用户在非WiFi网络时进行x5内核的下载。（如果为true，就不会显示用户确认的弹窗。false时，如果showTipsWithoutWifi为true，就会显示用户确认弹框；showTipsWithoutWifi为false时，不下载x5模块。）|
+|showTipsWithoutWifi|Boolean|false|是否在非WiFi网络环境时，显示用户确认下载x5内核的弹窗。（如果为true时，在非WiFi网络下载x5模块，会显示用户确认弹框，内容为 `当前处于非WiFi网络，是否允许下载x5模块？` ，false时不显示弹框 。）|
+|allowDownloadWithoutWiFi|Boolean|false|是否允许用户在非WiFi网络时进行x5内核的下载。（如果为true，就不会显示用户确认的弹窗。false时，如果showTipsWithoutWifi为true，就会显示用户确认弹框；showTipsWithoutWifi为false时，不下载x5模块。）|
-webview示例
+webview示例
-```json
-{
+```json
-  "app-plus" : {
+{
-    "webView": {
+  "app-plus" : {
-      "minUserAgentVersion": "95.0.4638.75",
+    "webView": {
-      "x5": {
+      "minUserAgentVersion": "95.0.4638.75",
-        "timeOut": 3000,
+      "x5": {
-        "showTipsWithoutWifi": true,
+        "timeOut": 3000,
-        "allowDownloadWithoutWiFi": false
+        "showTipsWithoutWifi": true,
-      }
+        "allowDownloadWithoutWiFi": false
-    }
+      }
-  }
+    }
-}
+  }
-```
+}
+```
-### h5
-|属性|类型|说明|
+### h5
-|:-|:-|:-|
+|属性|类型|说明|
-|title|String|页面标题，默认使用 manifest.json 的 name|
+|:-|:-|:-|
-|template|String|index.html模板路径，相对于应用根目录，可定制生成的 html 代码。参考：[自定义模板](/collocation/manifest?id=h5-template)|
+|title|String|页面标题，默认使用 manifest.json 的 name|
-|router|Object|参考：[router](/collocation/manifest?id=h5-router)|
+|template|String|index.html模板路径，相对于应用根目录，可定制生成的 html 代码。参考：[自定义模板](/collocation/manifest?id=h5-template)|
-|async|Object|参考：[async](/collocation/manifest?id=h5-async)|
+|router|Object|参考：[router](/collocation/manifest?id=h5-router)|
-|devServer|Object|开发环境 server 配置，参考：[devServer](/collocation/manifest?id=devserver)|
+|async|Object|参考：[async](/collocation/manifest?id=h5-async)|
-|publicPath|String|引用资源的地址前缀，仅发布时生效。参考：[publicPath](/collocation/manifest?id=publicPath)|
+|devServer|Object|开发环境 server 配置，参考：[devServer](/collocation/manifest?id=devserver)|
-|sdkConfigs|String|SDK配置，例如地图...  参考：[sdkConfigs](/collocation/manifest?id=h5sdkconfig)|
+|publicPath|String|引用资源的地址前缀，仅发布时生效。参考：[publicPath](/collocation/manifest?id=publicPath)|
-|optimization|Object|打包优化配置（HBuilderX 2.1.5 以上支持），参考[optimization](/collocation/manifest?id=optimization)|
+|sdkConfigs|String|SDK配置，例如地图...  参考：[sdkConfigs](/collocation/manifest?id=h5sdkconfig)|
-|uniStatistics|Object|[H5 是否开启 uni 统计，配置方法同全局配置](/collocation/manifest?id=uniStatistics)||
+|optimization|Object|打包优化配置（HBuilderX 2.1.5 以上支持），参考[optimization](/collocation/manifest?id=optimization)|
+|uniStatistics|Object|[H5 是否开启 uni 统计，配置方法同全局配置](/collocation/manifest?id=uniStatistics)||
-#### 自定义模板@h5-template
-需要使用自定义模板的场景，通常有以下几种情况：
+#### 自定义模板@h5-template
+需要使用自定义模板的场景，通常有以下几种情况：
- 调整页面 head 中的 meta 配置
- 补充 SEO 相关的一些配置（仅首页）
+- 调整页面 head 中的 meta 配置
- 加入百度统计等三方js
+- 补充 SEO 相关的一些配置（仅首页）
+- 加入百度统计等三方js
-使用自定义模板时，1. 工程根目录下新建一个html文件；2. 复制下面的基本模板内容，到这个html文件，在此基础上修改meta和引入js；3. 在 `manifest.json->h5->template` 节点中关联这个html文件的路径。
-```html
+使用自定义模板时，1. 工程根目录下新建一个html文件；2. 复制下面的基本模板内容，到这个html文件，在此基础上修改meta和引入js；3. 在 `manifest.json->h5->template` 节点中关联这个html文件的路径。
-<!DOCTYPE html>
+```html
-<html lang="zh-CN">
+<!DOCTYPE html>
-	<head>
+<html lang="zh-CN">
-		<meta charset="utf-8">
+	<head>
-		<meta http-equiv="X-UA-Compatible" content="IE=edge">
+		<meta charset="utf-8">
-		<title>
+		<meta http-equiv="X-UA-Compatible" content="IE=edge">
-			<%= htmlWebpackPlugin.options.title %>
+		<title>
-		</title>
+			<%= htmlWebpackPlugin.options.title %>
-		<!-- Open Graph data -->
+		</title>
-		<!-- <meta property="og:title" content="Title Here" /> -->
+		<!-- Open Graph data -->
-		<!-- <meta property="og:url" content="http://www.example.com/" /> -->
+		<!-- <meta property="og:title" content="Title Here" /> -->
-		<!-- <meta property="og:image" content="http://example.com/image.jpg" /> -->
+		<!-- <meta property="og:url" content="http://www.example.com/" /> -->
-		<!-- <meta property="og:description" content="Description Here" /> -->
+		<!-- <meta property="og:image" content="http://example.com/image.jpg" /> -->
-		<script>
+		<!-- <meta property="og:description" content="Description Here" /> -->
-			var coverSupport = 'CSS' in window && typeof CSS.supports === 'function' && (CSS.supports('top: env(a)') || CSS.supports('top: constant(a)'))
+		<script>
-			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' : '') + '" />')
+			var coverSupport = 'CSS' in window && typeof CSS.supports === 'function' && (CSS.supports('top: env(a)') || CSS.supports('top: constant(a)'))
-		</script>
+			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' : '') + '" />')
-		<link rel="stylesheet" href="<%= BASE_URL %>static/index.<%= VUE_APP_INDEX_CSS_HASH %>.css" />
+		</script>
-	</head>
+		<link rel="stylesheet" href="<%= BASE_URL %>static/index.<%= VUE_APP_INDEX_CSS_HASH %>.css" />
-	<body>
+	</head>
-		<noscript>
+	<body>
-			<strong>Please enable JavaScript to continue.</strong>
+		<noscript>
-		</noscript>
+			<strong>Please enable JavaScript to continue.</strong>
-		<div id="app"></div>
+		</noscript>
-		<!-- built files will be auto injected -->
+		<div id="app"></div>
-	</body>
+		<!-- built files will be auto injected -->
-</html>
+	</body>
-```
+</html>
+```
-在hello uni-app示例中有一个`template.h5.html`文件，即是此用途。
+在hello uni-app示例中有一个`template.h5.html`文件，即是此用途。
-**关于SEO的补充说明**
+**关于SEO的补充说明**
-H5平台是SPA单页应用，普通的SEO信息即加meta字段只能在，自定义的模板html里配置首页。
+H5平台是SPA单页应用，普通的SEO信息即加meta字段只能在，自定义的模板html里配置首页。
-但SEO的时代在变，现在更有效的方式，使用uni-app同时发布一版百度小程序，这个搜索权重更高。DCloud的ask社区的H5版也是uni-app做的，同时发布了百度小程序，权重更高，每天来自百度的搜索量非常多。是一个可现身说法的好案例。
+但SEO的时代在变，现在更有效的方式，使用uni-app同时发布一版百度小程序，这个搜索权重更高。DCloud的ask社区的H5版也是uni-app做的，同时发布了百度小程序，权重更高，每天来自百度的搜索量非常多。是一个可现身说法的好案例。
-#### router@h5-router
-|属性|类型|默认值|说明|
+#### router@h5-router
-|:-|:-|:-|:-|
+|属性|类型|默认值|说明|
-|mode|String|hash|路由跳转模式，支持 hash、history|
+|:-|:-|:-|:-|
-|base|String|/|应用基础路径，例如，如果整个单页应用服务在 /app/ 下，然后 base 就应该设为 "/app/"，支持设置为相对路径 "./"|
+|mode|String|hash|路由跳转模式，支持 hash、history|
+|base|String|/|应用基础路径，例如，如果整个单页应用服务在 /app/ 下，然后 base 就应该设为 "/app/"，支持设置为相对路径 "./"|
-**注意：**
+**注意：**
-* `history` 模式部分浏览器器不支持，iOS微信内置浏览器无法观测到URL变动，默认分享（不使用微信[JSSDK](https://ask.dcloud.net.cn/article/35380)的情况下）的链接为入口页链接。
-* `history` 模式发行需要后台配置支持，详见：[history 模式的后端配置](https://router.vuejs.org/zh/guide/essentials/history-mode.html#%E5%90%8E%E7%AB%AF%E9%85%8D%E7%BD%AE%E4%BE%8B%E5%AD%90)
+* `history` 模式部分浏览器器不支持，iOS微信内置浏览器无法观测到URL变动，默认分享（不使用微信[JSSDK](https://ask.dcloud.net.cn/article/35380)的情况下）的链接为入口页链接。
+* `history` 模式发行需要后台配置支持，详见：[history 模式的后端配置](https://router.vuejs.org/zh/guide/essentials/history-mode.html#%E5%90%8E%E7%AB%AF%E9%85%8D%E7%BD%AE%E4%BE%8B%E5%AD%90)
-#### async@h5-async
-|属性|类型|默认值|说明|
+#### async@h5-async
-|:-|:-|:-|:-|
+|属性|类型|默认值|说明|
-|loading|String|AsyncLoading|页面 js 加载时使用的组件（需注册为全局组件）|
+|:-|:-|:-|:-|
-|error|String|AsyncError|页面 js 加载失败时使用的组件（需注册为全局组件）|
+|loading|String|AsyncLoading|页面 js 加载时使用的组件（需注册为全局组件）|
-|delay|Number|200|展示 loading 加载组件的延时时间（页面 js 若在 delay 时间内加载完成，则不会显示 loading 组件）|
+|error|String|AsyncError|页面 js 加载失败时使用的组件（需注册为全局组件）|
-|timeout|Number|60000|页面 js 加载超时时间（超时后展示 error 对应的组件）|
+|delay|Number|200|展示 loading 加载组件的延时时间（页面 js 若在 delay 时间内加载完成，则不会显示 loading 组件）|
+|timeout|Number|60000|页面 js 加载超时时间（超时后展示 error 对应的组件）|
-#### devServer
-|属性|类型|默认值|说明|
+#### devServer
-|:-|:-|:-|:-|
+|属性|类型|默认值|说明|
-|https|Boolean|false|启用 https 协议|
+|:-|:-|:-|:-|
-|port|Number|Vue2 8080；Vue3 3000|前端开发服务端口|
+|https|Boolean|false|启用 https 协议|
-|disableHostCheck|Boolean|false|禁用 Host 检查|
+|port|Number|Vue2 8080；Vue3 3000|前端开发服务端口|
+|disableHostCheck|Boolean|false|禁用 Host 检查|
-Tips：`uni-app` 中 `manifest.json->h5->devServer` 实际上对应 `webpack` 的 [devServer](https://webpack.js.org/configuration/dev-server/)，鉴于 manifest 为 json 文件，故 `webpack.config.js->devServer` 配置项下的简单类型属性均可在`manifest.json->h5->devServer`节点下配置，funciton 等复杂类型暂不支持。
+Tips：`uni-app` 中 `manifest.json->h5->devServer` 实际上对应 `webpack` 的 [devServer](https://webpack.js.org/configuration/dev-server/)，鉴于 manifest 为 json 文件，故 `webpack.config.js->devServer` 配置项下的简单类型属性均可在`manifest.json->h5->devServer`节点下配置，funciton 等复杂类型暂不支持。
-#### publicPath
-配置 publicPath 为 cdn 资源地址前缀，这样编译出来的 html 文件，引用的 js，css 路径会自动变成 cdn 上的地址。
+#### publicPath
+配置 publicPath 为 cdn 资源地址前缀，这样编译出来的 html 文件，引用的 js，css 路径会自动变成 cdn 上的地址。
-注意：如果想对图片生效，image组件的图片地址需要使用相对路径
+注意：如果想对图片生效，image组件的图片地址需要使用相对路径
-**示例**
+**示例**
-以 hello-uniapp 发布 H5 时为例
+以 hello-uniapp 发布 H5 时为例
-未配置 publicPath 时，发布时 index.html 中的结果：
+未配置 publicPath 时，发布时 index.html 中的结果：
-```html
-<script src=/h5/static/js/chunk-vendors.803ce52d.js></script>
+```html
-<script src=/h5/static/js/index.34e8497d.js>
+<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 中的结果：
+```
+配置 publicPath 为 `https://www.cdn.com/h5/`（无效地址仅用作示例） 后，发布时 index.html 中的结果：
-```html
-<script src=https://www.cdn.com/h5/static/js/chunk-vendors.803ce52d.js></script>
+```html
-<script src=https://www.cdn.com/h5/static/js/index.34e8497d.js>
+<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 可以进一步压缩文件。具体的配置，可以参考网上的分享：https://juejin.im/post/5af003286fb9a07aac24611b
+**注意**
+- 打包部署后，在服务器上开启 gzip 可以进一步压缩文件。具体的配置，可以参考网上的分享：https://juejin.im/post/5af003286fb9a07aac24611b
-#### sdkconfig@h5sdkconfig
+#### sdkconfig@h5sdkconfig
-三方SDK配置。三方SDK的使用需要向这些SDK提供商申请，并配置参数到此处。可在HBuilderX可视化界面（H5 配置）输入配置。
+三方SDK配置。三方SDK的使用需要向这些SDK提供商申请，并配置参数到此处。可在HBuilderX可视化界面（H5 配置）输入配置。
-|属性|类型|描述|
-|:-|:-|:-|
+|属性|类型|描述|
-|maps|Object|地图或位置相关SDK|
+|:-|:-|:-|
+|maps|Object|地图或位置相关SDK|
-#### maps@h5sdkconfigmaps
+#### maps@h5sdkconfigmaps
-地图服务商 SDK 配置，使用地图以及位置（IP 定位及坐标转换）需要配置此项。
+地图服务商 SDK 配置，使用地图以及位置（IP 定位及坐标转换）需要配置此项。
-**示例**
+**示例**
-```json
-"h5": {
+```json
-	"sdkConfigs": {
+"h5": {
-		// 使用地图或位置相关功能必须填写其一
+	"sdkConfigs": {
-		"maps": {
+		// 使用地图或位置相关功能必须填写其一
-            "qqmap": {
+		"maps": {
-                // 腾讯地图秘钥 https://lbs.qq.com/dev/console/key/manage
+            "qqmap": {
-                "key": ""
+                // 腾讯地图秘钥 https://lbs.qq.com/dev/console/key/manage
-            },
+                "key": ""
-            "google": {
+            },
-                // 谷歌地图秘钥（HBuilderX 3.2.10+）https://developers.google.com/maps/documentation/javascript/get-api-key
+            "google": {
-                "key": ""
+                // 谷歌地图秘钥（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
+            "amap": {
-                "key": "",
+                // 谷歌地图秘钥（HBuilderX 3.6.0+）https://console.amap.com/dev/key/app
-                // 谷歌地图安全密钥（HBuilderX 3.6.0+）https://console.amap.com/dev/key/app
+                "key": "",
-                "securityJsCode": "",
+                // 谷歌地图安全密钥（HBuilderX 3.6.0+）https://console.amap.com/dev/key/app
-                // 谷歌地图安全密钥代理服务器地址（HBuilderX 3.6.0+）https://lbs.amap.com/api/jsapi-v2/guide/abc/prepare
+                "securityJsCode": "",
-                "serviceHost": "",
+                // 谷歌地图安全密钥代理服务器地址（HBuilderX 3.6.0+）https://lbs.amap.com/api/jsapi-v2/guide/abc/prepare
-            }
+                "serviceHost": "",
-		}
+            }
-	}
+		}
-}
+	}
-```
+}
+```
-#### optimization
+#### optimization
-|属性|类型|默认值|说明|
-|:-|:-|:-|:-|
+|属性|类型|默认值|说明|
-|prefetch|Boolean|false|资源预取|
+|:-|:-|:-|:-|
-|preload|Boolean|false|资源预加载|
+|prefetch|Boolean|false|资源预取|
-|treeShaking|Object||摇树优化，根据项目需求，动态打包框架所需的组件及API，保持框架代码最精简化，参考[treeShaking](/collocation/manifest?id=treeshaking)|
+|preload|Boolean|false|资源预加载|
+|treeShaking|Object||摇树优化，根据项目需求，动态打包框架所需的组件及API，保持框架代码最精简化，参考[treeShaking](/collocation/manifest?id=treeshaking)|
-##### treeShaking
+##### treeShaking
-|属性|类型|默认值|说明|
-|:-|:-|:-|:-|
+|属性|类型|默认值|说明|
-|enable|Boolean|false|是否启用摇树优化|
+|:-|:-|:-|:-|
+|enable|Boolean|false|是否启用摇树优化|
-**示例：**
-```json
+**示例：**
-"h5": {
+```json
-    "optimization": {
+"h5": {
-        "treeShaking": {
+    "optimization": {
-            "enable": true
+        "treeShaking": {
-        }
+            "enable": true
-    }
+        }
-}
+    }
-```
+}
+```
-Tips：关于摇树优化（treeShaking）原理及优化结果，参考：[https://ask.dcloud.net.cn/article/36279](https://ask.dcloud.net.cn/article/36279)
+Tips：关于摇树优化（treeShaking）原理及优化结果，参考：[https://ask.dcloud.net.cn/article/36279](https://ask.dcloud.net.cn/article/36279)
-### mp-weixin
+### mp-weixin
-|属性|类型|说明|
-|:-|:-|:-|
+|属性|类型|说明|
-|appid|String|微信小程序的AppID，登录 [https://mp.weixin.qq.com](https://mp.weixin.qq.com) 申请|
+|:-|:-|:-|
-|setting|Object|微信小程序项目设置，参考[setting](/collocation/manifest?id=setting)|
+|appid|String|微信小程序的AppID，登录 [https://mp.weixin.qq.com](https://mp.weixin.qq.com) 申请|
-|functionalPages|Boolean|微信小程序是否启用插件功能页，默认关闭|
+|setting|Object|微信小程序项目设置，参考[setting](/collocation/manifest?id=setting)|
-|requiredBackgroundModes|Array|微信小程序需要在后台使用的能力,[详见](https://developers.weixin.qq.com/miniprogram/dev/framework/config.html#requiredbackgroundmodes)|
+|functionalPages|Boolean|微信小程序是否启用插件功能页，默认关闭|
-|plugins|Object|使用到的插件，[详见](https://developers.weixin.qq.com/miniprogram/dev/framework/plugin/using.html)|
+|requiredBackgroundModes|Array|微信小程序需要在后台使用的能力,[详见](https://developers.weixin.qq.com/miniprogram/dev/framework/config.html#requiredbackgroundmodes)|
-|resizable|Boolean|在iPad上小程序是否支持屏幕旋转，默认关闭|
+|plugins|Object|使用到的插件，[详见](https://developers.weixin.qq.com/miniprogram/dev/framework/plugin/using.html)|
-|navigateToMiniProgramAppIdList|Array|需要跳转的小程序列表，[详见](https://developers.weixin.qq.com/miniprogram/dev/api/open-api/miniprogram-navigate/wx.navigateToMiniProgram.html)|
+|resizable|Boolean|在iPad上小程序是否支持屏幕旋转，默认关闭|
-|permission|Object|微信小程序接口权限相关设置，比如申请位置权限必须填此处[详见](https://developers.weixin.qq.com/miniprogram/dev/framework/config.html)|
+|navigateToMiniProgramAppIdList|Array|需要跳转的小程序列表，[详见](https://developers.weixin.qq.com/miniprogram/dev/api/open-api/miniprogram-navigate/wx.navigateToMiniProgram.html)|
-|workers|String|Worker 代码放置的目录。 [详见](https://developers.weixin.qq.com/miniprogram/dev/framework/workers.html)|
+|permission|Object|微信小程序接口权限相关设置，比如申请位置权限必须填此处[详见](https://developers.weixin.qq.com/miniprogram/dev/framework/config.html)|
-|optimization|Object| 对微信小程序的优化配置 |
+|workers|String|Worker 代码放置的目录。 [详见](https://developers.weixin.qq.com/miniprogram/dev/framework/workers.html)|
-|cloudfunctionRoot|String| 配置云开发目录，参考[setting](/collocation/manifest?id=cloudfunctionRoot)|
+|optimization|Object| 对微信小程序的优化配置 |
-|uniStatistics|Object|[微信小程序是否开启 uni 统计，配置方法同全局配置](/collocation/manifest?id=uniStatistics)|
+|cloudfunctionRoot|String| 配置云开发目录，参考[setting](/collocation/manifest?id=cloudfunctionRoot)|
-|scopedSlotsCompiler|String|Vue2 作用域插槽编译模式，uni-app 3.1.19+ 开始支持，可选：legacy、auto、augmented，默认：auto|
+|uniStatistics|Object|[微信小程序是否开启 uni 统计，配置方法同全局配置](/collocation/manifest?id=uniStatistics)|
-|mergeVirtualHostAttributes|Boolean|合并组件[虚拟节点](/tutorial/vue-api.html#%E5%85%B6%E4%BB%96%E9%85%8D%E7%BD%AE)外层属性（目前仅支持 style、class 属性），uni-app 3.5.1+ 开始支持|
+|scopedSlotsCompiler|String|Vue2 作用域插槽编译模式，uni-app 3.1.19+ 开始支持，可选：legacy、auto、augmented，默认：auto|
-|embeddedAppIdList|Array|要半屏跳转的小程序appid。[详见](https://developers.weixin.qq.com/miniprogram/dev/framework/open-ability/openEmbeddedMiniProgram.html)|
+|mergeVirtualHostAttributes|Boolean|合并组件[虚拟节点](/tutorial/vue-api.html#%E5%85%B6%E4%BB%96%E9%85%8D%E7%BD%AE)外层属性（目前仅支持 style、class 属性），uni-app 3.5.1+ 开始支持|
-|requiredPrivateInfos|Array|地理位置相关接口。[详见](https://developers.weixin.qq.com/community/develop/doc/000a02f2c5026891650e7f40351c01)|
+|embeddedAppIdList|Array|要半屏跳转的小程序appid。[详见](https://developers.weixin.qq.com/miniprogram/dev/framework/open-ability/openEmbeddedMiniProgram.html)|
-|lazyCodeLoading|String| 目前仅支持值 requiredComponents，代表开启小程序[按需注入](https://developers.weixin.qq.com/miniprogram/dev/framework/ability/lazyload.html#%E6%8C%89%E9%9C%80%E6%B3%A8%E5%85%A5)特性，[详见](https://developers.weixin.qq.com/miniprogram/dev/reference/configuration/app.html#lazyCodeLoading)|
+|requiredPrivateInfos|Array|地理位置相关接口。[详见](https://developers.weixin.qq.com/community/develop/doc/000a02f2c5026891650e7f40351c01)|
+|lazyCodeLoading|String| 目前仅支持值 requiredComponents，代表开启小程序[按需注入](https://developers.weixin.qq.com/miniprogram/dev/framework/ability/lazyload.html#%E6%8C%89%E9%9C%80%E6%B3%A8%E5%85%A5)特性，[详见](https://developers.weixin.qq.com/miniprogram/dev/reference/configuration/app.html#lazyCodeLoading)|
-#### setting
+#### setting
-编译到微信小程序平台下的项目设置。
+编译到微信小程序平台下的项目设置。
-|属性|类型|说明|
-|:-|:-|:-|
+|属性|类型|说明|
-|urlCheck|Boolean|是否检查安全域名和 TLS 版本|
+|:-|:-|:-|
-|es6|Boolean|ES6 转 ES5|
+|urlCheck|Boolean|是否检查安全域名和 TLS 版本|
-|postcss|Boolean|上传代码时样式是否自动补全|
+|es6|Boolean|ES6 转 ES5|
-|minified|Boolean|上传代码时是否自动压缩|
+|postcss|Boolean|上传代码时样式是否自动补全|
-|bigPackageSizeSupport|Boolean|预览及真机调试时包体积上限是否调整为4M，默认为true（HBuilderX 3.5.5+）。|
+|minified|Boolean|上传代码时是否自动压缩|
+|bigPackageSizeSupport|Boolean|预览及真机调试时包体积上限是否调整为4M，默认为true（HBuilderX 3.5.5+）。|
-#### optimization
+#### optimization
-对微信小程序的优化配置
+对微信小程序的优化配置
-|属性|类型|说明|
-|:-|:-|:-|
+|属性|类型|说明|
-|subPackages|Boolean|是否开启分包优化|
+|:-|:-|:-|
+|subPackages|Boolean|是否开启分包优化|
-#### cloudfunctionRoot
+#### cloudfunctionRoot
-如果需要使用微信小程序的云开发，需要在 mp-weixin 配置云开发目录
+如果需要使用微信小程序的云开发，需要在 mp-weixin 配置云开发目录
-```javascript
-"mp-weixin":{
+```javascript
-  // ...
+"mp-weixin":{
-   "cloudfunctionRoot": "cloudfunctions/", // 配置云开发目录
+  // ...
-  // ...
+   "cloudfunctionRoot": "cloudfunctions/", // 配置云开发目录
-}
+  // ...
-```
+}
+```
-配置目录之后，需要在项目根目录新建 `vue.config.js` 配置对应的文件编译规则
+配置目录之后，需要在项目根目录新建 `vue.config.js` 配置对应的文件编译规则
-```javascript
+```javascript
-{
+{
- plugins: [
-     new CopyWebpackPlugin([
+ 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'),
+         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
+### mp-alipay
-|属性								|类型		|说明			|
-|:-								|:-			|:-			|
+|属性								|类型		|说明			|
-|plugins							|Object	|使用到的插件，[详见](https://opendocs.alipay.com/mini/plugin/plugin-usage)	|
+|:-								|:-			|:-			|
-|component2						|Boolean| 是否启用 `component2` 编译，默认为true，[查看详情](https://docs.alipay.com/mini/framework/custom-component-overview)	|
+|plugins							|Object	|使用到的插件，[详见](https://opendocs.alipay.com/mini/plugin/plugin-usage)	|
-|enableAppxNg         |Boolean| 是否启用 `enableAppxNg` 小程序基础库 2.x 构建，默认为true，[查看详情](https://opendocs.alipay.com/mini/framework/project)，HBuilderX 3.2.10+ |
+|component2						|Boolean| 是否启用 `component2` 编译，默认为true，[查看详情](https://docs.alipay.com/mini/framework/custom-component-overview)	|
-|axmlStrictCheck			|Boolean| 是否启用 `axml` 严格语法检查，默认为false	|
+|enableAppxNg         |Boolean| 是否启用 `enableAppxNg` 小程序基础库 2.x 构建，默认为true，[查看详情](https://opendocs.alipay.com/mini/framework/project)，HBuilderX 3.2.10+ |
-|enableParallelLoader	|Boolean| 是否启用多进程编译，默认为false	|
+|axmlStrictCheck			|Boolean| 是否启用 `axml` 严格语法检查，默认为false	|
-|enableDistFileMinify	|Boolean| 是否压缩编译产物（仅在真机预览/真机调试时生效），默认为false	|
+|enableParallelLoader	|Boolean| 是否启用多进程编译，默认为false	|
-|uniStatistics				|Object	|[支付宝小程序是否开启 uni 统计，配置方法同全局配置](/collocation/manifest?id=uniStatistics)|
+|enableDistFileMinify	|Boolean| 是否压缩编译产物（仅在真机预览/真机调试时生效），默认为false	|
-|scopedSlotsCompiler|String|Vue2 作用域插槽编译模式，uni-app 3.1.19+ 开始支持，可选：legacy、auto、augmented，默认：auto|
+|uniStatistics				|Object	|[支付宝小程序是否开启 uni 统计，配置方法同全局配置](/collocation/manifest?id=uniStatistics)|
-|mergeVirtualHostAttributes|Boolean|合并组件节点外层属性（目前仅支持 style、class 属性），uni-app 3.5.1+ 开始支持|
+|scopedSlotsCompiler|String|Vue2 作用域插槽编译模式，uni-app 3.1.19+ 开始支持，可选：legacy、auto、augmented，默认：auto|
-|lazyCodeLoading|String|是否开启代码按需执行。|
+|mergeVirtualHostAttributes|Boolean|合并组件节点外层属性（目前仅支持 style、class 属性），uni-app 3.5.1+ 开始支持|
+|lazyCodeLoading|String|是否开启代码按需执行。|
-### mp-baidu
+### mp-baidu
-|属性|类型|说明|
-|:-|:-|:-|
+|属性|类型|说明|
-|appid|String|百度小程序的 AppID，登录 [https://smartprogram.baidu.com/docs/introduction/enter_application/](https://smartprogram.baidu.com/docs/introduction/enter_application/) 申请|
+|:-|:-|:-|
-|requiredBackgroundModes|Array|小程序需要在后台使用的能力，目前支持背景音频播放，"requiredBackgroundModes": ["audio"]，[详见](https://smartprogram.baidu.com/docs/develop/tutorial/process/#requiredBackgroundModes)	|
+|appid|String|百度小程序的 AppID，登录 [https://smartprogram.baidu.com/docs/introduction/enter_application/](https://smartprogram.baidu.com/docs/introduction/enter_application/) 申请|
-|prefetches|Array|预请求的所有url的列表，[详见](https://smartprogram.baidu.com/docs/develop/tutorial/process/#prefetches)																|
+|requiredBackgroundModes|Array|小程序需要在后台使用的能力，目前支持背景音频播放，"requiredBackgroundModes": ["audio"]，[详见](https://smartprogram.baidu.com/docs/develop/tutorial/process/#requiredBackgroundModes)	|
-|optimization|Object| 对百度小程序的优化配置 |
+|prefetches|Array|预请求的所有url的列表，[详见](https://smartprogram.baidu.com/docs/develop/tutorial/process/#prefetches)																|
-|uniStatistics|Object|[百度小程序是否开启 uni 统计，配置方法同全局配置](/collocation/manifest?id=uniStatistics)|
+|optimization|Object| 对百度小程序的优化配置 |
-|scopedSlotsCompiler|String|Vue2 作用域插槽编译模式，uni-app 3.1.19+ 开始支持，可选：legacy、auto、augmented，默认：auto|
+|uniStatistics|Object|[百度小程序是否开启 uni 统计，配置方法同全局配置](/collocation/manifest?id=uniStatistics)|
-|dynamicLib|Object|引入动态库，详情请参考[使用动态库](https://smartprogram.baidu.com/docs/develop/framework/dynamiclib_use/)|
+|scopedSlotsCompiler|String|Vue2 作用域插槽编译模式，uni-app 3.1.19+ 开始支持，可选：legacy、auto、augmented，默认：auto|
+|dynamicLib|Object|引入动态库，详情请参考[使用动态库](https://smartprogram.baidu.com/docs/develop/framework/dynamiclib_use/)|
-#### optimization
+#### optimization
-对百度小程序的优化配置
+对百度小程序的优化配置
-|属性|类型|说明|
-|:-|:-|:-|
+|属性|类型|说明|
-|subPackages|Boolean|是否开启分包优化|
+|:-|:-|:-|
+|subPackages|Boolean|是否开启分包优化|
-### mp-toutiao
+### mp-toutiao
-|属性|类型|说明|
-|:-|:-|:-|
+|属性|类型|说明|
-|appid|String|字节跳动小程序的 AppID，登录 [https://developer.toutiao.com/](https://developer.toutiao.com/) 申请|
+|:-|:-|:-|
-|setting|Object|字节跳动小程序项目设置，参考[字节跳动小程序项目设置](/collocation/manifest?id=mp-toutiao-setting)|
+|appid|String|字节跳动小程序的 AppID，登录 [https://developer.toutiao.com/](https://developer.toutiao.com/) 申请|
-|navigateToMiniProgramAppIdList	|Array|需要跳转的小程序列表，[详见](https://developer.toutiao.com/dev/cn/mini-app/develop/framework/basic-reference/general-configuration)	|
+|setting|Object|字节跳动小程序项目设置，参考[字节跳动小程序项目设置](/collocation/manifest?id=mp-toutiao-setting)|
-|uniStatistics|Object|[字节跳动小程序是否开启 uni 统计，配置方法同全局配置](/collocation/manifest?id=uniStatistics)|
+|navigateToMiniProgramAppIdList	|Array|需要跳转的小程序列表，[详见](https://developer.toutiao.com/dev/cn/mini-app/develop/framework/basic-reference/general-configuration)	|
-|scopedSlotsCompiler|String|Vue2 作用域插槽编译模式，uni-app 3.1.19+ 开始支持，可选：legacy、auto、augmented，默认：auto|
+|uniStatistics|Object|[字节跳动小程序是否开启 uni 统计，配置方法同全局配置](/collocation/manifest?id=uniStatistics)|
+|scopedSlotsCompiler|String|Vue2 作用域插槽编译模式，uni-app 3.1.19+ 开始支持，可选：legacy、auto、augmented，默认：auto|
-#### 字节跳动小程序项目设置@mp-toutiao-setting
+#### 字节跳动小程序项目设置@mp-toutiao-setting
-|属性|类型|说明|
-|:-|:-|:-|
+|属性|类型|说明|
-|urlCheck|Boolean|是否检查安全域名和 TLS 版本|
+|:-|:-|:-|
-|es6|Boolean|ES6 转 ES5|
+|urlCheck|Boolean|是否检查安全域名和 TLS 版本|
-|postcss|Boolean|上传代码时样式是否自动补全|
+|es6|Boolean|ES6 转 ES5|
-|minified|Boolean|上传代码时是否自动压缩|
+|postcss|Boolean|上传代码时样式是否自动补全|
+|minified|Boolean|上传代码时是否自动压缩|
-### mp-lark
+### mp-lark
-|属性|类型|说明|
-|:-|:-|:-|
+|属性|类型|说明|
-|appid|String|飞书小程序的 AppID，登录 [https://open.feishu.cn](https://open.feishu.cn) 申请|
+|:-|:-|:-|
-|setting|Object|飞书小程序项目设置，参考[飞书小程序项目设置](/collocation/manifest?id=mp-lark-setting)|
+|appid|String|飞书小程序的 AppID，登录 [https://open.feishu.cn](https://open.feishu.cn) 申请|
-|uniStatistics|Object|[飞书小程序是否开启 uni 统计，配置方法同全局配置](/collocation/manifest?id=uniStatistics)|
+|setting|Object|飞书小程序项目设置，参考[飞书小程序项目设置](/collocation/manifest?id=mp-lark-setting)|
-|scopedSlotsCompiler|String|Vue2 作用域插槽编译模式，uni-app 3.1.19+ 开始支持，可选：legacy、auto、augmented，默认：auto|
+|uniStatistics|Object|[飞书小程序是否开启 uni 统计，配置方法同全局配置](/collocation/manifest?id=uniStatistics)|
+|scopedSlotsCompiler|String|Vue2 作用域插槽编译模式，uni-app 3.1.19+ 开始支持，可选：legacy、auto、augmented，默认：auto|
-#### 飞书小程序项目设置@mp-lark-setting
+#### 飞书小程序项目设置@mp-lark-setting
-|属性|类型|说明|
-|:-|:-|:-|
+|属性|类型|说明|
-|urlCheck|Boolean|是否检查安全域名和 TLS 版本|
+|:-|:-|:-|
-|es6|Boolean|ES6 转 ES5|
+|urlCheck|Boolean|是否检查安全域名和 TLS 版本|
-|postcss|Boolean|上传代码时样式是否自动补全|
+|es6|Boolean|ES6 转 ES5|
-|minified|Boolean|上传代码时是否自动压缩|
+|postcss|Boolean|上传代码时样式是否自动补全|
+|minified|Boolean|上传代码时是否自动压缩|
-### mp-qq
+### mp-qq
-|属性							|类型			|说明																																												|
-|:-								|:-				|:-																																													|
+|属性							|类型			|说明																																												|
-|appid							|String			|qq 小程序的 AppID，登录 [https://q.qq.com](https://q.qq.com) 申请																													|
+|:-								|:-				|:-																																													|
-|requiredBackgroundModes		|Array			|小程序需要在后台使用的能力，目前支持背景音频播放，"requiredBackgroundModes": ["audio"]，[详见](https://q.qq.com/wiki/develop/miniprogram/frame/dispose.html#requiredbackgroundmodes)	|
+|appid							|String			|qq 小程序的 AppID，登录 [https://q.qq.com](https://q.qq.com) 申请																													|
-|navigateToMiniProgramAppIdList	|Array			|需要跳转的小程序列表，[详见](https://q.qq.com/wiki/develop/miniprogram/frame/dispose.html#navigatetominiprogramappidlist)																|
+|requiredBackgroundModes		|Array			|小程序需要在后台使用的能力，目前支持背景音频播放，"requiredBackgroundModes": ["audio"]，[详见](https://q.qq.com/wiki/develop/miniprogram/frame/dispose.html#requiredbackgroundmodes)	|
-|permission						|Object			|小程序接口权限相关设置，比如申请位置权限必须填此处[详见](https://q.qq.com/wiki/develop/miniprogram/frame/dispose.html#permission)														|
+|navigateToMiniProgramAppIdList	|Array			|需要跳转的小程序列表，[详见](https://q.qq.com/wiki/develop/miniprogram/frame/dispose.html#navigatetominiprogramappidlist)																|
-|workers						|String			|Worker 代码放置的目录。 [详见](https://q.qq.com/wiki/develop/miniprogram/frame/dispose.html#workers)																					|
+|permission						|Object			|小程序接口权限相关设置，比如申请位置权限必须填此处[详见](https://q.qq.com/wiki/develop/miniprogram/frame/dispose.html#permission)														|
-|groupIdList					|String Array	|需要打开群资料卡的群号列表，详见button的open-type																																		|
+|workers						|String			|Worker 代码放置的目录。 [详见](https://q.qq.com/wiki/develop/miniprogram/frame/dispose.html#workers)																					|
-|optimization|Object| 对QQ小程序的优化配置 |
+|groupIdList					|String Array	|需要打开群资料卡的群号列表，详见button的open-type																																		|
-|uniStatistics|Object|[QQ小程序是否开启 uni 统计，配置方法同全局配置](/collocation/manifest?id=uniStatistics)|
+|optimization|Object| 对QQ小程序的优化配置 |
-|scopedSlotsCompiler|String|Vue2 作用域插槽编译模式，uni-app 3.1.19+ 开始支持，可选：legacy、auto、augmented，默认：auto|
+|uniStatistics|Object|[QQ小程序是否开启 uni 统计，配置方法同全局配置](/collocation/manifest?id=uniStatistics)|
+|scopedSlotsCompiler|String|Vue2 作用域插槽编译模式，uni-app 3.1.19+ 开始支持，可选：legacy、auto、augmented，默认：auto|
-#### optimization
+#### optimization
-对QQ小程序的优化配置
+对QQ小程序的优化配置
-|属性|类型|说明|
-|:-|:-|:-|
+|属性|类型|说明|
-|subPackages|Boolean|是否开启分包优化|
+|:-|:-|:-|
+|subPackages|Boolean|是否开启分包优化|
-### mp-kuaishou
+### mp-kuaishou
-|属性|类型|说明|
-|:-|:-|:-|
+|属性|类型|说明|
-|appid|String|快手小程序的 AppID，登录 [https://mp.kuaishou.com](https://mp.kuaishou.com) 申请|
+|:-|:-|:-|
-|uniStatistics|Object|[快手小程序是否开启 uni 统计，配置方法同全局配置](/collocation/manifest?id=uniStatistics)|
+|appid|String|快手小程序的 AppID，登录 [https://mp.kuaishou.com](https://mp.kuaishou.com) 申请|
-|scopedSlotsCompiler|String|Vue2 作用域插槽编译模式，uni-app 3.1.19+ 开始支持，可选：legacy、auto、augmented，默认：augmented|
+|uniStatistics|Object|[快手小程序是否开启 uni 统计，配置方法同全局配置](/collocation/manifest?id=uniStatistics)|
+|scopedSlotsCompiler|String|Vue2 作用域插槽编译模式，uni-app 3.1.19+ 开始支持，可选：legacy、auto、augmented，默认：augmented|
-### 关于分包优化的说明
+### 关于分包优化的说明
- 在对应平台的配置下添加`"optimization":{"subPackages":true}`开启分包优化
- 目前只支持`mp-weixin`、`mp-qq`、`mp-baidu`、`mp-toutiao`的分包优化
+- 在对应平台的配置下添加`"optimization":{"subPackages":true}`开启分包优化
- 分包优化具体逻辑：
+- 目前只支持`mp-weixin`、`mp-qq`、`mp-baidu`、`mp-toutiao`的分包优化
-  + 静态文件：分包下支持 static 等静态资源拷贝，即分包目录内放置的静态资源不会被打包到主包中，也不可在主包中使用
+- 分包优化具体逻辑：
-  + js文件：当某个 js 仅被一个分包引用时，该 js 会被打包到该分包内，否则仍打到主包（即被主包引用，或被超过 1 个分包引用）
+  + 静态文件：分包下支持 static 等静态资源拷贝，即分包目录内放置的静态资源不会被打包到主包中，也不可在主包中使用
-  + 自定义组件：若某个自定义组件仅被一个分包引用时，且未放入到分包内，编译时会输出提示信息
+  + js文件：当某个 js 仅被一个分包引用时，该 js 会被打包到该分包内，否则仍打到主包（即被主包引用，或被超过 1 个分包引用）
+  + 自定义组件：若某个自定义组件仅被一个分包引用时，且未放入到分包内，编译时会输出提示信息
-**分包内静态文件示例**
+**分包内静态文件示例**
-```json
-"subPackages": [{
+```json
-	"root": "pages/sub",
+"subPackages": [{
-	"pages": [{
+	"root": "pages/sub",
-		"path": "index/index"
+	"pages": [{
-	}]
+		"path": "index/index"
-}]
+	}]
-```
+}]
+```
-以上面的分包为例，放在每个分包root对应目录下的静态文件会被打包到此分包内。
+以上面的分包为例，放在每个分包root对应目录下的静态文件会被打包到此分包内。
-### 快应用@quickapp-webview
+### 快应用@quickapp-webview
-|属性							 |类型			|说明|
-|:-								 |:-			|:-|
+|属性							 |类型			|说明|
-|icon							 |String	|应用图标，华为推荐 192x192|
+|:-								 |:-			|:-|
-|package					 |String	|应用包名|
+|icon							 |String	|应用图标，华为推荐 192x192|
-|minPlatformVersion|Number	|最小平台运行支持(华为最低 1070，vivo 1063)|
+|package					 |String	|应用包名|
-|versionName			 |String	|版本名称|
+|minPlatformVersion|Number	|最小平台运行支持(华为最低 1070，vivo 1063)|
-|versionCode			 |Number	|版本号|
+|versionName			 |String	|版本名称|
+|versionCode			 |Number	|版本号|
-**manifest.json配置**
-```json
+**manifest.json配置**
-"quickapp-webview": {// 快应用通用配置
+```json
-  "icon": "/static/logo.png",
+"quickapp-webview": {// 快应用通用配置
-  "package": "com.example.demo",
+  "icon": "/static/logo.png",
-  "versionName": "1.0.0",
+  "package": "com.example.demo",
-  "versionCode": 100
+  "versionName": "1.0.0",
-},
+  "versionCode": 100
-"quickapp-webview-union": {// 快应用联盟，目前仅支持 vivo、oppo
+},
-  "minPlatformVersion": 1063 //最小平台支持
+"quickapp-webview-union": {// 快应用联盟，目前仅支持 vivo、oppo
-},
+  "minPlatformVersion": 1063 //最小平台支持
-"quickapp-webview-huawei": {// 快应用华为
+},
-  "minPlatformVersion": 1070 //最小平台支持
+"quickapp-webview-huawei": {// 快应用华为
-}
+  "minPlatformVersion": 1070 //最小平台支持
-```
+}
+```
-### FAQ
-Q：iOS 应用调用相机等权限时，弹出的提示语如何修改？
+### FAQ
-A：在 manifest.json 可视化界面-App模块权限配置-iOS隐私信息访问的许可描述
+Q：iOS 应用调用相机等权限时，弹出的提示语如何修改？
+A：在 manifest.json 可视化界面-App模块权限配置-iOS隐私信息访问的许可描述