hello mui中的无等待窗体切换是如何实现的
从mui v0.7.0版本开始,hello mui示例App的窗体切换性能大幅提升,点击一个链接,不显示雪花等待框,立即打开一个“正在加载...”的页面,之后真实内容快速填充“正在加载...”区域;本文详细讲解如何实现这种窗体切换效果。
整体思路:
1、预加载一个模板父页面(template.html)和共用子页面;
2、点击列表链接时,直接显示模板父页面,并动态修改模板父页面的标题;
3、共用子页面通过loadURL方法加载对应目标页面;
步骤分解:
list.html页面中预加载模板父页面和共用子页面,为了提高效率,共用子页面默认加载了主列表中的第一项(accordion.html),代码如下:
//预加载模板父页面
var template = mui.preload({
url:'examples/template.html',
id:'demoTemplate',
styles:{
popGesture:"hide"
}
});
//预加载共用子页面
var subWebview = mui.preload({
url:'examples/accordion.html',
id:'template_sub',
styles:{
top: '48px',
bottom: '0px'
}
});
点击列表项时,立即显示模板父页面,改变模板父页面标题,共用子页面加载对应的目标页面,代码如下:
var title = this.innerText;
template.evalJS("with(document.getElementById('title')){innerHTML='" + title + "';className='mui-title mui-fadein';};");
if(subWebview.getURL()==this.href){
subWebview.show();
}else{
subWebview.loadURL(this.href);
}
template.show('slide-in-right', 150);
共用子页面默认隐藏,等加载新内容完毕后,再显示出来,代码如下:
subWebview.addEventListener('loaded', function() {
setTimeout(function(){
subWebview.show();
},50);
});
新页面按下返回按钮后,隐藏模板父页面,并在窗体动画结束后,隐藏共用子页面,代码(App.js)如下:
getTemplateWebview().hide('auto');
setTimeout(function() {
document.getElementById("title").className = 'mui-title mui-fadeout';
getSubWebview().hide("none");
}, 200);
如上方案的优点:
1、模板父页面预加载,点击后立即显示,不用展示雪花等待框,也不会出现白屏现象;
2、共用子页面,有效控制webview数量,避免切页时频繁创建、销毁webview;
从mui v0.7.0版本开始,hello mui示例App的窗体切换性能大幅提升,点击一个链接,不显示雪花等待框,立即打开一个“正在加载...”的页面,之后真实内容快速填充“正在加载...”区域;本文详细讲解如何实现这种窗体切换效果。
整体思路:
1、预加载一个模板父页面(template.html)和共用子页面;
2、点击列表链接时,直接显示模板父页面,并动态修改模板父页面的标题;
3、共用子页面通过loadURL方法加载对应目标页面;
步骤分解:
list.html页面中预加载模板父页面和共用子页面,为了提高效率,共用子页面默认加载了主列表中的第一项(accordion.html),代码如下:
//预加载模板父页面
var template = mui.preload({
url:'examples/template.html',
id:'demoTemplate',
styles:{
popGesture:"hide"
}
});
//预加载共用子页面
var subWebview = mui.preload({
url:'examples/accordion.html',
id:'template_sub',
styles:{
top: '48px',
bottom: '0px'
}
});
点击列表项时,立即显示模板父页面,改变模板父页面标题,共用子页面加载对应的目标页面,代码如下:
var title = this.innerText;
template.evalJS("with(document.getElementById('title')){innerHTML='" + title + "';className='mui-title mui-fadein';};");
if(subWebview.getURL()==this.href){
subWebview.show();
}else{
subWebview.loadURL(this.href);
}
template.show('slide-in-right', 150);
共用子页面默认隐藏,等加载新内容完毕后,再显示出来,代码如下:
subWebview.addEventListener('loaded', function() {
setTimeout(function(){
subWebview.show();
},50);
});
新页面按下返回按钮后,隐藏模板父页面,并在窗体动画结束后,隐藏共用子页面,代码(App.js)如下:
getTemplateWebview().hide('auto');
setTimeout(function() {
document.getElementById("title").className = 'mui-title mui-fadeout';
getSubWebview().hide("none");
}, 200);
如上方案的优点:
1、模板父页面预加载,点击后立即显示,不用展示雪花等待框,也不会出现白屏现象;
2、共用子页面,有效控制webview数量,避免切页时频繁创建、销毁webview;
Android返回键back事件处理兼容性问题,plus.key的监听顺序说明
当前界面只有一个webview时,plus.key的注册时很清晰的。
但当前若有多个webview,或者有父子webview,则需要理清各webview接收key响应的逻辑。
-
隐藏的webview是不会接受到按键事件通知的。
-
Webview嵌套后返回按键事件是按照先子后父的顺序进行分发处理。
顺序分发到某个子Webview对象监听了backbutton事件:plus.key.addEventListener('backbutton',backListener,false);
则终止返回按键事件的分发处理,如果Webview处于隐藏状态则不处理返回事件。
即子webview接收到后,父就不再接收了。
如果业务逻辑操作隐藏了子Webview,事件会正常传递给父Webview。
一般建议统一在父webview注册plus.key的事件,不要在子webview注册。
如果是使用通用js文件默认添加了此事件的监听,则可以通过plus.key.removeEventListener方法取消监听,示例代码如下:
<script type="text/javascript">
function backListener(){
console.log('backbutton');
}
// 开始监听backbutton事件
function startBack(){
plus.key.addEventListener('backbutton',backListener,false);
}
// 取消监听backbutton事件
function stopBack(){
plus.key.removeEventListener('backbutton',backListener);
}
</script>
当前界面只有一个webview时,plus.key的注册时很清晰的。
但当前若有多个webview,或者有父子webview,则需要理清各webview接收key响应的逻辑。
-
隐藏的webview是不会接受到按键事件通知的。
-
Webview嵌套后返回按键事件是按照先子后父的顺序进行分发处理。
顺序分发到某个子Webview对象监听了backbutton事件:plus.key.addEventListener('backbutton',backListener,false);
则终止返回按键事件的分发处理,如果Webview处于隐藏状态则不处理返回事件。
即子webview接收到后,父就不再接收了。
如果业务逻辑操作隐藏了子Webview,事件会正常传递给父Webview。
一般建议统一在父webview注册plus.key的事件,不要在子webview注册。
如果是使用通用js文件默认添加了此事件的监听,则可以通过plus.key.removeEventListener方法取消监听,示例代码如下:
<script type="text/javascript">
function backListener(){
console.log('backbutton');
}
// 开始监听backbutton事件
function startBack(){
plus.key.addEventListener('backbutton',backListener,false);
}
// 取消监听backbutton事件
function stopBack(){
plus.key.removeEventListener('backbutton',backListener);
}
</script>
收起阅读 »
HTML5+ SDK 功能概述
HTML5+ SDK 概述
HTML5 Plus SDK,简称5+SDK,是把HTML5+运行环境(5+ runtime)封装为原生SDK,可作为以下用途:
- 使用5+ SDK实现本地(离线)打包。
- 通过原生开发扩展5+ runtime的能力,uni-app项目推荐开发uni-app原生插件,5+APP项目开发[5+插件]()。
- 在现有原生项目中使用HTML5+ SDK替换原有的webview,以获得更强的web增强表现。
uni-app项目发行为APP时也可以使用5+SDK本地(离线)打包
HTML5+ 本地(离线)打包
HBuilder的云端打包虽然方便,但不能打超过40M的包。通过HTML5+SDK的本地打包方案可以解决打包大小限制的问题。
Android平台:
Android平台本地(离线)打包教程,导入5+SDK中自带的示例工程
Android平台本地(离线)打包教程,创建最简打包工程
Android平台本地(离线)打包,配置开通广告
Android平台本地(离线)打包,常见问题
Android平台uni-app本地(离线)打包注意事项
iOS平台:
离线打包的配置方法可参考文档:
IOS离线打包
安卓离线打包
uni-app离线打包注意事项及配置
开发HTML5+ 功能扩展
开发者可以使用原生语言调用HTML5+ SDK,扩展HTML5+ runtime的功能,并打包成手机应用进行发布。
开发者还可以将开发完成的新功能编译成静态库或者jar包分享给其他开发者,让HTML5+获得更丰富的能力。
开发方法和步骤请参考文档:
IOS平台第三方插件开发指导
Android平台第三方插件开发指导
HTML5+ 集成
开发者可以在现有的项目中集成HTML5+SDK,使自己开发中的项目能够使用HTLM5+扩展功能。
HTML5+集成方式有两种,Widget应用方式集成和Webview方式集成。
如果想在原生应用中启动一个完整的HTML5+ App,应该使用widget方式;
如果只是某个页面的webview想换成HTML5+ runtime的webview,应该使用webview方式。
Widget插件集成方式
如果开发者需要在现有开发中应用的基础上使用HTML5+SDK显示一个手机端的HTML5+ APP,可以使用Widget应用的方式集成HTML5+SDK。
使用Widget集成方式,开发者可快速的实现在手机端管理一个或多个支持HTML5+能力的移动WebAPP。
集成方式可参考文档
Android平台以Widget方式集成HTML5+SDK方法
IOS平台以Widget方式集成HTML5+SDK方法
Webview集成方式
开发者在项目开发的过程中,如需在某些流程下需要显示一个支持HTML5+扩展能力的WebView。开发者可以选择使用Webview的方式集成HTML5+SDK。
使用Webview方式集成HTML5+SDK,可以指定显示本地的HTML页面,也可以指定一个网络地址。开发者可在打开的Webview中调用全部HTML5+ 的JS API。
集成方式可参考文档
Android平台以WebView方式集成HTML5+SDK方法
IOS平台以WebView方式集成HTML5+SDK方法
HTML5+ SDK 概述
HTML5 Plus SDK,简称5+SDK,是把HTML5+运行环境(5+ runtime)封装为原生SDK,可作为以下用途:
- 使用5+ SDK实现本地(离线)打包。
- 通过原生开发扩展5+ runtime的能力,uni-app项目推荐开发uni-app原生插件,5+APP项目开发[5+插件]()。
- 在现有原生项目中使用HTML5+ SDK替换原有的webview,以获得更强的web增强表现。
uni-app项目发行为APP时也可以使用5+SDK本地(离线)打包
HTML5+ 本地(离线)打包
HBuilder的云端打包虽然方便,但不能打超过40M的包。通过HTML5+SDK的本地打包方案可以解决打包大小限制的问题。
Android平台:
Android平台本地(离线)打包教程,导入5+SDK中自带的示例工程
Android平台本地(离线)打包教程,创建最简打包工程
Android平台本地(离线)打包,配置开通广告
Android平台本地(离线)打包,常见问题
Android平台uni-app本地(离线)打包注意事项
iOS平台:
离线打包的配置方法可参考文档:
IOS离线打包
安卓离线打包
uni-app离线打包注意事项及配置
开发HTML5+ 功能扩展
开发者可以使用原生语言调用HTML5+ SDK,扩展HTML5+ runtime的功能,并打包成手机应用进行发布。
开发者还可以将开发完成的新功能编译成静态库或者jar包分享给其他开发者,让HTML5+获得更丰富的能力。
开发方法和步骤请参考文档:
IOS平台第三方插件开发指导
Android平台第三方插件开发指导
HTML5+ 集成
开发者可以在现有的项目中集成HTML5+SDK,使自己开发中的项目能够使用HTLM5+扩展功能。
HTML5+集成方式有两种,Widget应用方式集成和Webview方式集成。
如果想在原生应用中启动一个完整的HTML5+ App,应该使用widget方式;
如果只是某个页面的webview想换成HTML5+ runtime的webview,应该使用webview方式。
Widget插件集成方式
如果开发者需要在现有开发中应用的基础上使用HTML5+SDK显示一个手机端的HTML5+ APP,可以使用Widget应用的方式集成HTML5+SDK。
使用Widget集成方式,开发者可快速的实现在手机端管理一个或多个支持HTML5+能力的移动WebAPP。
集成方式可参考文档
Android平台以Widget方式集成HTML5+SDK方法
IOS平台以Widget方式集成HTML5+SDK方法
Webview集成方式
开发者在项目开发的过程中,如需在某些流程下需要显示一个支持HTML5+扩展能力的WebView。开发者可以选择使用Webview的方式集成HTML5+SDK。
使用Webview方式集成HTML5+SDK,可以指定显示本地的HTML页面,也可以指定一个网络地址。开发者可在打开的Webview中调用全部HTML5+ 的JS API。
集成方式可参考文档
Android平台以WebView方式集成HTML5+SDK方法
IOS平台以WebView方式集成HTML5+SDK方法
HTML 5+ SDK 更新日志
离线SDK下载已迁移到新地址,android 离线SDK下载地址、iOS 离线SDK下载地址
<!--
> 注意:本文SDK对应的是HBuilderX的正式版。alpha版的SDK下载地址另见HTML5+ SDK (alpha版)
> 注意:本SDK适合5+App的离线打包、原生能力扩展,适合uni-app的App端离线打包
> 注意:本SDK不适合uni-app扩展原生能力,如有相关需求,另见文档为uni-app扩展原生插件
> 注意:本SDK不适合原生App中部分栏目使用uni-app的集成方式,此需求应该使用uni小程序sdk,另见文档在原生App中集成uni小程序sdk
Android 平台 HTML5+ SDK 更新日志
2020年04月22日发布
重要:因新版本去掉基础aar中的权限,所以请根据自身需求添加所需权限,权限可参考SDK中示例进行添加。
重要:更新SDK是,需同时更新SDK目录/SDK/assets/data/目录下所有文件。
重要:如需操作Application,必须要继承自DCloudApplication。
- 更新uni-app离线打包支持,需使用HBuilderX(2.6.15.20200421)版本生成本地打包App资源。
- 修复 v2版本apk使用wgt升级资源后,用v3版本apk覆盖安装无法进入应用的Bug
- 修复 nvue rich-text 组件 img 标签可能不显示的Bug
- 修复 nvue input 组件 font-size 值设置过大时光标可能不显示的Bug
- 修复 nvue input 组件设置 type 为 digit/number 时弹出键盘类型不正确的问题
- 修复 vue map 组件 marker 属性打包后图片不显示的Bug
- 修复 tabBar 页面设置 titleNView 的 type 为 transparent 滚动时标题栏透明度不发生变化的Bug
- 修复 nvue 页面跳转到 vue 页面后,input 组件获得焦点时可能无法弹出软键盘的Bug
- 新增 pop-in/pop-out 动画时通过 animationAlphaBGColor 设置动画蒙层背景色,可用于避免暗色风格页面转场动画的蒙层偏白
- 修复 uni-AD 腾讯广点通部分视频激励广告播放 30 秒后点击关闭按钮触发 onClose 事件参数中 isEnded 属性可能为 false 的Bug
- 修复 Webview窗口对象 loadURL 方法没有触发 overrideUrlLoading 拦截回调函数的Bug
- 修复 显示系统软键盘 plus.key.showSoftKeybord 多次调用会触发关闭软键盘的Bug
- 修复 storage存储键值通过 setItem 方法传入 value 为空字符串后,通过 getItem 方法返回 null 的Bug
- 修复 同时创建两个音频播放对象,其中一个音频暂停后另一个无法播放的Bug
- 修复 视频播放控件 VideoPlayer 播放部分 rtmp 链接可能无声音的Bug
- 修复 确认模态框 confirm 显示时会弹出软键盘的Bug
Android平台历史版本
2020年04月10日发布
重要:因新版本去掉基础aar中的权限,所以请根据自身需求添加所需权限,权限可参考SDK中示例进行添加。
重要:更新SDK是,需同时更新SDK目录/SDK/assets/data/目录下所有文件。
重要:如需操作Application,必须要继承自DCloudApplication。
- 更新uni-app离线打包支持,需使用HBuilderX(2.6.11.20200409)版本生成本地打包App资源。
- 修复 nvue web-view 组件 src 属性的链接地址中带 query 参数无效的Bug
- 修复 nvue web-view、image 等组件 src 属性资源地址为_doc、_download路径时可能无法正常载入的Bug
- 修复 nvue list/waterfall 组件底部使用 loading 加载更多时,无法正常触发 @loading 事件的Bug
- 修复 nvue list 组件 @scroll 事件返回参数 contentOffset.y 值域不正确的Bug
- 修复 uni.sendSocketMessage 无法发送某些 bytebuffer 数据的Bug
- 新增 uni-AD 激励视频广告支持服务器回调(限今日头条穿山甲广告)
- 新增 Webview窗口标题栏 titleNView 的 titleIcon 支持网络图标路径
- 修复 Webview窗口对象 loadURL 方法 headers 参数设置无效的Bug
- 修复 在Android10上第一次安装后启动可能引起应用崩溃的Bug
- 修复 应用标识 AppID 使用www结尾时导致部分资源无法正常载入的Bug
- 修复 百度语音识别时在部分设备可能返回 4004 app name unknown 错误的Bug
- 修复 设置应用图标显示角标数字 plus.runtime.setBadgeNumber 在部分设备超过100时仍然显示99的Bug
- 修复 文件系统目录对象 DirectoryEntry 的 getFile 方法返回错误信息不准确的Bug
- 修复 调用 plus.gellay.pick 通过QQ浏览器选择图片或视频在部分设备可能无响应的Bug
- 修复 HBuilderX 2.6.1引出的获取Cookie值 plus.navigator.getCookie 返回数据不正确的Bug
2020年04月03日发布
重要:因新版本去掉基础aar中的权限,所以请根据自身需求添加所需权限,权限可参考SDK中示例进行添加。
重要:更新SDK是,需同时更新SDK目录/SDK/assets/data/目录下所有文件。
重要:如需操作Application,必须要继承自DCloudApplication。
- 更新uni-app离线打包支持,需使用HBuilderX(2.6.9.20200403)版本生成本地打包App资源。
- 新增 获取当前屏幕宽高信息接口 plus.screen.getCurrentSize
2020年03月31日发布
重要:因新版本去掉基础aar中的权限,所以请根据自身需求添加所需权限,权限可参考SDK中示例进行添加。
重要:更新SDK是,需同时更新SDK目录/SDK/assets/data/目录下所有文件。
重要:如需操作Application,必须要继承自DCloudApplication。
- 更新uni-app离线打包支持,需使用HBuilderX(2.6.8.20200330)版本生成本地打包App资源。
- 优化 storage 相关 API 性能
- 修复 pages.json 内配置 softinputMode 为 adjustResize 部分情况下失效的Bug
- 修复 nvue video 组件在页面中存在多个且包含 cover-view 全屏播放时闪退的Bug
- 修复 nvue video 组件设置 click 事件后视频操作按钮无法触发的Bug
- 修复 nvue waterfall 组件加入 Refresh 后item排版错乱的Bug
- 修复 tabBar 的 midButton 设置 backgroundImage 显示不正常的Bug
- 修复 国产安卓模拟器 uni.getSystemInfo 获取设备宽高错误的Bug
- 修复 v3版本 map 组件绑定宽高后无法动态修改的Bug
- 修复 v3版本 nvue 为首页时 autoclose 设置为 false 也会自动关闭启动页的Bug
- 修复 v3版本 SocketTask.onMessage 接收数据类型为 ArrayBuffer 时解析错误的Bug
- 新增 原生标题栏支持自定义返回按钮角标、标题图标、副标题等功能
- 修复 Webview窗口的 WebviewEvent 事件回调函数参数没有 target 属性的Bug
- 优化 本地数据存储 plus.storage 性能,新增异步操作接口
- 修复 uni-AD 激励视频云端打包勾选穿山甲,广告平台没有通过审核时可能引起应用崩溃的Bug
- 修复 提交华为应用市场检查可能误报 TrojanDropper.Agent.EIY 病毒的Bug
- 修复 页面中a标签设置非法链接后,点击可能出现应用闪退的Bug
- 修复 在部分华为手机上修改文件名之后,使用input标签type为file时获取文件名称可能为随机数字的Bug
- 修复 Webview窗口标题栏(titleNView)设置type为transparent时,其它原生控件(如VideoPlayer)可能会覆盖标题栏的Bug
- 修复 页面中input标签触发软键盘收回时可能影响 WebviewStyles 中的top属性不生效的Bug
- 修复 获取UA值 plus.navigator.getUserAgent 返回为空的Bug
- 修复 视频播放控件 VideoPlayer 跳转到指定位置之后,弹幕仍然按照之前的进度播放的Bug
- 修复 视频播放控件 VideoPlayer 未指定 direction 时没有根据视频的宽高自动选择 direction 的Bug
- 修复 地图控件 setCenter 后不触发 onstatuschanged 事件的Bug
- 修复 HBuilderX2.6.5 引出的在Android4.4系统设备无法正常运行的Bug
- 修复 系统选择按钮框底部取消按钮UI显示不正常的Bug
2020年03月19日发布
重要:因新版本去掉基础aar中的权限,所以请根据自身需求添加所需权限,权限可参考SDK中示例进行添加。
重要:更新SDK是,需同时更新SDK目录/SDK/assets/data/目录下所有文件。
重要:如需操作Application,必须要继承自DCloudApplication。
- 更新uni-app离线打包支持,需使用HBuilderX(2.6.5.20200314)版本生成本地打包App资源。
- 修复 在Android4.4系统设备无法正常运行的Bug
- 修复 提交华为应用市场检查可能误报 TrojanDropper.Agent.EIY 病毒的Bug
2020年03月14日发布
重要:因新版本去掉基础aar中的权限,所以请根据自身需求添加所需权限,权限可参考SDK中示例进行添加。
重要:更新SDK是,需同时更新SDK目录/SDK/assets/data/目录下所有文件。
重要:如需操作Application,必须要继承自DCloudApplication。
- 更新uni-app离线打包支持,需使用HBuilderX(2.6.5.20200314)版本生成本地打包App资源。
- 修复 nvue map 组件不设置 markers 属性导致tap事件不触发的Bug
- 修复 云打包后 uni.getImageInfo() 获取本地图片信息可能会触发失败回调的Bug
- 修复 v3版本 wgt热更新后无法打开新增页面的Bug
- 修复 nvue video 组件在页面中存在多个且包含 cover-view 全屏播放时闪退的Bug
- 新增 原生标题栏支持自定义返回按钮、标题居左、标题栏背景图、背景渐变色等功能
- 新增 视频播放控件 VideoPlayer 支持全屏播放时点击事件 fullscreenclick
- 新增 原生隐私与政策提示框配置
- 优化 云端打包默认需要的系统权限,支持配置是否自动添加第三方SDK需要的权限
- 优化 Webview窗口加载可缩放页面时默认隐藏系统缩放控制条
- 修复 获取系统语言信息 plus.os.language 字符中没有包含地区信息的Bug
2020年02月26日发布
重要:因新版本去掉基础aar中的权限,所以请根据自身需求添加所需权限,权限可参考SDK中示例进行添加。
重要:更新SDK是,需同时更新SDK目录/SDK/assets/data/目录下所有文件。
重要:如需操作Application,必须要继承自DCloudApplication。
- 更新uni-app离线打包支持,需使用HBuilderX(2.6.1.20200226)版本生成本地打包App资源。
2020年02月24日发布
点击下载SDK
重要:因新版本去掉基础aar中的权限,所以请根据自身需求添加所需权限,权限可参考SDK中示例进行添加。
重要:更新SDK是,需同时更新SDK目录/SDK/assets/data/目录下所有文件。
重要:如需操作Application,必须要继承自DCloudApplication。 - 更新uni-app离线打包支持,需使用HBuilderX(2.6.0.20200223)版本生成本地打包App资源。
- 新增 plus.ad 广告模块,聚合穿山甲、广点通、360联盟等uni-AD联盟服务,支持信息流、banner、激励视频等应用内自定义广告
- 新增 Webview窗口样式支持设置禁止调用plus属性 disablePlus,解决加载外部页面时可能调用plus对应用造成危害的隐患
- 新增 数据库执行SQL语句 plus.sqlite.executeSql 支持一次传入多条语句,解决Android平台一条SQL语句中不支持以分号分割多条命令的需求
- 新增 推送 支持异步获取客户端推送标识接口 plus.push.getClientInfoAsync,解决同步接口可能返回空数据的问题
- Android平台 新增 腾讯X5内核。可解决rom自定义主题字体适配、低端机浏览器兼容性等问题
- 修复 Webview窗口创建并显示后立即关闭可能出现闪退的Bug
- 修复 在定时器回调函数中调用 plus.screen.lockOrientation 可能会引起应用闪退的Bug
- 修复 在部分手机上获取OAID可能触发错误回调,错误信息提示不支持的Bug
- 修复 调用系统分享消息 plus.share.sendWithSystem 标题不支持国际化的Bug
- 修复 音频播放对象 AudioPlayer 触发end事件之后,调用 stop 和 destroy 方法会出现闪退的Bug
2020年01月04日发布
点击下载SDK
重要:因新版本去掉基础aar中的权限,所以请根据自身需求添加所需权限,权限可参考SDK中示例进行添加。
重要:更新SDK是,需同时更新SDK目录/SDK/assets/data/目录下所有文件。
重要:如需操作Application,必须要继承自DCloudApplication。 - 更新uni-app离线打包支持,需使用HBuilderX(2.5.1.20200103)版本生成本地打包App资源。
- 更新 高德地图SDK(7.1.0)
- 修复 Webview窗口关闭后可能出现内存占用不释放的Bug
- 修复 数据库执行SQL语句 plus.sqlite.executeSql 不支持多条sql语句的Bug
- 修复 真机运行默认将日志保存到SD卡中,长时间运行可能出现日志文件过大的Bug
2019年12月11日发布
点击下载SDK
重要:因新版本去掉基础aar中的权限,所以请根据自身需求添加所需权限,权限可参考SDK中示例进行添加。
重要:更新SDK是,需同时更新SDK目录/SDK/assets/data/目录下所有文件。
重要:如需操作Application,必须要继承自DCloudApplication。 - 更新uni-app离线打包支持,需使用HBuilderX (2.4.6.20191210)版本生成本地打包App资源。
- 修复 选择位置 概率出现定位中心点不居中的Bug
- 优化 启动时申请手机存储权限,若用户拒绝则会弹出说明文字。满足部分应用商店要求的权限申请需申明的要求
- 修复 Webview窗口设置drag滑屏操作手势,快速滑动操作可能引起白屏的Bug
- 修复 视频播放控件(VideoPlayer)可能无法播放某些本地视频文件的Bug
- 修复 数据库执行SQL语句(plus.sqlite.executeSql)传入错误sql语句时,可能在控制台输出错误日志且不触发错误回调的Bug
2019年11月15日发布
点击下载SDK
重要:因新版本去掉基础aar中的权限,所以请根据自身需求添加所需权限,权限可参考SDK中示例进行添加。
重要:更新SDK是,需同时更新SDK目录/SDK/assets/data/目录下所有文件。
重要:如需操作Application,必须要继承自DCloudApplication。 - 更新uni-app离线打包支持,需使用HBuilderX(2.4.2.20191115)版本生成本地打包App资源。
- 新增 获取移动智能设备标识公共服务平台提供的匿名设备标识符OAID、开发者匿名设备标识符VAID、及应用匿名设备标识符AAID,可用于解决Android10无法获取设备标识(如IMEI、IMSI、Wi-Fi MAC地址等)的问题
- 新增 在manifest中配置 App 启动时申请设备IMEI等信息的权限策略,默认调整为应用第一次启动时申请
- 新增 Webview窗口支持暂停(pause)和恢复(resume)操作,解决页面中如果存在持续渲染隐藏后可能引起卡顿的Bug
- 新增 文件上传支持配置分块上传参数chunkSize,解决不能真实返回上传进度的Bug
- 修复 Webview子窗口先隐藏(hide)再添加(append)到父窗口依然显示的Bug
- 修复 二维码(Barcode)扫描在设备横屏时显示异常的Bug
- 修复 创建视频播放控件(VideoPlayer)时,没有开始播放视频也会停止后台背景音频的Bug
- 优化 视频播放的操作条的拖动误触和图标美化问题
- 修复 在部分设备上插拔usb硬件设备可能引起应用重启的Bug
2019年10月24日发布
点击下载SDK
重要:因新版本去掉基础aar中的权限,所以请根据自身需求添加所需权限,权限可参考SDK中示例进行添加。
重要:更新SDK是,需同时更新SDK目录/SDK/assets/data/目录下所有文件。
重要:如需操作Application,必须要继承自DCloudApplication。 - 更新uni-app离线打包支持,需使用HBuilderX(2.3.7.20191024)版本生成本地打包App资源。
- Android平台 修复 微信分享内容包含网络图片时,第二次操作分享会失败的Bug
2019年10月21日发布
点击下载SDK
重要:因新版本去掉基础aar中的权限,所以请根据自身需求添加所需权限,权限可参考SDK中示例进行添加。
重要:更新SDK是,需同时更新SDK目录/SDK/assets/data/目录下所有文件。
重要:如需操作Application,必须要继承自DCloudApplication。 - 更新uni-app离线打包支持,需使用HBuilderX(2.3.6.20191020)版本生成本地打包App资源。
- 修复 HBuilderX2.3.5引出的上传文件 uploadFile 可能失败的Bug
2019年10月18日发布
点击下载SDK
重要:因新版本去掉基础aar中的权限,所以请根据自身需求添加所需权限,权限可参考SDK中示例进行添加。
重要:更新SDK是,需同时更新SDK目录/SDK/assets/data/目录下所有文件。
重要:如需操作Application,必须要继承自DCloudApplication。 - 更新uni-app离线打包支持,需使用HBuilderX (2.3.5.20191018)版本生成本地打包App资源。
- Android平台 更新 个推/UniPush SDK(4.3.7.0),解决无法上架谷歌应用市场(GooglePlay)的问题
- Android平台 修复 MIUI11中toast背景为白色,导致前景色无法看清的Bug
- 更新 微信登录、分享、支付SDK(5.4.3),适配Android10
- 更新 QQ登录、分享SDK(3.3.5),新浪微博登录、分享SDK(4.4.1)
- 更新 高德地图SDK(6.8.0),解决在部分手机上可能出现黑屏的Bug
- 修复 数据库查询SQL语句(plus.sqlite.selectSql)返回结果中的浮点数据类型精度丢失的Bug
- 修复 在双卡手机上获取国际移动用户识别码(IMSI)只能返回一个值的Bug
- 修复 Android10设备上获取设备唯一标识(UUID)为空的Bug
- 修复 上传任务(plus.uploader.createUpload)提交的请求头中包含多个Cookie的Bug
- 修复 上传任务(plus.uploader.createUpload)不能真实返回上传进度的Bug
- 修复 蓝牙断开设备连接(plus.bluetooth.closeBLEConnection)可能不触发onBLEConnectionStateChange事件的Bug
- 修复 微信分享图片无法加载带重定向的url链接的Bug
- 修复 Webview窗口动画在特定情况下可能会将pop-in/out动画自动变为slide-in/out-right的Bug
2019年09月23日发布
点击下载SDK
重要:因新版本去掉基础aar中的权限,所以请根据自身需求添加所需权限,权限可参考SDK中示例进行添加。
重要:更新SDK是,需同时更新SDK目录/SDK/assets/data/目录下所有文件。
重要:如需操作Application,必须要继承自DCloudApplication。 - 更新uni-app离线打包支持,需使用HBuilderX (2.3.3.20190923)版本生成本地打包App资源。
2019年09月21日发布
点击下载SDK
重要:因新版本去掉基础aar中的权限,所以请根据自身需求添加所需权限,权限可参考SDK中示例进行添加。
重要:更新SDK是,需同时更新SDK目录/SDK/assets/data/目录下所有文件。
重要:如需操作Application,必须要继承自DCloudApplication。 - 更新uni-app离线打包支持,需使用HBuilderX(2.3.2.20190921)版本生成本地打包App资源。
- Android平台 修复 系统相册选择文件(plus.gallery.pick)设置selected参数时多次选择失效的Bug 详情
2019年09月20日发布
点击下载SDK
重要:因新版本去掉基础aar中的权限,所以请根据自身需求添加所需权限,权限可参考SDK中示例进行添加。
重要:更新SDK是,需同时更新SDK目录/SDK/assets/data/目录下所有文件。
重要:如需操作Application,必须要继承自DCloudApplication。 - 更新uni-app离线打包支持,需使用HBuilderX(2.3.1.20190920)版本生成本地打包App资源。
2019年09月20日发布
点击下载SDK
重要:因新版本去掉基础aar中的权限,所以请根据自身需求添加所需权限,权限可参考SDK中示例进行添加。
重要:更新SDK是,需同时更新SDK目录/SDK/assets/data/目录下所有文件。
重要:如需操作Application,必须要继承自DCloudApplication。
- 更新uni-app离线打包支持,需使用HBuilderX(2.3.0.20190919)版本生成本地打包App资源。
- 优化 窗体动画popin/popout的效率,Android6+加入老窗体透明alpha效果(同时注意此时动画时长设置不再生效)
- 修复 部分平板设备横屏显示时可能出现灰色区域的Bug
- 修复 图片压缩转换(plus.zip.compressImage)后exif头信息丢失的Bug
- 修复 获取图片信息(plus.io.getImageInfo)传入网络图片地址无法下载图片时控制台输出Unexpected identifier错误的Bug
- 修复 设置应用全屏显示(plus.navigator.setFullscreen)时在部分刘海屏设备显示区域可能不正确的Bug
- 修复 Webview窗口动画在Android6以下设备可能出现残影的Bug
- 修复 使用plus.io.resolveLocalFileSystemURL方法传入路径非'/'结尾是获取目录对象entry不正确,导致entry.getDirectory创建子目录路径不对的Bug
2019年08月19日发布
点击下载SDK
重要:因新版本去掉基础aar中的权限,所以请根据自身需求添加所需权限,权限可参考SDK中示例进行添加。
重要:更新SDK是,需同时更新SDK目录/SDK/assets/data/目录下所有文件。
重要:如需操作Application,必须要继承自DCloudApplication。
- 更新uni-app离线打包支持,需使用HBuilderX(2.2.2.20190816)版本生成本地打包App资源。
- 修复 部分情况下软键盘隐藏后页面底部留白的Bug 详情
- 修复 plus.gallery.pick选择视频后返回失败的Bug
- 修复2.2.1引起的uniapp原生插件使用时报错找不到的问题
2019年08月14日发布
点击下载SDK
重要:因新版本去掉基础aar中的权限,所以请根据自身需求添加所需权限,权限可参考SDK中示例进行添加。
重要:更新SDK是,需同时更新SDK目录/SDK/assets/data/目录下所有文件。
重要:如需操作Application,必须要继承自DCloudApplication。 - 更新uni-app离线打包支持,需使用HBuilderX(2.2.1.20190813)版本生成本地打包App资源。
- 修复 在小米手机上选择本地视频总是返回失败回调的Bug
- 修复 nvue页面中input组件弹出软键盘后报js错误(Failed to receiveTasks, instance is not available)的Bug
2019年08月12日发布
点击下载SDK
重要:因新版本去掉基础aar中的权限,所以请根据自身需求添加所需权限,权限可参考SDK中示例进行添加。
重要:更新SDK是,需同时更新SDK目录/SDK/assets/data/目录下所有文件。
重要:如需操作Application,必须要继承自DCloudApplication。 - 更新uni-app离线打包支持,需使用HBuilderX(2.2.0.20190810)版本生成本地打包App资源。
- 新增 5+ APP和uni-app适配支持arm64-v8a(64位)CPU类型,解决GooglePlay提审要求64位的问题
- 更新 支付宝SDK版本为15.6.5,修复SDK版本过低可能被Google Play下架的Bug
- 新增 支持manifest.json文件中设置屏幕方向(screenOrientation)真机运行时可立即生效(无需提交云端打包)
- 新增 适配最新的Android Q(API等级29)系统
- 新增 可在打包时取消x86 cpu支持,以减少apk体积
- 修复 部分安卓4.4手机上获取设备信息(plus.device.getInfo)无法返回imei的Bug
- 修复 微信登录第一次授权登录可能返回失败的Bug
- 修复 华为手机调用plus.runtime.setBadgeNumber(0)无法清除应用角标的Bug
2019年07月24日发布
点击下载SDK
重要:因新版本去掉基础aar中的权限,所以请根据自身需求添加所需权限,权限可参考SDK中示例进行添加。
重要:更新SDK是,需同时更新SDK目录/SDK/assets/data/目录下所有文件。
重要:如需操作Application,必须要继承自DCloudApplication。 - 更新uni-app离线打包支持,需使用HBuilderX(2.1.3.20190723)版本生成本地打包App资源。
- 修复 Webview子窗口调用plus.webview.startAnimation动画可能引起页面不显示的Bug
- 修复 Webview窗口软键盘弹出高度可能不正确的Bug
- 修复 Webview父子窗口都设置statusbar后导致显示不正确的Bug,统一为父子窗口同时设置statusbar后仅子窗口的statusbar生效
- 修复 Webview窗口的标题栏(titleNView)设置搜索框(searchInput)后可能会同时显示标题文字(titleText)的Bug
- 修复 wap2app应用首页为选项卡页面在全面屏手机第一次打开底部可能有空白的Bug
- 修复 图片进行扫码识别(plus.barcode.scan)返回数据多出引号的Bug
- 修复 获取设备信息(plus.device.getInfo)在部分只有一个IMEI号的设备(如华为荣耀6等)无返回值的Bug
- 修复 uni-app应用中nvue页面使用uni-app编译模式打包后覆盖安装使用了weex模式(老模式)版本引起nvue页面白屏的Bug
2019年07月16日发布
点击下载SDK
重要:因新版本去掉基础aar中的权限,所以请根据自身需求添加所需权限,权限可参考SDK中示例进行添加。
重要:更新SDK是,需同时更新SDK目录/SDK/assets/data/目录下所有文件。
重要:如需操作Application,必须要继承自DCloudApplication。 - 更新uni-app离线打包支持,需使用HBuilderX(2.1.1.20190716)版本生成本地打包App资源。
- 修复 nvue页面中image标签的placeholder属性设置本地地址可能引起崩溃的Bug
- 修复 原生控件对象(plus.nativeObj.View)不添加到Webview窗口直接显示后无法正常关闭的Bug
2019年07月15日发布
点击下载SDK
重要:因新版本去掉基础aar中的权限,所以请根据自身需求添加所需权限,权限可参考SDK中示例进行添加。
重要:更新SDK是,需同时更新SDK目录/SDK/assets/data/目录下所有文件。
重要:如需操作Application,必须要继承自DCloudApplication。 - 更新uni-app离线打包支持,需使用HBuilderX(2.1.0.20190713)版本生成本地打包App资源。
- 新增 5+App添加UniPush功能,替代之前的个推和小米推送。详情
- 新增 获取设备信息方法(plus.device.getInfo),不再推荐使用plus.device.imei。把属性改为方法可以避免Android平台在应用启动时被某些手机提示需要电话权限的问题。详情
- 云端打包API等级(targetSdkVersion)默认值调整为26,满足各主流应用市场的上架要求
- 新增 获取应用(ipa/apk)版本号(plus.runtime.versionCode)接口 文档
- 新增 获取应用信息(plus.runtime.getProperty)支持manifest.json文件中的版本号(version->code字段值) 文档
- 修复 网络请求接口(plus.net.XMLHttpRequest)获取HTTP响应头部信息字段中多一个空格的Bug
- 优化 图片预览(plus.nativeUI.previewImage)界面未沉浸式状态栏效果
- 修复 配置渠道云端打包后获取的渠道信息(plus.runtime.channel)总是为空的Bug 详情
- 修复 HBuilderX2.0.0版本引出的plus.io.getImageInfo一直触发失败回调的Bug 详情
- 修复 搜索蓝牙设备(plus.bluetooth.startBluetoothDevicesDiscovery)设置为允许重复上报相同设备(allowDuplicatesKey参数为true)时,获取设备列表为空的Bug
- 修复 图片预览(plus.nativeUI.previewImage)设置两张图片且loop为true会闪退的Bug 详情
- 完善 原生图片对象(plus.nativeObj.Bitmap)保存图片(save)方法兼容非预期参数 详情
- 修复 使用unipush模块提交华为应用市场报“HMS根证书文件”错误的Bug 详情
- 修复 Webview窗口在某些情况(如退出视频全屏播放、弹出软键盘按home键后再切回前台、wap2app应用设置statusbar)可能出现底部空缺的Bug 详情
- 修复 subnvue窗口在某些情况下调用setStyle无效的Bug
- 修复 视频控件(VideoPlayer)可能偶发出现进度条不更新不消失的Bug
- 修复 视频播放(VideoPlayer)控件提交云端打包后无法播放本地视频文件的Bug 详情
- 修复 应用第一次运行时调用定位功能可能不弹出定位权限申请框也不触发错误回调的Bug 详情
- 修复 原生控件(NView)绘制字体图标在部分魅族手机上可能无法显示的Bug 详情
- 修复 部分手机上设置titleNView后可能引起页面高度不对的Bug 详情
- 修复 通过plus.runtime.launchApplication启动的应用可能出现plus.runtime.arguments更新失败的Bug 详情
- 修复 nvue页面云端打包后设置字体(font-family)属性可能无效的Bug
- 修复 nvue页面创建WebSockets连接服务器总是反馈超时错误的Bug
- 修复 uni-app为多tab应用,切换显示nvue页面时可能出现顶部留白的Bug 详情
2019年06月14日发布
点击下载SDK
重要:因新版本去掉基础aar中的权限,所以请根据自身需求添加所需权限,权限可参考SDK中示例进行添加。
重要:更新SDK是,需同时更新SDK目录/SDK/assets/data/目录下所有文件。
重要:如需操作Application,必须要继承自DCloudApplication。 - 更新uni-app离线打包支持,需使用HBuilderX(2.0.1.20190614)版本生成本地打包App资源。
- 修复 配置渠道云端打包后获取的渠道信息(plus.runtime.channel)总是为空的Bug
- 修复 图片预览(plus.nativeUI.previewImage)设置两张图片且loop为true会闪退的Bug
2019年06月11日发布
点击下载SDK
重要:因新版本去掉基础aar中的权限,所以请根据自身需求添加所需权限,权限可参考SDK中示例进行添加。
重要:更新SDK是,需同时更新SDK目录/SDK/assets/data/目录下所有文件。
重要:如需操作Application,必须要继承自DCloudApplication。 - 更新uni-app离线打包支持,需使用HBuilderX(2.0.0.20190610)版本生成本地打包App资源。
- 新增 Webview窗口标题栏(titleNView)支持获取输入搜索内容功能(getTitleNViewSearchInputText)
- 新增 Webview窗口标题栏(titleNView)支持监听搜索输入框焦点变化事件(titleNViewSearchInputFocusChanged)
- 修复 Webview窗口未设置标题栏(titleNView)时可能出现显示错误的Bug
- 修复 数据库多次执行事务(plus.sqlite.transaction)可能不成功的Bug
- 修复 蓝牙(Bluetooth)搜索设备返回的advertisData数据丢失前两个字节的Bug
- 修复 部分设备上开启全面屏手势的情况下获取屏幕高度(plus.screen.resolutionHeight)不正确的Bug
- 修复 网络请求(plus.net.XMLHttpRequest)没有共享cookie的Bug
- 修复 视频控件(VideoPlayer)切换视频可能出现无法播放的Bug
- 修复 视频控件(VideoPlayer)播放部分rtmp协议视频可能出现没有声音的Bug
- 修复 uni-app应用设置窗口背景透明不生效的Bug
- 修复 调用摄像头(Camera)录像完成后点击播放可能触发错误回调的Bug
2019年05月23日发布
点击下载SDK
重要:因新版本去掉基础aar中的权限,所以请根据自身需求添加所需权限,权限可参考SDK中示例进行添加。
重要:更新SDK是,需同时更新SDK目录/SDK/assets/data/目录下所有文件。
重要:如需操作Application,必须要继承自DCloudApplication。 - 更新uni-app离线打包支持,需使用HBuilderX(1.9.9.20190522)版本生成本地打包App资源。
- 修复 使用console.log输出日志时在以[开头时日志可能显示不全的Bug
2019年05月20日发布
点击下载SDK
重要:因新版本去掉基础aar中的权限,所以请根据自身需求添加所需权限,权限可参考SDK中示例进行添加。
重要:更新SDK是,需同时更新SDK目录/SDK/assets/data/目录下所有文件。
重要:如需操作Application,必须要继承自DCloudApplication。 - 更新uni-app离线打包支持,需使用HBuilderX(1.9.8.20190518)版本生成本地打包App资源。
- 修复 uni-app应用在部分手机热启动可能出现白屏的问题
- 修复 HBuilderX1.9.7版本引出的plus.sqlite.selectSql返回数据结构不对的问题
2019年05月18日发布
点击下载SDK
重要:因新版本去掉基础aar中的权限,所以请根据自身需求添加所需权限,权限可参考SDK中示例进行添加。
重要:更新SDK是,需同时更新SDK目录/SDK/assets/data/目录下所有文件。
重要:如需操作Application,必须要继承自DCloudApplication。 - 更新uni-app离线打包支持,需使用HBuilderX(1.9.7.20190517)版本生成本地打包App资源。
- 优化 等待对话框(plus.nativeUI.showWaiting)默认图标为圆圈(circle)样式,并补充circle和雪花的样式选择参数
- 修复 Webview窗口嵌套时可能出现高度计算不正确的Bug 详情
- 修复 网络请求(plus.net.XMLHttpRequest)返回code为201~206时返回responseText不对的Bug
- 修复 地图控件调用getUserLocation、showUserLocation可能不会弹出定位授权确认框的Bug
- 修复 uni-app在自定义组件模式下窗口中存在地图控件时新开页面再返回可能显示异常的Bug
- 修复 nvue页面中的pickers组件可能无法正常弹出窗口的Bug
- 修复 蓝牙(Bluetooth)模块不初始化直接调用startBluetoothDevicesDiscovery方法可能崩溃的Bug 详情
- 修复 在部分手机上第一次运行时可能无法搜索到蓝牙设备的Bug
- 修复 uni-app中播放网络地址音频可能无法播放的Bug 详情
- 补齐 调用摄像头录像(startVideoCapture)支持设置视频长度videoMaximumDuration参数。设置录像时间无需再使用Native.js
- 修复 原生控件(plus.nativeObj.View)调用drawText绘制文本时position参数的top/left字段不支持auto的Bug
- 修复 SQLite中调用executeSql执行删除数据库(drop table database)操作后执行查询selectSql方法不触发回调的Bug
- 修复 直播推流(LivePusher)控件可能在首次创建时出现黑屏的Bug
- 修复 定位模块(Geolocation)调用watchPosition方法监听定位变化后再调用getCurrentPosition方法可能导致监听方法失效的Bug
- 修复 使用百度地图调用地理编码(plus.maps.Map.geocode)可能失败的Bug
2019年04月27日发布
点击下载SDK
重要:因新版本去掉基础aar中的权限,所以请根据自身需求添加所需权限,权限可参考SDK中示例进行添加。
重要:更新SDK是,需同时更新SDK目录/SDK/assets/data/目录下所有文件。
重要:如需操作Application,必须要继承自DCloudApplication。 - 更新uni-app离线打包支持,需使用HBuilderX(1.9.4.20190426)版本生成本地打包App资源。
- 新增 Webview窗口标题栏上搜索框(searchInput)支持设置输入的文本内容 文档
- 新增 请求系统权限plus.android.requestPermissions接口 文档
- 修复 nvue页面调用uni.removeStorage报js错误的问题 详情
- 修复 设置targetSdkVersion为28时调用plus.runtime.install安装应用无效的问题 详情
2019年04月18日发布
点击下载SDK
重要:因新版本去掉基础aar中的权限,所以请根据自身需求添加所需权限,权限可参考SDK中示例进行添加。
重要:更新SDK是,需同时更新SDK目录/SDK/assets/data/目录下所有文件。
重要:如需操作Application,必须要继承自DCloudApplication。 - 更新uni-app离线打包支持,需使用HBuilderX(1.9.2.20190417)版本生成本地打包App资源。
- 修复 HBuilderX1.9.0版本引出的直播推流控件(LivePusher)可能黑屏的问题
- 修复 HBuilderX1.9.0版本引出的Webview窗口非全屏时宽高可能计算不对的问题
- 修复 HBuilderX1.9.0版本引出的uni-app首页为nvue页面可能白屏的问题
- 修复 uni-app在自定义组件模式下调用监听设备位置变化(plus.geolocation.watchPosition)报无clearTimeout方法的问题 详情
2019年04月16日发布
点击下载SDK
重要:因新版本去掉基础aar中的权限,所以请根据自身需求添加所需权限,权限可参考SDK中示例进行添加。
重要:更新SDK是,需同时更新SDK目录/SDK/assets/data/目录下所有文件。 - 更新uni-app离线打包支持,需使用HBuilderX(1.9.1.20190415)版本生成本地打包App资源。
- 修复 设置targetSdkVersion为25及以上时调用系统分享(plus.share.sendWithSystem)无效的问题
- 修复 Webview标题栏的输入框(searchInput)在部分设备无法获得焦点的问题
点击下载SDK
重要:因新版本去掉基础aar中的权限,所以请根据自身需求添加所需权限,权限可参考SDK中示例进行添加。
重要:更新SDK是,需同时更新SDK目录/SDK/assets/data/目录下所有文件。
- 更新uni-app离线打包支持,需使用HBuilderX(1.9.0.20190413)版本生成本地打包App资源。
- 优化 音频播放(AudioPlayer)功能,支持设置自动播放(autoplay)、循环播放(loop)、开始播放位置(startTime)、音频标题(title)及监听播放相关事件等
- 修复 直播推流(LivePusher)控件在Android8.0及以上系统可能引起崩溃的问题
- 修复 调用通讯录查找联系人方法(find)在Android8.0及以上系统可能引起崩溃的问题
- 修复 修复 二维码扫描控件(Barcode)可能出现扫描框不居中的问题
- 修复 UniPush通过厂商通道接收到多条消息后点击可能不触发click事件的问题
2019年04月01日发布
点击下载SDK
重要:因新版本去掉基础aar中的权限,所以请根据自身需求添加所需权限,权限可参考SDK中示例进行添加。
重要:更新SDK是,需同时更新SDK目录/SDK/assets/data/目录下所有文件。 - 更新uni-app离线打包支持,需使用HBuilderX(1.8.2.20190330)版本生成本地打包App资源。
- SQLite模块(plus.sqlite.*),支持操作本地数据库文件。打包配置指南。API文档
- 新增 页面中input标签type=file时支持选择摄像头拍照
- 修复 应用从后台重新激活后plus.runtime.arguments值可能不更新的问题
- 修复 视频控件(VideoPlayer)云端打包后可能无法播放本地视频文件的问题
- 修复 二维码扫描(Barcode)控件多次创建大小不同时可能导致识别区域偏移的问题
- 修复 uni-app应用资源通过wgt升级可能提示缺少uninview模块的问题
- 修复 Android9设备调用plus.runtime.install安装apk无效的问题
点击下载SDK
重要:因新版本去掉基础aar中的权限,所以请根据自身需求添加所需权限,权限可参考SDK中示例进行添加。
重要:更新SDK是,需同时更新SDK目录/SDK/assets/data/目录下所有文件。 - 更新uni-app离线打包支持,需使用HBuilderX(1.7.0.20190314)版本生成本地打包App资源。
- 更新 个推SDK更新为4.3.20版本,兼容Android9.0
- 修复 Webview窗口标题栏(titleNView)设置backgroundColor属性后系统状态栏背景可能不生效的问题
- 修复 在部分Android8.0设备调用 plus.runtime.install 接口无法安装apk的问题
- 修复 在部分Android8.0设备调用 plus.runtime.openFile 接口打开文件可能无效的问题
- 修复 二维码扫描窗口无法全屏显示的问题(参考HelloH5模板应用的Barcode示例页面)
- 修复 修复 二维码扫描窗口未授权相机权限后返回可能引起横屏显示的问题
- 视频控件(VideoPlayer)无法播放部分rtsp、rtmp视频,缓冲时间过长,切换视频播放进度未更新等问题
- 修复 nvue页面中image标签圆角(borderRadius)不生效的问题
2019年02月21日发布
点击下载SDK
重要:因新版本去掉基础aar中的权限,所以请根据自身需求添加所需权限,权限可参考SDK中示例进行添加。
重要:更新SDK是,需同时更新SDK目录/SDK/assets/data/目录下所有文件。 - 更新uni-app离线打包支持,需使用HBuilderX(1.6.2.20190220)版本生成本地打包App资源。
- 修复 获取语言(plus.os.language、navigator.language)一直返回英文(en_US)的问题
- 修复 下载任务未配置fileName参数并且url地址中未包含文件名称时可能导致下载失败的问题
- 修复searchInput在uni-app中autoFocus会自动关闭软键盘的问题
- 修复 视频播放(VideoPlayer)控件无法播放本地视频文件的问题
- 修复 修复 蓝牙连接设备后可能立即中断(日志提示Cannot read property 'map' of null)的问题
- 修复 nvue页面中image标签不触发load事件的问题
- 修复 修复 nvue页面中slider标签初始化设置index属性不生效的问题
2019年01月21日发布
点击下载SDK
重要:因新版本去掉基础aar中的权限,所以请根据自身需求添加所需权限,权限可参考SDK中示例进行添加。
重要:更新SDK是,需同时更新SDK目录/SDK/assets/data/目录下所有文件。
- 更新uni-app离线打包支持,需使用HBuilderX(1.5.1或1.5.2)版本生成本地打包App资源。
- 调整SDK默认为高德地图。
- 标题栏按钮(WebviewTitleNViewButtonStyles)支持红点、角标和向下箭头等
- 修复 窗口中原生标题栏(titleNView)style为transparent样式时返回按钮图标不可见的问题
- 修复 窗口中包含地图控件时切换动画可能出现白屏现象的问题
- 修复 窗口设置显示进度条(progress)在页面跳转时可能不触发显示进度的问题
- 修复 二维码扫描窗口无法全屏显示的问题(参考HelloH5模板应用的Barcode示例页面)
- 修复 视频播放(VideoPlayer)控件断网恢复后可能无法继续播放的问题
- 修复 设置应用启动图片为.9.png时有可能出现拉伸显示的问题
- 修复 原生控件(NView)绘制图片是left/top属性值设置为auto时无法居中显示的问题
- 修复 原生控件(NView)字体或背景颜色值使用rgba格式时无法容错解析空格的问题
- 修复 百度地图在部分手机上可能出现闪黑的问题
- 修复 推送消息传输透传数据时可能出现payload参数无法返回的问题
- 更新 小米推送SDK版本为3.6.12
- 修复 窗口使用circle样式下拉刷新时可能不触发H5中touchcancel事件的问题
- 修复 下载(Downloader)任务过多时暂停后可能无法再继续的问题
- 修复 上传(Uploader)任务的地址为https时可能无法正常上传的问题
- 修复 nvue页面在非解压模式可能出现图片无法正常显示的问题
2018年12月26日发布
点击下载SDK
重要:因新版本去掉基础aar中的权限,所以请根据自身需求添加所需权限,权限可参考SDK中示例进行添加。
- 更新uni-app离线打包支持,需使用HBuilderX(1.4.0.XXXX)版本生成本地打包App资源.
- 更新 nvue页面渲染内核,速度更快、效率更高
- 优化 应用图标角标设置支持华为手机、适配新版本小米手机
- 优化 支持Android9.0查询是否为刘海屏设备(plus.navigator.hasNotchInScreen)
- 修复 部分Android9.0设备上可能弹出"Detected problems with API compatibility"提示框问题
- 修复 打包设置gargetSDKVersion大于26可能导致无法接收推送消息的问题
- 修复 蓝牙读写二进制数据可能不正确的问题
- 修复 Webview窗口的titleNView设置为transparent样式时可能直接显示文字的问题
- 修复 Webview窗口的titleNView上按钮字体图标可能不居中显示的问题
2018年12月12日发布
点击下载SDK
重要:因新版本去掉基础aar中的权限,所以请根据自身需求添加所需权限,权限可参考SDK中示例进行添加。 - 更新uni-app离线打包支持,需使用HBuilderX(1.3.1.20181211)版本生成本地打包App资源.
- 新增 支持蓝牙模块 详见
- 新增 支持启动微信小程序(plus.share.ShareService.launchMiniProgram),同时需在manifest中配置navigateToMiniProgramAppIdList
- 新增 titleNView配置支持左右内边距(padding/padding-left/padding-right)和按钮的宽度(width)
- 新增 查询设备是否为刘海屏设备接口(plus.navigator.hasNotchInScreen)
- 更新 百度地图SDK(v5.2.1)及百度定位SDK(v7.5.0)
- 更新barcode模块,优化二维码识别,修复部分二维码可能无法识别的问题(barcode离线打包集成发生变化,请参考SDK中文档集成)
- 修复 Webview的默认下拉刷新样式可能显示不正常的问题
- 修复 Webview未显示时通过setStyle方法设置参数可能无法及时生效的问题
- 优化 从相册选择图片(plus.gallery.pick)界面交互体验,修复 在部分手机设置filter为video无效的问题
- 修复 视频控件(VideoPlayer)全屏/非全屏切换导致视频从头播放的问题
2018年11月27日发布
点击下载SDK
重要:因新版本去掉基础aar中的权限,所以请根据自身需求添加所需权限,权限可参考SDK中示例进行添加。 - 更新uni-app离线打包支持,需使用HBuilderX(1.2.1.20181126)版本生成本地打包App资源
- 新增 nvue页面支持bindingx
- 优化 原生图片预览(plus.nativeUI.previewImage)的UI操作体验
- 修复 Webview窗口default样式下拉刷新不触发pullToRefresh事件的问题
- 新增 Webview窗口支持配置显示页面加载进度条(WebviewStyles的progress属性)
- 修复 从无法微信小程序启动的问题
- 修复 Webview窗口default样式下拉刷新不触发pullToRefresh事件的问题
- 修复 视频播放控件(VideoPlayer)在自动调节亮度模式进入全屏变黑的问题
- 修复 nvue页面不支持Websocket功能的问题
- 修复 nvue页面未设置titleNView时可能显示不正常的问题
- 删除lib.5plus.base-release.aar基座中敏感权限,因权限缺失导致的运行失败需手动添加到AndroidManifest.xml中
2018年11月09日发布
- 更新uni-app离线打包支持,需使用HBuilderX(1.1.0.20181030)版本生成本地打包App资源
- 修改高德地图定位权限和marker点击问题
- 若小米手机运行时出现弹窗提醒,请将targetSdkVersion调至28
2018年09月29日发布
点击下载SDK
1.新增支持uni-app离线打包(HBuilderX中生成本地打包App资源) - 简化SDK集成方式,优化jar为aar。
- 新增支持视频播放控件、直播推流等控件;
- 更新分享SDK(微信、新浪微博),支持分享音频、视频、小程序等;
- 修复已知5+API的bug,提升稳定性。
2018年05月11日发布
点击下载SDK
1.修复近期发现的一些bug,提升稳定性2018年03月21日发布
点击下载SDK
1.支持玩咖广告。
2.同步更新流应用内核:修复一些已知的BUG等2018年03月19日发布
点击下载SDK
1.去掉android.support.v4包引用,由开发者在gradle文件自行配置
2.同步更新流应用内核:修复一些已知的BUG等
2018年03月14日发布
点击下载SDK
1.完善广告功能,可以通过配置manifest.json控制是否使用开屏广告
2.同步更新流应用内核:修复一些已知的BUG等
IOS平台HTML5+ SDK 更新日志
2020年4月22日发布
- 更新uni-app离线打包支持,需使用HBuilderX(2.6.15.20200421)版本生成本地打包App资源。
- 新增 原生导航标题栏的 titleIcon 支持 base64 图标,方便页面里已经存在的图标在滚动时绘制在原生导航栏上
- 新增 actionSheet 取消按钮文字国际化(如设置按钮文字,则以设置文字为准,如未设置,则根据手机系统的语言显示)
- 修复 打包模块勾选 iOS UIWebview/Android X5 Webview 后,wgt升级更新失败触发错误回调的Bug 详情
- iOS平台 更新 uni-AD 腾讯广点通SDK版本为4.11.6
- iOS平台 修复 uni-AD 腾讯广点通部分视频激励广告点击关闭按钮触发 onClose 事件参数中 isEnded 属性可能为 false 的Bug
- iOS平台 修复 uni-AD 腾讯广点通的信息流视频广告自动播放时没有静音的Bug
- iOS平台 修复 HBuilderX2.6.8 引出的Webview窗口 userAgent 不正确可能导致加载的页面内部逻辑不正确的Bug 详情
- iOS平台 修复 iOS 13.4.1及以上版本在 iPad 设备应用第一次启动获取不到所有窗口对象的Bug 详情
- iOS平台 修复 视频播放控件 VideoPlayer 全屏时在 iPhoneX 可能出现亮度控制视图位置错乱的Bug 详情
- iOS平台 修复 原生导航标题栏 设置 type 为 float 时,backgroundColor 的半透明效果显示不正确的Bug
- App-iOS平台 修复 nvue video 组件设置 @click 事件后,视频底部控制栏上除进度条以外的其他按钮失效的Bug 详情
- App-iOS平台 修复 v3模式 movable-area 组件嵌套 scroll-view 组件点击事件不触发的Bug 详情
- App-iOS 修复 uni.onBLEConnectionStateChange 不触发的bug
- App-iOS 修复 uni.chooseImage 从相机选择图片分辨率过低的Bug 详情
本次发出的新版SDK已经将Release-iphoneos 和 Release-iphonesimulator两个目录下的库文件进行合并。
老版本SDK用户在替换新SDK时还需要检查工程内是否引入了 libcoreSupport.a这个库,如果工程内没有引入会遇到编译错误。
离线打包用户在更新SDK时请注意:在替换最新SDK的静态库文件的同时要替换相同版本的PandoraAPI.bundle文件。以及注意替换uni-app项目相关的".js"文件
IOS平台历史版本
2020年4月10日发布
- 更新uni-app离线打包支持,需使用HBuilderX(2.6.11.20200409)版本生成本地打包App资源。
- iOS平台 新增 Webview窗口使用WKWebview内核在iOS11及以上设备支持js原生混淆 详情
- iOS平台 更新 支付宝Alipay SDK版本为15.7.4,解决AppStore审核报使用废弃UIWebview APIs的问题
- iOS平台 更新 新浪微博登录、分享SDK版本为3.2.7,解决AppStore审核报使用废弃UIWebview APIs的问题
- iOS平台 更新 今日头条穿山甲广告SDK版本为V2.9.5.0
- iOS平台 修复 iOS 13.3及以上版本在 iPad 设备 plus.webview.all 无法获取所有Webview窗口的Bug 详情
- iOS平台 修复 iOS 13.3及以上版本在 iPad 设备 mui.openWindow 设置的窗口参数获取不到的Bug 详情
- iOS平台 修复 iOS 13及以上版本视频播放控件 VideoPlayer 全屏时可能出现亮度控制视图位置错乱的Bug 详情
- iOS平台 修复 视频播放控件 VideoPlayer 在下拉通知栏页面后依然播放的Bug 详情
- iOS平台 修复 预览图片 plus.nativeUI.previewImage 传入长图时显示不清楚的Bug 详情
- iOS平台 修复 应用安装后第一次启动 splash 界面显示不正常的Bug
- iOS平台 修复 Webview窗口 setStyle 设置 {titleNView: false} 后通过 getSytle 获取的 titleNView 数据不正确的Bug
- App-iOS平台 修复 nvue web-view 组件加载本地 html 文件,若路径中带 query 参数时,无法正常显示的Bug 详情
- App-iOS平台 修复 v3版本 uni.canvasToTempFilePath 在 ios 9.3.4 报错的Bug 详情
2020年4月3日发布
- 更新uni-app离线打包支持,需使用HBuilderX(2.6.9.20200403)版本生成本地打包App资源。
- 【重要】iOS平台 新增 UIWebview独立模块,默认不再包含UIWebview相关代码 详情
- 新增 获取当前屏幕宽高信息接口 plus.screen.getCurrentSize 文档
- App-iOS平台 修复 textarea 组件在 iOS13.4 系统报错的Bug
- App-iOS平台 修复 锁定横屏后打开 nvue 页面使用 plus.screen 获取屏幕宽高值不对的Bug
- iOS平台 修复 Webview窗口标题栏 titleNView 动态设置 titleText 在某些情况下可能不生效的Bug 详情
2020年3月31日发布
- 更新uni-app离线打包支持,需使用HBuilderX(2.6.8.20200330)版本生成本地打包App资源。
- 【重要】iOS平台 新增 UIWebview独立模块,默认不再包含UIWebview相关代码 详情
- iOS平台 新增 系统选择按钮框 plus.nativeUI.actionSheet 在iPad设备支持 popover 设置弹出指示区域 文档
- iOS平台 新增 本地数据存储 plus.storage 异步操作接口 文档
- iOS平台 更新 友盟统计SDK版本为6.1.0
- iOS平台 更新 微信登录、分享、支付SDK版本为1.8.6.2
- iOS平台 修复 视频播放控件 VideoPlayer 设置 show-center-play-btn 属性不生效的Bug 详情
- iOS平台 修复 Webview窗口标题栏(titleNView)中 button 按钮设置 colorPressed 不生效的Bug 详情
- iOS平台 修复 新浪微博分享 type 为 web 类型时 pictures 属性不生效的Bug
- iOS平台 修复 系统选择按钮框 plus.nativeUI.actionSheet 显示后不关闭,通过HBuilderX真机运行更新资源可能引起崩溃的Bug
- iOS平台 修复 云端打包启动页面中应用图标显示不清晰的Bug 详情
- App-iOS平台 新增 API uni.onUIStyleChange 监听系统主题状态变化(限v3) 详情
- App-iOS平台 优化 API uni.showActionSheet 在 iPad 设备支持 popover 设置弹出指示区域(限v3)
- App-iOS平台 修复 设备上使用第三方输入法收起键盘输入框无法失去焦点的Bug 详情
- App-iOS平台 修复 部分情况 page 设置 height 为 100% 无法全屏的Bug
- App-iOS平台 修复 页面使用原生占位时在 iPhoneX 获取窗口高度错误的Bug
- App-iOS平台 修复 picker 设置 value 过大时会滚动到空白位置的Bug 详情
- App-iOS平台 修复 nvue 页面中加载 base64 格式 iconfont 文件在iOS13.4系统崩溃的Bug 详情
2020年3月15日发布
- 更新uni-app离线打包支持,需使用HBuilderX(2.6.5.20200314)版本生成本地打包App资源。
- 新增 原生标题栏支持自定义返回按钮、标题居左、标题栏背景图、背景渐变色等功能 文档
- 新增 视频播放控件 VideoPlayer 支持全屏播放时点击事件 fullscreenclick 文档
- App-iOS平台 修复 v3版本 wgt热更新后 plus.runtime.restart 卡在启动页的Bug 详情
- App-iOS平台 修复 v3版本 video 组件部分情况无法显示的bug
- App-iOS平台 修复 nvue web-view 组件加载本地文件显示空白的Bug 详情
- App-iOS平台 修复 nvue image 组件使用相对路径加载图片可能会不显示的Bug 详情
- App-iOS平台 修复 video 组件设置 muted 为0静音后再设置为1时无法重新开启声音的bug 详情
- iOS平台 新增 适配iOS13+引入的暗黑模式 DarkMode 文档
- iOS平台 新增 应用使用Push(消息推送)模块后启动时不弹出“发送通知”系统授权框的配置方法 详情
- iOS平台 修复 视频播放控件 VideoPlayer 设置 objectFit 属性不生效的bug 详情
- iOS平台 修复 使用WKWebview内核 plus.orientation.getCurrentOrientation 无法获取设备方向信息的Bug
2020年2月26日发布
点击下载SDK
注意:App端重大架构升级 “v3编译器”,所以离线打包工程中需要引入__uniappes6.js和weex-main-jsfm-uni-v3.js这2个文件,具体看官方的打包演示工程。
- 更新uni-app离线打包支持,需使用HBuilderX(2.6.1.20200226)版本生成本地打包App资源。
- App-iOS平台 修复 非 v3 编译模式真机运行时提示框架版本不一致的Bug
2020年2月24日发布
点击下载SDK
注意:App端重大架构升级 “v3编译器”,所以离线打包工程中需要引入__uniappes6.js和weex-main-jsfm-uni-v3.js这2个文件,具体看官方的打包演示工程。
- 更新uni-app离线打包支持,需使用HBuilderX(2.6.0.20200223)版本生成本地打包App资源。
- App-iOS平台 修复 v3版本 部分情况下 rpx 计算错误的Bug
- App-iOS平台 修复 video 组件未播放时调用 seek 可能导致界面不正常的bug 详情
- App-iOS平台 修复 页面中使用字体图标时可能无法正常显示的Bug
- App-iOS平台 修复 tabBar 自定义高度时红点和角标显示位置不正确的Bug 详情
- App-iOS平台 修复 nvue input 组件 placeholder-style 和 placeholder-class 设置 fontSize 不生效的Bug
- App-iOS平台 修复 nvue list 组件设置 bounce 为 false 可能导致页面无法滚动的Bug
- App-iOS平台 修复 nvue map 组件使用 controls 控件提交云端打包后可能会引起崩溃的Bug 详情
- iOS平台 修复 在非刘海屏手机获取应用的安全区域 plus.navigator.getSafeAreaInsets 返回 deviceTop 数据可能不正确的Bug
- iOS平台 修复 调用 plus.gallery.pick 选择相册中的照片后, 连续快速点击完成按钮可能会引起应用崩溃的Bug 详情
- iOS平台 修复 视频播放控件 VideoPlayer 暂停播放后手势快进或后退操作时,没有更新进度条上显示时间的Bug
2020年1月4日发布
点击下载SDK
注意:App端重大架构升级 “v3编译器”,所以离线打包工程中需要引入__uniappes6.js和weex-main-jsfm-uni-v3.js这2个文件,具体看官方的打包演示工程。
- 更新uni-app离线打包支持,需使用HBuilderX(2.5.1.20200103)版本生成本地打包App资源。
- 【重要】iOS平台 新增 支持苹果授权登录(Sign in with Apple) 教程
- iOS平台 修复 音频播放对象(AudioPlayer)播放网络音频时,缓存完成恢复播放时没有触发 onPlay 事件的Bug
- iOS平台 修复 Webview窗口的titleUpdate事件可能不触发导致无法修改页面标题的Bug 详情
- iOS平台 修复 Webview窗口的标题栏(titleNView)设置titleSize属性不生效的Bug
- iOS平台 修复 系统日期选择框(plus.nativeUI.pickDate)、时间选择框(plus.nativeUI.pickTime)在横屏时显示不正常的Bug
- iOS平台 修复 应用切换到后台,从其它应用传参数激活到前台时 plus.runtime.arguments 可能不更新的Bug
- iOS平台 修复 录音对象(AudioRecorder)录制mp3格式音频设置 channels 参数值为 mono 不生效的Bug 详情
- iOS平台 修复 录音对象(AudioRecorder)设置音频播放模式 setSessionCategory 可能不生效的Bug
- iOS平台 修复 iOS13调用 plus.screen.setBrightness 方法可能会导致页面失去响应的Bug
- iOS平台 修复 在非刘海屏手机获取应用的安全区域 plus.navigator.getSafeAreaInsets 返回 deviceTop 数据可能不正确的Bug
- App-iOS平台 新增 nvue 普通 view 组件支持设置高斯模糊(毛玻璃)效果 详情
- App-iOS平台 修复 nvue input 组件设置 maxlength 属性后,@input事件返回value值与实际显示值不一致的Bug 详情
- App-iOS平台 修复 tabbar及标题栏上设置字体图标可能无法正常显示的Bug
- App-iOS平台 修复 nvue map 组件不设置 marker 的 title 及 callout 时会显示空白标注的Bug 详情
- App-iOS平台 修复 使用 uni.hideKeyboard 输入框无法失去焦点的Bug 详情
2019年12月11日发布
点击下载SDK
注意:App端重大架构升级 “v3编译器”,所以离线打包工程中需要引入__uniappes6.js和weex-main-jsfm-uni-v3.js这2个文件,具体看官方的打包演示工程。
- 更新uni-app离线打包支持,需使用HBuilderX(2.4.6.20191210)版本生成本地打包App资源。
- iOS平台 新增 Webview窗口原生标题栏样式属性 blurEffect,支持高斯模糊(毛玻璃)效果 详情
- iOS平台 补齐 直播推流(LivePusher)控件支持设置最小码率(min-bitrate)和最大码率(max-bitrate)
- iOS平台 修复 Webview窗口原生标题栏的搜索框(searchInput)获取焦点会导致placeholder文字移位的Bug 详情
- iOS平台 修复 图片预览(plus.nativeUI.previewImage)可能出现长图片不能滚动的Bug 详情
- iOS平台 修复 图片预览(plus.nativeUI.previewImage)可能无法正常显示部分网络地址图片的Bug 详情
- iOS平台 修复 使用UniPush或个推推送在后台统计数据中没有展示数和点击数的Bug 详情
- iOS平台 修复 用户拒绝访问相机后,调用摄像头拍照或录像时不会触发错误回调的Bug
- iOS平台 修复 配置使用高德或百度地图后,定位默认没有使用gcj02坐标的Bug
- iOS平台 修复 系统日期(plus.nativeUI.pickDate)、时间(plus.nativeUI.pickTime)选择框与系统提示框遮罩颜色不一致的Bug
- iOS平台 修复 苹果应用内支付IAP恢复购买接口(restoreComplateRequest)有可能不会返回恢复购买凭证的Bug
- App-iOS平台 新增 tabbar和navigationBar 支持设置高斯模糊(毛玻璃)效果 详情
- App-iOS平台 修复 nvue view 组件设置 border 属性可能引起应用崩溃的Bug 详情
- App-iOS平台 修复 iOS 13 系统中 textarea 输入的内容,比 placeholder 偏左一点的Bug 详情
- App-iOS平台 修复 faceID 识别成功时不能正确触发成功回调的Bug 详情
- App-iOS平台 修复 网络请求 uni.request 设置请求的 header 中存在非字符串值可能会引起崩溃的Bug
- App平台 修复 nvue 导航栏 titleNView 的 type 属性设置为 transparent 时不生效的Bug 详情
2019年11月15日发布
点击下载SDK
注意:weexUniJs.js和uni-app-service.js这2个文件的路径有变化,需要重新引入自己的工程中,具体看官方的打包demo示例。
- 更新uni-app离线打包支持,需使用HBuilderX(2.4.2.20191115)版本生成本地打包App资源。
- iOS平台 修复 Webview窗口使用WKWebview内核时截屏绘制(draw)设置 clip 参数无效的Bug 详情
- iOS平台 修复 Webview窗口全部关闭(close)时可能引起应用崩溃的Bug
- iOS平台 修复 Webview窗口设置自定义标题栏按钮点击时可能引起应用崩溃的Bug
- iOS平台 修复 视频播放(VideoPlayer)控件无法自动识别视频方向的Bug 详情
- iOS平台 修复 调用摄像头拍照(captureImage)时设置resolution参数为high、low、medium时可能引起图片显示方向不正确的Bug 详情
- iOS平台 修复 系统相册选择图片(plus.gallery.pick)可能返回不是选中图片的Bug 详情
- iOS平台 修复 文件下载暂停后再继续文件名后面会自动添加数字的Bug 详情
- iOS平台 修复 平台绝对路径转换成本地URL路径(plus.io.convertAbsoluteFileSystem)可能返回null的Bug 详情
- iOS平台 修复 设置应用屏幕常亮(plus.device.setWakelock)在iOS13.1.3系统可能引起崩溃的Bug
- iOS平台 修复 Native.JS获取当前Webview窗口的原生实例对象(plus.ios.currentWebview)可能返回为空的Bug 详情
- iOS平台 修复 创建本地消息(plus.push.createMessage)在iOS10及以上系统只显示最后一条的Bug 详情
- App-iOS平台 修复 nvue页面在iOS13及以上系统默认字体不对的Bug
- App-iOS平台 修复 nvue list 组件 scroll 事件返回的 isDragging 属性不正确的Bug 详情
- App-iOS平台 修复 nvue list 组件滚动时 scrollStart/scrollEnd 事件返回参数值为负数的Bug
- App-iOS平台 修复 nvue swiper 组件动态修改 current 属性触发 transition 事件返回的参数不准确的Bug
- App-iOS平台 修复 uni.hideKeyboard 不能收起软键盘的Bug #903
- App-iOS平台 修复 picker 组件可能被软键盘遮挡的Bug #888
- App-iOS平台 修复 input 组件输入中文时失焦导致文字消失的Bug #888
- App-iOS平台 修复 nvue text 组件设置 line-height 属性可能引起显示不正确的Bug
- App-iOS平台 修复 nvue live-pusher 组件设置 whiteness 属性为false不生效的Bug
- App-iOS平台 修复 nvue barcode 组件动态修改属性不生效的Bug
- App-iOS平台 修复 纯nvue项目 侧滑关闭后无法触发上个页面生命周期 onShow 的Bug 详情
2019年10月24日发布
点击下载SDK
注意:weexUniJs.js和uni-app-service.js这2个文件的路径有变化,需要重新引入自己的工程中,具体看官方的打包demo示例。
- 更新uni-app离线打包支持,需使用HBuilderX(2.3.7.20191024)版本生成本地打包App资源。
- iOS平台 修复 图片预览(plus.nativeUI.previewImage)3张图片且current属性设置为2时显示不正常的Bug 详情
- App-iOS平台 修复 nvue map组件的标记点(markers)的 iconPath 属性值设置为相对路径时可能引起应用崩溃的Bug 详情
2019年10月21日发布
点击下载SDK
注意:weexUniJs.js和uni-app-service.js这2个文件的路径有变化,需要重新引入自己的工程中,具体看官方的打包demo示例。
- 更新uni-app离线打包支持,需使用HBuilderX(2.3.6.20191021)版本生成本地打包App资源。
- App-iOS平台 修复 tabBar 页面因内存不足而白屏后无法自动恢复的Bug 详情
- App-iOS平台 修复 tabBar 设置 icon 图标可能无法显示的Bug 详情
- App-iOS平台 修复 nvue list组件 scroll 事件返回的参数缺少 isDragging 属性的Bug 详情
2019年10月18日发布
点击下载SDK
注意:weexUniJs.js和uni-app-service.js这个2个文件的路径有变化,需要重新引入自己的工程中,具体看官方的打包demo示例。
- 更新uni-app离线打包支持,需使用HBuilderX(2.3.5.20191018)版本生成本地打包App资源。
- iOS平台 更新 微信登录、分享、支付SDK(1.8.6.1),适配iOS13,需要配置通用链接(Universal Links)详情
- iOS平台 更新 QQ登录、分享SDK(3.3.6),新浪微博登录、分享SDK(3.2.5)
- iOS平台 修复 iOS13上配置后台播放音乐可能引起应用崩溃的Bug 详情
- iOS平台 修复 图片压缩(plus.zip.compressImage)设置缩放图片的宽度(width)和高度(height)无效的Bug 详情
- iOS平台 修复 iPhone11上查询设备是否为刘海屏(plus.navigator.hasNotchInScreen)返回值不正确的Bug 详情
- iOS平台 修复 视频播放(VideoPlayer)控件设置 show-progress 属性不生效的Bug
- iOS平台 修复 视频播放(VideoPlayer)控件设置 autoplay 属性值为 true 后加载雪花可能显示不正常的Bug
- iOS平台 修复 指纹识别(Fingerprint)判断当前设备是否支持(plus.fingerprint.isSupport)返回值可能不正确的Bug
- iOS平台 修复 Webview窗口设置软键盘模式(softinputMode)为adjustResize时,新开页面并弹出软键盘后返回可能白屏的Bug
- iOS平台 修复 数据库(SQLite)多次打开数据库后,调用判断数据库是否打开(plus.sqlite.isOpenDatabase)返回值可能不正确的Bug
- iOS平台 修复 数据库(SQLite)在HX中真机运行可能出现SQL语句操作(plus.sqlite.executeSql)无法正常执行的Bug
- App-iOS平台 新增 nvue live-pusher组件支持 orientation 属性设置画面方向
- App-iOS平台 修复 nvue map组件的点击控件事件 @controltap 不响应的Bug 详情
- App-iOS平台 修复 nvue barcode组件扫码成功触发 marked 事件返回参数条码数据为空的Bug 详情
- iOS平台 修复 系统相册选择图片文件时如果相册中没有图片返回时loading界面不消失的Bug
2019年09月23日发布
- 更新uni-app离线打包支持,需使用HBuilderX(2.3.3.20190923)版本生成本地打包App资源。
- iOS平台 修复 iOS13上保存图片到系统相册(plus.gallery.save)失败的Bug
- iOS平台 修复 非自定义组件编译模式 uni.request 无法跨域的Bug 详情
- iOS平台 修复 nvue swiper组件包含子组件少于3个时布局可能不正确的Bug
- iOS平台 修复 nvue video组件退出全屏动画时被其它组件覆盖的Bug
2019年09月21日发布
- 更新uni-app离线打包支持,需使用HBuilderX(2.3.2.20190921)版本生成本地打包App资源。
- iOS平台 修复 视频播放(VideoPlayer)控件退出全屏后状态栏方向不对的Bug 详情
- iOS平台 修复 iOS13上获取系统状态栏样式(plus.navigator.getStatusBarStyle)总是反馈dark,导致uni-app状态栏颜色混乱的Bug 详情
- iOS平台 修复 iOS13上获取系统状态高度不正确的Bug 详情
- iOS平台 修复 slider组件中的内容可能出现重叠的Bug
- iOS平台 修复 iOS13上input组件设置自动聚焦无效的Bug
- iOS平台 修复 nvue 组件 refresh 某些情况下闪退的 Bug
2019年09月20日发布
- 更新uni-app离线打包支持,需使用HBuilderX(2.3.1.20190920)版本生成本地打包App资源。
2019年09月20日发布
点击下载SDK
重要:因为增加uni的自定义组件,原barcode、video和livepush模块的依赖关系有所变化,具体参看Feature-iOS.xls文件和livepush
- 更新uni-app离线打包支持,需使用HBuilderX(2.3.0.20190919)版本生成本地打包App资源。
- iOS平台 新增 云打包支持配置Capabilities,如通用链接(Universal Link)详情
- iOS平台 新增 创建本地消息(plus.push.createMessage)支持设置标题(title)和副标题(subtitle) 详情
- iOS平台 更新 UniPush&个推推送SDK(2.4.1.0)适配iOS13
- iOS平台 更新 友盟统计SDK(6.0.5)适配iOS13,注意:新版本要求应用使用广告标识IDFA 详情
- iOS平台 修复 使用录音对象(AudioRecorder)时如果用户不允许访问麦克风(未授权)不触发失败回调的Bug
- iOS平台 修复 音频播放对象(AudioPlayer)的setStyles方法设置开始播放位置(startTime)不准确,isPaused方法获取播放状态不准确的Bug 详情
- iOS平台 修复 视频播放(VideoPlayer)控件无法播放带身份认证的rtsp地址的Bug 详情
- iOS平台 修复 视频播放(VideoPlayer)控件在iOS13上退出全屏后显示位置不正确的Bug
- iOS平台 修复 蓝牙(Bluetooth)停止搜索设备后再开始可能无法返回之前搜索到的设备,及搜索设置allowDuplicatesKey参数无效的Bug。
- iOS平台 修复 获取网络gif图片信息(plus.io.getImageInfo)引起应用崩溃的Bug
- iOS平台 修复 Webview窗口设置滑屏(drag)后,侧滑返回操作可能引起应用崩溃的Bug 详情
- iOS平台 修复 应用仅配置横屏时调用系统相册选择图片(plus.gallery.pick)时引起应用崩溃的Bug 详情
- iOS平台 修复 图片压缩转换(plus.zip.compressImage)处理图片分辨率过高可能造成内存溢出引起应用崩溃的Bug 详情
- iOS平台 修复 图片预览(plus.nativeUI.previewImage)显示高分辨率图片可能超出内存溢出引起应用崩溃的Bug
- iOS平台 修复 直播推流(LivePusher)控件配置开启摄像头(enable-camera)属性导致无法推视频流的Bug
- iOS平台 修复 直播推流(LivePusher)控件设置视频模式(mode)属性和宽高比(aspect)属性可能不生效的Bug
- iOS平台 修复 获取图片信息(plus.io.getImageInfo)传入网络图片地址无法下载图片时触发成功回调的Bug
- iOS平台 修复 Webview窗口背景设置为深色时,Tab栏上面会出现白条的Bug 详情
- iOS平台 修复 Webview窗口使用WKWebview内核时overrideUrlLoading方法无效的Bug 详情
- iOS平台 修复 蓝牙(Bluetooth)开始搜索后不停止直接关闭页面可能会引起应用崩溃的Bug
- iOS平台 修复 uni-app中subNVue页面可能无法接收到父页面通过subNVue.postMessage发送的消息的Bug 详情
- iOS平台 修复 nvue iPhoneX设备软键盘弹出时页面偏移位置不准确的Bug 详情
- iOS平台 修复 nvue map组件添加的子组件可能无法显示的Bug 详情
- iOS平台 修复 nvue swipe组件高度动态变化后切页显示不正常的Bug 详情
- iOS平台 修复 nvue video标签设置封面图片(poster)后动态修改src属性可能引起应用崩溃的Bug 详情
- iOS平台 修复 nvue video标签设置自动播放(autoplay)为true不生效的Bug
- iOS平台 修复 nvue video标签中退出全屏后覆盖元素显示不正常的Bug
- iOS平台 修复 nvue input组件设置adjust-position属性值为false无效的Bug 详情
- iOS平台 修复 nvue webSocket模块设置多个协议(protocol)导致连接服务器失败的Bug
- iOS平台 修复 nvue bindingx在uni-app编译模式下拖拽组件时偏移系数不正确的Bug
- iOS平台 修复 uni原生插件实现代理方法(application:openURL:options:)后与第三方应用交互(如调用微信登录)引起应用崩溃的Bug
- iOS平台 修复 uni原生插件实现代理方法(application:handleOpenURL:)不触发,导致无法获取第三方应用返回数据的Bug
2019年08月19日发布
点击下载SDK
重要:因为增加uni的自定义组件,原barcode、video和livepush模块的依赖关系有所变化,具体参看Feature-iOS.xls文件和livepush
- 更新uni-app离线打包支持,需使用HBuilderX(2.2.2.20190816)版本生成本地打包App资源。
2019年08月14日发布
点击下载SDK
重要:因为增加uni的自定义组件,原barcode、video和livepush模块的依赖关系有所变化,具体参看Feature-iOS.xls文件和livepush
- 更新uni-app离线打包支持,需使用HBuilderX(2.2.1.20190813)版本生成本地打包App资源。
- iOS平台 更新 高德地图SDK:基础SDK(v1.5.7)、3D地图SDK(v6.9.0)、搜索功能(v6.9.0),修复多次打开关闭地图页面引起应用崩溃的Bug 详情
- iOS平台 修复 视频播放(VideoPlayer)控件的timeupdate事件不触发的Bug 详情
- iOS平台 修复 视频播放(VideoPlayer)控件全屏时音量调节手势功能无效的Bug
- iOS平台 修复 Webview窗口配置系统软键盘模式(softinputMode)为adjustResize,收起软键盘后窗口高度无法恢复的Bug 详情
- iOS平台 修复 uni-app项目打包模块配置中勾选“Maps(地图)”但不配置高德或百度地图SDK参数引起提交云端打包失败的Bug
2019年08月12日发布
点击下载SDK
重要:因为增加uni的自定义组件,原barcode、video和livepush模块的依赖关系有所变化,具体参看Feature-iOS.xls文件和livepush
- 更新uni-app离线打包支持,需使用HBuilderX(2.2.0.20190810)版本生成本地打包App资源。
- iOS平台 新增 视频播放(VideoPlayer)控件支持设置倍速播放(playbackRate)
- iOS平台 修复 视频播放(VideoPlayer)控件在页面关闭后可能还会在后台重新播放的Bug 详情
- iOS平台 修复 横竖屏设置中landscape-primary、landscape-secondary方向与android平台相反的Bug
- iOS平台 修复 使用plus.maps.create创建地图设置宽高为用百分比时计算不准确的Bug 详情
- iOS平台 修复 蓝牙(Bluetooth)订阅特征值变化(notifyBLECharacteristicValueChange)后触发onBLECharacteristicValueChange事件逻辑不正确的Bug
- iOS平台 修复 蓝牙(Bluetooth)特征值的写(write)属性可能获取不正确的Bug
- iOS平台 修复 蓝牙(Bluetooth)特征值读(readBLECharacteristicValue)或写(writeBLECharacteristicValue)操作可能不触发回调的Bug
2019年07月24日发布
点击下载SDK
重要:因为增加uni的自定义组件,原barcode、video和livepush模块的依赖关系有所变化,具体参看Feature-iOS.xls文件和livepush
- 更新uni-app离线打包支持,需使用HBuilderX(2.1.3.20190723)版本生成本地打包App资源。
- iOS平台 修复 UniPush通过苹果APNS通道下发payload为字符串内容时,点击触发click事件中消息对象的payload属性值自动转换为包含无效数据json类型的Bug
- iOS平台 修复 nvue页面中获取渠道标识(plus.runtime.channel)返回值不正确的Bug
- iOS平台 修复 真机运行时偶发页面无法渲染(白屏)的Bug 详情
2019年07月16日发布
点击下载SDK
重要:因为增加uni的自定义组件,原barcode、video和livepush模块的依赖关系有所变化,具体参看Feature-iOS.xls文件和livepush
- 更新uni-app离线打包支持,需使用HBuilderX(2.1.1.20190716)版本生成本地打包App资源。
- iOS平台 修复 uni-app使用非自定义组件模式编译可能出现卡在splash界面或崩溃闪退的Bug 详情
- iOS平台 修复 5+应用使用WKWebview在某些情况下可能引起闪退的Bug
- iOS平台 修复 webview的circle样式下拉刷新操作不流畅和显示细节不正确的Bug 详情
2019年07月15日发布
点击下载SDK
重要:因为增加uni的自定义组件,原barcode、video和livepush模块的依赖关系有所变化,具体参看Feature-iOS.xls文件和livepush
- 更新uni-app离线打包支持,需使用HBuilderX(2.1.0.20190713)版本生成本地打包App资源。
- iOS平台 修复 提交苹果应用市场(AppStore)审核提示违反Guideline2.5.2的Bug 详情
- iOS平台 修复 音频播放(AudioPlayer)后台播放网络音乐时控制页面(iOS锁屏控制页)进度显示不准确的Bug 详情
- iOS平台 修复 数据库(SQLite)在多个页面同时操作时可能无效的Bug 详情
- iOS平台 修复 Webview窗口设置不替换H5标准定位接口(replacewebapi:{geolocation:'none'})不生效的Bug
- iOS平台 修复 日期选择(plus.nativeUI.pickDate)设置显示日期小于起始日期时默认返回的日期不正确的Bug 详情
- iOS平台 修复 获取图片信息(plus.io.getImageInfo)可能不触发回调的Bug 详情
- iOS平台 修复 非自定义组件模式在某些情况子窗口高度计算不正确的Bug 详情
- iOS平台 修复 视频控件(VideoPlayer)播放时拖放调整进度后可能不触发播放结束事件的Bug
- iOS平台 修复 子Webview窗口中软键盘收起后页面无法自动恢复的Bug 详情
- iOS平台 修复 蓝牙(Bluetooth)第一次获取本机蓝牙适配器状态(getBluetoothAdapterState)不触发回调的Bug 详情
- iOS平台 修复 蓝牙(Bluetooth)特征值的write操作类型值为false时无法写入数据的Bug 详情
- iOS平台 修复 蓝牙(Bluetooth)特征值的notify操作类型值为true时无法订阅的Bug 详情
- iOS平台 修复 nvue页面打开vue页面后弹出软键盘时可能会露出之前nvue页面内容的Bug
- iOS平台 修复 nvue页面中img标签src属性不支持"_doc"等开头的图片地址的Bug 详情
- iOS平台 修复 地图控件中的标点对象(marker)在新开页面后再返回时点击报js错误的bug 详情
- iOS平台 修复 nvue页面中获取渠道标识(plus.runtime.channel)返回值不正确的Bug
2019年06月14日发布
- 更新uni-app离线打包支持,需使用HBuilderX(2.0.1.20190614)版本生成本地打包App资源。
2019年06月11日发布
- 更新uni-app离线打包支持,需使用HBuilderX(2.0.0.20190610)版本生成本地打包App资源。
- iOS平台 修复 提交苹果应用市场(AppStore)审核提示违反Guideline2.5.2的Bug 详情
- iOS平台 修复 音频播放(AudioPlayer)后台播放网络音乐时控制页面(iOS锁屏控制页)进度显示不准确的Bug 详情
- iOS平台 修复 日期选择对话框(plus.nativeUI.pickDate)返回日期可能不准确的Bug 详情
- iOS平台 修复 Webview窗口移除原生控件(plus.nativeObj.View)不生效的Bug
- iOS平台 修复 Webview窗口获取样式(getStyle)返回的json对象键名称全部为小写的Bug
2019年05月23日发布
- 更新uni-app离线打包支持,需使用HBuilderX(1.9.9.20190522)版本生成本地打包App资源。
- iOS平台 修复 HBuilderX1.9.8版本引出的网络请求url编码的地址包含#等锚点时可能获取不到数据的Bug。
- iOS平台 修复 自定义组件模式下调用地图控件对象的resize方法会引起程序崩溃的Bug。
- 注意离线打包时如果弹出提示框且内容为:“HTML5+ Rumtime D”时,需要在打包的原生工程里配置国际化如何配置
2019年05月19日发布
- 更新uni-app离线打包支持,需使用HBuilderX(1.9.8.20190518)版本生成本地打包App资源。
- iOS平台 修复 Webview窗口打开页面地址中包含表情字符串时可能引起崩溃的问题
2019年05月18日发布
- 更新uni-app离线打包支持,需使用HBuilderX(1.9.7.20190517)版本生成本地打包App资源。
- iOS平台 修复 uni-app中设置nvue页面为首页时要6s才能进入应用的Bug
- iOS平台 修复 Webview窗口的下拉刷新雪花可能会被系统状态栏覆盖的Bug
- iOS平台 修复 通过setstyle重设searchInput的placehold时,会把其他参数覆盖的Bug
- iOS平台 修复 真机运行wap2app后再运行uni-app可能无法正常显示的Bug
- iOS平台 修复 原生图片轮播控件(plus.nativeObj.ImageSlider)可能显示不正常的Bug 详情
- iOS平台 修复 原生控件(plus.nativeObj.View)绘制png图片可能无法支持透明的Bug 详情
- iOS平台 修复 uni-app在非自定义组件模式下调用原生插件可能报JS错误(plus.postMessage is not a function)的Bug
- iOS平台 修复 地图控件调用setStyles方法更新样式不生效的Bug
- iOS平台 修复 地图控件可能报JS错误 Can't find variable: WeexPlus 的Bug 详情
- iOS平台 修复 视频播放控件(VideoPlayer)切换到全屏播放时画面可能会卡住的Bug
- iOS平台 修复 视频播放控件(VideoPlayer)可能出现画面被压缩的Bug 详情
- iOS平台 修复 数据库(SQLite)操作在一个db文件中创建多个数据库时异常的Bug 详情
- iOS平台 修复 iOS11及以下系统plus.net.XMLHttpRequest使用GET请求调用send设置body参数可能导致请求失败的Bug
- iOS平台 修复 iOS10及以下系统播放音频(plus.audio.AudioPlayer)可能引起崩溃的Bug
- iOS平台 修复 录制mp3文件时会提前触发录音完成回调,此时调用播放可能引起无法触发播放完成事件的Bug
- iOS平台 修复 uni-app在自定义组件模式下向低功耗蓝牙设备指定特征值写入数据操作无效的Bug
- iOS平台 修复 uni-app在自定义组件模式下native.js的plus.ios.import方法调用时报js错误的Bug 详情
- iOS平台 修复 uni-app在自定义组件模式下报weex-polyfill找不到的Bug 详情
- iOS平台 修复 uni-app在自定义组件模式下使用new方法创建的地图无法再append到其它窗口的Bug 详情
- iOS平台 修复 uni-app在自定义组件模式下调用加速度相关接口(plus.accelerometer)时报js错误的Bug
- iOS平台 修复 uni-app在自定义组件模式下获取当前连接的网络类型可能不正确的Bug
- iOS平台 修复 uni原生插件开发在非自定义组件模式下返回js层数据中包含不支持的数据类型导致插件方法调用失败的Bug
2019年04月27日发布
- 更新uni-app离线打包支持,需使用HBuilderX(1.9.4.20190426)版本生成本地打包App资源。
- 新增 Webview窗口标题栏上搜索框(searchInput)支持设置输入的文本内容 文档
- iOS平台 修复 页面使用UIWebview渲染设置softinputMode为adjustResize时弹出软键盘后可能白屏的问题
- iOS平台 修复 uni-app在自定义组件模式下使用地图可能报js错误的问题
- iOS平台 修复 uni-app在自定义组件模式下使用直播推流(LivePusher)控件报js错误的问题
2019年04月23日发布
- 更新uni-app离线打包支持,需使用HBuilderX(1.9.3.20190422)版本生成本地打包App资源。
- iOS平台 修复 nvue页面设置titleNView为false时显示不正确的bug 详情
- iOS平台 修复 nvue页面设置显示titleNView时页面高度可能计算不正确的bug
- iOS平台 修复 页面使用UIWebview渲染设置softinputMode为adjustResize时弹出软键盘后可能会出现黑色区域的问题
- iOS平台 修复 uni-app设置为自定义组件模式时在iOS8.x系统页面白屏的问题
- Hello H5+ 新增 数据库(SQLite)操作示例页面
2019年04月18日发布
- 更新uni-app离线打包支持,需使用HBuilderX(1.9.2.20190417)版本生成本地打包App资源。
- iOS平台 修复 uni-app在非自定义组件模式下调用uni原生插件报plus.postMessage错误的问题 详情
- iOS平台 修复 打开蓝牙适配器可能不触发回调的问题 详情
- iOS平台 修复 Webview窗口标题栏上的搜索框(searchInput)失去焦点后输入的文本不显示的问题
- iOS平台 修复 uni-app在自定义组件模式下console.log只能输出最后一个参数的问题
2019年04月16日发布
- 更新uni-app离线打包支持,需使用HBuilderX(1.9.1.20190415)版本生成本地打包App资源。
- iOS平台 修复 使用WKWebview后在应用首页可能出现侧滑返回到白色页面的问题
- iOS平台 修复 推送(push)消息事件监听回调可能报js错误的问题
2019年04月13日发布
- 更新uni-app离线打包支持,需使用HBuilderX(1.9.0.20190412)版本生成本地打包App资源。
- iOS平台 新增 音频播放(AudioPlayer)支持后台控制器(锁屏播放控制面板)功能
- iOS平台 新增 获取设备安全区域接口(plus.navigator.getSafeAreaInsets)。文档
- iOS平台 修复 录音(AudioRecorder)设置格式为mp3时出现时长不正确的问题
- iOS平台 修复 页面中使用原生控件(plus.nativeObj.View)侧滑返回时可能出现js错误的问题
- iOS平台 修复 页面的softinputMode设置为adjustResize时,软键盘弹出可能会出现页面上移的问题
- iOS平台 修复 页面编辑框失去焦点时会自动滚动到顶部的问题
- iOS平台 修复 图片预览(plus.nativeUI.previewImage)初始显示宽度不正确的问题
- iOS平台 更新 高德地图:基础SDK(v1.5.6)、3D地图SDK(v6.7.0)、搜索功能(v6.5.0)
2019年04月01日发布
- 更新uni-app离线打包支持,需使用HBuilderX(1.8.2.20190330)版本生成本地打包App资源。
- 【重要】新增 SQLite模块(plus.sqlite.*),支持操作本地数据库文件。打包配置指南。API文档
- iOS平台 修复 创建Webview时设置softinputNavBar属性不生效的问题
- iOS平台 修复 提交云端打包后调用新浪微博分享可能出现应用卡死的问题
- iOS平台 修复 图片预览(plus.nativeUI.previewImage)设置current参数大于图片总数时显示逻辑异常的问题
- iOS平台 修复 蓝牙写入特征值时在部分设备上可能出现无法写入的问题
- iOS平台 修复 模拟器上真机运行更新时可能卡在正在重启的问题
2019年03月15日发布
- 更新uni-app离线打包支持,需使用HBuilderX(1.7.0.20190314)版本生成本地打包App资源。
- 新增 自定义基座运行应用时toast提示“当前应用运行在自定义基座中”,避免将自定义基座作为正式包发布
- 新增 Webview窗口标题栏(titleNView)上的按钮支持配置最大宽度(maxWidth)
- 新增支持获取uni-app运行环境版本接口(plus.runtime.uniVersion)
- iOS平台 新增 Webview窗口支持设置是否隐藏软键盘上的导航条(softinputNavBar)
- iOS平台 修复 在iOS12及以上系统WKWebview软键盘弹出后无法完全收回的问题
- iOS平台 修复 在iOS11.4及以上系统弹出软键盘后可能出现页面会整体上移并出现黑色背景的问题
- iOS平台 修复 视频控件(VideoPlayer)无法播放部分rtsp、rtmp视频,timeupdate事件可能不触发等问题
- iOS平台 修复 视频控件(VideoPlayer)在iOS9.x上播放m3u8视频可能引起崩溃的问题
- iOS平台 修复 Webview窗口标题栏(titleNView)在透明样式下按钮文字初始颜色不正确的问题
- iOS平台 修复 部分蓝牙设备可能无法搜索到,蓝牙服务uuid和特征值uuid格式不正确等问题
- iOS平台 修复 uni-app在iOS8.x系统上页面无法渲染出内容的问题
- iOS平台 修复 nvue页面中websocket连接总是失败的问题
2019年02月21日发布
点击下载SDK
1、更新uni-app离线打包支持,需使用HBuilderX(1.6.2.20190220)版本生成本地打包App资源。
2、iOS平台 修复 应用首页配置为WKWebview时可能出现启动后白屏的问题
3、iOS平台 修复 相册选择文件界面(plus.gallery.pick)未自动适配系统语言的问题
4、iOS平台 修复 Webview窗口titleNView的buttons中不设置text属性可能会卡死、colour属性无法动态修改的问题
5、iOS平台 修复 提交Appstore提示使用非公开API(DirectoryWatcher)的问题
6、iOS平台 更新 云打包编译环境为XCode10.1,解决提交AppStore提示“WARNING ITMS-90725”的问题
2019年01月21日发布
点击下载SDK
1、更新uni-app离线打包支持,需使用HBuilderX(1.5.1或1.5.2)版本生成本地打包App资源。
2、调整sdk包中HBuilder-Hello工程里默认为高德地图。
3、新增 标题栏按钮(WebviewTitleNViewButtonStyles)支持红点、角标和向下箭头等。
4、iOS平台 修复 原生控件(NView)可能出现点击事件不触发的问题(影响使用NView实现Tab切换页面功能)
5、iOS平台 修复 视频播放(VideoPlayer)控件隐藏后还继续播放的问题
6、iOS平台 修复 窗口使用UIWebview内核可能出现拦截资源不生效的问题
7、iOS平台 修复 地图控件缩放时可能出现标点漂移的问题
8、iOS平台 修复 地图控件的标点可能出现点击不生效的问题
9、iOS平台 修复 WAP2APP应用中小米推送可能接收不到消息的问题
10、iOS平台 修复 获取摄像头对象(plus.camera.getCamera)指定摄像头索引值不生效的问题
11、iOS平台 修复 nvue页面不支持websocket模块的问题
2018年12月26日发布
- 更新uni-app离线打包支持,需使用HBuilderX(1.4.0.XXXX)版本生成本地打包App资源.
- Webview窗口设置是否自动调整.
3.内容区域避免与安全区域或系统状态栏重合,参考:地址.
4.iOS平台 修复 图片压缩(plus.zip.compressImage)的overwrite参数不生效的问题.
5.iOS平台 修复 保存图片到相册使用相对路径时可能导致程序异常的问题.
6.iOS平台 修复 在WAP2APP应用中微信分享成功没有触发回调函数的问题.
7.iOS平台 修复 视频播放控件(VideoPlayer)通过setStle设置height属性不生效的问题.
2018年12月12日发布
点击下载SDK
1、更新uni-app离线打包支持,需使用HBuilderX(1.3.1.20181211)版本生成本地打包App资源.
2、iOS平台 更新 支付宝App支付SDK(v15.5.7).
3、iOS平台 修复 通过Scheme启动应用plus.runtime.arguments可能获取不到启动参数的问题.
4、iOS平台 修复 设置Storage数据(plus.storage.setItem)可能引起程序崩溃的问题.
5、iOS平台 修复 视频播放控件(VideoPlayer)播放某些视频最后几秒可能一直缓冲的问题.
6、iOS平台 修复 视频播放控件(VideoPlayer)拖动播放进度后修改src可能不会自动播放的问题.
7、iOS平台 修复 地图控件来回移动操作后可能导致标点对象(Marker)变形的问题.
8、iOS平台 修复 百度定位可能引起应用崩溃的问题.
2018年5月11日发布
点击下载SDK
1 修复近期发现的一些bug,提升稳定性
2 更新微信SDK,新版微信SDK有带支付和不带支付两个版本,使用微信支付的开发者需要在工程中引入libWeChatSDK_pay.a。
使用了微信分享和登录但未使用支付的用户需要在工程中引入libWeChatSDK.a。
未使用微信支付功能的用户引入libWeChatSDK_pay.a在提交AppStore审核时可能会因为支付通道问题被拒绝
-->
离线SDK下载已迁移到新地址,android 离线SDK下载地址、iOS 离线SDK下载地址
<!--
> 注意:本文SDK对应的是HBuilderX的正式版。alpha版的SDK下载地址另见HTML5+ SDK (alpha版)
> 注意:本SDK适合5+App的离线打包、原生能力扩展,适合uni-app的App端离线打包
> 注意:本SDK不适合uni-app扩展原生能力,如有相关需求,另见文档为uni-app扩展原生插件
> 注意:本SDK不适合原生App中部分栏目使用uni-app的集成方式,此需求应该使用uni小程序sdk,另见文档在原生App中集成uni小程序sdk
Android 平台 HTML5+ SDK 更新日志
2020年04月22日发布
重要:因新版本去掉基础aar中的权限,所以请根据自身需求添加所需权限,权限可参考SDK中示例进行添加。
重要:更新SDK是,需同时更新SDK目录/SDK/assets/data/目录下所有文件。
重要:如需操作Application,必须要继承自DCloudApplication。
- 更新uni-app离线打包支持,需使用HBuilderX(2.6.15.20200421)版本生成本地打包App资源。
- 修复 v2版本apk使用wgt升级资源后,用v3版本apk覆盖安装无法进入应用的Bug
- 修复 nvue rich-text 组件 img 标签可能不显示的Bug
- 修复 nvue input 组件 font-size 值设置过大时光标可能不显示的Bug
- 修复 nvue input 组件设置 type 为 digit/number 时弹出键盘类型不正确的问题
- 修复 vue map 组件 marker 属性打包后图片不显示的Bug
- 修复 tabBar 页面设置 titleNView 的 type 为 transparent 滚动时标题栏透明度不发生变化的Bug
- 修复 nvue 页面跳转到 vue 页面后,input 组件获得焦点时可能无法弹出软键盘的Bug
- 新增 pop-in/pop-out 动画时通过 animationAlphaBGColor 设置动画蒙层背景色,可用于避免暗色风格页面转场动画的蒙层偏白
- 修复 uni-AD 腾讯广点通部分视频激励广告播放 30 秒后点击关闭按钮触发 onClose 事件参数中 isEnded 属性可能为 false 的Bug
- 修复 Webview窗口对象 loadURL 方法没有触发 overrideUrlLoading 拦截回调函数的Bug
- 修复 显示系统软键盘 plus.key.showSoftKeybord 多次调用会触发关闭软键盘的Bug
- 修复 storage存储键值通过 setItem 方法传入 value 为空字符串后,通过 getItem 方法返回 null 的Bug
- 修复 同时创建两个音频播放对象,其中一个音频暂停后另一个无法播放的Bug
- 修复 视频播放控件 VideoPlayer 播放部分 rtmp 链接可能无声音的Bug
- 修复 确认模态框 confirm 显示时会弹出软键盘的Bug
Android平台历史版本
2020年04月10日发布
重要:因新版本去掉基础aar中的权限,所以请根据自身需求添加所需权限,权限可参考SDK中示例进行添加。
重要:更新SDK是,需同时更新SDK目录/SDK/assets/data/目录下所有文件。
重要:如需操作Application,必须要继承自DCloudApplication。
- 更新uni-app离线打包支持,需使用HBuilderX(2.6.11.20200409)版本生成本地打包App资源。
- 修复 nvue web-view 组件 src 属性的链接地址中带 query 参数无效的Bug
- 修复 nvue web-view、image 等组件 src 属性资源地址为_doc、_download路径时可能无法正常载入的Bug
- 修复 nvue list/waterfall 组件底部使用 loading 加载更多时,无法正常触发 @loading 事件的Bug
- 修复 nvue list 组件 @scroll 事件返回参数 contentOffset.y 值域不正确的Bug
- 修复 uni.sendSocketMessage 无法发送某些 bytebuffer 数据的Bug
- 新增 uni-AD 激励视频广告支持服务器回调(限今日头条穿山甲广告)
- 新增 Webview窗口标题栏 titleNView 的 titleIcon 支持网络图标路径
- 修复 Webview窗口对象 loadURL 方法 headers 参数设置无效的Bug
- 修复 在Android10上第一次安装后启动可能引起应用崩溃的Bug
- 修复 应用标识 AppID 使用www结尾时导致部分资源无法正常载入的Bug
- 修复 百度语音识别时在部分设备可能返回 4004 app name unknown 错误的Bug
- 修复 设置应用图标显示角标数字 plus.runtime.setBadgeNumber 在部分设备超过100时仍然显示99的Bug
- 修复 文件系统目录对象 DirectoryEntry 的 getFile 方法返回错误信息不准确的Bug
- 修复 调用 plus.gellay.pick 通过QQ浏览器选择图片或视频在部分设备可能无响应的Bug
- 修复 HBuilderX 2.6.1引出的获取Cookie值 plus.navigator.getCookie 返回数据不正确的Bug
2020年04月03日发布
重要:因新版本去掉基础aar中的权限,所以请根据自身需求添加所需权限,权限可参考SDK中示例进行添加。
重要:更新SDK是,需同时更新SDK目录/SDK/assets/data/目录下所有文件。
重要:如需操作Application,必须要继承自DCloudApplication。
- 更新uni-app离线打包支持,需使用HBuilderX(2.6.9.20200403)版本生成本地打包App资源。
- 新增 获取当前屏幕宽高信息接口 plus.screen.getCurrentSize
2020年03月31日发布
重要:因新版本去掉基础aar中的权限,所以请根据自身需求添加所需权限,权限可参考SDK中示例进行添加。
重要:更新SDK是,需同时更新SDK目录/SDK/assets/data/目录下所有文件。
重要:如需操作Application,必须要继承自DCloudApplication。
- 更新uni-app离线打包支持,需使用HBuilderX(2.6.8.20200330)版本生成本地打包App资源。
- 优化 storage 相关 API 性能
- 修复 pages.json 内配置 softinputMode 为 adjustResize 部分情况下失效的Bug
- 修复 nvue video 组件在页面中存在多个且包含 cover-view 全屏播放时闪退的Bug
- 修复 nvue video 组件设置 click 事件后视频操作按钮无法触发的Bug
- 修复 nvue waterfall 组件加入 Refresh 后item排版错乱的Bug
- 修复 tabBar 的 midButton 设置 backgroundImage 显示不正常的Bug
- 修复 国产安卓模拟器 uni.getSystemInfo 获取设备宽高错误的Bug
- 修复 v3版本 map 组件绑定宽高后无法动态修改的Bug
- 修复 v3版本 nvue 为首页时 autoclose 设置为 false 也会自动关闭启动页的Bug
- 修复 v3版本 SocketTask.onMessage 接收数据类型为 ArrayBuffer 时解析错误的Bug
- 新增 原生标题栏支持自定义返回按钮角标、标题图标、副标题等功能
- 修复 Webview窗口的 WebviewEvent 事件回调函数参数没有 target 属性的Bug
- 优化 本地数据存储 plus.storage 性能,新增异步操作接口
- 修复 uni-AD 激励视频云端打包勾选穿山甲,广告平台没有通过审核时可能引起应用崩溃的Bug
- 修复 提交华为应用市场检查可能误报 TrojanDropper.Agent.EIY 病毒的Bug
- 修复 页面中a标签设置非法链接后,点击可能出现应用闪退的Bug
- 修复 在部分华为手机上修改文件名之后,使用input标签type为file时获取文件名称可能为随机数字的Bug
- 修复 Webview窗口标题栏(titleNView)设置type为transparent时,其它原生控件(如VideoPlayer)可能会覆盖标题栏的Bug
- 修复 页面中input标签触发软键盘收回时可能影响 WebviewStyles 中的top属性不生效的Bug
- 修复 获取UA值 plus.navigator.getUserAgent 返回为空的Bug
- 修复 视频播放控件 VideoPlayer 跳转到指定位置之后,弹幕仍然按照之前的进度播放的Bug
- 修复 视频播放控件 VideoPlayer 未指定 direction 时没有根据视频的宽高自动选择 direction 的Bug
- 修复 地图控件 setCenter 后不触发 onstatuschanged 事件的Bug
- 修复 HBuilderX2.6.5 引出的在Android4.4系统设备无法正常运行的Bug
- 修复 系统选择按钮框底部取消按钮UI显示不正常的Bug
2020年03月19日发布
重要:因新版本去掉基础aar中的权限,所以请根据自身需求添加所需权限,权限可参考SDK中示例进行添加。
重要:更新SDK是,需同时更新SDK目录/SDK/assets/data/目录下所有文件。
重要:如需操作Application,必须要继承自DCloudApplication。
- 更新uni-app离线打包支持,需使用HBuilderX(2.6.5.20200314)版本生成本地打包App资源。
- 修复 在Android4.4系统设备无法正常运行的Bug
- 修复 提交华为应用市场检查可能误报 TrojanDropper.Agent.EIY 病毒的Bug
2020年03月14日发布
重要:因新版本去掉基础aar中的权限,所以请根据自身需求添加所需权限,权限可参考SDK中示例进行添加。
重要:更新SDK是,需同时更新SDK目录/SDK/assets/data/目录下所有文件。
重要:如需操作Application,必须要继承自DCloudApplication。
- 更新uni-app离线打包支持,需使用HBuilderX(2.6.5.20200314)版本生成本地打包App资源。
- 修复 nvue map 组件不设置 markers 属性导致tap事件不触发的Bug
- 修复 云打包后 uni.getImageInfo() 获取本地图片信息可能会触发失败回调的Bug
- 修复 v3版本 wgt热更新后无法打开新增页面的Bug
- 修复 nvue video 组件在页面中存在多个且包含 cover-view 全屏播放时闪退的Bug
- 新增 原生标题栏支持自定义返回按钮、标题居左、标题栏背景图、背景渐变色等功能
- 新增 视频播放控件 VideoPlayer 支持全屏播放时点击事件 fullscreenclick
- 新增 原生隐私与政策提示框配置
- 优化 云端打包默认需要的系统权限,支持配置是否自动添加第三方SDK需要的权限
- 优化 Webview窗口加载可缩放页面时默认隐藏系统缩放控制条
- 修复 获取系统语言信息 plus.os.language 字符中没有包含地区信息的Bug
2020年02月26日发布
重要:因新版本去掉基础aar中的权限,所以请根据自身需求添加所需权限,权限可参考SDK中示例进行添加。
重要:更新SDK是,需同时更新SDK目录/SDK/assets/data/目录下所有文件。
重要:如需操作Application,必须要继承自DCloudApplication。
- 更新uni-app离线打包支持,需使用HBuilderX(2.6.1.20200226)版本生成本地打包App资源。
2020年02月24日发布
点击下载SDK
重要:因新版本去掉基础aar中的权限,所以请根据自身需求添加所需权限,权限可参考SDK中示例进行添加。
重要:更新SDK是,需同时更新SDK目录/SDK/assets/data/目录下所有文件。
重要:如需操作Application,必须要继承自DCloudApplication。 - 更新uni-app离线打包支持,需使用HBuilderX(2.6.0.20200223)版本生成本地打包App资源。
- 新增 plus.ad 广告模块,聚合穿山甲、广点通、360联盟等uni-AD联盟服务,支持信息流、banner、激励视频等应用内自定义广告
- 新增 Webview窗口样式支持设置禁止调用plus属性 disablePlus,解决加载外部页面时可能调用plus对应用造成危害的隐患
- 新增 数据库执行SQL语句 plus.sqlite.executeSql 支持一次传入多条语句,解决Android平台一条SQL语句中不支持以分号分割多条命令的需求
- 新增 推送 支持异步获取客户端推送标识接口 plus.push.getClientInfoAsync,解决同步接口可能返回空数据的问题
- Android平台 新增 腾讯X5内核。可解决rom自定义主题字体适配、低端机浏览器兼容性等问题
- 修复 Webview窗口创建并显示后立即关闭可能出现闪退的Bug
- 修复 在定时器回调函数中调用 plus.screen.lockOrientation 可能会引起应用闪退的Bug
- 修复 在部分手机上获取OAID可能触发错误回调,错误信息提示不支持的Bug
- 修复 调用系统分享消息 plus.share.sendWithSystem 标题不支持国际化的Bug
- 修复 音频播放对象 AudioPlayer 触发end事件之后,调用 stop 和 destroy 方法会出现闪退的Bug
2020年01月04日发布
点击下载SDK
重要:因新版本去掉基础aar中的权限,所以请根据自身需求添加所需权限,权限可参考SDK中示例进行添加。
重要:更新SDK是,需同时更新SDK目录/SDK/assets/data/目录下所有文件。
重要:如需操作Application,必须要继承自DCloudApplication。 - 更新uni-app离线打包支持,需使用HBuilderX(2.5.1.20200103)版本生成本地打包App资源。
- 更新 高德地图SDK(7.1.0)
- 修复 Webview窗口关闭后可能出现内存占用不释放的Bug
- 修复 数据库执行SQL语句 plus.sqlite.executeSql 不支持多条sql语句的Bug
- 修复 真机运行默认将日志保存到SD卡中,长时间运行可能出现日志文件过大的Bug
2019年12月11日发布
点击下载SDK
重要:因新版本去掉基础aar中的权限,所以请根据自身需求添加所需权限,权限可参考SDK中示例进行添加。
重要:更新SDK是,需同时更新SDK目录/SDK/assets/data/目录下所有文件。
重要:如需操作Application,必须要继承自DCloudApplication。 - 更新uni-app离线打包支持,需使用HBuilderX (2.4.6.20191210)版本生成本地打包App资源。
- 修复 选择位置 概率出现定位中心点不居中的Bug
- 优化 启动时申请手机存储权限,若用户拒绝则会弹出说明文字。满足部分应用商店要求的权限申请需申明的要求
- 修复 Webview窗口设置drag滑屏操作手势,快速滑动操作可能引起白屏的Bug
- 修复 视频播放控件(VideoPlayer)可能无法播放某些本地视频文件的Bug
- 修复 数据库执行SQL语句(plus.sqlite.executeSql)传入错误sql语句时,可能在控制台输出错误日志且不触发错误回调的Bug
2019年11月15日发布
点击下载SDK
重要:因新版本去掉基础aar中的权限,所以请根据自身需求添加所需权限,权限可参考SDK中示例进行添加。
重要:更新SDK是,需同时更新SDK目录/SDK/assets/data/目录下所有文件。
重要:如需操作Application,必须要继承自DCloudApplication。 - 更新uni-app离线打包支持,需使用HBuilderX(2.4.2.20191115)版本生成本地打包App资源。
- 新增 获取移动智能设备标识公共服务平台提供的匿名设备标识符OAID、开发者匿名设备标识符VAID、及应用匿名设备标识符AAID,可用于解决Android10无法获取设备标识(如IMEI、IMSI、Wi-Fi MAC地址等)的问题
- 新增 在manifest中配置 App 启动时申请设备IMEI等信息的权限策略,默认调整为应用第一次启动时申请
- 新增 Webview窗口支持暂停(pause)和恢复(resume)操作,解决页面中如果存在持续渲染隐藏后可能引起卡顿的Bug
- 新增 文件上传支持配置分块上传参数chunkSize,解决不能真实返回上传进度的Bug
- 修复 Webview子窗口先隐藏(hide)再添加(append)到父窗口依然显示的Bug
- 修复 二维码(Barcode)扫描在设备横屏时显示异常的Bug
- 修复 创建视频播放控件(VideoPlayer)时,没有开始播放视频也会停止后台背景音频的Bug
- 优化 视频播放的操作条的拖动误触和图标美化问题
- 修复 在部分设备上插拔usb硬件设备可能引起应用重启的Bug
2019年10月24日发布
点击下载SDK
重要:因新版本去掉基础aar中的权限,所以请根据自身需求添加所需权限,权限可参考SDK中示例进行添加。
重要:更新SDK是,需同时更新SDK目录/SDK/assets/data/目录下所有文件。
重要:如需操作Application,必须要继承自DCloudApplication。 - 更新uni-app离线打包支持,需使用HBuilderX(2.3.7.20191024)版本生成本地打包App资源。
- Android平台 修复 微信分享内容包含网络图片时,第二次操作分享会失败的Bug
2019年10月21日发布
点击下载SDK
重要:因新版本去掉基础aar中的权限,所以请根据自身需求添加所需权限,权限可参考SDK中示例进行添加。
重要:更新SDK是,需同时更新SDK目录/SDK/assets/data/目录下所有文件。
重要:如需操作Application,必须要继承自DCloudApplication。 - 更新uni-app离线打包支持,需使用HBuilderX(2.3.6.20191020)版本生成本地打包App资源。
- 修复 HBuilderX2.3.5引出的上传文件 uploadFile 可能失败的Bug
2019年10月18日发布
点击下载SDK
重要:因新版本去掉基础aar中的权限,所以请根据自身需求添加所需权限,权限可参考SDK中示例进行添加。
重要:更新SDK是,需同时更新SDK目录/SDK/assets/data/目录下所有文件。
重要:如需操作Application,必须要继承自DCloudApplication。 - 更新uni-app离线打包支持,需使用HBuilderX (2.3.5.20191018)版本生成本地打包App资源。
- Android平台 更新 个推/UniPush SDK(4.3.7.0),解决无法上架谷歌应用市场(GooglePlay)的问题
- Android平台 修复 MIUI11中toast背景为白色,导致前景色无法看清的Bug
- 更新 微信登录、分享、支付SDK(5.4.3),适配Android10
- 更新 QQ登录、分享SDK(3.3.5),新浪微博登录、分享SDK(4.4.1)
- 更新 高德地图SDK(6.8.0),解决在部分手机上可能出现黑屏的Bug
- 修复 数据库查询SQL语句(plus.sqlite.selectSql)返回结果中的浮点数据类型精度丢失的Bug
- 修复 在双卡手机上获取国际移动用户识别码(IMSI)只能返回一个值的Bug
- 修复 Android10设备上获取设备唯一标识(UUID)为空的Bug
- 修复 上传任务(plus.uploader.createUpload)提交的请求头中包含多个Cookie的Bug
- 修复 上传任务(plus.uploader.createUpload)不能真实返回上传进度的Bug
- 修复 蓝牙断开设备连接(plus.bluetooth.closeBLEConnection)可能不触发onBLEConnectionStateChange事件的Bug
- 修复 微信分享图片无法加载带重定向的url链接的Bug
- 修复 Webview窗口动画在特定情况下可能会将pop-in/out动画自动变为slide-in/out-right的Bug
2019年09月23日发布
点击下载SDK
重要:因新版本去掉基础aar中的权限,所以请根据自身需求添加所需权限,权限可参考SDK中示例进行添加。
重要:更新SDK是,需同时更新SDK目录/SDK/assets/data/目录下所有文件。
重要:如需操作Application,必须要继承自DCloudApplication。 - 更新uni-app离线打包支持,需使用HBuilderX (2.3.3.20190923)版本生成本地打包App资源。
2019年09月21日发布
点击下载SDK
重要:因新版本去掉基础aar中的权限,所以请根据自身需求添加所需权限,权限可参考SDK中示例进行添加。
重要:更新SDK是,需同时更新SDK目录/SDK/assets/data/目录下所有文件。
重要:如需操作Application,必须要继承自DCloudApplication。 - 更新uni-app离线打包支持,需使用HBuilderX(2.3.2.20190921)版本生成本地打包App资源。
- Android平台 修复 系统相册选择文件(plus.gallery.pick)设置selected参数时多次选择失效的Bug 详情
2019年09月20日发布
点击下载SDK
重要:因新版本去掉基础aar中的权限,所以请根据自身需求添加所需权限,权限可参考SDK中示例进行添加。
重要:更新SDK是,需同时更新SDK目录/SDK/assets/data/目录下所有文件。
重要:如需操作Application,必须要继承自DCloudApplication。 - 更新uni-app离线打包支持,需使用HBuilderX(2.3.1.20190920)版本生成本地打包App资源。
2019年09月20日发布
点击下载SDK
重要:因新版本去掉基础aar中的权限,所以请根据自身需求添加所需权限,权限可参考SDK中示例进行添加。
重要:更新SDK是,需同时更新SDK目录/SDK/assets/data/目录下所有文件。
重要:如需操作Application,必须要继承自DCloudApplication。
- 更新uni-app离线打包支持,需使用HBuilderX(2.3.0.20190919)版本生成本地打包App资源。
- 优化 窗体动画popin/popout的效率,Android6+加入老窗体透明alpha效果(同时注意此时动画时长设置不再生效)
- 修复 部分平板设备横屏显示时可能出现灰色区域的Bug
- 修复 图片压缩转换(plus.zip.compressImage)后exif头信息丢失的Bug
- 修复 获取图片信息(plus.io.getImageInfo)传入网络图片地址无法下载图片时控制台输出Unexpected identifier错误的Bug
- 修复 设置应用全屏显示(plus.navigator.setFullscreen)时在部分刘海屏设备显示区域可能不正确的Bug
- 修复 Webview窗口动画在Android6以下设备可能出现残影的Bug
- 修复 使用plus.io.resolveLocalFileSystemURL方法传入路径非'/'结尾是获取目录对象entry不正确,导致entry.getDirectory创建子目录路径不对的Bug
2019年08月19日发布
点击下载SDK
重要:因新版本去掉基础aar中的权限,所以请根据自身需求添加所需权限,权限可参考SDK中示例进行添加。
重要:更新SDK是,需同时更新SDK目录/SDK/assets/data/目录下所有文件。
重要:如需操作Application,必须要继承自DCloudApplication。
- 更新uni-app离线打包支持,需使用HBuilderX(2.2.2.20190816)版本生成本地打包App资源。
- 修复 部分情况下软键盘隐藏后页面底部留白的Bug 详情
- 修复 plus.gallery.pick选择视频后返回失败的Bug
- 修复2.2.1引起的uniapp原生插件使用时报错找不到的问题
2019年08月14日发布
点击下载SDK
重要:因新版本去掉基础aar中的权限,所以请根据自身需求添加所需权限,权限可参考SDK中示例进行添加。
重要:更新SDK是,需同时更新SDK目录/SDK/assets/data/目录下所有文件。
重要:如需操作Application,必须要继承自DCloudApplication。 - 更新uni-app离线打包支持,需使用HBuilderX(2.2.1.20190813)版本生成本地打包App资源。
- 修复 在小米手机上选择本地视频总是返回失败回调的Bug
- 修复 nvue页面中input组件弹出软键盘后报js错误(Failed to receiveTasks, instance is not available)的Bug
2019年08月12日发布
点击下载SDK
重要:因新版本去掉基础aar中的权限,所以请根据自身需求添加所需权限,权限可参考SDK中示例进行添加。
重要:更新SDK是,需同时更新SDK目录/SDK/assets/data/目录下所有文件。
重要:如需操作Application,必须要继承自DCloudApplication。 - 更新uni-app离线打包支持,需使用HBuilderX(2.2.0.20190810)版本生成本地打包App资源。
- 新增 5+ APP和uni-app适配支持arm64-v8a(64位)CPU类型,解决GooglePlay提审要求64位的问题
- 更新 支付宝SDK版本为15.6.5,修复SDK版本过低可能被Google Play下架的Bug
- 新增 支持manifest.json文件中设置屏幕方向(screenOrientation)真机运行时可立即生效(无需提交云端打包)
- 新增 适配最新的Android Q(API等级29)系统
- 新增 可在打包时取消x86 cpu支持,以减少apk体积
- 修复 部分安卓4.4手机上获取设备信息(plus.device.getInfo)无法返回imei的Bug
- 修复 微信登录第一次授权登录可能返回失败的Bug
- 修复 华为手机调用plus.runtime.setBadgeNumber(0)无法清除应用角标的Bug
2019年07月24日发布
点击下载SDK
重要:因新版本去掉基础aar中的权限,所以请根据自身需求添加所需权限,权限可参考SDK中示例进行添加。
重要:更新SDK是,需同时更新SDK目录/SDK/assets/data/目录下所有文件。
重要:如需操作Application,必须要继承自DCloudApplication。 - 更新uni-app离线打包支持,需使用HBuilderX(2.1.3.20190723)版本生成本地打包App资源。
- 修复 Webview子窗口调用plus.webview.startAnimation动画可能引起页面不显示的Bug
- 修复 Webview窗口软键盘弹出高度可能不正确的Bug
- 修复 Webview父子窗口都设置statusbar后导致显示不正确的Bug,统一为父子窗口同时设置statusbar后仅子窗口的statusbar生效
- 修复 Webview窗口的标题栏(titleNView)设置搜索框(searchInput)后可能会同时显示标题文字(titleText)的Bug
- 修复 wap2app应用首页为选项卡页面在全面屏手机第一次打开底部可能有空白的Bug
- 修复 图片进行扫码识别(plus.barcode.scan)返回数据多出引号的Bug
- 修复 获取设备信息(plus.device.getInfo)在部分只有一个IMEI号的设备(如华为荣耀6等)无返回值的Bug
- 修复 uni-app应用中nvue页面使用uni-app编译模式打包后覆盖安装使用了weex模式(老模式)版本引起nvue页面白屏的Bug
2019年07月16日发布
点击下载SDK
重要:因新版本去掉基础aar中的权限,所以请根据自身需求添加所需权限,权限可参考SDK中示例进行添加。
重要:更新SDK是,需同时更新SDK目录/SDK/assets/data/目录下所有文件。
重要:如需操作Application,必须要继承自DCloudApplication。 - 更新uni-app离线打包支持,需使用HBuilderX(2.1.1.20190716)版本生成本地打包App资源。
- 修复 nvue页面中image标签的placeholder属性设置本地地址可能引起崩溃的Bug
- 修复 原生控件对象(plus.nativeObj.View)不添加到Webview窗口直接显示后无法正常关闭的Bug
2019年07月15日发布
点击下载SDK
重要:因新版本去掉基础aar中的权限,所以请根据自身需求添加所需权限,权限可参考SDK中示例进行添加。
重要:更新SDK是,需同时更新SDK目录/SDK/assets/data/目录下所有文件。
重要:如需操作Application,必须要继承自DCloudApplication。 - 更新uni-app离线打包支持,需使用HBuilderX(2.1.0.20190713)版本生成本地打包App资源。
- 新增 5+App添加UniPush功能,替代之前的个推和小米推送。详情
- 新增 获取设备信息方法(plus.device.getInfo),不再推荐使用plus.device.imei。把属性改为方法可以避免Android平台在应用启动时被某些手机提示需要电话权限的问题。详情
- 云端打包API等级(targetSdkVersion)默认值调整为26,满足各主流应用市场的上架要求
- 新增 获取应用(ipa/apk)版本号(plus.runtime.versionCode)接口 文档
- 新增 获取应用信息(plus.runtime.getProperty)支持manifest.json文件中的版本号(version->code字段值) 文档
- 修复 网络请求接口(plus.net.XMLHttpRequest)获取HTTP响应头部信息字段中多一个空格的Bug
- 优化 图片预览(plus.nativeUI.previewImage)界面未沉浸式状态栏效果
- 修复 配置渠道云端打包后获取的渠道信息(plus.runtime.channel)总是为空的Bug 详情
- 修复 HBuilderX2.0.0版本引出的plus.io.getImageInfo一直触发失败回调的Bug 详情
- 修复 搜索蓝牙设备(plus.bluetooth.startBluetoothDevicesDiscovery)设置为允许重复上报相同设备(allowDuplicatesKey参数为true)时,获取设备列表为空的Bug
- 修复 图片预览(plus.nativeUI.previewImage)设置两张图片且loop为true会闪退的Bug 详情
- 完善 原生图片对象(plus.nativeObj.Bitmap)保存图片(save)方法兼容非预期参数 详情
- 修复 使用unipush模块提交华为应用市场报“HMS根证书文件”错误的Bug 详情
- 修复 Webview窗口在某些情况(如退出视频全屏播放、弹出软键盘按home键后再切回前台、wap2app应用设置statusbar)可能出现底部空缺的Bug 详情
- 修复 subnvue窗口在某些情况下调用setStyle无效的Bug
- 修复 视频控件(VideoPlayer)可能偶发出现进度条不更新不消失的Bug
- 修复 视频播放(VideoPlayer)控件提交云端打包后无法播放本地视频文件的Bug 详情
- 修复 应用第一次运行时调用定位功能可能不弹出定位权限申请框也不触发错误回调的Bug 详情
- 修复 原生控件(NView)绘制字体图标在部分魅族手机上可能无法显示的Bug 详情
- 修复 部分手机上设置titleNView后可能引起页面高度不对的Bug 详情
- 修复 通过plus.runtime.launchApplication启动的应用可能出现plus.runtime.arguments更新失败的Bug 详情
- 修复 nvue页面云端打包后设置字体(font-family)属性可能无效的Bug
- 修复 nvue页面创建WebSockets连接服务器总是反馈超时错误的Bug
- 修复 uni-app为多tab应用,切换显示nvue页面时可能出现顶部留白的Bug 详情
2019年06月14日发布
点击下载SDK
重要:因新版本去掉基础aar中的权限,所以请根据自身需求添加所需权限,权限可参考SDK中示例进行添加。
重要:更新SDK是,需同时更新SDK目录/SDK/assets/data/目录下所有文件。
重要:如需操作Application,必须要继承自DCloudApplication。 - 更新uni-app离线打包支持,需使用HBuilderX(2.0.1.20190614)版本生成本地打包App资源。
- 修复 配置渠道云端打包后获取的渠道信息(plus.runtime.channel)总是为空的Bug
- 修复 图片预览(plus.nativeUI.previewImage)设置两张图片且loop为true会闪退的Bug
2019年06月11日发布
点击下载SDK
重要:因新版本去掉基础aar中的权限,所以请根据自身需求添加所需权限,权限可参考SDK中示例进行添加。
重要:更新SDK是,需同时更新SDK目录/SDK/assets/data/目录下所有文件。
重要:如需操作Application,必须要继承自DCloudApplication。 - 更新uni-app离线打包支持,需使用HBuilderX(2.0.0.20190610)版本生成本地打包App资源。
- 新增 Webview窗口标题栏(titleNView)支持获取输入搜索内容功能(getTitleNViewSearchInputText)
- 新增 Webview窗口标题栏(titleNView)支持监听搜索输入框焦点变化事件(titleNViewSearchInputFocusChanged)
- 修复 Webview窗口未设置标题栏(titleNView)时可能出现显示错误的Bug
- 修复 数据库多次执行事务(plus.sqlite.transaction)可能不成功的Bug
- 修复 蓝牙(Bluetooth)搜索设备返回的advertisData数据丢失前两个字节的Bug
- 修复 部分设备上开启全面屏手势的情况下获取屏幕高度(plus.screen.resolutionHeight)不正确的Bug
- 修复 网络请求(plus.net.XMLHttpRequest)没有共享cookie的Bug
- 修复 视频控件(VideoPlayer)切换视频可能出现无法播放的Bug
- 修复 视频控件(VideoPlayer)播放部分rtmp协议视频可能出现没有声音的Bug
- 修复 uni-app应用设置窗口背景透明不生效的Bug
- 修复 调用摄像头(Camera)录像完成后点击播放可能触发错误回调的Bug
2019年05月23日发布
点击下载SDK
重要:因新版本去掉基础aar中的权限,所以请根据自身需求添加所需权限,权限可参考SDK中示例进行添加。
重要:更新SDK是,需同时更新SDK目录/SDK/assets/data/目录下所有文件。
重要:如需操作Application,必须要继承自DCloudApplication。 - 更新uni-app离线打包支持,需使用HBuilderX(1.9.9.20190522)版本生成本地打包App资源。
- 修复 使用console.log输出日志时在以[开头时日志可能显示不全的Bug
2019年05月20日发布
点击下载SDK
重要:因新版本去掉基础aar中的权限,所以请根据自身需求添加所需权限,权限可参考SDK中示例进行添加。
重要:更新SDK是,需同时更新SDK目录/SDK/assets/data/目录下所有文件。
重要:如需操作Application,必须要继承自DCloudApplication。 - 更新uni-app离线打包支持,需使用HBuilderX(1.9.8.20190518)版本生成本地打包App资源。
- 修复 uni-app应用在部分手机热启动可能出现白屏的问题
- 修复 HBuilderX1.9.7版本引出的plus.sqlite.selectSql返回数据结构不对的问题
2019年05月18日发布
点击下载SDK
重要:因新版本去掉基础aar中的权限,所以请根据自身需求添加所需权限,权限可参考SDK中示例进行添加。
重要:更新SDK是,需同时更新SDK目录/SDK/assets/data/目录下所有文件。
重要:如需操作Application,必须要继承自DCloudApplication。 - 更新uni-app离线打包支持,需使用HBuilderX(1.9.7.20190517)版本生成本地打包App资源。
- 优化 等待对话框(plus.nativeUI.showWaiting)默认图标为圆圈(circle)样式,并补充circle和雪花的样式选择参数
- 修复 Webview窗口嵌套时可能出现高度计算不正确的Bug 详情
- 修复 网络请求(plus.net.XMLHttpRequest)返回code为201~206时返回responseText不对的Bug
- 修复 地图控件调用getUserLocation、showUserLocation可能不会弹出定位授权确认框的Bug
- 修复 uni-app在自定义组件模式下窗口中存在地图控件时新开页面再返回可能显示异常的Bug
- 修复 nvue页面中的pickers组件可能无法正常弹出窗口的Bug
- 修复 蓝牙(Bluetooth)模块不初始化直接调用startBluetoothDevicesDiscovery方法可能崩溃的Bug 详情
- 修复 在部分手机上第一次运行时可能无法搜索到蓝牙设备的Bug
- 修复 uni-app中播放网络地址音频可能无法播放的Bug 详情
- 补齐 调用摄像头录像(startVideoCapture)支持设置视频长度videoMaximumDuration参数。设置录像时间无需再使用Native.js
- 修复 原生控件(plus.nativeObj.View)调用drawText绘制文本时position参数的top/left字段不支持auto的Bug
- 修复 SQLite中调用executeSql执行删除数据库(drop table database)操作后执行查询selectSql方法不触发回调的Bug
- 修复 直播推流(LivePusher)控件可能在首次创建时出现黑屏的Bug
- 修复 定位模块(Geolocation)调用watchPosition方法监听定位变化后再调用getCurrentPosition方法可能导致监听方法失效的Bug
- 修复 使用百度地图调用地理编码(plus.maps.Map.geocode)可能失败的Bug
2019年04月27日发布
点击下载SDK
重要:因新版本去掉基础aar中的权限,所以请根据自身需求添加所需权限,权限可参考SDK中示例进行添加。
重要:更新SDK是,需同时更新SDK目录/SDK/assets/data/目录下所有文件。
重要:如需操作Application,必须要继承自DCloudApplication。 - 更新uni-app离线打包支持,需使用HBuilderX(1.9.4.20190426)版本生成本地打包App资源。
- 新增 Webview窗口标题栏上搜索框(searchInput)支持设置输入的文本内容 文档
- 新增 请求系统权限plus.android.requestPermissions接口 文档
- 修复 nvue页面调用uni.removeStorage报js错误的问题 详情
- 修复 设置targetSdkVersion为28时调用plus.runtime.install安装应用无效的问题 详情
2019年04月18日发布
点击下载SDK
重要:因新版本去掉基础aar中的权限,所以请根据自身需求添加所需权限,权限可参考SDK中示例进行添加。
重要:更新SDK是,需同时更新SDK目录/SDK/assets/data/目录下所有文件。
重要:如需操作Application,必须要继承自DCloudApplication。 - 更新uni-app离线打包支持,需使用HBuilderX(1.9.2.20190417)版本生成本地打包App资源。
- 修复 HBuilderX1.9.0版本引出的直播推流控件(LivePusher)可能黑屏的问题
- 修复 HBuilderX1.9.0版本引出的Webview窗口非全屏时宽高可能计算不对的问题
- 修复 HBuilderX1.9.0版本引出的uni-app首页为nvue页面可能白屏的问题
- 修复 uni-app在自定义组件模式下调用监听设备位置变化(plus.geolocation.watchPosition)报无clearTimeout方法的问题 详情
2019年04月16日发布
点击下载SDK
重要:因新版本去掉基础aar中的权限,所以请根据自身需求添加所需权限,权限可参考SDK中示例进行添加。
重要:更新SDK是,需同时更新SDK目录/SDK/assets/data/目录下所有文件。 - 更新uni-app离线打包支持,需使用HBuilderX(1.9.1.20190415)版本生成本地打包App资源。
- 修复 设置targetSdkVersion为25及以上时调用系统分享(plus.share.sendWithSystem)无效的问题
- 修复 Webview标题栏的输入框(searchInput)在部分设备无法获得焦点的问题
点击下载SDK
重要:因新版本去掉基础aar中的权限,所以请根据自身需求添加所需权限,权限可参考SDK中示例进行添加。
重要:更新SDK是,需同时更新SDK目录/SDK/assets/data/目录下所有文件。
- 更新uni-app离线打包支持,需使用HBuilderX(1.9.0.20190413)版本生成本地打包App资源。
- 优化 音频播放(AudioPlayer)功能,支持设置自动播放(autoplay)、循环播放(loop)、开始播放位置(startTime)、音频标题(title)及监听播放相关事件等
- 修复 直播推流(LivePusher)控件在Android8.0及以上系统可能引起崩溃的问题
- 修复 调用通讯录查找联系人方法(find)在Android8.0及以上系统可能引起崩溃的问题
- 修复 修复 二维码扫描控件(Barcode)可能出现扫描框不居中的问题
- 修复 UniPush通过厂商通道接收到多条消息后点击可能不触发click事件的问题
2019年04月01日发布
点击下载SDK
重要:因新版本去掉基础aar中的权限,所以请根据自身需求添加所需权限,权限可参考SDK中示例进行添加。
重要:更新SDK是,需同时更新SDK目录/SDK/assets/data/目录下所有文件。 - 更新uni-app离线打包支持,需使用HBuilderX(1.8.2.20190330)版本生成本地打包App资源。
- SQLite模块(plus.sqlite.*),支持操作本地数据库文件。打包配置指南。API文档
- 新增 页面中input标签type=file时支持选择摄像头拍照
- 修复 应用从后台重新激活后plus.runtime.arguments值可能不更新的问题
- 修复 视频控件(VideoPlayer)云端打包后可能无法播放本地视频文件的问题
- 修复 二维码扫描(Barcode)控件多次创建大小不同时可能导致识别区域偏移的问题
- 修复 uni-app应用资源通过wgt升级可能提示缺少uninview模块的问题
- 修复 Android9设备调用plus.runtime.install安装apk无效的问题
点击下载SDK
重要:因新版本去掉基础aar中的权限,所以请根据自身需求添加所需权限,权限可参考SDK中示例进行添加。
重要:更新SDK是,需同时更新SDK目录/SDK/assets/data/目录下所有文件。 - 更新uni-app离线打包支持,需使用HBuilderX(1.7.0.20190314)版本生成本地打包App资源。
- 更新 个推SDK更新为4.3.20版本,兼容Android9.0
- 修复 Webview窗口标题栏(titleNView)设置backgroundColor属性后系统状态栏背景可能不生效的问题
- 修复 在部分Android8.0设备调用 plus.runtime.install 接口无法安装apk的问题
- 修复 在部分Android8.0设备调用 plus.runtime.openFile 接口打开文件可能无效的问题
- 修复 二维码扫描窗口无法全屏显示的问题(参考HelloH5模板应用的Barcode示例页面)
- 修复 修复 二维码扫描窗口未授权相机权限后返回可能引起横屏显示的问题
- 视频控件(VideoPlayer)无法播放部分rtsp、rtmp视频,缓冲时间过长,切换视频播放进度未更新等问题
- 修复 nvue页面中image标签圆角(borderRadius)不生效的问题
2019年02月21日发布
点击下载SDK
重要:因新版本去掉基础aar中的权限,所以请根据自身需求添加所需权限,权限可参考SDK中示例进行添加。
重要:更新SDK是,需同时更新SDK目录/SDK/assets/data/目录下所有文件。 - 更新uni-app离线打包支持,需使用HBuilderX(1.6.2.20190220)版本生成本地打包App资源。
- 修复 获取语言(plus.os.language、navigator.language)一直返回英文(en_US)的问题
- 修复 下载任务未配置fileName参数并且url地址中未包含文件名称时可能导致下载失败的问题
- 修复searchInput在uni-app中autoFocus会自动关闭软键盘的问题
- 修复 视频播放(VideoPlayer)控件无法播放本地视频文件的问题
- 修复 修复 蓝牙连接设备后可能立即中断(日志提示Cannot read property 'map' of null)的问题
- 修复 nvue页面中image标签不触发load事件的问题
- 修复 修复 nvue页面中slider标签初始化设置index属性不生效的问题
2019年01月21日发布
点击下载SDK
重要:因新版本去掉基础aar中的权限,所以请根据自身需求添加所需权限,权限可参考SDK中示例进行添加。
重要:更新SDK是,需同时更新SDK目录/SDK/assets/data/目录下所有文件。
- 更新uni-app离线打包支持,需使用HBuilderX(1.5.1或1.5.2)版本生成本地打包App资源。
- 调整SDK默认为高德地图。
- 标题栏按钮(WebviewTitleNViewButtonStyles)支持红点、角标和向下箭头等
- 修复 窗口中原生标题栏(titleNView)style为transparent样式时返回按钮图标不可见的问题
- 修复 窗口中包含地图控件时切换动画可能出现白屏现象的问题
- 修复 窗口设置显示进度条(progress)在页面跳转时可能不触发显示进度的问题
- 修复 二维码扫描窗口无法全屏显示的问题(参考HelloH5模板应用的Barcode示例页面)
- 修复 视频播放(VideoPlayer)控件断网恢复后可能无法继续播放的问题
- 修复 设置应用启动图片为.9.png时有可能出现拉伸显示的问题
- 修复 原生控件(NView)绘制图片是left/top属性值设置为auto时无法居中显示的问题
- 修复 原生控件(NView)字体或背景颜色值使用rgba格式时无法容错解析空格的问题
- 修复 百度地图在部分手机上可能出现闪黑的问题
- 修复 推送消息传输透传数据时可能出现payload参数无法返回的问题
- 更新 小米推送SDK版本为3.6.12
- 修复 窗口使用circle样式下拉刷新时可能不触发H5中touchcancel事件的问题
- 修复 下载(Downloader)任务过多时暂停后可能无法再继续的问题
- 修复 上传(Uploader)任务的地址为https时可能无法正常上传的问题
- 修复 nvue页面在非解压模式可能出现图片无法正常显示的问题
2018年12月26日发布
点击下载SDK
重要:因新版本去掉基础aar中的权限,所以请根据自身需求添加所需权限,权限可参考SDK中示例进行添加。
- 更新uni-app离线打包支持,需使用HBuilderX(1.4.0.XXXX)版本生成本地打包App资源.
- 更新 nvue页面渲染内核,速度更快、效率更高
- 优化 应用图标角标设置支持华为手机、适配新版本小米手机
- 优化 支持Android9.0查询是否为刘海屏设备(plus.navigator.hasNotchInScreen)
- 修复 部分Android9.0设备上可能弹出"Detected problems with API compatibility"提示框问题
- 修复 打包设置gargetSDKVersion大于26可能导致无法接收推送消息的问题
- 修复 蓝牙读写二进制数据可能不正确的问题
- 修复 Webview窗口的titleNView设置为transparent样式时可能直接显示文字的问题
- 修复 Webview窗口的titleNView上按钮字体图标可能不居中显示的问题
2018年12月12日发布
点击下载SDK
重要:因新版本去掉基础aar中的权限,所以请根据自身需求添加所需权限,权限可参考SDK中示例进行添加。 - 更新uni-app离线打包支持,需使用HBuilderX(1.3.1.20181211)版本生成本地打包App资源.
- 新增 支持蓝牙模块 详见
- 新增 支持启动微信小程序(plus.share.ShareService.launchMiniProgram),同时需在manifest中配置navigateToMiniProgramAppIdList
- 新增 titleNView配置支持左右内边距(padding/padding-left/padding-right)和按钮的宽度(width)
- 新增 查询设备是否为刘海屏设备接口(plus.navigator.hasNotchInScreen)
- 更新 百度地图SDK(v5.2.1)及百度定位SDK(v7.5.0)
- 更新barcode模块,优化二维码识别,修复部分二维码可能无法识别的问题(barcode离线打包集成发生变化,请参考SDK中文档集成)
- 修复 Webview的默认下拉刷新样式可能显示不正常的问题
- 修复 Webview未显示时通过setStyle方法设置参数可能无法及时生效的问题
- 优化 从相册选择图片(plus.gallery.pick)界面交互体验,修复 在部分手机设置filter为video无效的问题
- 修复 视频控件(VideoPlayer)全屏/非全屏切换导致视频从头播放的问题
2018年11月27日发布
点击下载SDK
重要:因新版本去掉基础aar中的权限,所以请根据自身需求添加所需权限,权限可参考SDK中示例进行添加。 - 更新uni-app离线打包支持,需使用HBuilderX(1.2.1.20181126)版本生成本地打包App资源
- 新增 nvue页面支持bindingx
- 优化 原生图片预览(plus.nativeUI.previewImage)的UI操作体验
- 修复 Webview窗口default样式下拉刷新不触发pullToRefresh事件的问题
- 新增 Webview窗口支持配置显示页面加载进度条(WebviewStyles的progress属性)
- 修复 从无法微信小程序启动的问题
- 修复 Webview窗口default样式下拉刷新不触发pullToRefresh事件的问题
- 修复 视频播放控件(VideoPlayer)在自动调节亮度模式进入全屏变黑的问题
- 修复 nvue页面不支持Websocket功能的问题
- 修复 nvue页面未设置titleNView时可能显示不正常的问题
- 删除lib.5plus.base-release.aar基座中敏感权限,因权限缺失导致的运行失败需手动添加到AndroidManifest.xml中
2018年11月09日发布
- 更新uni-app离线打包支持,需使用HBuilderX(1.1.0.20181030)版本生成本地打包App资源
- 修改高德地图定位权限和marker点击问题
- 若小米手机运行时出现弹窗提醒,请将targetSdkVersion调至28
2018年09月29日发布
点击下载SDK
1.新增支持uni-app离线打包(HBuilderX中生成本地打包App资源) - 简化SDK集成方式,优化jar为aar。
- 新增支持视频播放控件、直播推流等控件;
- 更新分享SDK(微信、新浪微博),支持分享音频、视频、小程序等;
- 修复已知5+API的bug,提升稳定性。
2018年05月11日发布
点击下载SDK
1.修复近期发现的一些bug,提升稳定性2018年03月21日发布
点击下载SDK
1.支持玩咖广告。
2.同步更新流应用内核:修复一些已知的BUG等2018年03月19日发布
点击下载SDK
1.去掉android.support.v4包引用,由开发者在gradle文件自行配置
2.同步更新流应用内核:修复一些已知的BUG等
2018年03月14日发布
点击下载SDK
1.完善广告功能,可以通过配置manifest.json控制是否使用开屏广告
2.同步更新流应用内核:修复一些已知的BUG等
IOS平台HTML5+ SDK 更新日志
2020年4月22日发布
- 更新uni-app离线打包支持,需使用HBuilderX(2.6.15.20200421)版本生成本地打包App资源。
- 新增 原生导航标题栏的 titleIcon 支持 base64 图标,方便页面里已经存在的图标在滚动时绘制在原生导航栏上
- 新增 actionSheet 取消按钮文字国际化(如设置按钮文字,则以设置文字为准,如未设置,则根据手机系统的语言显示)
- 修复 打包模块勾选 iOS UIWebview/Android X5 Webview 后,wgt升级更新失败触发错误回调的Bug 详情
- iOS平台 更新 uni-AD 腾讯广点通SDK版本为4.11.6
- iOS平台 修复 uni-AD 腾讯广点通部分视频激励广告点击关闭按钮触发 onClose 事件参数中 isEnded 属性可能为 false 的Bug
- iOS平台 修复 uni-AD 腾讯广点通的信息流视频广告自动播放时没有静音的Bug
- iOS平台 修复 HBuilderX2.6.8 引出的Webview窗口 userAgent 不正确可能导致加载的页面内部逻辑不正确的Bug 详情
- iOS平台 修复 iOS 13.4.1及以上版本在 iPad 设备应用第一次启动获取不到所有窗口对象的Bug 详情
- iOS平台 修复 视频播放控件 VideoPlayer 全屏时在 iPhoneX 可能出现亮度控制视图位置错乱的Bug 详情
- iOS平台 修复 原生导航标题栏 设置 type 为 float 时,backgroundColor 的半透明效果显示不正确的Bug
- App-iOS平台 修复 nvue video 组件设置 @click 事件后,视频底部控制栏上除进度条以外的其他按钮失效的Bug 详情
- App-iOS平台 修复 v3模式 movable-area 组件嵌套 scroll-view 组件点击事件不触发的Bug 详情
- App-iOS 修复 uni.onBLEConnectionStateChange 不触发的bug
- App-iOS 修复 uni.chooseImage 从相机选择图片分辨率过低的Bug 详情
本次发出的新版SDK已经将Release-iphoneos 和 Release-iphonesimulator两个目录下的库文件进行合并。
老版本SDK用户在替换新SDK时还需要检查工程内是否引入了 libcoreSupport.a这个库,如果工程内没有引入会遇到编译错误。
离线打包用户在更新SDK时请注意:在替换最新SDK的静态库文件的同时要替换相同版本的PandoraAPI.bundle文件。以及注意替换uni-app项目相关的".js"文件
IOS平台历史版本
2020年4月10日发布
- 更新uni-app离线打包支持,需使用HBuilderX(2.6.11.20200409)版本生成本地打包App资源。
- iOS平台 新增 Webview窗口使用WKWebview内核在iOS11及以上设备支持js原生混淆 详情
- iOS平台 更新 支付宝Alipay SDK版本为15.7.4,解决AppStore审核报使用废弃UIWebview APIs的问题
- iOS平台 更新 新浪微博登录、分享SDK版本为3.2.7,解决AppStore审核报使用废弃UIWebview APIs的问题
- iOS平台 更新 今日头条穿山甲广告SDK版本为V2.9.5.0
- iOS平台 修复 iOS 13.3及以上版本在 iPad 设备 plus.webview.all 无法获取所有Webview窗口的Bug 详情
- iOS平台 修复 iOS 13.3及以上版本在 iPad 设备 mui.openWindow 设置的窗口参数获取不到的Bug 详情
- iOS平台 修复 iOS 13及以上版本视频播放控件 VideoPlayer 全屏时可能出现亮度控制视图位置错乱的Bug 详情
- iOS平台 修复 视频播放控件 VideoPlayer 在下拉通知栏页面后依然播放的Bug 详情
- iOS平台 修复 预览图片 plus.nativeUI.previewImage 传入长图时显示不清楚的Bug 详情
- iOS平台 修复 应用安装后第一次启动 splash 界面显示不正常的Bug
- iOS平台 修复 Webview窗口 setStyle 设置 {titleNView: false} 后通过 getSytle 获取的 titleNView 数据不正确的Bug
- App-iOS平台 修复 nvue web-view 组件加载本地 html 文件,若路径中带 query 参数时,无法正常显示的Bug 详情
- App-iOS平台 修复 v3版本 uni.canvasToTempFilePath 在 ios 9.3.4 报错的Bug 详情
2020年4月3日发布
- 更新uni-app离线打包支持,需使用HBuilderX(2.6.9.20200403)版本生成本地打包App资源。
- 【重要】iOS平台 新增 UIWebview独立模块,默认不再包含UIWebview相关代码 详情
- 新增 获取当前屏幕宽高信息接口 plus.screen.getCurrentSize 文档
- App-iOS平台 修复 textarea 组件在 iOS13.4 系统报错的Bug
- App-iOS平台 修复 锁定横屏后打开 nvue 页面使用 plus.screen 获取屏幕宽高值不对的Bug
- iOS平台 修复 Webview窗口标题栏 titleNView 动态设置 titleText 在某些情况下可能不生效的Bug 详情
2020年3月31日发布
- 更新uni-app离线打包支持,需使用HBuilderX(2.6.8.20200330)版本生成本地打包App资源。
- 【重要】iOS平台 新增 UIWebview独立模块,默认不再包含UIWebview相关代码 详情
- iOS平台 新增 系统选择按钮框 plus.nativeUI.actionSheet 在iPad设备支持 popover 设置弹出指示区域 文档
- iOS平台 新增 本地数据存储 plus.storage 异步操作接口 文档
- iOS平台 更新 友盟统计SDK版本为6.1.0
- iOS平台 更新 微信登录、分享、支付SDK版本为1.8.6.2
- iOS平台 修复 视频播放控件 VideoPlayer 设置 show-center-play-btn 属性不生效的Bug 详情
- iOS平台 修复 Webview窗口标题栏(titleNView)中 button 按钮设置 colorPressed 不生效的Bug 详情
- iOS平台 修复 新浪微博分享 type 为 web 类型时 pictures 属性不生效的Bug
- iOS平台 修复 系统选择按钮框 plus.nativeUI.actionSheet 显示后不关闭,通过HBuilderX真机运行更新资源可能引起崩溃的Bug
- iOS平台 修复 云端打包启动页面中应用图标显示不清晰的Bug 详情
- App-iOS平台 新增 API uni.onUIStyleChange 监听系统主题状态变化(限v3) 详情
- App-iOS平台 优化 API uni.showActionSheet 在 iPad 设备支持 popover 设置弹出指示区域(限v3)
- App-iOS平台 修复 设备上使用第三方输入法收起键盘输入框无法失去焦点的Bug 详情
- App-iOS平台 修复 部分情况 page 设置 height 为 100% 无法全屏的Bug
- App-iOS平台 修复 页面使用原生占位时在 iPhoneX 获取窗口高度错误的Bug
- App-iOS平台 修复 picker 设置 value 过大时会滚动到空白位置的Bug 详情
- App-iOS平台 修复 nvue 页面中加载 base64 格式 iconfont 文件在iOS13.4系统崩溃的Bug 详情
2020年3月15日发布
- 更新uni-app离线打包支持,需使用HBuilderX(2.6.5.20200314)版本生成本地打包App资源。
- 新增 原生标题栏支持自定义返回按钮、标题居左、标题栏背景图、背景渐变色等功能 文档
- 新增 视频播放控件 VideoPlayer 支持全屏播放时点击事件 fullscreenclick 文档
- App-iOS平台 修复 v3版本 wgt热更新后 plus.runtime.restart 卡在启动页的Bug 详情
- App-iOS平台 修复 v3版本 video 组件部分情况无法显示的bug
- App-iOS平台 修复 nvue web-view 组件加载本地文件显示空白的Bug 详情
- App-iOS平台 修复 nvue image 组件使用相对路径加载图片可能会不显示的Bug 详情
- App-iOS平台 修复 video 组件设置 muted 为0静音后再设置为1时无法重新开启声音的bug 详情
- iOS平台 新增 适配iOS13+引入的暗黑模式 DarkMode 文档
- iOS平台 新增 应用使用Push(消息推送)模块后启动时不弹出“发送通知”系统授权框的配置方法 详情
- iOS平台 修复 视频播放控件 VideoPlayer 设置 objectFit 属性不生效的bug 详情
- iOS平台 修复 使用WKWebview内核 plus.orientation.getCurrentOrientation 无法获取设备方向信息的Bug
2020年2月26日发布
点击下载SDK
注意:App端重大架构升级 “v3编译器”,所以离线打包工程中需要引入__uniappes6.js和weex-main-jsfm-uni-v3.js这2个文件,具体看官方的打包演示工程。
- 更新uni-app离线打包支持,需使用HBuilderX(2.6.1.20200226)版本生成本地打包App资源。
- App-iOS平台 修复 非 v3 编译模式真机运行时提示框架版本不一致的Bug
2020年2月24日发布
点击下载SDK
注意:App端重大架构升级 “v3编译器”,所以离线打包工程中需要引入__uniappes6.js和weex-main-jsfm-uni-v3.js这2个文件,具体看官方的打包演示工程。
- 更新uni-app离线打包支持,需使用HBuilderX(2.6.0.20200223)版本生成本地打包App资源。
- App-iOS平台 修复 v3版本 部分情况下 rpx 计算错误的Bug
- App-iOS平台 修复 video 组件未播放时调用 seek 可能导致界面不正常的bug 详情
- App-iOS平台 修复 页面中使用字体图标时可能无法正常显示的Bug
- App-iOS平台 修复 tabBar 自定义高度时红点和角标显示位置不正确的Bug 详情
- App-iOS平台 修复 nvue input 组件 placeholder-style 和 placeholder-class 设置 fontSize 不生效的Bug
- App-iOS平台 修复 nvue list 组件设置 bounce 为 false 可能导致页面无法滚动的Bug
- App-iOS平台 修复 nvue map 组件使用 controls 控件提交云端打包后可能会引起崩溃的Bug 详情
- iOS平台 修复 在非刘海屏手机获取应用的安全区域 plus.navigator.getSafeAreaInsets 返回 deviceTop 数据可能不正确的Bug
- iOS平台 修复 调用 plus.gallery.pick 选择相册中的照片后, 连续快速点击完成按钮可能会引起应用崩溃的Bug 详情
- iOS平台 修复 视频播放控件 VideoPlayer 暂停播放后手势快进或后退操作时,没有更新进度条上显示时间的Bug
2020年1月4日发布
点击下载SDK
注意:App端重大架构升级 “v3编译器”,所以离线打包工程中需要引入__uniappes6.js和weex-main-jsfm-uni-v3.js这2个文件,具体看官方的打包演示工程。
- 更新uni-app离线打包支持,需使用HBuilderX(2.5.1.20200103)版本生成本地打包App资源。
- 【重要】iOS平台 新增 支持苹果授权登录(Sign in with Apple) 教程
- iOS平台 修复 音频播放对象(AudioPlayer)播放网络音频时,缓存完成恢复播放时没有触发 onPlay 事件的Bug
- iOS平台 修复 Webview窗口的titleUpdate事件可能不触发导致无法修改页面标题的Bug 详情
- iOS平台 修复 Webview窗口的标题栏(titleNView)设置titleSize属性不生效的Bug
- iOS平台 修复 系统日期选择框(plus.nativeUI.pickDate)、时间选择框(plus.nativeUI.pickTime)在横屏时显示不正常的Bug
- iOS平台 修复 应用切换到后台,从其它应用传参数激活到前台时 plus.runtime.arguments 可能不更新的Bug
- iOS平台 修复 录音对象(AudioRecorder)录制mp3格式音频设置 channels 参数值为 mono 不生效的Bug 详情
- iOS平台 修复 录音对象(AudioRecorder)设置音频播放模式 setSessionCategory 可能不生效的Bug
- iOS平台 修复 iOS13调用 plus.screen.setBrightness 方法可能会导致页面失去响应的Bug
- iOS平台 修复 在非刘海屏手机获取应用的安全区域 plus.navigator.getSafeAreaInsets 返回 deviceTop 数据可能不正确的Bug
- App-iOS平台 新增 nvue 普通 view 组件支持设置高斯模糊(毛玻璃)效果 详情
- App-iOS平台 修复 nvue input 组件设置 maxlength 属性后,@input事件返回value值与实际显示值不一致的Bug 详情
- App-iOS平台 修复 tabbar及标题栏上设置字体图标可能无法正常显示的Bug
- App-iOS平台 修复 nvue map 组件不设置 marker 的 title 及 callout 时会显示空白标注的Bug 详情
- App-iOS平台 修复 使用 uni.hideKeyboard 输入框无法失去焦点的Bug 详情
2019年12月11日发布
点击下载SDK
注意:App端重大架构升级 “v3编译器”,所以离线打包工程中需要引入__uniappes6.js和weex-main-jsfm-uni-v3.js这2个文件,具体看官方的打包演示工程。
- 更新uni-app离线打包支持,需使用HBuilderX(2.4.6.20191210)版本生成本地打包App资源。
- iOS平台 新增 Webview窗口原生标题栏样式属性 blurEffect,支持高斯模糊(毛玻璃)效果 详情
- iOS平台 补齐 直播推流(LivePusher)控件支持设置最小码率(min-bitrate)和最大码率(max-bitrate)
- iOS平台 修复 Webview窗口原生标题栏的搜索框(searchInput)获取焦点会导致placeholder文字移位的Bug 详情
- iOS平台 修复 图片预览(plus.nativeUI.previewImage)可能出现长图片不能滚动的Bug 详情
- iOS平台 修复 图片预览(plus.nativeUI.previewImage)可能无法正常显示部分网络地址图片的Bug 详情
- iOS平台 修复 使用UniPush或个推推送在后台统计数据中没有展示数和点击数的Bug 详情
- iOS平台 修复 用户拒绝访问相机后,调用摄像头拍照或录像时不会触发错误回调的Bug
- iOS平台 修复 配置使用高德或百度地图后,定位默认没有使用gcj02坐标的Bug
- iOS平台 修复 系统日期(plus.nativeUI.pickDate)、时间(plus.nativeUI.pickTime)选择框与系统提示框遮罩颜色不一致的Bug
- iOS平台 修复 苹果应用内支付IAP恢复购买接口(restoreComplateRequest)有可能不会返回恢复购买凭证的Bug
- App-iOS平台 新增 tabbar和navigationBar 支持设置高斯模糊(毛玻璃)效果 详情
- App-iOS平台 修复 nvue view 组件设置 border 属性可能引起应用崩溃的Bug 详情
- App-iOS平台 修复 iOS 13 系统中 textarea 输入的内容,比 placeholder 偏左一点的Bug 详情
- App-iOS平台 修复 faceID 识别成功时不能正确触发成功回调的Bug 详情
- App-iOS平台 修复 网络请求 uni.request 设置请求的 header 中存在非字符串值可能会引起崩溃的Bug
- App平台 修复 nvue 导航栏 titleNView 的 type 属性设置为 transparent 时不生效的Bug 详情
2019年11月15日发布
点击下载SDK
注意:weexUniJs.js和uni-app-service.js这2个文件的路径有变化,需要重新引入自己的工程中,具体看官方的打包demo示例。
- 更新uni-app离线打包支持,需使用HBuilderX(2.4.2.20191115)版本生成本地打包App资源。
- iOS平台 修复 Webview窗口使用WKWebview内核时截屏绘制(draw)设置 clip 参数无效的Bug 详情
- iOS平台 修复 Webview窗口全部关闭(close)时可能引起应用崩溃的Bug
- iOS平台 修复 Webview窗口设置自定义标题栏按钮点击时可能引起应用崩溃的Bug
- iOS平台 修复 视频播放(VideoPlayer)控件无法自动识别视频方向的Bug 详情
- iOS平台 修复 调用摄像头拍照(captureImage)时设置resolution参数为high、low、medium时可能引起图片显示方向不正确的Bug 详情
- iOS平台 修复 系统相册选择图片(plus.gallery.pick)可能返回不是选中图片的Bug 详情
- iOS平台 修复 文件下载暂停后再继续文件名后面会自动添加数字的Bug 详情
- iOS平台 修复 平台绝对路径转换成本地URL路径(plus.io.convertAbsoluteFileSystem)可能返回null的Bug 详情
- iOS平台 修复 设置应用屏幕常亮(plus.device.setWakelock)在iOS13.1.3系统可能引起崩溃的Bug
- iOS平台 修复 Native.JS获取当前Webview窗口的原生实例对象(plus.ios.currentWebview)可能返回为空的Bug 详情
- iOS平台 修复 创建本地消息(plus.push.createMessage)在iOS10及以上系统只显示最后一条的Bug 详情
- App-iOS平台 修复 nvue页面在iOS13及以上系统默认字体不对的Bug
- App-iOS平台 修复 nvue list 组件 scroll 事件返回的 isDragging 属性不正确的Bug 详情
- App-iOS平台 修复 nvue list 组件滚动时 scrollStart/scrollEnd 事件返回参数值为负数的Bug
- App-iOS平台 修复 nvue swiper 组件动态修改 current 属性触发 transition 事件返回的参数不准确的Bug
- App-iOS平台 修复 uni.hideKeyboard 不能收起软键盘的Bug #903
- App-iOS平台 修复 picker 组件可能被软键盘遮挡的Bug #888
- App-iOS平台 修复 input 组件输入中文时失焦导致文字消失的Bug #888
- App-iOS平台 修复 nvue text 组件设置 line-height 属性可能引起显示不正确的Bug
- App-iOS平台 修复 nvue live-pusher 组件设置 whiteness 属性为false不生效的Bug
- App-iOS平台 修复 nvue barcode 组件动态修改属性不生效的Bug
- App-iOS平台 修复 纯nvue项目 侧滑关闭后无法触发上个页面生命周期 onShow 的Bug 详情
2019年10月24日发布
点击下载SDK
注意:weexUniJs.js和uni-app-service.js这2个文件的路径有变化,需要重新引入自己的工程中,具体看官方的打包demo示例。
- 更新uni-app离线打包支持,需使用HBuilderX(2.3.7.20191024)版本生成本地打包App资源。
- iOS平台 修复 图片预览(plus.nativeUI.previewImage)3张图片且current属性设置为2时显示不正常的Bug 详情
- App-iOS平台 修复 nvue map组件的标记点(markers)的 iconPath 属性值设置为相对路径时可能引起应用崩溃的Bug 详情
2019年10月21日发布
点击下载SDK
注意:weexUniJs.js和uni-app-service.js这2个文件的路径有变化,需要重新引入自己的工程中,具体看官方的打包demo示例。
- 更新uni-app离线打包支持,需使用HBuilderX(2.3.6.20191021)版本生成本地打包App资源。
- App-iOS平台 修复 tabBar 页面因内存不足而白屏后无法自动恢复的Bug 详情
- App-iOS平台 修复 tabBar 设置 icon 图标可能无法显示的Bug 详情
- App-iOS平台 修复 nvue list组件 scroll 事件返回的参数缺少 isDragging 属性的Bug 详情
2019年10月18日发布
点击下载SDK
注意:weexUniJs.js和uni-app-service.js这个2个文件的路径有变化,需要重新引入自己的工程中,具体看官方的打包demo示例。
- 更新uni-app离线打包支持,需使用HBuilderX(2.3.5.20191018)版本生成本地打包App资源。
- iOS平台 更新 微信登录、分享、支付SDK(1.8.6.1),适配iOS13,需要配置通用链接(Universal Links)详情
- iOS平台 更新 QQ登录、分享SDK(3.3.6),新浪微博登录、分享SDK(3.2.5)
- iOS平台 修复 iOS13上配置后台播放音乐可能引起应用崩溃的Bug 详情
- iOS平台 修复 图片压缩(plus.zip.compressImage)设置缩放图片的宽度(width)和高度(height)无效的Bug 详情
- iOS平台 修复 iPhone11上查询设备是否为刘海屏(plus.navigator.hasNotchInScreen)返回值不正确的Bug 详情
- iOS平台 修复 视频播放(VideoPlayer)控件设置 show-progress 属性不生效的Bug
- iOS平台 修复 视频播放(VideoPlayer)控件设置 autoplay 属性值为 true 后加载雪花可能显示不正常的Bug
- iOS平台 修复 指纹识别(Fingerprint)判断当前设备是否支持(plus.fingerprint.isSupport)返回值可能不正确的Bug
- iOS平台 修复 Webview窗口设置软键盘模式(softinputMode)为adjustResize时,新开页面并弹出软键盘后返回可能白屏的Bug
- iOS平台 修复 数据库(SQLite)多次打开数据库后,调用判断数据库是否打开(plus.sqlite.isOpenDatabase)返回值可能不正确的Bug
- iOS平台 修复 数据库(SQLite)在HX中真机运行可能出现SQL语句操作(plus.sqlite.executeSql)无法正常执行的Bug
- App-iOS平台 新增 nvue live-pusher组件支持 orientation 属性设置画面方向
- App-iOS平台 修复 nvue map组件的点击控件事件 @controltap 不响应的Bug 详情
- App-iOS平台 修复 nvue barcode组件扫码成功触发 marked 事件返回参数条码数据为空的Bug 详情
- iOS平台 修复 系统相册选择图片文件时如果相册中没有图片返回时loading界面不消失的Bug
2019年09月23日发布
- 更新uni-app离线打包支持,需使用HBuilderX(2.3.3.20190923)版本生成本地打包App资源。
- iOS平台 修复 iOS13上保存图片到系统相册(plus.gallery.save)失败的Bug
- iOS平台 修复 非自定义组件编译模式 uni.request 无法跨域的Bug 详情
- iOS平台 修复 nvue swiper组件包含子组件少于3个时布局可能不正确的Bug
- iOS平台 修复 nvue video组件退出全屏动画时被其它组件覆盖的Bug
2019年09月21日发布
- 更新uni-app离线打包支持,需使用HBuilderX(2.3.2.20190921)版本生成本地打包App资源。
- iOS平台 修复 视频播放(VideoPlayer)控件退出全屏后状态栏方向不对的Bug 详情
- iOS平台 修复 iOS13上获取系统状态栏样式(plus.navigator.getStatusBarStyle)总是反馈dark,导致uni-app状态栏颜色混乱的Bug 详情
- iOS平台 修复 iOS13上获取系统状态高度不正确的Bug 详情
- iOS平台 修复 slider组件中的内容可能出现重叠的Bug
- iOS平台 修复 iOS13上input组件设置自动聚焦无效的Bug
- iOS平台 修复 nvue 组件 refresh 某些情况下闪退的 Bug
2019年09月20日发布
- 更新uni-app离线打包支持,需使用HBuilderX(2.3.1.20190920)版本生成本地打包App资源。
2019年09月20日发布
点击下载SDK
重要:因为增加uni的自定义组件,原barcode、video和livepush模块的依赖关系有所变化,具体参看Feature-iOS.xls文件和livepush
- 更新uni-app离线打包支持,需使用HBuilderX(2.3.0.20190919)版本生成本地打包App资源。
- iOS平台 新增 云打包支持配置Capabilities,如通用链接(Universal Link)详情
- iOS平台 新增 创建本地消息(plus.push.createMessage)支持设置标题(title)和副标题(subtitle) 详情
- iOS平台 更新 UniPush&个推推送SDK(2.4.1.0)适配iOS13
- iOS平台 更新 友盟统计SDK(6.0.5)适配iOS13,注意:新版本要求应用使用广告标识IDFA 详情
- iOS平台 修复 使用录音对象(AudioRecorder)时如果用户不允许访问麦克风(未授权)不触发失败回调的Bug
- iOS平台 修复 音频播放对象(AudioPlayer)的setStyles方法设置开始播放位置(startTime)不准确,isPaused方法获取播放状态不准确的Bug 详情
- iOS平台 修复 视频播放(VideoPlayer)控件无法播放带身份认证的rtsp地址的Bug 详情
- iOS平台 修复 视频播放(VideoPlayer)控件在iOS13上退出全屏后显示位置不正确的Bug
- iOS平台 修复 蓝牙(Bluetooth)停止搜索设备后再开始可能无法返回之前搜索到的设备,及搜索设置allowDuplicatesKey参数无效的Bug。
- iOS平台 修复 获取网络gif图片信息(plus.io.getImageInfo)引起应用崩溃的Bug
- iOS平台 修复 Webview窗口设置滑屏(drag)后,侧滑返回操作可能引起应用崩溃的Bug 详情
- iOS平台 修复 应用仅配置横屏时调用系统相册选择图片(plus.gallery.pick)时引起应用崩溃的Bug 详情
- iOS平台 修复 图片压缩转换(plus.zip.compressImage)处理图片分辨率过高可能造成内存溢出引起应用崩溃的Bug 详情
- iOS平台 修复 图片预览(plus.nativeUI.previewImage)显示高分辨率图片可能超出内存溢出引起应用崩溃的Bug
- iOS平台 修复 直播推流(LivePusher)控件配置开启摄像头(enable-camera)属性导致无法推视频流的Bug
- iOS平台 修复 直播推流(LivePusher)控件设置视频模式(mode)属性和宽高比(aspect)属性可能不生效的Bug
- iOS平台 修复 获取图片信息(plus.io.getImageInfo)传入网络图片地址无法下载图片时触发成功回调的Bug
- iOS平台 修复 Webview窗口背景设置为深色时,Tab栏上面会出现白条的Bug 详情
- iOS平台 修复 Webview窗口使用WKWebview内核时overrideUrlLoading方法无效的Bug 详情
- iOS平台 修复 蓝牙(Bluetooth)开始搜索后不停止直接关闭页面可能会引起应用崩溃的Bug
- iOS平台 修复 uni-app中subNVue页面可能无法接收到父页面通过subNVue.postMessage发送的消息的Bug 详情
- iOS平台 修复 nvue iPhoneX设备软键盘弹出时页面偏移位置不准确的Bug 详情
- iOS平台 修复 nvue map组件添加的子组件可能无法显示的Bug 详情
- iOS平台 修复 nvue swipe组件高度动态变化后切页显示不正常的Bug 详情
- iOS平台 修复 nvue video标签设置封面图片(poster)后动态修改src属性可能引起应用崩溃的Bug 详情
- iOS平台 修复 nvue video标签设置自动播放(autoplay)为true不生效的Bug
- iOS平台 修复 nvue video标签中退出全屏后覆盖元素显示不正常的Bug
- iOS平台 修复 nvue input组件设置adjust-position属性值为false无效的Bug 详情
- iOS平台 修复 nvue webSocket模块设置多个协议(protocol)导致连接服务器失败的Bug
- iOS平台 修复 nvue bindingx在uni-app编译模式下拖拽组件时偏移系数不正确的Bug
- iOS平台 修复 uni原生插件实现代理方法(application:openURL:options:)后与第三方应用交互(如调用微信登录)引起应用崩溃的Bug
- iOS平台 修复 uni原生插件实现代理方法(application:handleOpenURL:)不触发,导致无法获取第三方应用返回数据的Bug
2019年08月19日发布
点击下载SDK
重要:因为增加uni的自定义组件,原barcode、video和livepush模块的依赖关系有所变化,具体参看Feature-iOS.xls文件和livepush
- 更新uni-app离线打包支持,需使用HBuilderX(2.2.2.20190816)版本生成本地打包App资源。
2019年08月14日发布
点击下载SDK
重要:因为增加uni的自定义组件,原barcode、video和livepush模块的依赖关系有所变化,具体参看Feature-iOS.xls文件和livepush
- 更新uni-app离线打包支持,需使用HBuilderX(2.2.1.20190813)版本生成本地打包App资源。
- iOS平台 更新 高德地图SDK:基础SDK(v1.5.7)、3D地图SDK(v6.9.0)、搜索功能(v6.9.0),修复多次打开关闭地图页面引起应用崩溃的Bug 详情
- iOS平台 修复 视频播放(VideoPlayer)控件的timeupdate事件不触发的Bug 详情
- iOS平台 修复 视频播放(VideoPlayer)控件全屏时音量调节手势功能无效的Bug
- iOS平台 修复 Webview窗口配置系统软键盘模式(softinputMode)为adjustResize,收起软键盘后窗口高度无法恢复的Bug 详情
- iOS平台 修复 uni-app项目打包模块配置中勾选“Maps(地图)”但不配置高德或百度地图SDK参数引起提交云端打包失败的Bug
2019年08月12日发布
点击下载SDK
重要:因为增加uni的自定义组件,原barcode、video和livepush模块的依赖关系有所变化,具体参看Feature-iOS.xls文件和livepush
- 更新uni-app离线打包支持,需使用HBuilderX(2.2.0.20190810)版本生成本地打包App资源。
- iOS平台 新增 视频播放(VideoPlayer)控件支持设置倍速播放(playbackRate)
- iOS平台 修复 视频播放(VideoPlayer)控件在页面关闭后可能还会在后台重新播放的Bug 详情
- iOS平台 修复 横竖屏设置中landscape-primary、landscape-secondary方向与android平台相反的Bug
- iOS平台 修复 使用plus.maps.create创建地图设置宽高为用百分比时计算不准确的Bug 详情
- iOS平台 修复 蓝牙(Bluetooth)订阅特征值变化(notifyBLECharacteristicValueChange)后触发onBLECharacteristicValueChange事件逻辑不正确的Bug
- iOS平台 修复 蓝牙(Bluetooth)特征值的写(write)属性可能获取不正确的Bug
- iOS平台 修复 蓝牙(Bluetooth)特征值读(readBLECharacteristicValue)或写(writeBLECharacteristicValue)操作可能不触发回调的Bug
2019年07月24日发布
点击下载SDK
重要:因为增加uni的自定义组件,原barcode、video和livepush模块的依赖关系有所变化,具体参看Feature-iOS.xls文件和livepush
- 更新uni-app离线打包支持,需使用HBuilderX(2.1.3.20190723)版本生成本地打包App资源。
- iOS平台 修复 UniPush通过苹果APNS通道下发payload为字符串内容时,点击触发click事件中消息对象的payload属性值自动转换为包含无效数据json类型的Bug
- iOS平台 修复 nvue页面中获取渠道标识(plus.runtime.channel)返回值不正确的Bug
- iOS平台 修复 真机运行时偶发页面无法渲染(白屏)的Bug 详情
2019年07月16日发布
点击下载SDK
重要:因为增加uni的自定义组件,原barcode、video和livepush模块的依赖关系有所变化,具体参看Feature-iOS.xls文件和livepush
- 更新uni-app离线打包支持,需使用HBuilderX(2.1.1.20190716)版本生成本地打包App资源。
- iOS平台 修复 uni-app使用非自定义组件模式编译可能出现卡在splash界面或崩溃闪退的Bug 详情
- iOS平台 修复 5+应用使用WKWebview在某些情况下可能引起闪退的Bug
- iOS平台 修复 webview的circle样式下拉刷新操作不流畅和显示细节不正确的Bug 详情
2019年07月15日发布
点击下载SDK
重要:因为增加uni的自定义组件,原barcode、video和livepush模块的依赖关系有所变化,具体参看Feature-iOS.xls文件和livepush
- 更新uni-app离线打包支持,需使用HBuilderX(2.1.0.20190713)版本生成本地打包App资源。
- iOS平台 修复 提交苹果应用市场(AppStore)审核提示违反Guideline2.5.2的Bug 详情
- iOS平台 修复 音频播放(AudioPlayer)后台播放网络音乐时控制页面(iOS锁屏控制页)进度显示不准确的Bug 详情
- iOS平台 修复 数据库(SQLite)在多个页面同时操作时可能无效的Bug 详情
- iOS平台 修复 Webview窗口设置不替换H5标准定位接口(replacewebapi:{geolocation:'none'})不生效的Bug
- iOS平台 修复 日期选择(plus.nativeUI.pickDate)设置显示日期小于起始日期时默认返回的日期不正确的Bug 详情
- iOS平台 修复 获取图片信息(plus.io.getImageInfo)可能不触发回调的Bug 详情
- iOS平台 修复 非自定义组件模式在某些情况子窗口高度计算不正确的Bug 详情
- iOS平台 修复 视频控件(VideoPlayer)播放时拖放调整进度后可能不触发播放结束事件的Bug
- iOS平台 修复 子Webview窗口中软键盘收起后页面无法自动恢复的Bug 详情
- iOS平台 修复 蓝牙(Bluetooth)第一次获取本机蓝牙适配器状态(getBluetoothAdapterState)不触发回调的Bug 详情
- iOS平台 修复 蓝牙(Bluetooth)特征值的write操作类型值为false时无法写入数据的Bug 详情
- iOS平台 修复 蓝牙(Bluetooth)特征值的notify操作类型值为true时无法订阅的Bug 详情
- iOS平台 修复 nvue页面打开vue页面后弹出软键盘时可能会露出之前nvue页面内容的Bug
- iOS平台 修复 nvue页面中img标签src属性不支持"_doc"等开头的图片地址的Bug 详情
- iOS平台 修复 地图控件中的标点对象(marker)在新开页面后再返回时点击报js错误的bug 详情
- iOS平台 修复 nvue页面中获取渠道标识(plus.runtime.channel)返回值不正确的Bug
2019年06月14日发布
- 更新uni-app离线打包支持,需使用HBuilderX(2.0.1.20190614)版本生成本地打包App资源。
2019年06月11日发布
- 更新uni-app离线打包支持,需使用HBuilderX(2.0.0.20190610)版本生成本地打包App资源。
- iOS平台 修复 提交苹果应用市场(AppStore)审核提示违反Guideline2.5.2的Bug 详情
- iOS平台 修复 音频播放(AudioPlayer)后台播放网络音乐时控制页面(iOS锁屏控制页)进度显示不准确的Bug 详情
- iOS平台 修复 日期选择对话框(plus.nativeUI.pickDate)返回日期可能不准确的Bug 详情
- iOS平台 修复 Webview窗口移除原生控件(plus.nativeObj.View)不生效的Bug
- iOS平台 修复 Webview窗口获取样式(getStyle)返回的json对象键名称全部为小写的Bug
2019年05月23日发布
- 更新uni-app离线打包支持,需使用HBuilderX(1.9.9.20190522)版本生成本地打包App资源。
- iOS平台 修复 HBuilderX1.9.8版本引出的网络请求url编码的地址包含#等锚点时可能获取不到数据的Bug。
- iOS平台 修复 自定义组件模式下调用地图控件对象的resize方法会引起程序崩溃的Bug。
- 注意离线打包时如果弹出提示框且内容为:“HTML5+ Rumtime D”时,需要在打包的原生工程里配置国际化如何配置
2019年05月19日发布
- 更新uni-app离线打包支持,需使用HBuilderX(1.9.8.20190518)版本生成本地打包App资源。
- iOS平台 修复 Webview窗口打开页面地址中包含表情字符串时可能引起崩溃的问题
2019年05月18日发布
- 更新uni-app离线打包支持,需使用HBuilderX(1.9.7.20190517)版本生成本地打包App资源。
- iOS平台 修复 uni-app中设置nvue页面为首页时要6s才能进入应用的Bug
- iOS平台 修复 Webview窗口的下拉刷新雪花可能会被系统状态栏覆盖的Bug
- iOS平台 修复 通过setstyle重设searchInput的placehold时,会把其他参数覆盖的Bug
- iOS平台 修复 真机运行wap2app后再运行uni-app可能无法正常显示的Bug
- iOS平台 修复 原生图片轮播控件(plus.nativeObj.ImageSlider)可能显示不正常的Bug 详情
- iOS平台 修复 原生控件(plus.nativeObj.View)绘制png图片可能无法支持透明的Bug 详情
- iOS平台 修复 uni-app在非自定义组件模式下调用原生插件可能报JS错误(plus.postMessage is not a function)的Bug
- iOS平台 修复 地图控件调用setStyles方法更新样式不生效的Bug
- iOS平台 修复 地图控件可能报JS错误 Can't find variable: WeexPlus 的Bug 详情
- iOS平台 修复 视频播放控件(VideoPlayer)切换到全屏播放时画面可能会卡住的Bug
- iOS平台 修复 视频播放控件(VideoPlayer)可能出现画面被压缩的Bug 详情
- iOS平台 修复 数据库(SQLite)操作在一个db文件中创建多个数据库时异常的Bug 详情
- iOS平台 修复 iOS11及以下系统plus.net.XMLHttpRequest使用GET请求调用send设置body参数可能导致请求失败的Bug
- iOS平台 修复 iOS10及以下系统播放音频(plus.audio.AudioPlayer)可能引起崩溃的Bug
- iOS平台 修复 录制mp3文件时会提前触发录音完成回调,此时调用播放可能引起无法触发播放完成事件的Bug
- iOS平台 修复 uni-app在自定义组件模式下向低功耗蓝牙设备指定特征值写入数据操作无效的Bug
- iOS平台 修复 uni-app在自定义组件模式下native.js的plus.ios.import方法调用时报js错误的Bug 详情
- iOS平台 修复 uni-app在自定义组件模式下报weex-polyfill找不到的Bug 详情
- iOS平台 修复 uni-app在自定义组件模式下使用new方法创建的地图无法再append到其它窗口的Bug 详情
- iOS平台 修复 uni-app在自定义组件模式下调用加速度相关接口(plus.accelerometer)时报js错误的Bug
- iOS平台 修复 uni-app在自定义组件模式下获取当前连接的网络类型可能不正确的Bug
- iOS平台 修复 uni原生插件开发在非自定义组件模式下返回js层数据中包含不支持的数据类型导致插件方法调用失败的Bug
2019年04月27日发布
- 更新uni-app离线打包支持,需使用HBuilderX(1.9.4.20190426)版本生成本地打包App资源。
- 新增 Webview窗口标题栏上搜索框(searchInput)支持设置输入的文本内容 文档
- iOS平台 修复 页面使用UIWebview渲染设置softinputMode为adjustResize时弹出软键盘后可能白屏的问题
- iOS平台 修复 uni-app在自定义组件模式下使用地图可能报js错误的问题
- iOS平台 修复 uni-app在自定义组件模式下使用直播推流(LivePusher)控件报js错误的问题
2019年04月23日发布
- 更新uni-app离线打包支持,需使用HBuilderX(1.9.3.20190422)版本生成本地打包App资源。
- iOS平台 修复 nvue页面设置titleNView为false时显示不正确的bug 详情
- iOS平台 修复 nvue页面设置显示titleNView时页面高度可能计算不正确的bug
- iOS平台 修复 页面使用UIWebview渲染设置softinputMode为adjustResize时弹出软键盘后可能会出现黑色区域的问题
- iOS平台 修复 uni-app设置为自定义组件模式时在iOS8.x系统页面白屏的问题
- Hello H5+ 新增 数据库(SQLite)操作示例页面
2019年04月18日发布
- 更新uni-app离线打包支持,需使用HBuilderX(1.9.2.20190417)版本生成本地打包App资源。
- iOS平台 修复 uni-app在非自定义组件模式下调用uni原生插件报plus.postMessage错误的问题 详情
- iOS平台 修复 打开蓝牙适配器可能不触发回调的问题 详情
- iOS平台 修复 Webview窗口标题栏上的搜索框(searchInput)失去焦点后输入的文本不显示的问题
- iOS平台 修复 uni-app在自定义组件模式下console.log只能输出最后一个参数的问题
2019年04月16日发布
- 更新uni-app离线打包支持,需使用HBuilderX(1.9.1.20190415)版本生成本地打包App资源。
- iOS平台 修复 使用WKWebview后在应用首页可能出现侧滑返回到白色页面的问题
- iOS平台 修复 推送(push)消息事件监听回调可能报js错误的问题
2019年04月13日发布
- 更新uni-app离线打包支持,需使用HBuilderX(1.9.0.20190412)版本生成本地打包App资源。
- iOS平台 新增 音频播放(AudioPlayer)支持后台控制器(锁屏播放控制面板)功能
- iOS平台 新增 获取设备安全区域接口(plus.navigator.getSafeAreaInsets)。文档
- iOS平台 修复 录音(AudioRecorder)设置格式为mp3时出现时长不正确的问题
- iOS平台 修复 页面中使用原生控件(plus.nativeObj.View)侧滑返回时可能出现js错误的问题
- iOS平台 修复 页面的softinputMode设置为adjustResize时,软键盘弹出可能会出现页面上移的问题
- iOS平台 修复 页面编辑框失去焦点时会自动滚动到顶部的问题
- iOS平台 修复 图片预览(plus.nativeUI.previewImage)初始显示宽度不正确的问题
- iOS平台 更新 高德地图:基础SDK(v1.5.6)、3D地图SDK(v6.7.0)、搜索功能(v6.5.0)
2019年04月01日发布
- 更新uni-app离线打包支持,需使用HBuilderX(1.8.2.20190330)版本生成本地打包App资源。
- 【重要】新增 SQLite模块(plus.sqlite.*),支持操作本地数据库文件。打包配置指南。API文档
- iOS平台 修复 创建Webview时设置softinputNavBar属性不生效的问题
- iOS平台 修复 提交云端打包后调用新浪微博分享可能出现应用卡死的问题
- iOS平台 修复 图片预览(plus.nativeUI.previewImage)设置current参数大于图片总数时显示逻辑异常的问题
- iOS平台 修复 蓝牙写入特征值时在部分设备上可能出现无法写入的问题
- iOS平台 修复 模拟器上真机运行更新时可能卡在正在重启的问题
2019年03月15日发布
- 更新uni-app离线打包支持,需使用HBuilderX(1.7.0.20190314)版本生成本地打包App资源。
- 新增 自定义基座运行应用时toast提示“当前应用运行在自定义基座中”,避免将自定义基座作为正式包发布
- 新增 Webview窗口标题栏(titleNView)上的按钮支持配置最大宽度(maxWidth)
- 新增支持获取uni-app运行环境版本接口(plus.runtime.uniVersion)
- iOS平台 新增 Webview窗口支持设置是否隐藏软键盘上的导航条(softinputNavBar)
- iOS平台 修复 在iOS12及以上系统WKWebview软键盘弹出后无法完全收回的问题
- iOS平台 修复 在iOS11.4及以上系统弹出软键盘后可能出现页面会整体上移并出现黑色背景的问题
- iOS平台 修复 视频控件(VideoPlayer)无法播放部分rtsp、rtmp视频,timeupdate事件可能不触发等问题
- iOS平台 修复 视频控件(VideoPlayer)在iOS9.x上播放m3u8视频可能引起崩溃的问题
- iOS平台 修复 Webview窗口标题栏(titleNView)在透明样式下按钮文字初始颜色不正确的问题
- iOS平台 修复 部分蓝牙设备可能无法搜索到,蓝牙服务uuid和特征值uuid格式不正确等问题
- iOS平台 修复 uni-app在iOS8.x系统上页面无法渲染出内容的问题
- iOS平台 修复 nvue页面中websocket连接总是失败的问题
2019年02月21日发布
点击下载SDK
1、更新uni-app离线打包支持,需使用HBuilderX(1.6.2.20190220)版本生成本地打包App资源。
2、iOS平台 修复 应用首页配置为WKWebview时可能出现启动后白屏的问题
3、iOS平台 修复 相册选择文件界面(plus.gallery.pick)未自动适配系统语言的问题
4、iOS平台 修复 Webview窗口titleNView的buttons中不设置text属性可能会卡死、colour属性无法动态修改的问题
5、iOS平台 修复 提交Appstore提示使用非公开API(DirectoryWatcher)的问题
6、iOS平台 更新 云打包编译环境为XCode10.1,解决提交AppStore提示“WARNING ITMS-90725”的问题
2019年01月21日发布
点击下载SDK
1、更新uni-app离线打包支持,需使用HBuilderX(1.5.1或1.5.2)版本生成本地打包App资源。
2、调整sdk包中HBuilder-Hello工程里默认为高德地图。
3、新增 标题栏按钮(WebviewTitleNViewButtonStyles)支持红点、角标和向下箭头等。
4、iOS平台 修复 原生控件(NView)可能出现点击事件不触发的问题(影响使用NView实现Tab切换页面功能)
5、iOS平台 修复 视频播放(VideoPlayer)控件隐藏后还继续播放的问题
6、iOS平台 修复 窗口使用UIWebview内核可能出现拦截资源不生效的问题
7、iOS平台 修复 地图控件缩放时可能出现标点漂移的问题
8、iOS平台 修复 地图控件的标点可能出现点击不生效的问题
9、iOS平台 修复 WAP2APP应用中小米推送可能接收不到消息的问题
10、iOS平台 修复 获取摄像头对象(plus.camera.getCamera)指定摄像头索引值不生效的问题
11、iOS平台 修复 nvue页面不支持websocket模块的问题
2018年12月26日发布
- 更新uni-app离线打包支持,需使用HBuilderX(1.4.0.XXXX)版本生成本地打包App资源.
- Webview窗口设置是否自动调整.
3.内容区域避免与安全区域或系统状态栏重合,参考:地址.
4.iOS平台 修复 图片压缩(plus.zip.compressImage)的overwrite参数不生效的问题.
5.iOS平台 修复 保存图片到相册使用相对路径时可能导致程序异常的问题.
6.iOS平台 修复 在WAP2APP应用中微信分享成功没有触发回调函数的问题.
7.iOS平台 修复 视频播放控件(VideoPlayer)通过setStle设置height属性不生效的问题.
2018年12月12日发布
点击下载SDK
1、更新uni-app离线打包支持,需使用HBuilderX(1.3.1.20181211)版本生成本地打包App资源.
2、iOS平台 更新 支付宝App支付SDK(v15.5.7).
3、iOS平台 修复 通过Scheme启动应用plus.runtime.arguments可能获取不到启动参数的问题.
4、iOS平台 修复 设置Storage数据(plus.storage.setItem)可能引起程序崩溃的问题.
5、iOS平台 修复 视频播放控件(VideoPlayer)播放某些视频最后几秒可能一直缓冲的问题.
6、iOS平台 修复 视频播放控件(VideoPlayer)拖动播放进度后修改src可能不会自动播放的问题.
7、iOS平台 修复 地图控件来回移动操作后可能导致标点对象(Marker)变形的问题.
8、iOS平台 修复 百度定位可能引起应用崩溃的问题.
2018年5月11日发布
点击下载SDK
1 修复近期发现的一些bug,提升稳定性
2 更新微信SDK,新版微信SDK有带支付和不带支付两个版本,使用微信支付的开发者需要在工程中引入libWeChatSDK_pay.a。
使用了微信分享和登录但未使用支付的用户需要在工程中引入libWeChatSDK.a。
未使用微信支付功能的用户引入libWeChatSDK_pay.a在提交AppStore审核时可能会因为支付通道问题被拒绝
-->
iOS平台使用Webview窗口的侧滑返回效果
HBuilder 5+ Runtime 0.13.0以后版本支持侧滑返回功能(从屏幕左侧向右滑动可关闭Webview窗口),效果如下:
默认所有Webview窗口都是开启此功能的,并且侧滑返回后会关闭Webview窗口。
使用Webview窗口的侧滑返回功能
通过WebviewStyle的popGesture单独控制每个Webview的侧滑返回效果,取值:
值 | 效果 |
---|---|
none | 无侧滑返回功能 |
close | 侧滑返回关闭Webview窗口 |
hide | 侧滑返回隐藏webview窗口 |
侧滑返回隐藏或关闭Webview窗口的逻辑与调用hide和close方法一致。
5+APP应用示例
-
创建webview支持侧滑返回:
var wv=plus.webview.create('url','id',{'popGesture':'close'}); wv.show(); // 或这样写 var wv=plus.webview.open('url','id',{'popGesture':'close'});
-
动态改变webview的侧滑返回功能:
var wv=plus.webview.currentWebview(); // 关闭侧滑返回功能 wv.setStyle({'popGesture':'none'}); // 侧滑返回后关闭webview wv.setStyle({'popGesture':'close'}); // 侧滑返回后隐藏webview wv.setStyle({'popGesture':'hide'});
uni-app应用示例
在pages.json对应页面的style下添加popGesture属性:
{
"path" : "pages/component/text/text",
"style" : {
"navigationBarTitleText" : "text",
"popGesture": "none"
}
}
修改应用的窗口默认
为了提升用户的体验效果,默认所有Webview窗口都是侧滑返回关闭("close"),也可以在manifest.json中修改默认值。
打开应用manifest.json文件,切换到代码视图,添加popGesture字段,值可为WebviewStyle的popGesture取值("hide"|"close"|"none")。
- 5+APP(WAP2APP)应用在manifest.json的"plus"->"popGesture"节点配置:
- uni-app应用,只能配置"close"|"none",不能配置为"hide",默认值为"close",在manifest.json的"app-plus"->"popGesture"节点配置:
注意:仅iOS平台支持侧滑返回功能
HBuilder 5+ Runtime 0.13.0以后版本支持侧滑返回功能(从屏幕左侧向右滑动可关闭Webview窗口),效果如下:
默认所有Webview窗口都是开启此功能的,并且侧滑返回后会关闭Webview窗口。
使用Webview窗口的侧滑返回功能
通过WebviewStyle的popGesture单独控制每个Webview的侧滑返回效果,取值:
值 | 效果 |
---|---|
none | 无侧滑返回功能 |
close | 侧滑返回关闭Webview窗口 |
hide | 侧滑返回隐藏webview窗口 |
侧滑返回隐藏或关闭Webview窗口的逻辑与调用hide和close方法一致。
5+APP应用示例
-
创建webview支持侧滑返回:
var wv=plus.webview.create('url','id',{'popGesture':'close'}); wv.show(); // 或这样写 var wv=plus.webview.open('url','id',{'popGesture':'close'});
-
动态改变webview的侧滑返回功能:
var wv=plus.webview.currentWebview(); // 关闭侧滑返回功能 wv.setStyle({'popGesture':'none'}); // 侧滑返回后关闭webview wv.setStyle({'popGesture':'close'}); // 侧滑返回后隐藏webview wv.setStyle({'popGesture':'hide'});
uni-app应用示例
在pages.json对应页面的style下添加popGesture属性:
{
"path" : "pages/component/text/text",
"style" : {
"navigationBarTitleText" : "text",
"popGesture": "none"
}
}
修改应用的窗口默认
为了提升用户的体验效果,默认所有Webview窗口都是侧滑返回关闭("close"),也可以在manifest.json中修改默认值。
打开应用manifest.json文件,切换到代码视图,添加popGesture字段,值可为WebviewStyle的popGesture取值("hide"|"close"|"none")。
- 5+APP(WAP2APP)应用在manifest.json的"plus"->"popGesture"节点配置:
- uni-app应用,只能配置"close"|"none",不能配置为"hide",默认值为"close",在manifest.json的"app-plus"->"popGesture"节点配置:
注意:仅iOS平台支持侧滑返回功能
收起阅读 »Android平台指定程序使用的权限(Permissions)
HBuilder的App云端打包会根据应用使用的5+ API自动添加Android权限(Permissions),是按照5+ API模块分类来添加的(参考5+ API使用的Android权限列表)。
例如,如使用了Device的API,如plus.networkinfo.getCurrentType(),默认情况下打包机会自动添加Device模块相关的所有权限:
<uses-permission android:name="android.permission.WAKE_LOCK"/>
<uses-permission android:name="android.permission.VIBRATE"/>
<uses-permission android:name="android.permission.READ_PHONE_STATE"/>
<uses-permission android:name="android.permission.CALL_PHONE"/>
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE"/>
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>
而实际只需要最后两个权限就可以,前面四个权限都是没有必要添加的。
为了解决添加不必要Android权限的问题,我们可以通过以下方式设置定义Android权限
-
打开应用的manifest.json文件,切换到代码视图,添加plus->distribute->google->custompermissions节点,并设置值为true:
-
参考5+ API使用的Android权限列表,根据应用中使用的5+ API整理出要使用的Android权限,并添加到plus->distribute->google->permissions值数组中,如下是使用Speech和Statistic两个模块要使用到的权限:
-
保存,并提交App云端打包
HBuilder的App云端打包会根据应用使用的5+ API自动添加Android权限(Permissions),是按照5+ API模块分类来添加的(参考5+ API使用的Android权限列表)。
例如,如使用了Device的API,如plus.networkinfo.getCurrentType(),默认情况下打包机会自动添加Device模块相关的所有权限:
<uses-permission android:name="android.permission.WAKE_LOCK"/>
<uses-permission android:name="android.permission.VIBRATE"/>
<uses-permission android:name="android.permission.READ_PHONE_STATE"/>
<uses-permission android:name="android.permission.CALL_PHONE"/>
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE"/>
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>
而实际只需要最后两个权限就可以,前面四个权限都是没有必要添加的。
为了解决添加不必要Android权限的问题,我们可以通过以下方式设置定义Android权限
-
打开应用的manifest.json文件,切换到代码视图,添加plus->distribute->google->custompermissions节点,并设置值为true:
-
参考5+ API使用的Android权限列表,根据应用中使用的5+ API整理出要使用的Android权限,并添加到plus->distribute->google->permissions值数组中,如下是使用Speech和Statistic两个模块要使用到的权限:
-
保存,并提交App云端打包
5+ API使用的Android权限列表(Permissions)
5+ API分模块封装调用了系统各种原生能力,而部分能力需要使用到Android的permissions,以下列出了各模块(或具体API)使用的的权限:
基础权限
5+ App必须使用的到最小权限集
API | 权限 | 说明 |
---|---|---|
ALL | <uses-permission android:name="android.permission.INTERNET"/> | 允许程序访问网络 |
ALL | <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/> | 允许程序读写扩展存储卡 |
Audio
调用plus.audio.*使用到的权限集
API | 权限 | 说明 |
---|---|---|
ALL | <uses-permission android:name="android.permission.RECORD_AUDIO"/> | 允许程序录制音频 |
ALL | <uses-permission android:name="android.permission.MODIFY_AUDIO_SETTINGS"/> | 允许程序修改全局音频设置 |
Camera
调用plus.camera.*使用到的权限集
API | 权限 | 说明 |
---|---|---|
ALL | <uses-permission android:name="android.permission.CAMERA"/> | 允许程序使用照相设备 |
ALL | <uses-feature android:name="android.hardware.camera"/> | 允许程序访问照相设备 |
Contacts
调用plus.contacts.*使用到的权限集
API | 权限 | 说明 |
---|---|---|
ALL | <uses-permission android:name="android.permission.GET_ACCOUNTS"/> | 允许程序访问Accounts Service帐户列表 |
ALL | <uses-permission android:name="android.permission.READ_CONTACTS"/> | 允许程序读取用户联系人数据 |
ALL | <uses-permission android:name="android.permission.WRITE_CONTACTS"/> | 允许程序修改用户联系人数据 |
Device
调用plus.device.、plus.screen.、plus.display.、plus.networkinfo.、plus.os.*使用到的权限集
API | 权限 | 说明 |
---|---|---|
plus.device.setWakelock(); plus.device.isWakelock(); | <uses-permission android:name="android.permission.WAKE_LOCK"/> | 允许程序保持进程不进入休眠状态 |
plus.device.vibrate(); | <uses-permission android:name="android.permission.VIBRATE"/> | 允许程序访问振动设备 |
plus.device.* | <uses-permission android:name="android.permission.READ_PHONE_STATE"/> | 允许程序访问手机状态信息 |
plus.device.dail(); | <uses-permission android:name="android.permission.CALL_PHONE"/> | 允许程序不通过拨号界面拨打电话 |
plus.networkinfo.* | <uses-permission android:name="android.permission.ACCESS_WIFI_STATE"/> | 允许程序访问Wi-Fi网络状态信息 |
plus.networkinfo.* | <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/> | 允许程序访问有关GSM网络信息 |
Geolocation
调用plus.geolocation.*使用到的权限集
API | 权限 | 说明 |
---|---|---|
ALL | <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"/> | 允许程序访问位置信息 |
ALL | <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION"/> | 允许程序访问CellID或WiFi热点来获取位置信息 |
ALL | <uses-permission android:name="android.permission.ACCESS_WIFI_STATE"/> | 允许程序访问Wi-Fi网络状态信息 |
ALL | <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/> | 允许程序访问有关GSM网络信息 |
ALL | <uses-permission android:name="android.permission.CHANGE_WIFI_STATE"/> | 允许程序改变Wi-Fi连接状态 |
ALL | <uses-permission android:name="android.permission.READ_PHONE_STATE"/> | 允许程序访问手机状态信息 |
ALL | <uses-permission android:name="android.permission.MOUNT_UNMOUNT_FILESYSTEMS"/> | 允许程序挂载和移除可移动存储设备 |
ALL | <uses-permission android:name="android.permission.READ_LOGS"/> | 允许程序读取系统日志文件 |
ALL | <uses-permission android:name="android.permission.WRITE_SETTINGS"/>" | 允许程序读取或写入系统设置 |
Messaging
调用plus.messaging.*使用到的权限集
API | 权限 | 说明 |
---|---|---|
ALL | <uses-permission android:name="android.permission.SEND_SMS"/> | 允许程序发送SMS短信 |
ALL | <uses-permission android:name="android.permission.READ_SMS"/> | 允许程序读取短信息 |
ALL | <uses-permission android:name="android.permission.WRITE_SMS"/> | 允许程序写短信 |
Barcode
调用plus.barcode.*使用到的权限集
API | 权限 | 说明 |
---|---|---|
ALL | <uses-permission android:name="android.permission.CAMERA"/> | 允许程序使用照相设备 |
ALL | <uses-feature android:name="android.hardware.camera"/> | 允许程序访问照相设备 |
ALL | <uses-feature android:name="android.hardware.camera.autofocus"/> | 允许程序访问照相设备自动聚焦 |
ALL | <uses-permission android:name="android.permission.FLASHLIGHT"/>" | 允许程序访问闪光灯 |
ALL | <uses-permission android:name="android.permission.VIBRATE"/> | 允许程序访问振动设备 |
Map
调用plus.maps.*使用到的权限集
百度地图
API | 权限 | 说明 |
---|---|---|
ALL | <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"/> | 允许程序访问位置信息 |
ALL | <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION"/> | 允许程序访问CellID或WiFi热点来获取位置信息 |
ALL | <uses-permission android:name="android.permission.ACCESS_WIFI_STATE"/> | 允许程序访问Wi-Fi网络状态信息 |
ALL | <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/> | 允许程序访问有关GSM网络信息 |
ALL | <uses-permission android:name="android.permission.CHANGE_WIFI_STATE"/> | 允许程序改变Wi-Fi连接状态 |
ALL | <uses-permission android:name="android.permission.READ_PHONE_STATE"/> | 允许程序访问手机状态信息 |
ALL | <uses-permission android:name="android.permission.MOUNT_UNMOUNT_FILESYSTEMS"/> | 允许程序挂载和移除可移动存储设备 |
ALL | <uses-permission android:name="android.permission.READ_LOGS"/> | 允许程序读取系统日志文件 |
ALL | <uses-permission android:name="android.permission.WRITE_SETTINGS"/>" | 允许程序读取或写入系统设置 |
高德地图
API | 权限 | 说明 |
---|---|---|
ALL | <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"/> | 允许程序访问位置信息 |
ALL | <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION"/> | 允许程序访问CellID或WiFi热点来获取位置信息 |
ALL | <uses-permission android:name="android.permission.ACCESS_WIFI_STATE"/> | 允许程序访问Wi-Fi网络状态信息 |
ALL | <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/> | 允许程序访问有关GSM网络信息 |
ALL | <uses-permission android:name="android.permission.CHANGE_WIFI_STATE"/> | 允许程序改变Wi-Fi连接状态 |
ALL | <uses-permission android:name="android.permission.READ_PHONE_STATE"/> | 允许程序访问手机状态信息 |
ALL | <uses-permission android:name="android.permission.MOUNT_UNMOUNT_FILESYSTEMS"/> | 允许程序挂载和移除可移动存储设备 |
ALL | <uses-permission android:name="android.permission.READ_LOGS"/> | 允许程序读取系统日志文件 |
ALL | <uses-permission android:name="android.permission.WRITE_SETTINGS"/>" | 允许程序读取或写入系统设置 |
OAuth
调用plus.oauth.*使用到的权限集
微信
API | 权限 | 说明 |
---|---|---|
ALL | <uses-permission android:name="android.permission.MODIFY_AUDIO_SETTINGS"/> | 允许程序修改全局音频设置 |
新浪微博
API | 权限 | 说明 |
---|---|---|
ALL | 无 | 无 |
QQ分享
API | 权限 | 说明 |
---|---|---|
ALL | <uses-permission android:name="android.permission.MODIFY_AUDIO_SETTINGS"/> | 允许程序修改全局音频设置 |
Payment
调用plus.payment.*使用到的权限集
支付宝
API | 权限 | 说明 |
---|---|---|
ALL | <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/> | 允许程序访问有关GSM网络信息 |
ALL | <uses-permission android:name="android.permission.ACCESS_WIFI_STATE"/> | 允许程序访问Wi-Fi网络状态信息 |
ALL | <uses-permission android:name="android.permission.READ_PHONE_STATE"/> | 允许程序访问手机状态信息 |
ALL | <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION"/> | 允许程序访问CellID或WiFi热点来获取位置信息 |
微信支付
API | 权限 | 说明 |
---|---|---|
ALL | <uses-permission android:name="android.permission.MODIFY_AUDIO_SETTINGS"/> | 允许程序修改全局音频设置 |
Push
调用plus.push.*使用到的权限集
个推推送
API | 权限 | 说明 |
---|---|---|
ALL | <uses-permission android:name="android.permission.READ_PHONE_STATE"/> | 允许程序访问手机状态信息 |
ALL | <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/> | 允许程序访问有关GSM网络信息 |
ALL | <uses-permission android:name="android.permission.CHANGE_WIFI_STATE"/> | 允许程序改变Wi-Fi连接状态 |
ALL | <uses-permission android:name="android.permission.WAKE_LOCK"/> | 允许程序保持进程不进入休眠状态 |
ALL | <uses-permission android:name="android.permission.RECEIVE_BOOT_COMPLETED"/> | 允许程序开机启动服务(离线推送服务) |
ALL | <uses-permission android:name="android.permission.VIBRATE"/> | 允许程序访问振动设备 |
ALL | <uses-permission android:name="android.permission.ACCESS_WIFI_STATE"/> | 允许程序访问Wi-Fi网络状态信息 |
ALL | <uses-permission android:name="android.permission.GET_TASKS"/> | 允许程序获取系统当前运行的任务信息 |
ALL | <uses-permission android:name="android.permission.READ_LOGS"/> | 允许程序读取系统日志文件 |
ALL | <uses-permission android:name="android.permission.RECEIVE_USER_PRESENT"/>" | 允许程序唤醒机器 |
ALL | <uses-permission android:name="getui.permission.GetuiService"/> | 允许程序访问个推离线服务(个推自定义权限) |
ALL | <permission android:name="getui.permission.GetuiService" android:protectionLevel="normal"/> | 允许程序访问个推离线服务(个推自定义权限) |
Share
调用plus.share.*使用到的权限集
微信
API | 权限 | 说明 |
---|---|---|
ALL | <uses-permission android:name="android.permission.MODIFY_AUDIO_SETTINGS"/> | 允许程序修改全局音频设置 |
新浪微博
API | 权限 | 说明 |
---|---|---|
ALL | <uses-permission android:name="android.permission.CHANGE_WIFI_STATE"/> | 允许程序改变Wi-Fi连接状态 |
ALL | <uses-permission android:name="android.permission.ACCESS_WIFI_STATE"/> | 允许程序访问Wi-Fi网络状态信息 |
ALL | <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/> | 允许程序访问有关GSM网络信息 |
QQ分享
API | 权限 | 说明 |
---|---|---|
ALL | <uses-permission android:name="android.permission.MODIFY_AUDIO_SETTINGS"/> | 允许程序修改全局音频设置 |
腾讯微博
API | 权限 | 说明 |
---|---|---|
ALL | <uses-permission android:name="android.permission.CHANGE_WIFI_STATE"/> | 允许程序改变Wi-Fi连接状态 |
ALL | <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/> | 允许程序访问有关GSM网络信息 |
ALL | <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION"/> | 允许程序访问CellID或WiFi热点来获取位置信息 |
ALL | <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"/> | 允许程序访问位置信息 |
ALL | <uses-permission android:name="android.permission.ACCESS_MOCK_LOCATION"/> | 允许程序创建模拟位置 |
Speech
调用plus.speech.*使用到的权限集
API | 权限 | 说明 |
---|---|---|
ALL | <uses-permission android:name="android.permission.RECORD_AUDIO"/> | 允许程序录制音频 |
ALL | <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/> | 允许程序访问有关GSM网络信息 |
ALL | <uses-permission android:name="android.permission.ACCESS_WIFI_STATE"/> | 允许程序访问Wi-Fi网络状态信息 |
ALL | <uses-permission android:name="android.permission.CHANGE_NETWORK_STATE"/> | 允许程序改变网络连接状态 |
ALL | <uses-permission android:name="android.permission.READ_PHONE_STATE"/> | 允许程序访问手机状态信息 |
Statistic
调用plus.statistic.*使用到的权限集
API | 权限 | 说明 |
---|---|---|
ALL | <uses-permission android:name="android.permission.READ_LOGS"/> | 允许程序读取系统日志文件 |
ALL | <uses-permission android:name="android.permission.RECEIVE_BOOT_COMPLETED"/> | 允许程序开机启动服务(实时提交统计数据服务) |
ALL | <uses-permission android:name="android.permission.RECEIVE_USER_PRESENT"/> | 允许程序唤醒机器 |
Native.JS
native.js封装的plus.android.* API不需要额外的权限,但导入对应对象调用native API时可能需要用到特定的权限,这时需根据情况在manifest.json中的plus->distribute->google->permissions下添加。
5+ API分模块封装调用了系统各种原生能力,而部分能力需要使用到Android的permissions,以下列出了各模块(或具体API)使用的的权限:
基础权限
5+ App必须使用的到最小权限集
API | 权限 | 说明 |
---|---|---|
ALL | <uses-permission android:name="android.permission.INTERNET"/> | 允许程序访问网络 |
ALL | <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/> | 允许程序读写扩展存储卡 |
Audio
调用plus.audio.*使用到的权限集
API | 权限 | 说明 |
---|---|---|
ALL | <uses-permission android:name="android.permission.RECORD_AUDIO"/> | 允许程序录制音频 |
ALL | <uses-permission android:name="android.permission.MODIFY_AUDIO_SETTINGS"/> | 允许程序修改全局音频设置 |
Camera
调用plus.camera.*使用到的权限集
API | 权限 | 说明 |
---|---|---|
ALL | <uses-permission android:name="android.permission.CAMERA"/> | 允许程序使用照相设备 |
ALL | <uses-feature android:name="android.hardware.camera"/> | 允许程序访问照相设备 |
Contacts
调用plus.contacts.*使用到的权限集
API | 权限 | 说明 |
---|---|---|
ALL | <uses-permission android:name="android.permission.GET_ACCOUNTS"/> | 允许程序访问Accounts Service帐户列表 |
ALL | <uses-permission android:name="android.permission.READ_CONTACTS"/> | 允许程序读取用户联系人数据 |
ALL | <uses-permission android:name="android.permission.WRITE_CONTACTS"/> | 允许程序修改用户联系人数据 |
Device
调用plus.device.、plus.screen.、plus.display.、plus.networkinfo.、plus.os.*使用到的权限集
API | 权限 | 说明 |
---|---|---|
plus.device.setWakelock(); plus.device.isWakelock(); | <uses-permission android:name="android.permission.WAKE_LOCK"/> | 允许程序保持进程不进入休眠状态 |
plus.device.vibrate(); | <uses-permission android:name="android.permission.VIBRATE"/> | 允许程序访问振动设备 |
plus.device.* | <uses-permission android:name="android.permission.READ_PHONE_STATE"/> | 允许程序访问手机状态信息 |
plus.device.dail(); | <uses-permission android:name="android.permission.CALL_PHONE"/> | 允许程序不通过拨号界面拨打电话 |
plus.networkinfo.* | <uses-permission android:name="android.permission.ACCESS_WIFI_STATE"/> | 允许程序访问Wi-Fi网络状态信息 |
plus.networkinfo.* | <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/> | 允许程序访问有关GSM网络信息 |
Geolocation
调用plus.geolocation.*使用到的权限集
API | 权限 | 说明 |
---|---|---|
ALL | <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"/> | 允许程序访问位置信息 |
ALL | <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION"/> | 允许程序访问CellID或WiFi热点来获取位置信息 |
ALL | <uses-permission android:name="android.permission.ACCESS_WIFI_STATE"/> | 允许程序访问Wi-Fi网络状态信息 |
ALL | <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/> | 允许程序访问有关GSM网络信息 |
ALL | <uses-permission android:name="android.permission.CHANGE_WIFI_STATE"/> | 允许程序改变Wi-Fi连接状态 |
ALL | <uses-permission android:name="android.permission.READ_PHONE_STATE"/> | 允许程序访问手机状态信息 |
ALL | <uses-permission android:name="android.permission.MOUNT_UNMOUNT_FILESYSTEMS"/> | 允许程序挂载和移除可移动存储设备 |
ALL | <uses-permission android:name="android.permission.READ_LOGS"/> | 允许程序读取系统日志文件 |
ALL | <uses-permission android:name="android.permission.WRITE_SETTINGS"/>" | 允许程序读取或写入系统设置 |
Messaging
调用plus.messaging.*使用到的权限集
API | 权限 | 说明 |
---|---|---|
ALL | <uses-permission android:name="android.permission.SEND_SMS"/> | 允许程序发送SMS短信 |
ALL | <uses-permission android:name="android.permission.READ_SMS"/> | 允许程序读取短信息 |
ALL | <uses-permission android:name="android.permission.WRITE_SMS"/> | 允许程序写短信 |
Barcode
调用plus.barcode.*使用到的权限集
API | 权限 | 说明 |
---|---|---|
ALL | <uses-permission android:name="android.permission.CAMERA"/> | 允许程序使用照相设备 |
ALL | <uses-feature android:name="android.hardware.camera"/> | 允许程序访问照相设备 |
ALL | <uses-feature android:name="android.hardware.camera.autofocus"/> | 允许程序访问照相设备自动聚焦 |
ALL | <uses-permission android:name="android.permission.FLASHLIGHT"/>" | 允许程序访问闪光灯 |
ALL | <uses-permission android:name="android.permission.VIBRATE"/> | 允许程序访问振动设备 |
Map
调用plus.maps.*使用到的权限集
百度地图
API | 权限 | 说明 |
---|---|---|
ALL | <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"/> | 允许程序访问位置信息 |
ALL | <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION"/> | 允许程序访问CellID或WiFi热点来获取位置信息 |
ALL | <uses-permission android:name="android.permission.ACCESS_WIFI_STATE"/> | 允许程序访问Wi-Fi网络状态信息 |
ALL | <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/> | 允许程序访问有关GSM网络信息 |
ALL | <uses-permission android:name="android.permission.CHANGE_WIFI_STATE"/> | 允许程序改变Wi-Fi连接状态 |
ALL | <uses-permission android:name="android.permission.READ_PHONE_STATE"/> | 允许程序访问手机状态信息 |
ALL | <uses-permission android:name="android.permission.MOUNT_UNMOUNT_FILESYSTEMS"/> | 允许程序挂载和移除可移动存储设备 |
ALL | <uses-permission android:name="android.permission.READ_LOGS"/> | 允许程序读取系统日志文件 |
ALL | <uses-permission android:name="android.permission.WRITE_SETTINGS"/>" | 允许程序读取或写入系统设置 |
高德地图
API | 权限 | 说明 |
---|---|---|
ALL | <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"/> | 允许程序访问位置信息 |
ALL | <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION"/> | 允许程序访问CellID或WiFi热点来获取位置信息 |
ALL | <uses-permission android:name="android.permission.ACCESS_WIFI_STATE"/> | 允许程序访问Wi-Fi网络状态信息 |
ALL | <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/> | 允许程序访问有关GSM网络信息 |
ALL | <uses-permission android:name="android.permission.CHANGE_WIFI_STATE"/> | 允许程序改变Wi-Fi连接状态 |
ALL | <uses-permission android:name="android.permission.READ_PHONE_STATE"/> | 允许程序访问手机状态信息 |
ALL | <uses-permission android:name="android.permission.MOUNT_UNMOUNT_FILESYSTEMS"/> | 允许程序挂载和移除可移动存储设备 |
ALL | <uses-permission android:name="android.permission.READ_LOGS"/> | 允许程序读取系统日志文件 |
ALL | <uses-permission android:name="android.permission.WRITE_SETTINGS"/>" | 允许程序读取或写入系统设置 |
OAuth
调用plus.oauth.*使用到的权限集
微信
API | 权限 | 说明 |
---|---|---|
ALL | <uses-permission android:name="android.permission.MODIFY_AUDIO_SETTINGS"/> | 允许程序修改全局音频设置 |
新浪微博
API | 权限 | 说明 |
---|---|---|
ALL | 无 | 无 |
QQ分享
API | 权限 | 说明 |
---|---|---|
ALL | <uses-permission android:name="android.permission.MODIFY_AUDIO_SETTINGS"/> | 允许程序修改全局音频设置 |
Payment
调用plus.payment.*使用到的权限集
支付宝
API | 权限 | 说明 |
---|---|---|
ALL | <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/> | 允许程序访问有关GSM网络信息 |
ALL | <uses-permission android:name="android.permission.ACCESS_WIFI_STATE"/> | 允许程序访问Wi-Fi网络状态信息 |
ALL | <uses-permission android:name="android.permission.READ_PHONE_STATE"/> | 允许程序访问手机状态信息 |
ALL | <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION"/> | 允许程序访问CellID或WiFi热点来获取位置信息 |
微信支付
API | 权限 | 说明 |
---|---|---|
ALL | <uses-permission android:name="android.permission.MODIFY_AUDIO_SETTINGS"/> | 允许程序修改全局音频设置 |
Push
调用plus.push.*使用到的权限集
个推推送
API | 权限 | 说明 |
---|---|---|
ALL | <uses-permission android:name="android.permission.READ_PHONE_STATE"/> | 允许程序访问手机状态信息 |
ALL | <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/> | 允许程序访问有关GSM网络信息 |
ALL | <uses-permission android:name="android.permission.CHANGE_WIFI_STATE"/> | 允许程序改变Wi-Fi连接状态 |
ALL | <uses-permission android:name="android.permission.WAKE_LOCK"/> | 允许程序保持进程不进入休眠状态 |
ALL | <uses-permission android:name="android.permission.RECEIVE_BOOT_COMPLETED"/> | 允许程序开机启动服务(离线推送服务) |
ALL | <uses-permission android:name="android.permission.VIBRATE"/> | 允许程序访问振动设备 |
ALL | <uses-permission android:name="android.permission.ACCESS_WIFI_STATE"/> | 允许程序访问Wi-Fi网络状态信息 |
ALL | <uses-permission android:name="android.permission.GET_TASKS"/> | 允许程序获取系统当前运行的任务信息 |
ALL | <uses-permission android:name="android.permission.READ_LOGS"/> | 允许程序读取系统日志文件 |
ALL | <uses-permission android:name="android.permission.RECEIVE_USER_PRESENT"/>" | 允许程序唤醒机器 |
ALL | <uses-permission android:name="getui.permission.GetuiService"/> | 允许程序访问个推离线服务(个推自定义权限) |
ALL | <permission android:name="getui.permission.GetuiService" android:protectionLevel="normal"/> | 允许程序访问个推离线服务(个推自定义权限) |
Share
调用plus.share.*使用到的权限集
微信
API | 权限 | 说明 |
---|---|---|
ALL | <uses-permission android:name="android.permission.MODIFY_AUDIO_SETTINGS"/> | 允许程序修改全局音频设置 |
新浪微博
API | 权限 | 说明 |
---|---|---|
ALL | <uses-permission android:name="android.permission.CHANGE_WIFI_STATE"/> | 允许程序改变Wi-Fi连接状态 |
ALL | <uses-permission android:name="android.permission.ACCESS_WIFI_STATE"/> | 允许程序访问Wi-Fi网络状态信息 |
ALL | <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/> | 允许程序访问有关GSM网络信息 |
QQ分享
API | 权限 | 说明 |
---|---|---|
ALL | <uses-permission android:name="android.permission.MODIFY_AUDIO_SETTINGS"/> | 允许程序修改全局音频设置 |
腾讯微博
API | 权限 | 说明 |
---|---|---|
ALL | <uses-permission android:name="android.permission.CHANGE_WIFI_STATE"/> | 允许程序改变Wi-Fi连接状态 |
ALL | <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/> | 允许程序访问有关GSM网络信息 |
ALL | <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION"/> | 允许程序访问CellID或WiFi热点来获取位置信息 |
ALL | <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"/> | 允许程序访问位置信息 |
ALL | <uses-permission android:name="android.permission.ACCESS_MOCK_LOCATION"/> | 允许程序创建模拟位置 |
Speech
调用plus.speech.*使用到的权限集
API | 权限 | 说明 |
---|---|---|
ALL | <uses-permission android:name="android.permission.RECORD_AUDIO"/> | 允许程序录制音频 |
ALL | <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/> | 允许程序访问有关GSM网络信息 |
ALL | <uses-permission android:name="android.permission.ACCESS_WIFI_STATE"/> | 允许程序访问Wi-Fi网络状态信息 |
ALL | <uses-permission android:name="android.permission.CHANGE_NETWORK_STATE"/> | 允许程序改变网络连接状态 |
ALL | <uses-permission android:name="android.permission.READ_PHONE_STATE"/> | 允许程序访问手机状态信息 |
Statistic
调用plus.statistic.*使用到的权限集
API | 权限 | 说明 |
---|---|---|
ALL | <uses-permission android:name="android.permission.READ_LOGS"/> | 允许程序读取系统日志文件 |
ALL | <uses-permission android:name="android.permission.RECEIVE_BOOT_COMPLETED"/> | 允许程序开机启动服务(实时提交统计数据服务) |
ALL | <uses-permission android:name="android.permission.RECEIVE_USER_PRESENT"/> | 允许程序唤醒机器 |
Native.JS
native.js封装的plus.android.* API不需要额外的权限,但导入对应对象调用native API时可能需要用到特定的权限,这时需根据情况在manifest.json中的plus->distribute->google->permissions下添加。
收起阅读 »HBuilder/HBuilder中less、sass、scss、stylus、typescript/ts等预编译语言的使用方法
一、HBuilderX
1. 语法提示
HBuilderX自带less、scss的完整语法提示和转到定义,无需安装语法提示插件,但不支持stylus的语法提示。
HBuilderX的ts语法提示,需要在菜单【工具】-【插件安装】中安装typescript语法提示插件。
2. 编译
- 在菜单工具-插件中安装less、sass、scss、stylus、typescript相关的插件,包括编译插件、格式化插件。
- 安装编译插件后,对less/scss/stylus/ts文件点右键-外部命令,展开的菜单里会有编译菜单。
- 除了编译菜单,插件下还有配置菜单(那个package.json文件),可设置快捷键、编译路径、是否保存时自动编译等。具体见http://ask.dcloud.net.cn/article/19599
- 如果你工程下有webpack等编译器,执行npm运行命令时会走工程下的编译器而不是HBuilderX的插件。
- uni-app项目由uni-app插件在保存时自动编译,无需手动配置。
3. 格式化
格式化less、scss、stylus、typescript等文件需要在插件安装里装prettier插件。然后正常按格式化快捷键ctrl+k即可。
二、老HBuilder
HBuilder支持less、sass。不支持stylus、typescript。
- less、scss代码提示:只能提示其中的css部分,less、sass仅支持对已编写的代码的单词提示
- 编译:
对less、sass文件右键点击编译,即可正常编译
HBuilder还支持预编译器配置,在菜单工具-预编译器配置里,可以自己选配less、sass甚至coffeescript等文件的预编译器,保存即可触发。
Less文件配置说明, 其他文件可参照操作: - npm全局安装less: npm install less -g
- hbuilder 菜单"工具"->"选项"->"预编译器", 修改.less 中的命令路径和命令参数, 也可以直接使用"智能完成".
- 如果"智能完成"失败, 请在"命令触发地址"中填写less全局安装后的命令文件lessc.cmd (windows) 或 less (mac)文件的路径. 命令参数请参照截图填写,也可自行修改保存路径
一、HBuilderX
1. 语法提示
HBuilderX自带less、scss的完整语法提示和转到定义,无需安装语法提示插件,但不支持stylus的语法提示。
HBuilderX的ts语法提示,需要在菜单【工具】-【插件安装】中安装typescript语法提示插件。
2. 编译
- 在菜单工具-插件中安装less、sass、scss、stylus、typescript相关的插件,包括编译插件、格式化插件。
- 安装编译插件后,对less/scss/stylus/ts文件点右键-外部命令,展开的菜单里会有编译菜单。
- 除了编译菜单,插件下还有配置菜单(那个package.json文件),可设置快捷键、编译路径、是否保存时自动编译等。具体见http://ask.dcloud.net.cn/article/19599
- 如果你工程下有webpack等编译器,执行npm运行命令时会走工程下的编译器而不是HBuilderX的插件。
- uni-app项目由uni-app插件在保存时自动编译,无需手动配置。
3. 格式化
格式化less、scss、stylus、typescript等文件需要在插件安装里装prettier插件。然后正常按格式化快捷键ctrl+k即可。
二、老HBuilder
HBuilder支持less、sass。不支持stylus、typescript。
- less、scss代码提示:只能提示其中的css部分,less、sass仅支持对已编写的代码的单词提示
- 编译:
对less、sass文件右键点击编译,即可正常编译
HBuilder还支持预编译器配置,在菜单工具-预编译器配置里,可以自己选配less、sass甚至coffeescript等文件的预编译器,保存即可触发。
Less文件配置说明, 其他文件可参照操作: - npm全局安装less: npm install less -g
- hbuilder 菜单"工具"->"选项"->"预编译器", 修改.less 中的命令路径和命令参数, 也可以直接使用"智能完成".
- 如果"智能完成"失败, 请在"命令触发地址"中填写less全局安装后的命令文件lessc.cmd (windows) 或 less (mac)文件的路径. 命令参数请参照截图填写,也可自行修改保存路径
HBuilder/HBuilderX真机运行、手机运行、真机联调常见问题
本帖已移动到:https://uniapp.dcloud.net.cn/tutorial/run/run-app-faq.html
.
特别说明
回帖,请详细描述:电脑操作系统、手机系统(anroid、ios)、手机系统版本号、或手机型号。
您只有描述清问题,别人才能更快帮到您。
.
联系方式
HBuilderX Mac电脑专用交流: 148229211
HBuilderX 官方QQ群:793046085
本帖已移动到:https://uniapp.dcloud.net.cn/tutorial/run/run-app-faq.html
.
特别说明
回帖,请详细描述:电脑操作系统、手机系统(anroid、ios)、手机系统版本号、或手机型号。
您只有描述清问题,别人才能更快帮到您。
.
联系方式
HBuilderX Mac电脑专用交流: 148229211
HBuilderX 官方QQ群:793046085
收起阅读 »常见问题
Q:怎么才能快速掌握HBuilder开发技巧?
A:软件自带HelloHBuilder项目,该项目为教程项目(如果不小心删除了不要担心,可以在新建WEB项目时,使用HelloHBuilder模板新建出来),按照项目中的lesson1.txt中的快捷键敲一遍即可快速掌握HBuilder快速开发技巧。
Q:什么是HTML5+?
A:HTML5+规范是基于HTML5的扩展规范,用于弥补HTML5和原生应用功能之间的差距。HTML5+规范是一个开放的规范,在W3C中国的指导下,由工信部下属的HTML5中国产业联盟(www.html5plus.org)运作,所有规范都是面向开发者的,开发者提需求、开发者评审实现方案、开发者投票选定规范。
Q:什么叫滚动条信息点?
A: 当代码中有重要的标记出现时,会生成滚动条信息点,在滚动条右侧出现颜色各异的点。点击这些点或使用跳转到下一个信息点功能,可以快速到达这些代码处。如下标记会生成信息点:书签、任务、错误提示。
Q:怎么实现代码追踪?
A: 在编辑代码时经常会出现需要跳转到引用文件或者变量定义的地方,HBuilder提供了一个非常好用的代码追踪功能,只需要按住Alt+鼠标左键即可实现追踪。
图示:
Q:输入small不提示,语法库是不是不全?
A: 代码块是否提示,取决于是否设置了这个代码块,代码块是可自定义的。
默认没有预置small代码块,你也可以在代码块弹出界面点右下角的编辑图标,进行代码块的补充修改。
另外可以使用emmet(ZenCoding)语法,这个没有提示,但敲完small,按tab,就会自动生成标签。
emmet是一种前端公开技术,网上教程很多。
Q:为什么有时候我输入代码块的名称,却没有出现想要的代码块?
A: 代码块的显示名称和激活字符是不同的,查看激活字符请在激活代码助手后选择代码块,看右边信息栏的详情
Q:编辑器怎么实现分栏?
A: HBuilder编辑器分栏功能可以实现左右分栏和上下分栏以及组合分栏。
1、左右分栏实现:鼠标点着编辑器选项卡往最右边拖动即可实现左右分栏
左右分栏实现效果:
2、上下分栏实现:鼠标点着编辑器选项卡往最下边拖动即可实现上下分栏
上下分栏实现效果:
3、组合分栏实现:组合分栏就是即有的文件向下拖动,有的文件向右拖动,下面给出一个效果图,感兴趣的话您可以拖个试试:)
Q:为什么我的代码明明是对的却报错?
A: HBuilder的语法验证器是集成的三方插件,有可能其本身对某些写法不兼容,当某种语法验证器把正确代码识别为错误时,你可以在工具-选项-HBuilder-Validation中关掉那个语法验证器。还可以设置正则表达式以兼容这种错误。
Q:有没有快速比较两个文件差异的办法?
A: 比较两个文档的方法是,在项目管理器按ctrl选两个文件,点右键,选比较对象
Q:不建项目单独打开文件会提示有部分功能无法使用,具体是哪些功能无法使用?
A: 主要是跨文件的项目管理功能受影响。
HBuilder会为项目建立索引,工程间文件的链接引用关系都在管理中。
这样在跨文件引用提示、转到定义、重构、移动图片路径等很多操作中HBuilder都能智能处理。
如果单独打开文件,功能就弱了很多,当然也比普通文本编辑器多。
举个例子,<a class="classA">,在HBuilder里写class=时,可以提示工程中各种css,classA如果是外部的css文件定义的, 可以按下Alt点鼠标跳转到那个css中。
这都是普通文本编辑器做不到的。
如果您习惯了资源管理器做项目管理、文本编辑器做代码编辑,那么建议改变下工作习惯。
用HBuilder做统一的项目管理和文本编辑,你会发现工作效率更高。
Q:我安装了SVN插件为什么我找不到SVN的功能?
A: 跟eclipse的svn插件用法是一样的。
在工具-插件安装中选择svn插件安装,安装完毕后,按提示重启HBuilder。
在菜单文件-导入里,选择从svn中检出项目,配置svn地址。
在项目管理器中点右键-版本管理,里面有svn的各种提交、更新等命令。
Q:怎么才能快速记住快捷键?
A: 记快捷键,不如记快捷键语法。
Alt是转到,Shift是转移,Ctrl是操作。
比如Alt+括号、引号,即使转到对于的符号。
Shift+回车是<br/>,shift+空格是 。
Ctrl+D是删除行,Ctrl+F2是重构命名。
Q:为什么不能手机预览?
A: WEB项目不可以手机预览页面。只有移动APP才可以。
确定项目是移动APP后,确保移动设备插好数据线并连接到电脑。
如果是iOS设备,请确保电脑安装有itunes,如果是Android,请确定手机驱动已经安装。
此时在HBuilder下方的状态栏也会提示手机已连接
然后点运行,选择对应的设备即可。
如果你只是想预览web项目,那么在菜单工具->高级选项->HBuilder->web服务器->内建服务器里,选择一个内网ip,比如192.xxx,然后手机通过wifi连入这台机器,即可预览。
Q:如何修改使用浏览器预览时,地址栏显示的IP
A: 依次点击工具-选项-HBuilder-Web服务器-内建服务器
可修改内建服务器的IP地址为127.0.0.1或本机网卡IP
内建服务器不可以运行PHP
需要重启HBuilder才生效
Q:如何方便在手机上浏览开发的网页?
A: 保证手机和pc在一个网段内,手机可连到pc的web服务器。HBuilder内置的web服务器地址配成192.168等内网地址,手机wifi连入,即可访问。
更改HBuilder内置的web服务器地址请点击菜单工具-选项,展开左边的HBuilder-web服务器-内建服务器,在右边更改地址,需要重启HBuilder才生效。
然后打开边改边看模式,点二维码,然后手机扫码即可。
Q:不能在收起代码的情况下复制粘贴收起的代码?
A: 复制折叠的代码,选择时需要多选择一个换行符。然后再复制。
Q:启动太慢?
A: HBuilder一般启动时6秒左右可以进入完整操作状态。
HBuilder还是属于IDE而不是文本编辑器,速度比文本编辑器慢是肯定的。
这两者最大的区别就是是否有AST语法树和WEB语法解析引擎,就是说HBuilder知道你写的是什么,按下点知道该出什么,写的对不对。
包括重构变量命名和转到定义,这些都是因为有语法树和解析引擎。
拥有最全的web语法库和最强的语法解析引擎,这个也是HBuilder的核心优势。
算是一种取舍吧,启动时慢几秒,但启动后写代码快的可不是差几秒了。
更新:请使用新一代HBuilderX,秒速启动。
Q:速度慢、内存占用高?
A: 速度我们一直在优化,请更新新版再试试。
HBuilder毕竟是IDE,功能比文本编辑器多非常多,执行的也自然会慢点。但机器性能若足够,也可以正常使用。
比如var a = document.getElementById("a1");。
在a后输入点的时候,HBuilder要扫描a到底是什么,超链接?canvas?输入框?然后才会给予用户最准确的提示。
这种计算都需要在按下键盘的很短时间内完成,想不卡还是很有挑战。
文本编辑器没有这些功能,所以不卡。
当然,在机器性能好时,HBuilder写代码要远爽于文本编辑器;但机器性能不好时...
影响性能的一些要素,可帮助你用的更快。
1、如果有固态硬盘,把HBuilder和工程代码都放到固态盘上;
2、同时打开的项目不要太多,把不用的项目点右键关闭,这样HBuilder就不扫描这些项目了,后台资源会释放不少
3、编辑大文档时慎用语法验证器,语法验证器较易引发卡顿,可以在工具-语法验证器设置里关闭。
4、编辑大文档时,最好关闭大纲的实时同步功能。大文档的大纲结构会很多,每次移动光标实时计算大纲的位置会有点慢。可以在需要定位时再点一下同步。大纲实时同步在大纲的右上角的下拉菜单里。
5、清理无用的js框架。Js框架文件都比较大且结构复杂,扫描框架比较费时。不用的框架就移出项目。另如果不在意框架的扫描提示,也可以把框架移除扫描清单,这样就不扫描这个文件了。对文件点右键-构建-移除构建目录。
6、windows search index和dropxbox等工具也会监控磁盘,当项目文件目录被他们监控时,磁盘IO会比较高。在新建项目时会明显卡。
7、有时HBuilder占用的内存释放不及时,可以使用360加速器等工具回收一些内存。
更新:请使用新一代HBuilderX,轻巧敏捷。
Q:升级失败或长时间无响应?
A: 如果装过其他eclipse插件,其升级服务器可能连不上而导致报错。
此时在工具-插件安装-手动安装eclipse插件-可用软件站点,取消其他插件的升级地址。
重新点击帮助-检查新版本即可。
Q:HBuilder必须联网使用吗?
A: 可以点离线使用。
但是没有网络时,有些依赖网络的功能不能使用,比如不能使用云服务创建、打包移动APP。
如果不方便联网,可以第一次使用手机做代理临时登录验证一下,以后就可以脱线使用了。
更新:请使用新一代HBuilderX,直接进软件,不需要点离线使用。
Q:你们会把这个工具做成 eclipse 的插件发布么?
A: 无法变成eclipse插件。
HBuilder里面有4种编程语言,除了java,还有c、HTML、ruby。单纯的java满足不了我们的需求。
另外HBuilder的核心定位就是做最好的HTML5编辑器,而非最好的所有编辑器。
倒是如果大家愿意的话,可以给HBuilder装其他语言的插件。
Q:PHP怎么运行?
A: HBuilder自带的web服务器是不能解析php的。
如果想解析php,需要自己安装php服务器,比如Apache。
安装好后,在HBuilder的工具-选项-web服务器中点新建外部web服务器,配置地址和参数,保存后重启HBuilder。
然后点运行即可。
Q:PHP怎么不高亮不提示?
A: PHP的语法提示需要安装PHP插件。
在工具-插件安装中,可以安装Aptana PHP插件。
如果确定安装了php插件,那么在工具-选项,搜索文件关联,在里面配置php文件和PHP Editor的关联。
也可以在项目管理器里对文件点右键,打开方式,里面选PHP Editor。
Q:PHP插件安装失败了?
A: 关闭PHP文件。
在帮助-关于我们-安装细节里,卸载PHP插件,重启。
然后在工具-插件安装里装php插件。再重启。
如仍有问题,请再联系我们。
Q:怎么才能快速掌握HBuilder开发技巧?
A:软件自带HelloHBuilder项目,该项目为教程项目(如果不小心删除了不要担心,可以在新建WEB项目时,使用HelloHBuilder模板新建出来),按照项目中的lesson1.txt中的快捷键敲一遍即可快速掌握HBuilder快速开发技巧。
Q:什么是HTML5+?
A:HTML5+规范是基于HTML5的扩展规范,用于弥补HTML5和原生应用功能之间的差距。HTML5+规范是一个开放的规范,在W3C中国的指导下,由工信部下属的HTML5中国产业联盟(www.html5plus.org)运作,所有规范都是面向开发者的,开发者提需求、开发者评审实现方案、开发者投票选定规范。
Q:什么叫滚动条信息点?
A: 当代码中有重要的标记出现时,会生成滚动条信息点,在滚动条右侧出现颜色各异的点。点击这些点或使用跳转到下一个信息点功能,可以快速到达这些代码处。如下标记会生成信息点:书签、任务、错误提示。
Q:怎么实现代码追踪?
A: 在编辑代码时经常会出现需要跳转到引用文件或者变量定义的地方,HBuilder提供了一个非常好用的代码追踪功能,只需要按住Alt+鼠标左键即可实现追踪。
图示:
Q:输入small不提示,语法库是不是不全?
A: 代码块是否提示,取决于是否设置了这个代码块,代码块是可自定义的。
默认没有预置small代码块,你也可以在代码块弹出界面点右下角的编辑图标,进行代码块的补充修改。
另外可以使用emmet(ZenCoding)语法,这个没有提示,但敲完small,按tab,就会自动生成标签。
emmet是一种前端公开技术,网上教程很多。
Q:为什么有时候我输入代码块的名称,却没有出现想要的代码块?
A: 代码块的显示名称和激活字符是不同的,查看激活字符请在激活代码助手后选择代码块,看右边信息栏的详情
Q:编辑器怎么实现分栏?
A: HBuilder编辑器分栏功能可以实现左右分栏和上下分栏以及组合分栏。
1、左右分栏实现:鼠标点着编辑器选项卡往最右边拖动即可实现左右分栏
左右分栏实现效果:
2、上下分栏实现:鼠标点着编辑器选项卡往最下边拖动即可实现上下分栏
上下分栏实现效果:
3、组合分栏实现:组合分栏就是即有的文件向下拖动,有的文件向右拖动,下面给出一个效果图,感兴趣的话您可以拖个试试:)
Q:为什么我的代码明明是对的却报错?
A: HBuilder的语法验证器是集成的三方插件,有可能其本身对某些写法不兼容,当某种语法验证器把正确代码识别为错误时,你可以在工具-选项-HBuilder-Validation中关掉那个语法验证器。还可以设置正则表达式以兼容这种错误。
Q:有没有快速比较两个文件差异的办法?
A: 比较两个文档的方法是,在项目管理器按ctrl选两个文件,点右键,选比较对象
Q:不建项目单独打开文件会提示有部分功能无法使用,具体是哪些功能无法使用?
A: 主要是跨文件的项目管理功能受影响。
HBuilder会为项目建立索引,工程间文件的链接引用关系都在管理中。
这样在跨文件引用提示、转到定义、重构、移动图片路径等很多操作中HBuilder都能智能处理。
如果单独打开文件,功能就弱了很多,当然也比普通文本编辑器多。
举个例子,<a class="classA">,在HBuilder里写class=时,可以提示工程中各种css,classA如果是外部的css文件定义的, 可以按下Alt点鼠标跳转到那个css中。
这都是普通文本编辑器做不到的。
如果您习惯了资源管理器做项目管理、文本编辑器做代码编辑,那么建议改变下工作习惯。
用HBuilder做统一的项目管理和文本编辑,你会发现工作效率更高。
Q:我安装了SVN插件为什么我找不到SVN的功能?
A: 跟eclipse的svn插件用法是一样的。
在工具-插件安装中选择svn插件安装,安装完毕后,按提示重启HBuilder。
在菜单文件-导入里,选择从svn中检出项目,配置svn地址。
在项目管理器中点右键-版本管理,里面有svn的各种提交、更新等命令。
Q:怎么才能快速记住快捷键?
A: 记快捷键,不如记快捷键语法。
Alt是转到,Shift是转移,Ctrl是操作。
比如Alt+括号、引号,即使转到对于的符号。
Shift+回车是<br/>,shift+空格是 。
Ctrl+D是删除行,Ctrl+F2是重构命名。
Q:为什么不能手机预览?
A: WEB项目不可以手机预览页面。只有移动APP才可以。
确定项目是移动APP后,确保移动设备插好数据线并连接到电脑。
如果是iOS设备,请确保电脑安装有itunes,如果是Android,请确定手机驱动已经安装。
此时在HBuilder下方的状态栏也会提示手机已连接
然后点运行,选择对应的设备即可。
如果你只是想预览web项目,那么在菜单工具->高级选项->HBuilder->web服务器->内建服务器里,选择一个内网ip,比如192.xxx,然后手机通过wifi连入这台机器,即可预览。
Q:如何修改使用浏览器预览时,地址栏显示的IP
A: 依次点击工具-选项-HBuilder-Web服务器-内建服务器
可修改内建服务器的IP地址为127.0.0.1或本机网卡IP
内建服务器不可以运行PHP
需要重启HBuilder才生效
Q:如何方便在手机上浏览开发的网页?
A: 保证手机和pc在一个网段内,手机可连到pc的web服务器。HBuilder内置的web服务器地址配成192.168等内网地址,手机wifi连入,即可访问。
更改HBuilder内置的web服务器地址请点击菜单工具-选项,展开左边的HBuilder-web服务器-内建服务器,在右边更改地址,需要重启HBuilder才生效。
然后打开边改边看模式,点二维码,然后手机扫码即可。
Q:不能在收起代码的情况下复制粘贴收起的代码?
A: 复制折叠的代码,选择时需要多选择一个换行符。然后再复制。
Q:启动太慢?
A: HBuilder一般启动时6秒左右可以进入完整操作状态。
HBuilder还是属于IDE而不是文本编辑器,速度比文本编辑器慢是肯定的。
这两者最大的区别就是是否有AST语法树和WEB语法解析引擎,就是说HBuilder知道你写的是什么,按下点知道该出什么,写的对不对。
包括重构变量命名和转到定义,这些都是因为有语法树和解析引擎。
拥有最全的web语法库和最强的语法解析引擎,这个也是HBuilder的核心优势。
算是一种取舍吧,启动时慢几秒,但启动后写代码快的可不是差几秒了。
更新:请使用新一代HBuilderX,秒速启动。
Q:速度慢、内存占用高?
A: 速度我们一直在优化,请更新新版再试试。
HBuilder毕竟是IDE,功能比文本编辑器多非常多,执行的也自然会慢点。但机器性能若足够,也可以正常使用。
比如var a = document.getElementById("a1");。
在a后输入点的时候,HBuilder要扫描a到底是什么,超链接?canvas?输入框?然后才会给予用户最准确的提示。
这种计算都需要在按下键盘的很短时间内完成,想不卡还是很有挑战。
文本编辑器没有这些功能,所以不卡。
当然,在机器性能好时,HBuilder写代码要远爽于文本编辑器;但机器性能不好时...
影响性能的一些要素,可帮助你用的更快。
1、如果有固态硬盘,把HBuilder和工程代码都放到固态盘上;
2、同时打开的项目不要太多,把不用的项目点右键关闭,这样HBuilder就不扫描这些项目了,后台资源会释放不少
3、编辑大文档时慎用语法验证器,语法验证器较易引发卡顿,可以在工具-语法验证器设置里关闭。
4、编辑大文档时,最好关闭大纲的实时同步功能。大文档的大纲结构会很多,每次移动光标实时计算大纲的位置会有点慢。可以在需要定位时再点一下同步。大纲实时同步在大纲的右上角的下拉菜单里。
5、清理无用的js框架。Js框架文件都比较大且结构复杂,扫描框架比较费时。不用的框架就移出项目。另如果不在意框架的扫描提示,也可以把框架移除扫描清单,这样就不扫描这个文件了。对文件点右键-构建-移除构建目录。
6、windows search index和dropxbox等工具也会监控磁盘,当项目文件目录被他们监控时,磁盘IO会比较高。在新建项目时会明显卡。
7、有时HBuilder占用的内存释放不及时,可以使用360加速器等工具回收一些内存。
更新:请使用新一代HBuilderX,轻巧敏捷。
Q:升级失败或长时间无响应?
A: 如果装过其他eclipse插件,其升级服务器可能连不上而导致报错。
此时在工具-插件安装-手动安装eclipse插件-可用软件站点,取消其他插件的升级地址。
重新点击帮助-检查新版本即可。
Q:HBuilder必须联网使用吗?
A: 可以点离线使用。
但是没有网络时,有些依赖网络的功能不能使用,比如不能使用云服务创建、打包移动APP。
如果不方便联网,可以第一次使用手机做代理临时登录验证一下,以后就可以脱线使用了。
更新:请使用新一代HBuilderX,直接进软件,不需要点离线使用。
Q:你们会把这个工具做成 eclipse 的插件发布么?
A: 无法变成eclipse插件。
HBuilder里面有4种编程语言,除了java,还有c、HTML、ruby。单纯的java满足不了我们的需求。
另外HBuilder的核心定位就是做最好的HTML5编辑器,而非最好的所有编辑器。
倒是如果大家愿意的话,可以给HBuilder装其他语言的插件。
Q:PHP怎么运行?
A: HBuilder自带的web服务器是不能解析php的。
如果想解析php,需要自己安装php服务器,比如Apache。
安装好后,在HBuilder的工具-选项-web服务器中点新建外部web服务器,配置地址和参数,保存后重启HBuilder。
然后点运行即可。
Q:PHP怎么不高亮不提示?
A: PHP的语法提示需要安装PHP插件。
在工具-插件安装中,可以安装Aptana PHP插件。
如果确定安装了php插件,那么在工具-选项,搜索文件关联,在里面配置php文件和PHP Editor的关联。
也可以在项目管理器里对文件点右键,打开方式,里面选PHP Editor。
Q:PHP插件安装失败了?
A: 关闭PHP文件。
在帮助-关于我们-安装细节里,卸载PHP插件,重启。
然后在工具-插件安装里装php插件。再重启。
如仍有问题,请再联系我们。
HBuilder入门-设计理念及常用功能
获取HBuilder
HBuilder新一代产品是HBuilderX,获取上一代产品的方式如下:
在http://dcloud.io/hbuilderx.html,点击右上角download,在弹出界面的底部点击“上一代HBuilder下载”。
设计理念
HBuilder,即Html Builder的缩写,Builder是建造者的意思。
HBuilder是一个极客工具,追求无鼠标的极速操作。
不管是敲代码的快捷设定,还是操作功能的快捷设定,都融入了效率第一的设计思想。
程序员究竟是coder,还是builder,我们坚持后者。
不为敲字母而花费时间,不为大小写拼错而调错半天,把精力花在思考上,想清楚后落笔如飞。
支撑这个理念,除了体验上的精细设计,还要求我们突破很多世界级技术难题,包括语法库、语法结构模型、AST语法分析引擎。
另一个需要强调的理念是H。
HBuilder顾名思义是为HTML设计的。
相对于java、.net、object-c这些主流编程语言,HTML开发者以往总感觉低人一等。
但时代在变,前端代码越来越复杂,前端工程师的身价也持续攀高,我们认为HTML5需要一款配得上它的地位的高级IDE,而不再是刀耕火种时代的文本编辑器。
所以HBuilder主要用于开发html、js、css,同时配合HTML的后端脚本语言如php、jsp也可以适用,还有前端的预编译语言如less以及我们钟爱的markdown都可以良好的编辑。
从2013年夏天发布至今,HBuilder已经成为业内主流的开发工具,拥有几百万开发者。
欢迎你使用HBuilder,成为HBuilder。
以下为常用功能简介。
代码助手,飞一样的编码
代码输入法:一个数字,少敲10下键盘。
按下候选列表前的数字,自动把该候选项输入到编辑区,你将不用把所有字都敲一遍了。当然除了数字选择,跳字输入也是支持的。
代码块:一个代码块,少敲20下键盘。
图标为的候选项为代码块。
代码块是常用的代码组合,比如在js中输入$,回车,则可以自动输入document.getElementById(id)。
再举例,在HTML中输入i,回车,可以得到input button标签。
查看、编辑代码块可以在工具-自定义代码块中,选择相应的代码块进行查看和编辑。也可以在激活代码块的代码助手中,点击详细信息右下角的修改图标进行修改和查看。
代码块激活字符原则1:连续单词的首字母。比如:dg激活document.getElementById("");vari激活var i=0;dn激活display: none;
代码块激活字符原则2:整段HTML一般使用tag的名称。比如script、style,通常,敲最多4个字母即可匹配到需要的代码块,不需要完整录入,如sc回车、st回车,即可完成script、style标签的输入。
代码块激活字符原则3:同一个tag,有多个代码块输出,则在最后加后缀。比如meta输出<meta name="" content=""/>但metau则输出<meta charset="UTF-8"/>,metag同理。
代码块激活字符原则4:如果原始语法超过4个字符,针对常用语法,则第一个单词的激活符使用缩写。比如input button,缩写为inbutton,同理intext是输入框。
代码块激活字符原则5:js的关键字代码块,是在关键字最后加一个重复字母。比如if直接敲会提示if关键字,但iff回车,则出现if代码块。类似的有forr、withh等。由于funtion字母较长,为加快输入速度,取fun缩写,比如funn,输出function代码块,而funa和func,分别输出匿名函数和闭包。
全时提示
HBuilder不仅仅提示全面的语法,非语法的各种候选输入也都能提示。包括图片、链接、颜色、字体、脚本、样式、URI、ID、class、自定义JS对象、方法。
举例,在img src=后激活代码助手,可以看到本工程所有图片列表;输入<sc可以看到本工程所有js列表;在js的document.getElementById(id)中提示本工程已经定义的ID列表;在css的color:后可以列出本工程所有使用过的颜色。
Emmet支持
HBuilder内嵌了emmet(即zencoding)插件。输入div#id1,按下tab,可以自动生成 <div id="id1"></div>。Emmet的详细语法请查阅其官方网站emmet.io。
框架语法支持
HBuilder内嵌了jquery、bootstrap、angular、mui等常用框架的语法提示库,并且这些框架语法一样可以享受到HBuilder的全时提示机制,提示图片、颜色、id、class...
如果要使用框架语法,需要在工具菜单/项目的右键菜单中,点击引入框架语法提示的子项,为该项目选择框架语法提示。提示效果如下:
JSDoc+
HBuilder扩展了jsdoc,并改良用途用于酷酷的语法提示,让动态的js有了静态的感觉。具体参考:http://ask.dcloud.net.cn/article/129
边看边改
想一边写代码,一边看效果?按下Ctrl P进入边看边改视图。左边保存右边立即刷新。
调试的玩法还有很多,参考http://ask.dcloud.net.cn/article/483
绿柔保护你的眼睛
绿柔主题的特点是柔和、低对比度、强光可见、绿色感加强。对着这样的界面写一天代码,感受要比对着太亮或太暗的界面舒服很多。
绿柔是一个严谨的设计过程,包含色彩心理学和色彩生理学的很多知识,而且在北京国奥心理医院做过严谨的医学测试,形成大量脑电波数据。
我们安排工程师在不同的配色主题下写代码,检测他们的脑疲劳程度,最终调校出了这套配色方案。
实验过程在官网下方也有介绍http://dcloud.io/
这是HBuilder发布会时设计师的演讲实录,表达了我们的设计理念:
最近有部电影叫盲探,其中刘德华盯了4天嫌疑犯眼睛就瞎了,眼睛很重要但也很脆弱。
我们现在的生活中到处是电子屏,电脑屏、手机屏、平板、电视,无论上班下班,我们都对着这些屏幕。这个时代保护眼睛更重要。一定不能程序员让在写代码时受更多罪。所以我们很重视配色方案。
我们调研了所有主流配色方案。没有满意的。有的很漂亮,但长时间看不舒服。所以我们决定自己调,但我们的设计目的不是为了好看,而是为了更健康。
色彩方面有色彩生理学和色彩心理学。我们先来看色彩生理学,当一个人眼睛长期看暗色系事物时,大脑会分泌激素强迫眼睛增强视力,比如我们在一个黑屋子待一会就能看清东西,但回到阳光下时又会晕眩,这叫做暗适应。暗适应会让程序员很不舒服,所以我们不能选暗色系。
再看色彩心理学,不同的色彩给人以不同的心理感受。红色让人感到刺激,绿色让人感到舒适,因为人们会联想到不同的事物从而引发心理的变化。
基于这些分析,调了上百次后,我们得出这样的方案,我们叫它绿柔。它的特点是柔和,自然,低对比度,并且强化了绿色的感觉。我们把各种颜色中的RGB中G,就是绿的数值调的更高。
我们做了样本测试,结果不错,程序员们在使用了一天绿柔界面后都表示比看一天其他软件更舒服。
最后衷心祝愿大家在满是电子屏的世界中,活的更健康!_
最全语法库和浏览器兼容数据
HBuilder的语法库包括W3C的HTML、JAVASCRIPT、CSS的正式标准和推荐标准...,ECMAScript中浏览器支持的部分,还有各大浏览器的扩展语法,webkit、moz、ms,均实时更新到各浏览器的最新版本。
信息栏中的浏览器品牌图标,全亮表示无障碍支持该语法,全灰表示不支持,而半亮则表示该浏览器部分支持该语法。半亮时会下图标下方显示出来详细的支持情况,比如video标签,从IE9才开始支持。
手机App开发
HTML5一大用途就是App开发。HBuilder良好的支持手机App开发。
包括新建移动App项目、run in device真机调试、本地及云端打包。
HBuilder开发的HTML5+ App,比普通的web App功能更强、性能更高,具体参考文档 5+ App章节。
更多挖宝
-
跳转助手、选择助手、转义助手、快捷键助手,让你手不离键盘。
-
更多精彩功能:语法校验 | 转到定义 | 重构 | 大纲 | 任务TODO | 版本历史 | 内置webserver | 预编译less、sass等文件
-
还不满足?下载插件增强更多功能,高手更可开发插件,并共享插件造福所有开发者。
获取HBuilder
HBuilder新一代产品是HBuilderX,获取上一代产品的方式如下:
在http://dcloud.io/hbuilderx.html,点击右上角download,在弹出界面的底部点击“上一代HBuilder下载”。
设计理念
HBuilder,即Html Builder的缩写,Builder是建造者的意思。
HBuilder是一个极客工具,追求无鼠标的极速操作。
不管是敲代码的快捷设定,还是操作功能的快捷设定,都融入了效率第一的设计思想。
程序员究竟是coder,还是builder,我们坚持后者。
不为敲字母而花费时间,不为大小写拼错而调错半天,把精力花在思考上,想清楚后落笔如飞。
支撑这个理念,除了体验上的精细设计,还要求我们突破很多世界级技术难题,包括语法库、语法结构模型、AST语法分析引擎。
另一个需要强调的理念是H。
HBuilder顾名思义是为HTML设计的。
相对于java、.net、object-c这些主流编程语言,HTML开发者以往总感觉低人一等。
但时代在变,前端代码越来越复杂,前端工程师的身价也持续攀高,我们认为HTML5需要一款配得上它的地位的高级IDE,而不再是刀耕火种时代的文本编辑器。
所以HBuilder主要用于开发html、js、css,同时配合HTML的后端脚本语言如php、jsp也可以适用,还有前端的预编译语言如less以及我们钟爱的markdown都可以良好的编辑。
从2013年夏天发布至今,HBuilder已经成为业内主流的开发工具,拥有几百万开发者。
欢迎你使用HBuilder,成为HBuilder。
以下为常用功能简介。
代码助手,飞一样的编码
代码输入法:一个数字,少敲10下键盘。
按下候选列表前的数字,自动把该候选项输入到编辑区,你将不用把所有字都敲一遍了。当然除了数字选择,跳字输入也是支持的。
代码块:一个代码块,少敲20下键盘。
图标为的候选项为代码块。
代码块是常用的代码组合,比如在js中输入$,回车,则可以自动输入document.getElementById(id)。
再举例,在HTML中输入i,回车,可以得到input button标签。
查看、编辑代码块可以在工具-自定义代码块中,选择相应的代码块进行查看和编辑。也可以在激活代码块的代码助手中,点击详细信息右下角的修改图标进行修改和查看。
代码块激活字符原则1:连续单词的首字母。比如:dg激活document.getElementById("");vari激活var i=0;dn激活display: none;
代码块激活字符原则2:整段HTML一般使用tag的名称。比如script、style,通常,敲最多4个字母即可匹配到需要的代码块,不需要完整录入,如sc回车、st回车,即可完成script、style标签的输入。
代码块激活字符原则3:同一个tag,有多个代码块输出,则在最后加后缀。比如meta输出<meta name="" content=""/>但metau则输出<meta charset="UTF-8"/>,metag同理。
代码块激活字符原则4:如果原始语法超过4个字符,针对常用语法,则第一个单词的激活符使用缩写。比如input button,缩写为inbutton,同理intext是输入框。
代码块激活字符原则5:js的关键字代码块,是在关键字最后加一个重复字母。比如if直接敲会提示if关键字,但iff回车,则出现if代码块。类似的有forr、withh等。由于funtion字母较长,为加快输入速度,取fun缩写,比如funn,输出function代码块,而funa和func,分别输出匿名函数和闭包。
全时提示
HBuilder不仅仅提示全面的语法,非语法的各种候选输入也都能提示。包括图片、链接、颜色、字体、脚本、样式、URI、ID、class、自定义JS对象、方法。
举例,在img src=后激活代码助手,可以看到本工程所有图片列表;输入<sc可以看到本工程所有js列表;在js的document.getElementById(id)中提示本工程已经定义的ID列表;在css的color:后可以列出本工程所有使用过的颜色。
Emmet支持
HBuilder内嵌了emmet(即zencoding)插件。输入div#id1,按下tab,可以自动生成 <div id="id1"></div>。Emmet的详细语法请查阅其官方网站emmet.io。
框架语法支持
HBuilder内嵌了jquery、bootstrap、angular、mui等常用框架的语法提示库,并且这些框架语法一样可以享受到HBuilder的全时提示机制,提示图片、颜色、id、class...
如果要使用框架语法,需要在工具菜单/项目的右键菜单中,点击引入框架语法提示的子项,为该项目选择框架语法提示。提示效果如下:
JSDoc+
HBuilder扩展了jsdoc,并改良用途用于酷酷的语法提示,让动态的js有了静态的感觉。具体参考:http://ask.dcloud.net.cn/article/129
边看边改
想一边写代码,一边看效果?按下Ctrl P进入边看边改视图。左边保存右边立即刷新。
调试的玩法还有很多,参考http://ask.dcloud.net.cn/article/483
绿柔保护你的眼睛
绿柔主题的特点是柔和、低对比度、强光可见、绿色感加强。对着这样的界面写一天代码,感受要比对着太亮或太暗的界面舒服很多。
绿柔是一个严谨的设计过程,包含色彩心理学和色彩生理学的很多知识,而且在北京国奥心理医院做过严谨的医学测试,形成大量脑电波数据。
我们安排工程师在不同的配色主题下写代码,检测他们的脑疲劳程度,最终调校出了这套配色方案。
实验过程在官网下方也有介绍http://dcloud.io/
这是HBuilder发布会时设计师的演讲实录,表达了我们的设计理念:
最近有部电影叫盲探,其中刘德华盯了4天嫌疑犯眼睛就瞎了,眼睛很重要但也很脆弱。
我们现在的生活中到处是电子屏,电脑屏、手机屏、平板、电视,无论上班下班,我们都对着这些屏幕。这个时代保护眼睛更重要。一定不能程序员让在写代码时受更多罪。所以我们很重视配色方案。
我们调研了所有主流配色方案。没有满意的。有的很漂亮,但长时间看不舒服。所以我们决定自己调,但我们的设计目的不是为了好看,而是为了更健康。
色彩方面有色彩生理学和色彩心理学。我们先来看色彩生理学,当一个人眼睛长期看暗色系事物时,大脑会分泌激素强迫眼睛增强视力,比如我们在一个黑屋子待一会就能看清东西,但回到阳光下时又会晕眩,这叫做暗适应。暗适应会让程序员很不舒服,所以我们不能选暗色系。
再看色彩心理学,不同的色彩给人以不同的心理感受。红色让人感到刺激,绿色让人感到舒适,因为人们会联想到不同的事物从而引发心理的变化。
基于这些分析,调了上百次后,我们得出这样的方案,我们叫它绿柔。它的特点是柔和,自然,低对比度,并且强化了绿色的感觉。我们把各种颜色中的RGB中G,就是绿的数值调的更高。
我们做了样本测试,结果不错,程序员们在使用了一天绿柔界面后都表示比看一天其他软件更舒服。
最后衷心祝愿大家在满是电子屏的世界中,活的更健康!_
最全语法库和浏览器兼容数据
HBuilder的语法库包括W3C的HTML、JAVASCRIPT、CSS的正式标准和推荐标准...,ECMAScript中浏览器支持的部分,还有各大浏览器的扩展语法,webkit、moz、ms,均实时更新到各浏览器的最新版本。
信息栏中的浏览器品牌图标,全亮表示无障碍支持该语法,全灰表示不支持,而半亮则表示该浏览器部分支持该语法。半亮时会下图标下方显示出来详细的支持情况,比如video标签,从IE9才开始支持。
手机App开发
HTML5一大用途就是App开发。HBuilder良好的支持手机App开发。
包括新建移动App项目、run in device真机调试、本地及云端打包。
HBuilder开发的HTML5+ App,比普通的web App功能更强、性能更高,具体参考文档 5+ App章节。
更多挖宝
-
跳转助手、选择助手、转义助手、快捷键助手,让你手不离键盘。
-
更多精彩功能:语法校验 | 转到定义 | 重构 | 大纲 | 任务TODO | 版本历史 | 内置webserver | 预编译less、sass等文件
-
还不满足?下载插件增强更多功能,高手更可开发插件,并共享插件造福所有开发者。
manifest.json文档说明
此文档不再维护,请参考新文档地址:https://uniapp.dcloud.io/tutorial/app-manifest
概述
manifest.json文件是5+移动App的配置文件,用于指定应用的显示名称、图标、入口页面等信息。用户可通过HBuilder|HBuilderX的可视化界面视图进行配置,也可在源码视图中根据以下规范直接修改。
manifest.json文件根据w3c的webapp规范制定,plus节点下内容为HTML5 Plus扩展规范,其下包括iOS和Android子节点,内容来源分别为iOS和Android原生打包所要求的参数,用于对5+移动App打包为ipa或apk安装包进行配置。
uni-app项目的manifest.json规范参考:https://uniapp.dcloud.io/collocation/manifest
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标签非全屏播放 (仅iOS生效)
"mediaPlaybackRequiresUserAction":"true|false", //可选,可通过此属性配置h5中的音频是否自动播放,注意当设置为false时开启自动播放,默认为true(仅iOS生效 HX3.0.1 + 版本支持)
"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白名单列表https://ask.dcloud.net.cn/article/94
],
"splashscreen": { //可选,splash界面配置
},
"ssl": { //可选,SSL配置
},
"softinput": { //可选,软键盘配置
},
"statusbar": { //可选,系统状态栏配置
},
"useragent": { //可选,UA配置
},
"launchwebview": { //可选,应用首页配置
},
"secondwebview": { //可选,应用双首页配置
},
"uni-app": { //可选,uni-app应用的配置
},
"compatible": { //可选,编译器兼容性配置
},
"wap2app": { //可选,wap2app相关配置
},
}
}
id
应用标识(AppID),在可视化“基础配置”项中。
更多信息参考DCloud 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
开发者网站地址
<a id="screenOrientation" />
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(视频播放)控件功能无关
mediaPlaybackRequiresUserAction (HX3.0.1 + 版本支持)
可通过此属性配置h5中的音频是否自动播放,注意当设置为false时开启自动播放,默认为true(仅iOS生效)
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的可视化界面中操作
使用云端uni原生插件参考:https://ask.dcloud.net.cn/article/35412
使用本地uni原生插件参考:https://ask.dcloud.net.cn/article/35844
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属性单独设置某个窗口的恢复处理逻辑
<a id="runmode" />
runmode
应用的运行模式,字符串类型
"plus": { //uni-app项目对应节点名称为"app-plus"
"runmode": "liberate"
// ...
}
可取值:
- "normal"
正常运行(不释放资源)模式,直接使用应用的资源,无法直接使用File API(plus.io.*)访问应用资源。 - "liberate"
释放资源运行模式,应用在第一次启动时将解压应用私有目录。该模式的缺点:第一次启动更慢,耗费时间先解压。该模式有用的场景:此模式下File API才可正常访问_www应用资源,以及在某些Android rom访问本地页面时url地址中包含?带参数,但不推荐使用这种跨页传参方式,推荐使用其他方式跨页传参http://ask.dcloud.net.cn/article/288。
注意:wap2app 应用固定为 liberate,不支持自定义。
safearea
iOS刘海屏设备(iPhoneX)的安全区域配置
"plus": { //uni-app项目对应节点名称为"app-plus"
"safearea": {
"background":"#CCCCCC",
"backgroundDark":"#2f0508",
"bottom":{
"offset":"auto"
},
"left": {
"offset":"auto"
},
"right: {
"offset":"auto"
}
},
// ...
}
background
安全区域外的背景颜色,默认值为"#FFFFFF"
backgroundDark HX 3.1.18+ 支持
暗黑模式下安全区域外的背景颜色,默认值"无", 更多关于暗黑模式的适配请参考 iOS适配暗黑模式
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。
<a id="splashscreen" />
splashscreen
程序启动界面配置信息,JSON格式对象
"plus": { //uni-app项目对应节点名称为"app-plus"
"splashscreen": {
"autoclose": "false",
"event": "loaded",
"target": "default",
"waiting": "true",
"delay": "500",
"ads": {
"background": "#FFFFFF",
"image": "logo.png"
},
"androidTranslucent": false
},
// ...
}
包括以下字段:
- 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格式,背景透明,留出边距,在不同分辨率手机上会自动等比例缩放处理) - androidTranslucent
使用“自定义启动图”启动界面时是否显示透明过渡界面,设置为true首次点击桌面图标后可能需要等待0.5秒左右(低端手机可能时间会更长)进入启动界面,设置为false则会在点击桌面图标后立即进入启动界面(在部分设备顶部系统状态栏可能会半透明显示)。
注意:仅在“自定义启动图”时生效,默认值为false。
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(HBuilderX3.1.3+版本调整默认值为false)。 - 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及以上)。
默认值为"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": { //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运行环境与编译环境不一致时,会弹出可能存在兼容性问题的提示框。
详细描述参考:https://ask.dcloud.net.cn/article/35627
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", //是否使用广告标识符,默认值为true
"capabilities": { //应用的能力配置(Capabilities)
},
"CFBundleName": "HBuilder",
"validArchitectures":[ //支持的cpu指令
"arm64"
]
},
"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平台目标版本
"forceDarkAllowed":"true", //是否允许强制支持暗黑模式,默认值为false, HBuilderX3.1.4+支持
"resizeableActivity":"false", //是否支持分屏时调整activity大小,默认不设置此值,HBuilderX3.1.10+支持
"packagingOptions": [ //配置gradle编译参数packagingOptions
"doNotStrip '*/armeabi-v7a/*.so'"
]
},
"icons":{ //应用图标配置
},
"splashscreen":{ //应用启动图片配置
},
"plugins":{ // 第三方sdk配置
}
}
}
apple
iOS平台打包配置,uni-app项目对应为"app-plus" -> "distribute" -> "ios"节点
其中appid、mobileprovision、password、p12、devices为iOS打包基础配置,点击HBuilderX菜单的"发行" -> "原生App-云打包"打开的“App云端打包”中配置:
urlschemewhitelist
设置应用访问白名单,更多详情参考https://ask.dcloud.net.cn
UIBackgroundModes
应用后台运行模式配置,如后台播放音乐、后台定位等
后台音乐播放
后台获取位置信息
更多后台能力参考苹果官方文档
urltypes
iOS平台URL Schemes配置,更多详情参考https://ask.dcloud.net.cn/article/64
<a id="frameworks"/>
frameworks
设置应用要引用的系统库(framework),字符串数组。
在使用native.js时使用,通知App云端打包在编译应用时引用对于的系统framework库,以便native.js能成功调用其中的API。
如要调用苹果游戏相关API,则需要引用"GameKit.framework"。
"frameworks": [ //iOS平台依赖的系统库
"GameKit.framework"
],
<a id="deploymentTarget"></a>
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(广告标识),更多详情参考https://ask.dcloud.net.cn/article/36107
capabilities
iOS平台打包时Capabilities配置,json类型数据,配置应用的capabilities数据(根据XCode规范分别配置到entitlements和plist文件中)
"capabilities": {
"entitlements": { // 合并到工程entitlements文件的数据(json格式)
},
"plists": { // 合并到工程Info.plist文件的数据(json格式)
}
},
更多详情参考https://ask.dcloud.net.cn/article/36393
CFBundleName
iOS平台云打包后生成应用的 bundle name 值。
默认值为"HBuilder",建议设置为英文,不要使用中文。
示例如下:
"CFBundleName": "HelloWorld",
validArchitectures
iOS平台编译时支持的CPU指令。
默认值为['arm64', 'arm64e', 'armv7', 'armv7s', 'x86_64'],如果使用了三方插件则会取插件配置validArchitectures的交集。
Android平台打包配置,uni-app项目对应为"app-plus" -> "distribute" -> "android"节点
其中packagename、keystore、password、aliasname为Android打包基础配置,点击HBuilderX菜单的"发行" -> "原生App-云打包"打开的“App云端打包”中设置:
schemes
Android平台URL Schemes配置,更多详情参考https://ask.dcloud.net.cn/article/409
theme
Android平台应用要使用的系统主题名称
更多详情参考Android配置应用主题皮肤
abiFilters
Android平台配置支持的CPU类型,更多详情参考https://ask.dcloud.net.cn/article/36195
permissions
Android平台使用到的权限,请在HBuilderX的manifest.json可视化界面“(App)模块权限配置”中的“Android打包权限配置”中勾选。
<a id="permissionExternalStorage"/>
permissionExternalStorage
HBuilderX2.5.0+版本支持
Android平台应用启动时申请读写手机存储权限配置
支持以下字段
- prompt
当用户拒绝授权读写手机存储权限时弹出提示框上显示的内容。
更多详情参考https://ask.dcloud.net.cn/article/36549
<a id="permissionPhoneState"/>
permissionPhoneState
HBuilderX2.3.8+版本支持
Android平台应用启动时申请读取设备信息权限配置
支持以下字段
- request
申请权限策略,可配置以下值:
"always" - 一直申请读取设备信息权限,用户必须授权允许,否则一直弹出提示框,直到用户允许;
"once" - 申请一次读取设备信息权限,不管用户是否允许
"none" - 不申请读取设备信息权限 - prompt
配置request值为"always"时有效,当用户拒绝授权读取设备信息权限时弹出提示框上显示的内容。
更多详情参考https://ask.dcloud.net.cn/article/36549
minSdkVersion & targetSdkVersion
minSdkVersion为应用兼容的最低Android版本(API等级)
targetSdkVersion为应用适配的Android版本(API等级)
更多详情参考https://ask.dcloud.net.cn/article/193
<a id="packagingOptions"/>
packagingOptions
配置应用的gradle配置项packagingOptions,参数值为字符串数组,每一项会单独配置到gradle文件的packagingOptions下,如下示例:
"packagingOptions": [
"doNotStrip '*/armeabi-v7a/*.so'",
"merge '**/LICENSE.txt'"
]
注意,默认已包含以下配置:
pickFirst 'lib/*/libstlport_shared.so'
pickFirst 'lib/*/libc++_shared.so'
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)图标配置”中操作设置
图片配置注意事项参考https://ask.dcloud.net.cn/article/35979
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配置”中操作设置
此文档不再维护,请参考新文档地址:https://uniapp.dcloud.io/tutorial/app-manifest
概述
manifest.json文件是5+移动App的配置文件,用于指定应用的显示名称、图标、入口页面等信息。用户可通过HBuilder|HBuilderX的可视化界面视图进行配置,也可在源码视图中根据以下规范直接修改。
manifest.json文件根据w3c的webapp规范制定,plus节点下内容为HTML5 Plus扩展规范,其下包括iOS和Android子节点,内容来源分别为iOS和Android原生打包所要求的参数,用于对5+移动App打包为ipa或apk安装包进行配置。
uni-app项目的manifest.json规范参考:https://uniapp.dcloud.io/collocation/manifest
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标签非全屏播放 (仅iOS生效)
"mediaPlaybackRequiresUserAction":"true|false", //可选,可通过此属性配置h5中的音频是否自动播放,注意当设置为false时开启自动播放,默认为true(仅iOS生效 HX3.0.1 + 版本支持)
"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白名单列表https://ask.dcloud.net.cn/article/94
],
"splashscreen": { //可选,splash界面配置
},
"ssl": { //可选,SSL配置
},
"softinput": { //可选,软键盘配置
},
"statusbar": { //可选,系统状态栏配置
},
"useragent": { //可选,UA配置
},
"launchwebview": { //可选,应用首页配置
},
"secondwebview": { //可选,应用双首页配置
},
"uni-app": { //可选,uni-app应用的配置
},
"compatible": { //可选,编译器兼容性配置
},
"wap2app": { //可选,wap2app相关配置
},
}
}
id
应用标识(AppID),在可视化“基础配置”项中。
更多信息参考DCloud 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
开发者网站地址
<a id="screenOrientation" />
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(视频播放)控件功能无关
mediaPlaybackRequiresUserAction (HX3.0.1 + 版本支持)
可通过此属性配置h5中的音频是否自动播放,注意当设置为false时开启自动播放,默认为true(仅iOS生效)
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的可视化界面中操作
使用云端uni原生插件参考:https://ask.dcloud.net.cn/article/35412
使用本地uni原生插件参考:https://ask.dcloud.net.cn/article/35844
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属性单独设置某个窗口的恢复处理逻辑
<a id="runmode" />
runmode
应用的运行模式,字符串类型
"plus": { //uni-app项目对应节点名称为"app-plus"
"runmode": "liberate"
// ...
}
可取值:
- "normal"
正常运行(不释放资源)模式,直接使用应用的资源,无法直接使用File API(plus.io.*)访问应用资源。 - "liberate"
释放资源运行模式,应用在第一次启动时将解压应用私有目录。该模式的缺点:第一次启动更慢,耗费时间先解压。该模式有用的场景:此模式下File API才可正常访问_www应用资源,以及在某些Android rom访问本地页面时url地址中包含?带参数,但不推荐使用这种跨页传参方式,推荐使用其他方式跨页传参http://ask.dcloud.net.cn/article/288。
注意:wap2app 应用固定为 liberate,不支持自定义。
safearea
iOS刘海屏设备(iPhoneX)的安全区域配置
"plus": { //uni-app项目对应节点名称为"app-plus"
"safearea": {
"background":"#CCCCCC",
"backgroundDark":"#2f0508",
"bottom":{
"offset":"auto"
},
"left": {
"offset":"auto"
},
"right: {
"offset":"auto"
}
},
// ...
}
background
安全区域外的背景颜色,默认值为"#FFFFFF"
backgroundDark HX 3.1.18+ 支持
暗黑模式下安全区域外的背景颜色,默认值"无", 更多关于暗黑模式的适配请参考 iOS适配暗黑模式
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。
<a id="splashscreen" />
splashscreen
程序启动界面配置信息,JSON格式对象
"plus": { //uni-app项目对应节点名称为"app-plus"
"splashscreen": {
"autoclose": "false",
"event": "loaded",
"target": "default",
"waiting": "true",
"delay": "500",
"ads": {
"background": "#FFFFFF",
"image": "logo.png"
},
"androidTranslucent": false
},
// ...
}
包括以下字段:
- 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格式,背景透明,留出边距,在不同分辨率手机上会自动等比例缩放处理) - androidTranslucent
使用“自定义启动图”启动界面时是否显示透明过渡界面,设置为true首次点击桌面图标后可能需要等待0.5秒左右(低端手机可能时间会更长)进入启动界面,设置为false则会在点击桌面图标后立即进入启动界面(在部分设备顶部系统状态栏可能会半透明显示)。
注意:仅在“自定义启动图”时生效,默认值为false。
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(HBuilderX3.1.3+版本调整默认值为false)。 - 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及以上)。
默认值为"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": { //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运行环境与编译环境不一致时,会弹出可能存在兼容性问题的提示框。
详细描述参考:https://ask.dcloud.net.cn/article/35627
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", //是否使用广告标识符,默认值为true
"capabilities": { //应用的能力配置(Capabilities)
},
"CFBundleName": "HBuilder",
"validArchitectures":[ //支持的cpu指令
"arm64"
]
},
"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平台目标版本
"forceDarkAllowed":"true", //是否允许强制支持暗黑模式,默认值为false, HBuilderX3.1.4+支持
"resizeableActivity":"false", //是否支持分屏时调整activity大小,默认不设置此值,HBuilderX3.1.10+支持
"packagingOptions": [ //配置gradle编译参数packagingOptions
"doNotStrip '*/armeabi-v7a/*.so'"
]
},
"icons":{ //应用图标配置
},
"splashscreen":{ //应用启动图片配置
},
"plugins":{ // 第三方sdk配置
}
}
}
apple
iOS平台打包配置,uni-app项目对应为"app-plus" -> "distribute" -> "ios"节点
其中appid、mobileprovision、password、p12、devices为iOS打包基础配置,点击HBuilderX菜单的"发行" -> "原生App-云打包"打开的“App云端打包”中配置:
urlschemewhitelist
设置应用访问白名单,更多详情参考https://ask.dcloud.net.cn
UIBackgroundModes
应用后台运行模式配置,如后台播放音乐、后台定位等
后台音乐播放
后台获取位置信息
更多后台能力参考苹果官方文档
urltypes
iOS平台URL Schemes配置,更多详情参考https://ask.dcloud.net.cn/article/64
<a id="frameworks"/>
frameworks
设置应用要引用的系统库(framework),字符串数组。
在使用native.js时使用,通知App云端打包在编译应用时引用对于的系统framework库,以便native.js能成功调用其中的API。
如要调用苹果游戏相关API,则需要引用"GameKit.framework"。
"frameworks": [ //iOS平台依赖的系统库
"GameKit.framework"
],
<a id="deploymentTarget"></a>
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(广告标识),更多详情参考https://ask.dcloud.net.cn/article/36107
capabilities
iOS平台打包时Capabilities配置,json类型数据,配置应用的capabilities数据(根据XCode规范分别配置到entitlements和plist文件中)
"capabilities": {
"entitlements": { // 合并到工程entitlements文件的数据(json格式)
},
"plists": { // 合并到工程Info.plist文件的数据(json格式)
}
},
更多详情参考https://ask.dcloud.net.cn/article/36393
CFBundleName
iOS平台云打包后生成应用的 bundle name 值。
默认值为"HBuilder",建议设置为英文,不要使用中文。
示例如下:
"CFBundleName": "HelloWorld",
validArchitectures
iOS平台编译时支持的CPU指令。
默认值为['arm64', 'arm64e', 'armv7', 'armv7s', 'x86_64'],如果使用了三方插件则会取插件配置validArchitectures的交集。
Android平台打包配置,uni-app项目对应为"app-plus" -> "distribute" -> "android"节点
其中packagename、keystore、password、aliasname为Android打包基础配置,点击HBuilderX菜单的"发行" -> "原生App-云打包"打开的“App云端打包”中设置:
schemes
Android平台URL Schemes配置,更多详情参考https://ask.dcloud.net.cn/article/409
theme
Android平台应用要使用的系统主题名称
更多详情参考Android配置应用主题皮肤
abiFilters
Android平台配置支持的CPU类型,更多详情参考https://ask.dcloud.net.cn/article/36195
permissions
Android平台使用到的权限,请在HBuilderX的manifest.json可视化界面“(App)模块权限配置”中的“Android打包权限配置”中勾选。
<a id="permissionExternalStorage"/>
permissionExternalStorage
HBuilderX2.5.0+版本支持
Android平台应用启动时申请读写手机存储权限配置
支持以下字段
- prompt
当用户拒绝授权读写手机存储权限时弹出提示框上显示的内容。
更多详情参考https://ask.dcloud.net.cn/article/36549
<a id="permissionPhoneState"/>
permissionPhoneState
HBuilderX2.3.8+版本支持
Android平台应用启动时申请读取设备信息权限配置
支持以下字段
- request
申请权限策略,可配置以下值:
"always" - 一直申请读取设备信息权限,用户必须授权允许,否则一直弹出提示框,直到用户允许;
"once" - 申请一次读取设备信息权限,不管用户是否允许
"none" - 不申请读取设备信息权限 - prompt
配置request值为"always"时有效,当用户拒绝授权读取设备信息权限时弹出提示框上显示的内容。
更多详情参考https://ask.dcloud.net.cn/article/36549
minSdkVersion & targetSdkVersion
minSdkVersion为应用兼容的最低Android版本(API等级)
targetSdkVersion为应用适配的Android版本(API等级)
更多详情参考https://ask.dcloud.net.cn/article/193
<a id="packagingOptions"/>
packagingOptions
配置应用的gradle配置项packagingOptions,参数值为字符串数组,每一项会单独配置到gradle文件的packagingOptions下,如下示例:
"packagingOptions": [
"doNotStrip '*/armeabi-v7a/*.so'",
"merge '**/LICENSE.txt'"
]
注意,默认已包含以下配置:
pickFirst 'lib/*/libstlport_shared.so'
pickFirst 'lib/*/libc++_shared.so'
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)图标配置”中操作设置
图片配置注意事项参考https://ask.dcloud.net.cn/article/35979
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配置”中操作设置
收起阅读 »