第五章 APICloud应用配置说明.pdfVIP

Overview 1、概述 每一个 Widget 包必须有一个名为 config.xml （大小写敏感）的配置文件，它位于 Widget 包的根目录下。该配置文件包含了关于该Widget 的重要信息，如：名称、作者信息、 描述、云端ID、偏好设置、权限配置、模块概览等等，并且该配置文件也是整个Widget 的 入口。 一个简单的config.xml 文件配置清单如下： widget id=A12345678901 version=0.0.1 nameAPI Example/name description API Example App. /description author email=developer@ href= APICloud.SIR /author content src=index.html / access origin=* / preference name=windowBackground value=#FFF / permission name=call / feature name=weiXin param name=urlScheme value=wx7779c7c063a9d4d9 / /feature /widget 注：该XML 文件必须采用UTF-8 编码。 2、配置清单描述 widget 父元素描述了该Widget 的基本属性，如表1 所示。 表1. widget 父元素的属性 属性名 描述 备注 id 应用ID，由云服务器自动分配。它是该Widget 在云端 必选 的唯一标识。云服务器根据此 ID 对 Widget 进行管理 并提供辅助服务，如：更新升级、统计分析、推送服 务等。 version Widget 的版本号 必选 sandbox 配置此属性后，APICloud 应用在运行之初，将会在设 可选 备的SD 卡上建立与此属性同名的文件夹根目录，并将 该目录默认为本应用的沙箱根路径，此后应用运行过 程中所有涉及的文件操作如：文件读写，拍照、下载 等等，操作结果的文件都将存放在该路径下。该属性 仅Android 平台生效 配置中的XML 元素如表2 所示。 表2. Widget 配置元素 元素名 描述 备注 name Widget 的名称。如：QQ、新浪微博、微信等 必选 description Widget 的简单描述信息 可选 author Widget 的作者信息 可选 content Widget 运行的起始页，支持相对/绝对路径 必选 access Widget 允许访问的资源范围。一般配置“*”，代表允 可选 许访问所有 preference 偏好设置。配置Widget 的一些运行时属性，如：页面 可选 是否支持弹动效果、窗口默认背景、页面是否显示滚 动条等。该配置可在 IDE 的GUI 界面中选择并使用。 详细请参考Preference Guide permission 权限配置。通过此配置向系统声明Widget 所用到的系 必选 统权限。如：直接拨打电话、直接发送短信、发起定 位