mui开发知识积累总结-----puls.runtime
Runtime
Runtime模块管理运⾏环境,可⽤于获取当前运⾏环境信息、与其它程序进⾏通讯等。通过plus.runtime可获取运⾏环境管理对象。属性:
version获取客户端的版本号
innerVersion获取客户端运⾏时环境的版本号
arguments获取第三⽅程序调⽤时传递给程序的参数
appid获取当前应⽤的APPID
⽅法:
getProperty获取指定APPID对应的应⽤信息
install安装应⽤
quit退出客户端程序
restart重启当前的应⽤
tBadgeNumber设置程序快捷⽅式上显⽰的提⽰数字
openURL调⽤第三⽅程序打开指定的URL
openFile调⽤第三⽅程序打开指定的⽂件
launchApplication调⽤第三⽅程序
对象:
WidgetOptionJSON对象,应⽤安装参数
WidgetInfoJSON对象,应⽤信息
OpenFileOptionJSON对象,打开⽂件参数
ApplicationInfJSON对象,打开第三⽅程序参数
回调⽅法:
InstallSuccessCallback安装应⽤成功回调函数
InstallErrorCallback安装应⽤失败回调函数
GetPropertyCallBack获取应⽤属性成功回调函数
OpenErrorCallback打开本地⽂件或URL失败回调函数
LaunchErrorCallback调⽤第三⽅程序失败回调函数
getProperty
获取指定APPID对应的应⽤信息
void Property( appid, getPropertyCB );
说明:
获取指定APPID对应的应⽤信息
参数:
appid (DOMString) 可选 应⽤的Appid
getPropertyCB (GetPropertyCallBack) 可选 获得应⽤信息成功回调函数返回值:
⽆
平台⽀持:
Android : 2.2+
⽀持松树蘑菇
iOS : 4.3+
⽀持
WP : 7.5+
暂不⽀持
⽰例:
/
/ 扩展API加载完毕后调⽤onPlusReady回调函数
document.addEventListener( "plusready", onPlusReady, fal );
// 扩展API加载完毕,现在可以正常调⽤扩展API
function onPlusReady() {
}
// 获取应⽤信息
function getAppInfo() {
Property( plus.runtime.appid, function ( wgtinfo ) { //appid属性
var wgtStr = "appid:"+wgtinfo.appid;
//version属性
wgtStr += "
version:"+wgtinfo.version;夜夜念奴娇
//name属性
wgtStr += "
name:"+wgtinfo.name;
//description属性
wgtStr += "
description:"+wgtinfo.description;
//author属性
苦瓜瘦肉汤的做法>文本框旋转
wgtStr += "
author:"+wgtinfo.author;
//email属性
4年级数学计算题wgtStr += "
email:"+ail;
//licence属性
wgtStr += "
licen:"+wgtinfo.licen;
//licenhref属性
wgtStr += "
licenhref:"+wgtinfo.licenhref;
//features 属性
wgtStr += "
features:"+wgtinfo.features;
console.log( wgtStr );
} );
}鄱阳湖的读音
获取应⽤信息
install
安装应⽤
void plus.runtime.install( wgtFilePath, options, installSuccessCB, installErrorCB);
安装包格式为wgt应⽤,其扩展名为'.wgt',使⽤这个⽅法之前,需要提前把安装包从⽹络处或其他位置放置到运⾏时环境可以访问的位置。参数:
振藩国术馆wgtFilePath (DOMString) 可选 应⽤安装⽂件或基座安装⽂件(扩展名为'.wgt')
options (WidgetOption) 可选 应⽤安装设置的参数
installSuccessCB (InstallSuccessCallback) 可选 正确安装后的回调
installErrorCB (InstallErrorCallback) 可选 安装失败的回调
返回值:
⽆
平台⽀持:
Android : 2.2+
⽀持,⽀持apk包的安装
iOS : 4.3+
⽀持,不⽀持ipa包的安装
WP : 7.5+
暂不⽀持
quit
退出客户端程序
void plus.runtime.quit();
说明:
退出客户端程序狐梦
返回值:
⽆
平台⽀持:
Android : 2.2+
⽀持
iOS : 4.3+
iOS系统不⽀持此功能,只能通过设备的Home键退出应⽤。
WP : 7.5+
⽰例:
// 扩展API加载完毕后调⽤onPlusReady回调函数
document.addEventListener( "plusready", onPlusReady, fal ); // 扩展API加载完毕,现在可以正常调⽤扩展API
function onPlusReady() {
plus.key.addEventListener( "backbutton", onKeyBack, fal ); }
function onKeyBack() {
plus.runtime.quit();
}
restart
重启当前的应⽤
void start();
说明:
重启当前的应⽤
返回值:
⽆
平台⽀持:
Android : 2.2+
⽀持
iOS : 4.3+
⽀持
WP : 7.5+
暂不⽀持
⽰例:
// 扩展API加载完毕后调⽤onPlusReady回调函数
document.addEventListener( "plusready", onPlusReady, fal ); // 扩展API加载完毕,现在可以正常调⽤扩展API