2020年之HBuilderX manifest.json配置最全详解
转自 duanshuilu.com
以下是HBuilderX manifest.json配置说明大全,涉及的较全面,如果不方便查看;
可以直接 Ctrl+ F 在页面查找相应字段配置。
概述
manifest.json文件是5+移动App的配置文件,用于指定应用的显示名称、图标、入口页面等信息。用户可通过HBuilder|HBuilderX的可视化界面视图进行配置,也可在源码视图中根据以下规范直接修改。
manifest.json文件根据w3c的webapp规范制定,plus节点下内容为HTML5 Plus扩展规范,其下包括iOS和Android子节点,内容来源分别为iOS和Android原生打包所要求的参数,用于对5+移动App打包为ipa或apk安装包进行配置。
manifest.json
以下是完整的manifest.json配置文件,在HBuilder|HBuilderX中切换到“源码视图”按以下规范进行手动配置。
{ "id": "H512345", //必填 "name": "应用名称", //必填 "version": { "name": "1.0", //必填,推荐使用.分割,如1.0 "code": "10" //必填,纯数字 }, "launch_path": "入口页面", //必填 "description": "应用描述信息", //可选 "icons": { //可选,以分辨率为索引键名 "72": "图标路径" }, "developer": { //选填,开发者信息 "name": "开发者名称", "email": "开发者邮箱地址", "url": "开发者网站" }, "screenOrientation": [ //应用支持的屏幕方向 "portrait-primary", //竖屏 "portrait-secondary", //竖屏(反向),上下颠倒 "landscape-primary", //横屏,Home键在右侧 "landscape-secondary" //横屏(反向),Home键在左侧 ], "permissions": { //5+模块,uni-app项目对应节点为"app-plus" -> "modules" "Accelerometer": { "description": "加速度传感器" } }, "plus": { // 5+扩展配置, uni-app项目对应节点为"app-plus" "allowsInlineMediaPlayback":"true|false", //可选,是否允许video标签非全屏播放 "appWhitelist": [ //可选,应用白名单列表(Android平台为apk下载地址,iOS平台为appstore地址) ], "arguments": "", //可选,预设应用的启动参数 "cache": { //可选,缓存配置 }, "cers": { //可选,异常错误反馈配置 }, "channel": "", //可选,渠道信息 "confusion": { //可选,原生js文件混淆配置 }, "distribute": { //必选,云端打包配置 }, "error": { //可选,错误页面配置 }, "locales": { //可选,国际化配置 } "nativePlugins": { //可选,原生插件相关配置 }, "popGesture": "none|close|hide", //可选,侧滑返回功能配置 "kernel": { //可选,Webview渲染内核配置 }, "runmode": "normal|liberate", //可选,运行模式 "safearea": { //可选,安全区域配置 }, "schemeWhitelist":[ //可选,Scheme白名单列表 ], "splashscreen": { //可选,splash界面配置 }, "ssl": { //可选,SSL配置 }, "softinput": { //可选,软键盘配置 }, "statusbar": { //可选,系统状态栏配置 }, "useragent": { //可选,UA配置 }, "launchwebview": { //可选,应用首页配置 }, "secondwebview": { //可选,应用双首页配置 }, "uni-app": { //可选,uni-app应用的配置 }, "compatible": { //可选,编译器兼容性配置 }, "wap2app": { //可选,wap2app相关配置 }, }
}
id
应用标识(AppID),在可视化“基础配置”项中。
name
应用名称,打包为apk/ipa安装到手机上显示的名称。
version
应用版本信息,包括版本名称和版本号。
- name
版本名称,字符串类型,用于显示的版本字符串。可通过5+API plus.runtime.version获取版本名称。
本地离线打包配置:Android平台,iOS平台。 - code
版本号,数字类型(正整数),操作系统使用,新版本的值要大于老版本,否则无法正常安装。可通过5+API plus.runtime.versionCode获取版本号。
本地离线打包配置:Android平台,iOS平台
launch_path
应用入口页面(首页)地址,相对于应用资源根目录(默认为根目录的index.html)。也可以是网络地址(需以http/https开头)。
description
应用描述信息。
icons
应用的图片配置(暂未使用)。
developer
开发者信息,可选内容。
- name
开发者名称 - email
开发者邮箱地址 - url
开发者网站地址
screenOrientation
应用支持的屏幕方向,字符串数组类型,配置需要支持的方向,可取值:
- portrait-primary
竖屏 - portrait-secondary
竖屏(反向),山下颠倒 - landscape-primary
横屏,Home键在右侧 - landscape-secondary
横屏(反向),Home键在左侧
permissions
要使用的模块配置,不要手动修改,应该在HBuilderX中manifest.json的可视化界面“(App)模块权限配置”项的“打包模块配置”下勾选
支持以下模块:
模块标识 | 模块名称 |
---|---|
Bluetooth | 低功耗蓝牙 |
Contacts | 通讯录 |
Fingerprint | 指纹识别 |
iBeacon | iBeacon |
LivePusher | 直播推流 |
Maps | 地图 |
Messaging | 短彩信、邮件 |
OAuth | 登录鉴权 |
Payment | 支付 |
Push | 消息推送 |
Speech | 语言识别 |
Statistic | 统计 |
SQLite | 数据库 |
VideoPlayer | 视频播放 |
plus
5+扩展配置,uni-app项目对应为”app-plus”节点
allowsInlineMediaPlayback
是否允许html页面中video标签非全屏播放,仅iOS平台有效
Boolean类型,值为true表示允许,false表示不允许,默认值为不允许。
html页面的video标签必须添加webkit-playsinline属性才支持非全屏播放,如下示例:
<video controls="controls" src="http://.../x.mp4" webkit-playsinline>
此配置与VideoPlayer(视频播放)控件功能无关
appWhitelist
应用中可直接安装原生应用的白名单地址(url)。
- Android平台
url地址如果是下载apk的链接,不在此白名单列表中的url下载apk将会被拦截(弹出toast提示“当前环境不支持下载未许可的apk文件”) - iOS平台
url地址如果是跳转到appstore,不在此白名单列表中的url跳转将会被拦截(弹出toast提示“当前环境不支持下载未许可的应用”)"plus": { //uni-app项目对应节点名称为"app-plus" "appWhitelist":[ "http://www.dcloud.io/streamapp/streamapp.apk", "itms://itunes.apple.com/cn/app/liu-ying-yong/id793135951" ], // ... }
以上白名单机制仅在流应用环境中限制,发布为独立App时忽略此配置
arguments
应用启动时的5+默认参数
String类型,可选。
在5+中可通过plus.runtime.arguments获取,如果外部调用应用时传入了参数,则覆盖此默认参数。
cache
应用的缓存配置信息,JSON格式对象
"plus": { //uni-app项目对应节点名称为"app-plus" "cache":{ "mode": "" }, // ... }
mode
Webview窗口默认使用的缓存模式,可取值:
- “default”
根据cache-control决定是否使用缓存数据,如果存在缓存并且没有过期则使用本地缓存资源,否则从网络获取; - “cacheElseNetwork”
只要存在缓存(即使过期)数据则使用,否则从网络获取; - “noCache”
不使用缓存数据,全部从网络获取; - “cacheOnly”
仅使用缓存数据,不从网络获取(注:如果没有缓存数据则会导致加载失败)。
默认为”default”。
cers
应用的异常崩溃与错误报告系统配置信息,JSON格式对象
"plus": { //uni-app项目对应节点名称为"app-plus" "cers":{ "crash": "" }, // ... }
crash
是否提交程序异常崩溃信息。
Boolean类型,true表示提交,false表示不提交,默认值为true。
channel
渠道标记,字符串类型。
"plus": { //uni-app项目对应节点名称为"app-plus" "channel": "google", // ... }
注意:不要直接修改此配置,参考渠道包打包配置教程
confusion
应用的JS文件原生混淆配置
"plus": { //uni-app项目对应节点名称为"app-plus" "confusion": { "description": "JS原生混淆", "resources": { "js/common.js": { }, "js/immersed.js": { } } }, // ... }
- description
原生混淆配置描述信息 - resources
要混淆的JS文件列表,JSON对象,以要混淆的js文件路径(相对路径)为键名,值为空JSON对象即可
注意:confusion节点是在plus节点之下,uni-app项目由于需要编译暂不支持原生混淆
iOS平台使用WKWebview不支持原生混淆,HBuilderX2.2.5(alpha)版本开始调整默认使用WKWebview,使用WKWebview时云端打包将忽略原生混淆配置(即不混淆)
error
定义窗口加载错误时的处理逻辑,JSON格式对象
"plus": { //uni-app项目对应节点名称为"app-plus" "error":{ "url": "本地错误页面地址" }, // ... }
- url
窗口加载错误时(如本地页面不存在,或者无法访问的网络地址)跳转的页面地址,仅支持本地页面地址。设置为“none”则关闭跳转到错误页面功能,此时页面显示Webview默认的错误页面内容。默认使用5+ Runtime内置的错误页。
locales
云端打包国际化配置,JSON格式对象
"plus": { //uni-app项目对应节点名称为"app-plus" "locales":{ "zh": {//中文(简体) "name": "应用名称", "android": { "strings": { //Android平台自定义字符串 } }, "ios": { "privacyDescription": { //iOS平台隐私访问描述信息 }, "infoPlist": { //iOS平台自定义InfoPlist.strings } } }, "zh-TW": {//中文繁体(台湾) }, "zh-HK": {//中文繁体(香港) }, "en": { } }, // ... }
nativePlugins
uni原生插件配置,JSON对象数组
"plus": { //uni-app项目对应节点名称为"app-plus" "nativePlugins": [ { "%PluginID%": { } } ], // ... }
注意:不要直接修改此配置,推荐在HBuilderX的可视化界面中操作
popGesture
应用中Webview窗口侧滑返回功能的默认效果,字符串类型
"plus": { //uni-app项目对应节点名称为"app-plus" "popGesture": "none", // ... }
可取以下值:
- “none”
默认Webview窗口无侧滑返回功能,侧滑时无任何响应 - “close”
默认webview窗口侧滑返回关闭,用户侧滑后窗口自动关闭,关闭窗口的逻辑与调用 close()方法一致。 - “hide”
默认webview窗口侧滑返回隐藏,即用户侧滑后窗口自动隐藏,隐藏窗口的逻辑与调用其hide()方法一致。
默认值为”none”。manifest.json中配置的为默认项, 在应用中可以通过WebviewStyles的popGesture属性动态修改。
注意:Android平台仅在流应用环境下支持侧滑返回。
kernel
Webview窗口使用的内核,JSON格式对象
"plus": { //uni-app项目对应节点名称为"app-plus" "kernel": { "ios": "WKWebview", "recovery": "restart|reload|none" }, // ... }
ios
iOS平台Webview窗口默认使用的内核,可取值:
- “WKWebview”
iOS8.0及以上系统默认使用WKWebview内核 - “UIWebview”
使用UIWebview内核
默认值为UIWebview。
HBuilderX2.2.5(alpha)版本开始调整默认为WKWebview
recovery
Webview内核崩溃后的恢复处理逻辑,仅iOS平台非uni-app项目使用WKWebview内核时生效,uni-app项目可自动恢复(推荐转换为uni-app项目)。
当WKWebview崩溃后,Webview页面的JS上下文将丢失,也无法渲染DOM内容(白屏)
可配置以下值:
- “restart”
重启应用,关闭所有页面重新打开应用首页,可通过(plus.runtime.isRecovery)来判断应用是否恢复重启 - “reload”
重新加载当前WKWebview(崩溃的WKWebview)页面,页面中JS上下文中所有数据丢失,在当前Webview中可通过plus.webview.isRecovery判断是否恢复重新加载,在其它Webview中可监听recovery事件来判断 - “none”
不做任何操作
创建Webview窗口时可设置kernelRecovery属性单独设置某个窗口的恢复处理逻辑
runmode
应用的运行模式,字符串类型
"plus": { //uni-app项目对应节点名称为"app-plus" "runmode": "liberate" // ... }
可取值:
- “normal”
正常运行模式。 - “liberate”
释放资源运行模式,应用在第一次启动时将解压自带资源到SDcard,正常情况不推荐使用该模式。该模式的缺点:第一次启动更慢,耗费时间先解压、容易被三方清理软件清理。该模式有用的场景:此模式下File API才可正常访问_www应用资源,以及在某些Android rom访问本地页面时url地址中包含?带参数,但不推荐使用这种跨页传参方式,推荐使用其他方式跨页传参
注意:wap2app 应用固定为 liberate,不支持自定义。
safearea
iOS刘海屏设备(iPhoneX)的安全区域配置
"plus": { //uni-app项目对应节点名称为"app-plus" "safearea": { "background":"#CCCCCC", "bottom":{ "offset":"auto" }, "left": { "offset":"auto" }, "right: { "offset":"auto" } }, // ... }
background
安全区域外的背景颜色,默认值为”#FFFFFF”
bottom
底部安全区域配置,包括以下属性
- offset
底部安全区域偏移,”none”表示不空出安全区域,”auto”自动计算空出安全区域,默认值为”none”left
左侧安全区域配置(横屏显示时有效),包含的属性与bottom一致。
right
右侧安全区域配置(横屏显示时有效),包含的属性与bottom一致。
schemeWhitelist
配置应用中URL Scheme白名单(非http、https、file),字符串数组
"plus": { //uni-app项目对应节点名称为"app-plus" "schemeWhitelist": [ "streamapp" ], // ... }
仅允许白名单中的scheme跳转,不在白名单中URL Scheme链接将会被拦截(拦截后不做任何处理)。
默认白名单为:
‘sms’, ‘tel’, ‘mailto’, ‘callto’, ‘weixin’, ‘alipay’, ‘alipays’, ‘alipayqr’, ‘weibo’, ‘mqq’, ‘mqqapi’, ‘qqmap’, ‘baidumap’, ‘amap’, ‘iosamap’, ‘streamapp’
iOS默认白名单还包括”itms”等跳转appstore。
splashscreen
程序启动界面配置信息,JSON格式对象
"plus": { //uni-app项目对应节点名称为"app-plus" "splashscreen": { "autoclose": "false", "event": "loaded", "target": "default", "waiting": "true", "delay": "500", "ads": { "background": "#FFFFFF", "image": "logo.png" } }, // ... }
包括以下字段:
- autoclose
是否自动关闭程序启动界面,布尔类型。
默认为true,即自动关闭程序启动界面,否则需要在应用中显式调用plus.navigator.closeSplashscreen方法来关闭。 - event
触发自动关闭splash界面的事件类型,字符串类型,可取值:
“titleUpdate”表示当首页Webview的titleUpdate事件触发时自动关闭splash界面;
“rendering”表示当首页Webview的rendering事件触发时自动关闭splash界面;
“loaded”:表示当首页Webview的loaded事件触发时自动关闭splash界面。
默认值为loaded。 - target
设置双首页模式下,定义目标webview触发event类型自动关闭splash界面,可取值:
“default”根据首页Webview的event事件关闭splash;
“second”:根据第二个首页Webview的event事件关闭splash。
默认值为”default”。 - waiting
是否在程序启动界面显示等待雪花,布尔类型。
默认为false,即不显示等待雪花。 - delay
启动界面在应用的首页面加载完毕后延迟关闭的时间,单位为毫秒,数字类型。
默认不延迟,即首页面加载完毕后立即关闭。 - ads
开屏广告配置信息,JSON格式对象
包括以下属性:
background:设置背景颜色
image:设置底部图片地址,相对应用资源目录路径,不支持网络地址,建议分辨率720×256(要求png格式,背景透明,留出边距,在不同分辨率手机上会自动等比例缩放处理)
ssl
应用ssl相关设置
"plus": { //uni-app项目对应节点名称为"app-plus" "ssl": { "untrustedca": "accept|refuse|warning" }, // ... }
包括以下字段:
- untrustedca
配置应用中https请求时,如果服务器返回非受信证书的处理逻辑,字符串类型,可取值:
“accept” – 接受此非受信证书,继续访问;
“refuse” – 拒绝此非 受信证书,停止访问;
“warning” – 弹出警告提示框提醒用户,由用户确定是否继续访问。
默认值为”accept”。
softinput
软键盘相关配置,JSON格式对象
"plus": { //uni-app项目对应节点名称为"app-plus" "softinput": { "navBar": "auto|none", "auxiliary": true|false, "mode": "adjustResize|adjustPan" }, // ... }
包括以下字段:
- navBar
软键盘上导航条的显示模式,字符串类型(仅iOS平台支持):
“auto” – 表示系统默认值(即显示导航条);
“none” – 表示不显示。
默认值为”auto”。 - auxiliary
是否开启辅助输入功能,Boolean类型
true表示开启,false表示关闭,默认值为true。 - mode
弹出系统软键盘模式,字符串类型,可取值:
“adjustResize” – 表示弹出软键盘时自动调整窗口大小;
“adjustPan” – 表示弹出软键盘时自动移动滚动窗口使得输入框可见(Android平台可能会出现软键盘盖住输入框的情况)。
默认值为”ajustResize”。
iOS平台可通过WebviewStyles的softinputMode属性对单个窗口进行控制
statusbar
应用启动后的系统状态栏样式,JSON格式对象
"plus": { //uni-app项目对应节点名称为"app-plus" "statusbar": { "immersed": "none|suggestedDevice|supportedDevice", "style": "dark|light", "background": "#RRGGBB" }, // ... }
包括以下字段:
- immersed
定义应用是否使用沉浸式状态栏样式,String类型,可取值:
“none” – 非沉浸式状态栏样式;
“suggestedDevice” – 沉浸式状态栏,仅在支持设置状态栏前景色样式的设备上生效(Android5.0的小米&魅族、Android6.0及以上,iOS在所有设备上生效);
“supportedDevice” – 沉浸式状态栏,在所有支持沉浸式状态栏设备上生效(与之前的true一致,Android4.4及以上)。
默认值为”false”。
-style
系统状态栏样式(前景颜色),字符串类型,可取以下值:
“dark” – 深色前景色样式(即状态栏前景文字为黑色),此时background建议设置为浅颜色;
“light” – 浅色前景色样式(即状态栏前景文字为白色),此时background建设设置为深颜色。
可通过plus.navigator.setStatusBarStyle()动态调整。注:Android5.0(小米&魅族)和Android6.0及以上系统支持,iOS7.0及以上系统支持
-background
系统状态栏背景颜色,字符串类型,#RRGGBB格式,颜色值格式为”#RRGGBB”,如”#FF0000″为红色。
默认使用系统样式,通常iOS平台默认为light样式;Android平台默认为dark(各ROM厂商存在差异)。
可通过plus.navigator.setStatusBarBackground()动态调整。
注:仅在immersed属性值设置为false时有效。
useragent(useragent_android/useragent_ios)
应用中http请求的userAgent信息,JSON格式对象
"plus": { //uni-app项目对应节点名称为"app-plus" "useragent": { "value": "要设置的默认userAgent值", "concatenate": "true|false" }, "useragent_android": { "value": "android平台要设置的默认userAgent值", "concatenate": "true|false" }, "useragent_ios": { "value": "ios平台要设置的默认userAgent值", "concatenate": "true|false" }, // ... }
包括以下字段:
- value
自定义userAgent值,字符串类型 - concatenate
是否将value值作为追加值连接到系统默认userAgent值之后,布尔类型:
“true” – 表示追加模式,若value不以空格字符开头,则在其前面自动添加空格字符;
“false” – 表示覆盖模式,即value值作为完整userAgent使用。
默认为false,即覆盖默认userAgent值。
useragent_android和useragent_ios分别配置对Android和iOS平台生效。
注:为了保证运行环境的一致性,建议concatenate设置为true。
launchwebview
应用首页Webview的配置信息,JSON格式对象
"plus": { //uni-app项目对应节点名称为"app-plus" "launchwebview": { "plusrequire": "ahead|normal|later|none", "injection": "true|false", "overrideresource": [{ "match":"区配拦截的资源url地址", "redirect":"拦截资源的重现向地址", "mime":"拦截资源的数据类型", "encoding":"拦截资源的数据编码", "header":"拦截资源的http头数据" }], "overrideurl": { "mode": "allow|reject,拦截模式", "match": "匹配拦截规则", "exclude": "none|redirect,排除拦截理规则" }, "replacewebapi": { "geolocation": "none|alldevice|auto, 重写标准定位API" }, "geolocation": "none|replace|auto, 重写标准定位API", "subNViews": [{ "id": "原生子View控件的标识", "styles": "JSON对象,原生子View控件样式", "tags": "JSON数组对象,原生子View控件上绘制的元素" }], "titleNView": { "backgroundColor": "#RRGGBB, 标题栏背景颜色", "titleText": "标题栏标题文字内容", "titleColor": "#RRGGBB, 标题栏标题文字颜色", "titleSize": "17px,标题字体大小,默认大小为17px", "autoBackButton": "true|false,是否显示标题栏上返回键", "backButton": "JSON对象,标题栏上返回键样式", "buttons": [{ "color": "按钮上的文字颜色", "colorPressed": "按钮按下状态的文字颜色", "float": "按钮在标题栏上的显示位置", "fontWeight": "按钮上文字的粗细", "fontSize": "按钮上文字的大小", "fontSrc": "按钮上文字使用的字体文件路径", "text": "按钮上显示的文字" }], "splitLine": "JSON对象,标题栏底部分割线样式" }, "statusbar": { "background": "#RRGGBB格式字符串,沉浸式状态栏样式下系统状态栏背景颜色" }, "top": "0px|10%,Webview的顶部偏移量", "height": "0px|10%,Webview窗口高度", "bottom": "0px|10%, Webview的底部偏移量,仅在未同时设置top和height属性时生效", "backButtonAutoControl": "none|hide|close,运行环境自动处理返回键的控制逻辑", "additionalHttpHeaders": "JSON数据,额外添加HTTP请求头数据" }, // ... }
包括以下字段:
overrideresource
配置应用首页的拦截资源请求处理逻辑,可包含多条配置项,json支持以下属性:
- match
区配拦截的资源url地址,支持正则表达式,与WebviewOverrideResourceOptions的match属性功能一致; - redirect
拦截资源的重现向地址,仅支持本地资源地址,如”_www”、”_doc”、”_downloads”、”_documents”等开头的路径,与WebviewOverrideResourceOptions的redirect属性功能一致; - mime
拦截资源的数据类型,RFC2045/RFC2046/RFC2047/RFC2048/RFC2049规范中定义的数据类型,与WebviewOverrideResourceOptions的mime属性功能一致; - encoding
拦截资源的数据编码,默认值”UTF-8″,与WebviewOverrideResourceOptions的encoding属性功能一致; - header
拦截资源的http头数据,JSON格式数据,与WebviewOverrideResourceOptions的encoding属性功能一致;
**注:以上配置项与Webview的overrideResourceRequest方法作用一致,配置项可参考规范
overrideurl
配置应用首页的拦截链接请求处理逻辑,支持以下属性:
- mode
拦截模式,可取值:
“allow” – 表示满足match属性定义的条件时不拦截url继续加载,不满足match属性定义的条件时拦截url跳转并触发callback回调;
“reject” – 表示满足match属性定义的提交时拦截url跳转并触发callback回调,不满足match属性定义的条件时不拦截url继续加载;
默认值为”reject”。 - match
匹配拦截规则,支持正则表达式,默认值为对所有URL地址生效(相当于正则表达式“.*”)。
如果mode值为”allow”则允许区配的URL请求跳转,mode值为”reject”则拦截区配的URL请求。 - exclude
排除拦截理规则,可取值:
“none” – 表示不排除任何URL请求(即拦截处理所有URL请求);
“redirect” – 表示排除拦截处理301/302跳转的请求(谨慎使用,非a标签的href触发的URL请求可能会误判断为302跳转);
默认值为”none”。
titleNView
配置应用首页的标题栏,配置此属性则首页显示标题栏,支持以下属性:
- backgroundcolor
标题栏背景颜色,字符串类型,格式为“#RRGGBB”,默认值为灰黑色(#1B1A1F) - titletext
标题栏标题文字内容,默认值为当前加载页面的标题 - titlecolor
标题栏标题文字颜色,字符串类型,格式为“#RRGGBB”,默认值为白色(#FFFFFF)
secondwebview
应用双首页模式配置,添加此字段则表明应用采用双首页模式运行,应用启动除了创建默认入口页外还创建第二个Webview,此字段配置第二个Webview的配置信息,JSON格式对象
"plus": { //uni-app项目对应节点名称为"app-plus" "secondwebview": { "launch_path": "加载页面地址", "id": "Webview窗口标识", "mode": "front|child|behind|parent,Webview显示模式", "top": "0px|10%,Webview的顶部偏移量", "height": "0px|10%,Webview窗口高度", "bottom": "0px|10%, Webview的底部偏移量", "plusrequire": "ahead|normal|later|none,控制JS注入时机", "injection": "true|false,是否提前注入js", "overrideresource": [{ "match":"区配拦截的资源url地址", "redirect":"拦截资源的重现向地址", "mime":"拦截资源的数据类型", "encoding":"拦截资源的数据编码", "header":"拦截资源的http头数据" }], "overrideurl": { "mode": "allow|reject,拦截模式", "match": "匹配拦截规则", "exclude": "none|redirect,排除拦截理规则" }, "replacewebapi": { "geolocation": "none|alldevice|auto, 重写标准定位API" }, "geolocation": "none|replace|auto, 重写标准定位API", "subNViews": [{ "id": "原生子View控件的标识", "styles": "JSON对象,原生子View控件样式", "tags": "JSON数组对象,原生子View控件上绘制的元素" }], "titleNView": { "backgroundColor": "#RRGGBB, 标题栏背景颜色", "titleText": "标题栏标题文字内容", "titleColor": "#RRGGBB, 标题栏标题文字颜色", "titleSize": "17px,标题字体大小,默认大小为17px", "autoBackButton": "true|false,是否显示标题栏上返回键", "backButton": "JSON对象,标题栏上返回键样式", "buttons": [{ "color": "按钮上的文字颜色", "colorPressed": "按钮按下状态的文字颜色", "float": "按钮在标题栏上的显示位置", "fontWeight": "按钮上文字的粗细", "fontSize": "按钮上文字的大小", "fontSrc": "按钮上文字使用的字体文件路径", "text": "按钮上显示的文字" }], "splitLine": "JSON对象,标题栏底部分割线样式" }, "statusbar": { "background": "#RRGGBB格式字符串,沉浸式状态栏样式下系统状态栏背景颜色" }, "backButtonAutoControl": "none|hide|close,运行环境自动处理返回键的控制逻辑", "additionalHttpHeaders": "JSON数据,额外添加HTTP请求头数据" }, // ... }
包括以下字段:
launch_path
第二个Webview窗口加载的页面地址,支持网络地址和本地地址
id
第二个Webview窗口标识,默认值为%APPID%__second
mode
第二个Webview窗口显示模式,可取值:
- child
表示作为launchwebview的子窗口 - front
表示与launchwebview平级并在其前显示 - behind
表示与launchwebview平级并在其后显示
默认值为”front”。
top
第二个Webview窗口的顶部偏移量
可取值像素值或百分比,如”0px”、”10%”。
height”
第二个Webview窗口的高度
可取值像素值或百分比,如”0px”、”50%”。
bottom
第二个Webview窗口的底部偏移量
可取值像素值或百分比,如”0px”、”10%”。
其它属性与launchwebview下一致
uni-app
仅uni-app项目生效
uni-app应用的配置,JSON格式对象
"plus": { //uni-app项目对应节点名称为"app-plus" "uni-app": { "nvue": { "flex-direction": "row|row-reverse|column|column-reverse" } }, // ... }
包括以下字段:
nvue
nvue页面的flex-direction默认值,字符串类型,可取值:
“row”、”row-reverse”、”column”、”column-reverse”
默认值为”row”。
compatible
仅uni-app项目生效
uni-app应用兼容性配置,JSON格式对象
"plus": { //uni-app项目对应节点名称为"app-plus" "compatible": { "ignoreVersion": true, "runtimeVersion": "兼容的uni-app运行环境版本号,多个版本使用,分割", "compilerVersion": "兼容的编译器版本号" }, // ... }
当uni-app运行环境与编译环境不一致时,会弹出可能存在兼容性问题的提示框。
wap2app
wap2app应用配置,JSON格式对象
"plus": { //uni-app项目对应节点名称为"app-plus" "wap2app": { "launchError": "tip|none" }, // ... }
包括以下字段:
launchError
应用首页加载错误处理逻辑,”tip”表示弹出提示框(无法连接服务器,请检查网络设置),”none”表示不处理(跳转到错误页面),默认值为”tip”。
plus->distribute
云端打包配置项,uni-app项目对应为”app-plus” -> “distribute”节点
"plus": { "distribute": { "debug": "true|false,是否开启调试功能", "syncDebug": "true|false, 是否为真机运行基座", "apple": { "appid": "", //iOS包名(Bundle ID) "mobileprovision": "", //iOS打包使用的profile文件 "password": "", //iOS打包使用的证书密码 "p12": "", //iOS打包使用的证书 "devices": "iphone|ipad|universal", //iOS支持的设备类型 "urlschemewhitelist": [ //iOS平台应用访问白名单 "" ], "UIBackgroundModes": ["audio","location"],//iOS应用后台运行模式 "urltypes": [ //iOS平台url scheme配置 ], "frameworks": [ //iOS平台依赖的系统库 "CoreLocation.framework" ], "deploymentTarget": "9.0", //iOS支持的最低版本 "privacyDescription": { //iOS隐私描述 } "idfa":"true|false", //是否使用广告标识符,默认值为false "capabilities": { //应用的能力配置(Capabilities) } }, "google":{ "packagename":"", //Android包名 "keystore":"", //Android签名证书 "password":"", //Android签名证书密码 "aliasname":"", //Android签名证书别名 "locale": "default", //应用的语言,默认值为default(系统语言),如en_US表示使用英语(美国) "schemes":[ //Android平台url scheme配置 ], "theme":"程序使用的主题", "abiFilters":[ //支持的CPU类型 "armeabi", "armeabi-v7a", "x86" ], "custompermissions":"true|false", "permissions":[ //Android平台使用的权限 "" ], "permissionPhoneState": { //Android平台读取设备信息权限配置 "request": "always|once|none", //申请权限策略 "prompt": "" //用户拒绝时弹出提示框上的内容 }, "permissionExternalStorage": { //Android平台读写存储权限配置 "prompt": "" //用户拒绝时弹出提示框上的内容 }, "minSdkVersion":"apk支持的最低版本", //Android平台最低版本 "targetSdkVersion":"apk的目标版本" //Android平台目标版本 }, "icons":{ //应用图标配置 }, "splashscreen":{ //应用启动图片配置 }, "plugins":{ // 第三方sdk配置 } }
}
apple
iOS平台打包配置,uni-app项目对应为”app-plus” -> “distribute” -> “ios”节点
其中appid、mobileprovision、password、p12、devices为iOS打包基础配置,点击HBuilderX菜单的”发行” -> “原生App-云打包”打开的“App云端打包”中配置:
urlschemewhitelist
设置应用访问白名单
UIBackgroundModes
应用后台运行模式配置,如后台播放音乐、后台定位等
urltypes
iOS平台URL Schemes配置
frameworks
设置应用要引用的系统库(framework),字符串数组。
在使用native.js时使用,通知App云端打包在编译应用时引用对于的系统framework库,以便native.js能成功调用其中的API。
如要调用苹果游戏相关API,则需要引用”GameKit.framework”。
"frameworks": [ //iOS平台依赖的系统库 "GameKit.framework" ],
deploymentTarget
设置应用支持的最低版本,可取值:
- iOS8:
‘8.0’, ‘8.1’, ‘8.2’, ‘8.3’, ‘8.4’ - iOS9:
‘9.0’, ‘9.1’, ‘9.2’, ‘9.3’ - iOS10:
‘10.0’, ‘10.1’, ‘10.2’, ‘10.3’ - iOS11:
‘11.0’, ‘11.1’, ‘11.2’, ‘11.3’, ‘11.4’ - iOS12:
‘12.0’, ‘12.1’, ‘12.2’, ‘12.3’, ‘12.4’ - iOS13:
‘13.0’, ‘13.1’
privacyDescription
iOS平台隐私描述,请在HBuilderX的manifest.json可视化界面“(App)模块权限配置”中进行配置。
idfa
iOS平台应用是否使用IDFA(广告标识)
capabilities
iOS平台打包时Capabilities配置,json类型数据,配置应用的capabilities数据(根据XCode规范分别配置到entitlements和plist文件中)
"capabilities": { "entitlements": { // 合并到工程entitlements文件的数据(json格式) }, "plists": { // 合并到工程Info.plist文件的数据(json格式) } },
Android平台打包配置,uni-app项目对应为”app-plus” -> “distribute” -> “android”节点
其中packagename、keystore、password、aliasname为Android打包基础配置,点击HBuilderX菜单的”发行” -> “原生App-云打包”打开的“App云端打包”中设置:
schemes
Android平台URL Schemes配置
theme
Android平台应用要使用的系统主题名称
abiFilters
Android平台配置支持的CPU类型
permissions
Android平台使用到的权限,请在HBuilderX的manifest.json可视化界面“(App)模块权限配置”中的“Android打包权限配置”中勾选。
permissionExternalStorage
HBuilderX2.5.0+版本支持
Android平台应用启动时申请读写手机存储权限配置
支持以下字段
- prompt
当用户拒绝授权读写手机存储权限时弹出提示框上显示的内容。
permissionPhoneState
HBuilderX2.3.8+版本支持
Android平台应用启动时申请读取设备信息权限配置
支持以下字段
- request
申请权限策略,可配置以下值:
“always” – 一直申请读取设备信息权限,用户必须授权允许,否则一直弹出提示框,直到用户允许;
“once” – 申请一次读取设备信息权限,不管用户是否允许
“none” – 不申请读取设备信息权限 - prompt
配置request值为”always”时有效,当用户拒绝授权读取设备信息权限时弹出提示框上显示的内容。
minSdkVersion & targetSdkVersion
minSdkVersion为应用兼容的最低Android版本(API等级)
targetSdkVersion为应用适配的Android版本(API等级)
icons
应用图标配置,json格式数据,分别包含Android和iOS平台的配置项:
"icons":{ "ios":{ "appstore":"必选, 1024x1024, 提交app sotre使用的图标", "iphone":{ "normal": "可选,57x57,iPhone3/3GS程序图标,低于iOS7不再支持", "retina": "可选,114x114,iPhone4程序图标,低于iOS7不再支持", "app@2x[retina7]": "可选,120x120,iOS7+程序图标(iPhone4S/5/6/7/8)", "app@3x[retina8]": "可选,180x180,iOS7+程序图标(iPhone6plus/7plus/8plus/X)", "spotlight-normal": "可选,29x29,iPhone3/3GS Spotlight搜索程序图标,低于iOS7不再支持", "spotlight-retina": "可选,58x58,iOS5/6 Spotlight搜索程序图标(iPhone4S),低于iOS7不再支持", "spotlight@2x[spotlight-retina7]": "可选,80x80,iOS7+ Spotlight搜索图标(iPhone5/6/7/8)", "spotlight@3x[spotlight-retina8]": "可选,120x120,iOS7+ Spotlight搜索图标(iPhone6plus/7plus/8plus/X) "settings-normal": "可选,29x29,iPhone4设置页面程序图标,低于iOS7不再支持", "settings@2x[settings-retina]": "可选,58x58,iOS5+ Settings设置图标(iPhone5/6/7/8)", "settings@3x[settings-retina8]": "可选,87x87,iOS5+ Settings设置图标(iPhone6plus/7plus/8plus/X)", "notification@2x": "可选,40x40,iOS7+ 通知栏图标(iPhone5/6/7/8)", "notification@3x": "可选,60x60,iOS7+ 通知栏图标(iPhone6plus/7plus/8plus/X)" }, "ipad":{ "normal": "可选,72x72,iPad普通屏幕程序图标,低于iOS7不再支持", "retina": "可选,144x144,iPad高分屏程序图标,低于iOS7不再支持", "app[normal7]": "可选,76x76,iOS7+程序图标", "app@2x[retina7]": "可选,152x152,iOS7+程序图标(高分屏)", "proapp@2x": "可选,167x167,iOS9+程序图标(iPad Pro)", "spotlight-normal": "可选,50x50,iPad Spotlight搜索程序图标,低于iOS7不再支持", "spotlight-retina": "可选,100x100,iPad高分屏Spotlight搜索程序图标,低于iOS7不再支持", "spotlight[spotlight-normal7]": "可选,40x40,iOS7+ Spotlight搜索图标", "spotlight@2x[spotlight-retina7]": "可选,80x80,iOS7+ Spotlight搜索图标(高分屏)", "settings[settings-normal]": "可选,29x29,iOS5+ 设置图标", "settings@2x[settings-retina]": "可选,58x58,iOS5+ 设置图标(高分屏)", "notification": "可选,20x20,iOS7+ 通知栏图标", "notification@2x": "可选,40x40,iOS7+ 通知栏图标(高分屏)" } }, "android":{ "ldpi": "可选,48x48", //已废弃 "mdpi": "可选,48x48", //已废弃 "hdpi": "可选,72x72", "xhdpi": "可选,96x96", "xxhdpi": "可选,144x144", "xxxhdpi": "可选,192x192" } },
云端打包时要求所有图标路径都相对于应用下”.manifest”目录。
提交云端打包时需做路径转换,请在HBuilderX的manifest.json可视化界面“(App)图标配置”中操作设置
splashscreen
应用启动图配置,json格式数据,分别包含Android和iOS平台的配置项:
"splashscreen":{ "ios":{ "iphone":{ "default": "可选,320x480,iPhone3(G/GS)启动图片", // portrait480h,兼容老设备,将废弃 "retina35": "可选,640x960,3.5英寸设备(iPhone4/4S)启动图片,支持iPhone4/4S时必选", // portrait480h@2x "retina40": "可选,640x1136,4.0英寸设备(iPhone5/5S)启动图片,支持iPhone5/5S显示时必选", // portrait-568h@2x "retina40l":"可选,1136x640,4.0英寸设备(iPhone5/5S)横屏启动图片,支持iPhone5/5S横屏显示时必选", // landscape-568h@2x "retina47": "可选,750x1334,4.7英寸设备(iPhone6/7/8)启动图片,支持iPhone6/7/8时必选", // portrait-667h@2x "retina47l": "可选,1334x750,4.7英寸设备(iPhone6/7/8)横屏启动图片,支持iPhone6/7/8横屏显示时必选", // landscape-667h@2x "retina55": "可选,1242x2208,5.5英寸设备(iPhone6/7/8Plus)启动图片,支持iPhone6/7/8Plus时必选", // portrait-736h@3x "retina55l": "可选,2208x1242,5.5英寸设备(iPhone6/7/8Plus)横屏启动图片,支持iPhone6/7/8Plus横屏显示时必选", // landscape-736h@3x "iphonex": "可选,1125x2436,5.8英寸设备(iPhoneX/XS)启动图片,支持iPhoneX/XS时必选", // portrait-812h@3x "iphonexl": "可选,2436x1125,5.8英寸设备(iPhoneX/XS)横屏启动图片,支持iPhoneX/XS横屏显示时必选", // landscape-812h@3x "portrait-896h@2x": "可选,828x1792,6.1英寸设备(iPhoneXR)启动图片,支持iPhone XR(iOS12+)时必选", "landscape-896h@2x": "可选,1792x828,6.1英寸设备(iPhoneXR)iPhoneXR横屏启动图片,支持iPhone XR(iOS12+)横屏显示时必选", "portrait-896h@3x": "可选,1242x2688,6.5英寸设备(iPhoneXS Max)启动图片,支持iPhone XS Max(iOS12+)时必选", "landscape-896h@3x": "可选,2688x1242,6.5英寸设备(iPhoneXS Max)横屏启动图片,支持iPhone XS Max(iOS12+)横屏显示时必选" }, "ipad":{ "portrait": "可选,768x1004,iPad竖屏无状态栏启动图片(兼容iOS5/6),仅支持iOS5/6的iPad时必选", //兼容老设备iOS5/6,将废弃 "portrait-retina": "可选,1536x2008,iPad高分屏竖屏无状态栏启动图片(兼容iOS5/6),仅支持iOS5/6的iPad时必选", //兼容老设备iOS5/6,将废弃 "landscape": "可选,1024x748,iPad横屏无状态栏启动图片(兼容iOS5/6),仅支持iOS5/6的iPad时必选", //兼容老设备iOS5/6,将废弃 "landscape-retina": "可选,2048x1496,iPad高分屏横屏启动图片(兼容iOS5/6),仅支持iOS5/6的iPad时必选", //兼容老设备iOS5/6,将废弃 "portrait7": "可选,768x1024,9.7/7.9英寸iPad/mini竖屏启动图片 ,支持iPad/mini(iOS7+)时必选", // portrait-1024h "landscape7": "可选,1024x768,9.7/7.9英寸iPad/mini横屏启动图片,支持iPad/mini(iOS7+)横屏显示时必选", // landscape-1024h "portrait-retina7": "可选,1536x2048,9.7/7.9英寸iPad/mini高分屏竖屏图片,支持iPad/mini(iOS7+)时必选", // portrait-1024h@2x "landscape-retina7": "可选,2048x1536,9.7/7.9英寸iPad/mini高分屏横屏启动图片,支持iPad/mini(iOS7+)横屏显示时必选", // landscape-1024h@2x "portrait-1112h@2x":"可选,1668x2224,10.5英寸iPad Pro竖屏启动图片,支持10.5英寸iPad Pro(iOS8+)时必选", "landscape-1112h@2x":"可选,2224x1668,10.5英寸iPad Pro横屏启动图片,支持10.5英寸iPad Pro(iOS8+)横屏显示时必选", "portrait-1194h@2x":"可选,1668x2388,11英寸iPad Pro竖屏启动图片,支持11英寸iPad Pro(iOS10+)时必选", "landscape-1194h@2x":"可选,2388x1668,11英寸iPad Pro横屏启动图片,支持11英寸iPad Pro(iOS10+)横屏显示时必选", "portrait-1366h@2x":"可选,2048x2732,12.9英寸iPad Pro竖屏启动图片,支持12.9英寸iPad Pro(iOS10+)时必选", "landscape-1366h@2x":"可选,2732x2048,12.9英寸iPad Pro横屏启动图片,支持12.9英寸iPad Pro(iOS10+)横屏显示时必选" } }, "android":{ "ldpi": "必选,320x442,低密度屏幕启动图片", "mdpi": "必选,240x282,中密度屏幕启动图片", "hdpi": "必选,480x762,高密度屏幕启动图片", "xhdpi": "必选,720x1242,720P高密度屏幕启动图片", "xxhdpi": "必选,1080x1882,1080P高密度屏幕启动图片" } },
云端打包时要求所有图标路径都相对于应用下”.manifest”目录。
提交云端打包时需做路径转换,请在HBuilderX的manifest.json可视化界面“(App)启动图配置”中操作设置
plugins
第三方SDK配置,json格式数据
键名为模块名称,如下为“个推”配置数据:
"plugins":{ // 第三方sdk配置 "push": { // 模块名称 "igexin":{ // 个推SDK参数配置 "appid": "pPyZWvH3Fa6PXba10aJ009", // 个推的appid "appkey": "b7dOGlNPHR7pqwUxDhpTi4", // 个推的appkey "appsecret": "IxVYAT9qws8dlNElaTMvg1", // 个推的appsecret "icons": { // 推送图片配置 "push": { // push图标,规格与应用图片一致,不配置则默认使用push图标 "ldpi": "可选,48x48", "mdpi": "可选,48x48", "hdpi": "可选,72x72", "xhdpi": "可选,96x96", "xxhdpi": "可选,144x144", "xxxhdpi": "可选,192x192" }, "small": { // 小图标,png格式图片,仅使用alpha图层 "ldpi": "可选,18*18", "mdpi": "可选,24*24", "hdpi": "可选,36*36", "xhdpi": "可选,48*48", "xxhdpi": "可选,72*72" }, "description": "推送图标" } } } }
请在HBuilderX的manifest.json可视化界面“(App)SDK配置”中操作设置
2020年之HBuilderX manifest.json配置最全详解相关推荐
- vue-cli脚手架配置基础文件详解/新手入门必看
vue-cli 脚手架中webpack 配置基础文件详解 需要Word版本 的小伙伴可以发我邮件2445478193@qq.com 一.前言 vue-cli是构建vue单页应用的脚手架,输入一串指定的 ...
- ureport2 mysql_Ureport2 安装,配置及问题详解
Ureport2 安装,配置及问题详解 本文详细介绍了笔者Ureport2的 安装,配置以及在此过程中遇到的问题和解决方法. 本安装 基于 IDEA+SpringBoot, 存储使用mysql数据库 ...
- 性能测试之JMeter接口关联【JSON提取器】详解
1.JSON提取器介绍 相信做过自动化测试的朋友经常会遇到这样的场景:我想调用系统中的某个业务接口,但是需要先登录系统.也就是现在很多接口的访问,都是需要登录接口的token做为基础. 在JMeter ...
- 微服务 分布式配置中心Apollo详解
微服务 分布式配置中心Apollo详解 1. 配置中心概述 1.1 配置中心简介 1.2 配置中心特点 1.3 配置中心对比 2. Apollo概述 2.1 Apollo简介 2.2 Apollo特点 ...
- Ureport2 安装,配置及问题详解
Ureport2 安装,配置及问题详解 本文详细介绍了笔者Ureport2的 安 ...
- IDEA的安装、配置与使用详解
IDEA的安装.配置与使用详解 目录结构 IDEA的安装.配置与使用详解 一.IDEA介绍 1. Jet Brains公司介绍 2. IDEA介绍 3. IDEA的主要功能介绍 4. IDEA的主要优 ...
- Gitbook详解(四)-配置和说明详解
文章目录 1. 简述 2. 配置概览 3. 配置示例 3.1 基础配置 3.2 structure 结构配置 3.3 variables 变量配置 3.4 links 链接导航 3.5 styles ...
- JetBrains DataGrip工具配置数据库过程详解
JetBrains DataGrip工具配置数据库过程详解 DataGrip是一款数据库管理客户端工具,方便连接到数据库服务器,执行sql.创建表.创建索引以及导出数据等. DataGrip 是 Je ...
- 大型企业网络配置系列课程详解(五) --Frame-Relay配置与相关概念的理解
大型企业网络配置系列课程详解(五) --Frame-Relay配置与相关概念的理解 实验原理: Frame-Relay(帧中继)简称FR,是国际电信联盟通信标准化组(ITU ...
最新文章
- vm_comcat报错 - 数字或值错误 : 字符串缓冲区太小
- 解决svn log显示no author,no date的方法之一
- leetcode136 只出现一次的数字
- go语言和java比_闲话Python, Go, Java
- 红黑树-想说爱你不容易
- pip环境变量配置 python3.6_零基础学python之爬虫第一节环境配置第一章:Python3+Pip环境配置...
- 土地利用转移矩阵--更新中
- TransCAD完整视频教程简介
- 设为首页、加入收藏及保存到桌面的JS代码
- 【抓否】哪来的“独角兽”——360私有化,富士康开飞机上市,宁德时代、药明康德这一系列闪电过会
- 西电计科院Python程序设计随课笔记(李光夏)
- 农场渲染文件服务器搭建,在渲染农场部署Maya to Arnold
- 案例6-1.3 哥尼斯堡的“七桥问题”
- Python Numpy .npy文件打开
- strcmp函数的分析及实现
- VPB和OSGGIS安装
- 专有网VPC---使用
- 我们每天自律、认真学习的最终目的是什么?
- 基于单幅图像的快速去雾算法实现
- CentOS 7阿里云服务器IP地址和MAC地址绑定
热门文章
- VUE(现代库) VS jquery(传统库)
- AML BitCoin在数字货币交易所IDAX上市
- JAVA体育用品在线商城系统-springboot【数据库设计、论文、源码、开题报告】
- 实力亲测 | 如何用云盾WAF做漏洞急救
- 基于python人工智能的最全学习路线总结,思路明朗了学习才高效
- Android商城项目开源
- 在安卓手机搭建kali环境,手机变成便携式渗透神器
- php命名空间非限定名称,PHP命名空间 - osc_nnp3dgfb的个人空间 - OSCHINA - 中文开源技术交流社区...
- 联想xt92耳机测评
- python基础(##16)