apicloud应用配置说明

《apicloud应用配置说明》由会员上传分享，免费在线阅读，更多相关内容在行业资料-天天文库。

1、Overview1、概述每一个Widget包必须有一个名为config.xml（大小写敏感）的配置文件，它位于Widget包的根目录下。该配置文件包含了关于该Widget的重要信息，如：名称、作者信息、描述、云端ID、偏好设置、权限配置、模块概览等等，并且该配置文件也是整个Widget的入口。一个简单的config.xml文件配置清单如下：APIExampleAPIExampleApp.

2、mail="developer@apicloud.com"href="http://www.apicloud.com">APICloud.SIR

3、idget>注：该XML文件必须采用UTF-8编码。2、配置清单描述widget父元素描述了该Widget的基本属性，如表1所示。表1.widget父元素的属性属性名描述备注id应用ID，由云服务器自动分配。它是该Widget在云端必选的唯一标识。云服务器根据此ID对Widget进行管理并提供辅助服务，如：更新升级、统计分析、推送服务等。versionWidget的版本号必选sandbox配置此属性后，APICloud应用在运行之初，将会在设可选备的SD卡上建立与此属性同名的文件夹根目录，并将该目录默认为本应用的沙箱根路径，此后应用运行过程中所有涉及的文件操作

4、如：文件读写，拍照、下载等等，操作结果的文件都将存放在该路径下。该属性仅Android平台生效配置中的XML元素如表2所示。表2.Widget配置元素元素名描述备注nameWidget的名称。如：QQ、新浪微博、微信等必选descriptionWidget的简单描述信息可选authorWidget的作者信息可选contentWidget运行的起始页，支持相对/绝对路径必选accessWidget允许访问的资源范围。一般配置“*”，代表允可选许访问所有preference偏好设置。配置Widget的一些运行时属性，如：页面可选是否支持弹动效果、窗口默认背景、页面

5、是否显示滚动条等。该配置可在IDE的GUI界面中选择并使用。详细请参考PreferenceGuidepermission权限配置。通过此配置向系统声明Widget所用到的系必选统权限。如：直接拨打电话、直接发送短信、发起定位等。该配置可在IDE的GUI界面中选择并使用。详细请参考PlatformPermissionfeature功能配置。通过此配置，向系统声明需要使用哪些功可选能，以及需要传递给该功能的数据。如：使用新浪微博、使用微信分享等。该配置可在IDE的GUI界面中选择并使用。详细请参考FeatureGuidePreferencePreference用于

6、声明本应用的一些全局设置或者属性，该字段以键值对的形式存在。APICloud应用在启动及运行过程中会随时参考这些属性，以达到应用运行的最优状态。1、配置App全局背景字段名：appBackground取值范围：1、颜色：#FFF，#FFFFFF，rgb(255,255,255)，rgba(255,255,255,1.0)；2、图片：相对widget包路径的url地址，如image/xxx.png默认值：rgba(0,0,0,0.0)描述：配置App的背景颜色或图片，默认为透明色。配置此字段后，如果window的背景为透明色，则将透射出App背景。APIClou

7、d应用的UI层次结构见图1.配置示例：

8、imageUrl"/>图1.APICloud应用UI层次结构图：若WindowBackground为透明，那么Window将展示App的背景，同时如果FrameBackground也为透明，那么Frame将展示App的背景。2、配置Window默认背景字段名：windowBackground取值范围：1、颜色：#FFF，#FFFFFF，rgb(255,255,255)，rgba(255,255,255,1.0)；2、图片：相对widge

9、t包路径的url地址，如image/x