runtime

Runtime模块管理运行环境，可用于获取当前运行环境信息、与其它程序进行通讯等。通过plus.runtime可获取运行环境管理对象。

属性：

• version: 获取客户端的版本号
• innerVersion: 获取客户端运行时环境的版本号
• arguments: 获取第三方程序调用时传递给程序的参数
• appid: 获取当前应用的APPID

方法：

• getProperty: 获取指定APPID对应的应用信息
• install: 安装应用
• quit: 退出客户端程序
• restart: 重启当前的应用
• setBadgeNumber: 设置程序快捷方式上显示的提示数字
• openURL: 调用第三方程序打开指定的URL
• openFile: 调用第三方程序打开指定的文件
• launchApplication: 调用第三方程序

对象：

• WidgetOption: JSON对象，应用安装参数
• WidgetInfo: JSON对象，应用信息
• OpenFileOption: JSON对象，打开文件参数
• ApplicationInf: JSON对象，打开第三方程序参数

回调方法：

• InstallSuccessCallback: 安装应用成功回调函数
• InstallErrorCallback: 安装应用失败回调函数
• GetPropertyCallBack: 获取应用属性成功回调函数
• OpenErrorCallback: 打开本地文件或URL失败回调函数
• LaunchErrorCallback: 调用第三方程序失败回调函数

权限：

permissions

"Runtime": {
	"description": "访问运行环境信息"
}
			

WidgetOption

JSON对象，应用安装参数

说明：

可通过对象设置安装的应用是否进行appid校验、版本号校验等。

属性：

• appid: (DOMString 类型 )应用的appid
  

  默认值 null。当前正在安装的应用的appid，填写该值后应用安装时将进行校验，如安装包内的appid和指定的不同则终止当前应用的安装

• force: (Boolean 类型 )是否强制安装
  

  默认值 false。当取值为true，应用安装为强制安装，不再进行版本号的校验，如果为false则进行版本号校验，如果将要安装应用的版本号不高于现有应用的版本号则终止安装，并返回安装失败

WidgetInfo

JSON对象，应用信息

属性：

• appid: (DomString 类型 )应用的APPID
  
• version: (DomString 类型 )应用的版本号
  
• name: (DomString 类型 )应用的名称
  
• description: (DomString 类型 )应用描述信息
  
• author: (DomString 类型 )应用描述信息
  
• email: (DomString 类型 )开发者邮箱地址
  
• license: (DomString 类型 )应用授权描述信息
  
• licensehref: (DomString 类型 )应用授权说明链接地址
  
• features: (DomString[] 类型 )应用许可特性列表
  

OpenFileOption

JSON对象，打开文件参数

属性：

• popover: (json 类型 )弹出系统选择程序界面指示区域
  

  JSON对象，格式如{top:10;left:10;width:200;height:200;}，所有值为像素值，左上坐标相对于容器webview的位置。仅在iPad设备平台有效。

ApplicationInf

JSON对象，打开第三方程序参数

属性：

• pname: (DOMString 类型 )第三方程序包名
  

  仅Android平台支持，表示程序的包名，其它平台忽略此属性值。

• action: (DOMString 类型 )程序的操作行为
  

  Android平台上与系统的action值一致；iOS平台为要调用程序的URLScheme格式字符串。

• extra: (JSON 类型 )调用程序的参数
  

  仅Android平台支持，为JSON格式，用于传递给要调用程序的参数，如extra:{url:"http://www.html5plus.org"}。

InstallSuccessCallback

安装应用成功回调函数

void onSuccess(widgetInfo){
	// Code here
}
				

参数：

• widgetInfo: ( WidgetInfo ) 必选 
  应用信息，参见：WidgetInfo

返回值：

InstallErrorCallback

安装应用失败回调函数

void onError(error){
	// Handle the error
}
				

参数：

• error: ( DOMException ) 必选 
  安装失败的错误信息

返回值：

GetPropertyCallBack

获取应用属性成功回调函数

void onGetPropertyCB(widgetInfo){
	// Code here
}
				

参数：

• widgetInfo: ( WidgetInfo ) 必选 
  应用信息，参见：WidgetInfo

返回值：

OpenErrorCallback

打开本地文件或URL失败回调函数

void onError(error){
	// Handle the error
}
				

参数：

• error: ( DOMException ) 必选 
  打开操作失败的错误信息

返回值：

LaunchErrorCallback

调用第三方程序失败回调函数

void onError(error){
	// Handle the error
}
				

参数：

• error: ( DOMException ) 必选 
  操作失败的错误信息

返回值：