目录
manifest.json配置文件说明
云端打包说明
离线打包说明
APP在开发完成之后需要打包发布提供给别人安装使用,那么打包之前,必须要做的一件事就是配置好APP的各项信息。manifest.json文件是5+移动App的配置文件,用于指定应用的显示名称、图标、入口页面等信息。用户可通过HBuilder|HBuilderX的可视化界面视图进行配置,也可在源码视图中根据以下规范直接修改。 manifest.json文件根据w3c的webapp规范制定,plus节点下内容为HTML5 Plus扩展规范,其下包括iOS和Android子节点,内容来源分别为iOS和Android原生打包所要求的参数,用于对5+移动App打包为苹果的ipa或安卓apk安装包进行配置。
下面将分为manifest.json配置文件说明、云端打包说明以及离线打包说明三个板块进行5+app开发打包的讲解。
以下是完整的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+模块 "Accelerometer": { "description": "加速度传感器" } }, "plus": { // 5+扩展配置 "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相关配置 }, } }应用标识(AppID),在可视化“基础配置”项中。
应用名称,打包为apk/ipa安装到手机上显示的名称。
应用版本信息,包括版本名称和版本号。
name 版本名称,字符串类型,用于显示的版本字符串。可通过5+API plus.runtime.version获取版本名称。code 版本号,数字类型(正整数),操作系统使用,新版本的值要大于老版本,否则无法正常安装。可通过5+API plus.runtime.versionCode获取版本号。应用入口页面(首页)地址,相对于应用资源根目录(默认为根目录的index.html)。也可以是网络地址(需以http/https开头)。
应用描述信息。
应用的图片配置。
开发者信息,可选内容。
name 开发者名称email 开发者邮箱地址url 开发者网站地址应用支持的屏幕方向,字符串数组类型,配置需要支持的方向,可取值:
portrait-primary 竖屏portrait-secondary 竖屏(反向),山下颠倒landscape-primary 横屏,Home键在右侧landscape-secondary 横屏(反向),Home键在左侧要使用的模块配置,不要手动修改,应该在HBuilderX中manifest.json的可视化界面“(App)模块权限配置”项的“打包模块配置”下勾选 支持以下模块:
模块标识模块名称Bluetooth低功耗蓝牙Contacts通讯录Fingerprint指纹识别iBeaconiBeaconLivePusher直播推流Maps地图Messaging短彩信、邮件OAuth登录鉴权Payment支付Push消息推送Speech语言识别Statistic统计SQLite数据库VideoPlayer视频播放5+扩展配置
allowsInlineMediaPlayback
是否允许html页面中video标签非全屏播放,仅iOS平台有效 Boolean类型,值为true表示允许,false表示不允许,默认值为不允许。 html页面的video标签必须添加webkit-playsinline属性才支持非全屏播放,如下示例:
复制代码<video controls="controls" src="http://.../x.mp4" webkit-playsinline>此配置与VideoPlayer(视频播放)控件功能无关
appWhitelist
应用中可直接安装原生应用的白名单地址。
Android平台 url地址如果是下载apk的链接,不在此白名单列表中的url下载apk将会被拦截(弹出toast提示“当前环境不支持下载未许可的apk文件”)iOS平台 url地址如果是跳转到appstore,不在此白名单列表中的url跳转将会被拦截(弹出toast提示“当前环境不支持下载未许可的应用”) 复制代码"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": { "cache":{ "mode": "" }, // ... }mode Webview窗口默认使用的缓存模式,可取值:
"default" 根据cache-control决定是否使用缓存数据,如果存在缓存并且没有过期则使用本地缓存资源,否则从网络获取;"cacheElseNetwork" 只要存在缓存(即使过期)数据则使用,否则从网络获取;"noCache" 不使用缓存数据,全部从网络获取;"cacheOnly" 仅使用缓存数据,不从网络获取(注:如果没有缓存数据则会导致加载失败)。默认为"default"。
cers
应用的异常崩溃与错误报告系统配置信息,JSON格式对象
复制代码 "plus": { "cers":{ "crash": "" }, // ... }crash 是否提交程序异常崩溃信息。 Boolean类型,true表示提交,false表示不提交,默认值为true。
channel
渠道标记,字符串类型。
复制代码 "plus": { "channel": "google", // ... }confusion
应用的JS文件原生混淆配置
复制代码 "plus": { "confusion": { "description": "JS原生混淆", "resources": { "js/common.js": { }, "js/immersed.js": { } } }, // ... } description 原生混淆配置描述信息resources 要混淆的JS文件列表,JSON对象,以要混淆的js文件路径(相对路径)为键名,值为空JSON对象即可注意:confusion节点是在plus节点之下,iOS平台使用WKWebview不支持原生混淆,HBuilderX2.2.5(alpha)版本开始调整默认使用WKWebview,使用WKWebview时云端打包将忽略原生混淆配置(即不混淆)
error
定义窗口加载错误时的处理逻辑,JSON格式对象
复制代码 "plus": { "error":{ "url": "本地错误页面地址" }, // ... } url 窗口加载错误时(如本地页面不存在,或者无法访问的网络地址)跳转的页面地址,仅支持本地页面地址。设置为“none”则关闭跳转到错误页面功能,此时页面显示Webview默认的错误页面内容。默认使用5+ Runtime内置的错误页。locales
云端打包国际化配置,JSON格式对象
复制代码 "plus": { "locales":{ "zh": {//中文(简体) "name": "应用名称", "android": { "strings": { //Android平台自定义字符串 } }, "ios": { "privacyDescription": { //iOS平台隐私访问描述信息 }, "infoPlist": { //iOS平台自定义InfoPlist.strings } } }, "zh-TW": {//中文繁体(台湾) }, "zh-HK": {//中文繁体(香港) }, "en": { } }, // ... }nativePlugins
原生插件配置,JSON对象数组
复制代码 "plus": { "nativePlugins": [ { "%PluginID%": { } } ], // ... }注意:不要直接修改此配置,推荐在HBuilderX的可视化界面中操作 使用云端uni原生插件参考:https://ask.dcloud.net.cn/article/35412 使用本地uni原生插件参考:https://ask.dcloud.net.cn/article/35844
popGesture
应用中Webview窗口侧滑返回功能的默认效果,字符串类型
复制代码 "plus": { "popGesture": "none", // ... }可取以下值:
"none" 默认Webview窗口无侧滑返回功能,侧滑时无任何响应"close" 默认webview窗口侧滑返回关闭,用户侧滑后窗口自动关闭,关闭窗口的逻辑与调用 close()方法一致。"hide" 默认webview窗口侧滑返回隐藏,即用户侧滑后窗口自动隐藏,隐藏窗口的逻辑与调用其hide()方法一致。默认值为"none"。manifest.json中配置的为默认项, 在应用中可以通过WebviewStyles的popGesture属性动态修改。注意:Android平台仅在流应用环境下支持侧滑返回。
kernel
Webview窗口使用的内核,JSON格式对象
复制代码 "plus": { "kernel": { "ios": "WKWebview", "recovery": "restart|reload|none" }, // ... }ios
iOS平台Webview窗口默认使用的内核,可取值:
"WKWebview" iOS8.0及以上系统默认使用WKWebview内核"UIWebview" 使用UIWebview内核HBuilderX2.2.5(alpha)版本开始调整默认为WKWebview
recovery
Webview内核崩溃后的恢复处理逻辑,仅iOS平台非uni-app项目使用WKWebview内核时生效。当WKWebview崩溃后,Webview页面的JS上下文将丢失,也无法渲染DOM内容(白屏) 可配置以下值:
"restart" 重启应用,关闭所有页面重新打开应用首页,可通过(plus.runtime.isRecovery)来判断应用是否恢复重启"reload" 重新加载当前WKWebview(崩溃的WKWebview)页面,页面中JS上下文中所有数据丢失,在当前Webview中可通过plus.webview.isRecovery判断是否恢复重新加载,在其它Webview中可监听recovery事件来判断"none" 不做任何操作创建Webview窗口时可设置kernelRecovery属性单独设置某个窗口的恢复处理逻辑
runmode
应用的运行模式,字符串类型
复制代码 "plus": { "runmode": "liberate" // ... }可取值:
"normal" 正常运行(不释放资源)模式,直接使用应用的资源,无法直接使用File API(plus.io.*)访问应用资源。"liberate" 释放资源运行模式,应用在第一次启动时将解压应用私有目录。该模式的缺点:第一次启动更慢,耗费时间先解压。safearea
iOS刘海屏设备(iPhoneX)的安全区域配置
复制代码 "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": { "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": { "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:设置底部图片地址,相对应用资源目录路径,不支持网络地址,建议分辨率720x256(要求png格式,背景透明,留出边距,在不同分辨率手机上会自动等比例缩放处理)ssl
应用ssl相关设置
复制代码 "plus": { "ssl": { "untrustedca": "accept|refuse|warning" }, // ... }包括以下字段:
untrustedca 配置应用中https请求时,如果服务器返回非受信证书的处理逻辑,字符串类型,可取值: "accept" - 接受此非受信证书,继续访问; "refuse" - 拒绝此非受信证书,停止访问; "warning" - 弹出警告提示框提醒用户,由用户确定是否继续访问。 默认值为"accept"。softinput
软键盘相关配置,JSON格式对象
复制代码 "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": { "statusbar": { "immersed": "none|suggestedDevice|supportedDevice", "style": "dark|light", "background": "#RRGGBB" }, // ... }包括以下字段:
immersed 定义应用是否使用沉浸式状态栏样式,String类型,可取值: "none" - 非沉浸式状态栏样式; "suggestedDevice" - 沉浸式状态栏,仅在支持设置状态栏前景色样式的设备上生效(Android5.0的小米&魅族、Android6.0及以上,iOS在所有设备上生效); "supportedDevice" - 沉浸式状态栏,在所有支持沉浸式状态栏设备上生效(与之前的true一致,Android4.4及以上)。 默认值为"none"。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属性值设置为none时有效。useragent(useragent_android/useragent_ios)
应用中http请求的userAgent信息,JSON格式对象
复制代码 "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": { "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": { "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下一致
云端打包配置项
复制代码"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) }, "CFBundleName": "HBuilder" }, "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平台打包配置
其中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格式) } },CFBundleName
iOS平台云打包后生成应用的 bundle name 值。 默认值为"HBuilder",建议设置为英文,不要使用中文。 示例如下:
复制代码 "CFBundleName": "HelloWorld",Android平台打包配置
其中packagename、keystore、password、aliasname为Android打包基础配置,点击HBuilderX菜单的"发行" -> "原生App-云打包"打开的“App云端打包”中设置:
schemes
Android平台URL Schemes配置,更多详情参考
theme
Android平台应用要使用的系统主题名称,更多详情参考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配置”中操作设置
APP开发调试完成之后,需要打包发行,云端打包就比较简单,直接点击发行,选择云打包即可进入下面的页面:
针对安卓打包,根据页面要求完成配置即可,对于证书的选择,有以上三种灵活选择,一般企业APP多半使用自己生成的证书,如果是个人开发可以选择后两者。
针对iOS打包,同样根据页面要求完成配置即可,对于证书的选择,有两种,一般是采用自己申请的证书,而越狱证书可能会导致普通手机没法使用。
点此链接进入安卓和苹果端离校打包说明教程。
