APICloud-config详解-Android

<!-- 配置详情：http://docs.apicloud.com/Dev-Guide/app-config-manual#2 -->
<!-- id:
应用ID，由云服务器自动分配。它是该Widget在云端的唯一标识。云服务器根据此ID对Widget进行管理并提供辅助服务，如：更新升级、统计分析、推送服务等。 -->
<!-- version:Widget的版本号 -->
<!--
 sandbox :
配置此属性后，APICloud应用在运行之初，将会在设备的SD卡上建立与此属性同名的文件夹根目录，
并将该目录默认为本应用的沙箱根路径，此后应用运行过程中所有涉及的文件操作如：文件读写，拍照、下载等等，操作结果的文件都将存放在该路径下。该属性仅Android平台生效 -->
<widget id="A6055656788186" version="0.0.1" sandbox="test">
    <!--Widget的名称。如：QQ、新浪微博、微信等-->
    <name>test</name>
    <!-- Widget的简单描述信息 -->
    <description>
       xhs的测试应用
    </description>
    <!--Widget的作者信息 -->
    <author email="1358521215@qq.com" href="http://write.blog.csdn.net/postlist?ticket=ST-165834-J3Xn5cWbPGL1PAms2ybM-passport.csdn.net">
        xhs的测试应用
    </author>
    <!-- Widget运行的起始页，支持相对/绝对路径 -->
    <content src="test.html"/>
    <!-- 在哪些页面里面可以访问APICloud的扩展API。一般配置“*”，代表所有页面都允许访问 -->
    <access origin="*"/>
    <!--
偏好设置。配置Widget的一些运行时属性，如：页面是否支持弹动效果、窗口默认背景、页面是否显示滚动条等。该配置可在APICloud Studio的GUI界面中选择并使用。详细请参考Preference Guide -->
    <!-- 配置页面是否可以弹动。若不配置，window默认不弹动，frame默认可以弹动；若配置，则window和frame是否可以弹动默认都以此配置的为准-->
    <preference name="pageBounce" value="false"/>
    <!-- 支持图片/颜色 -->
    <preference name="appBackground" value="rgba(0,0,0,0.0)"/>
    <!-- 支持图片/颜色 -->
    <preference name="windowBackground" value="rgba(0,0,0,0.0)"/>

    <preference name="frameBackgroundColor" value="rgba(0,0,0,0.0)"/>
    <!-- 配置在页面高度超出视图高度时，window|frame是否显示横滚动条。默认显示 -->
    <preference name="hScrollBarEnabled" value="true"/>
    <!-- 配置在页面高度超出视图高度时，window|frame是否显示竖滚动条。默认显示 -->
    <preference name="vScrollBarEnabled" value="true"/>
    <!-- 配置启动页是否自动隐藏。默认值：true-->
    <!-- 描述：APICloud应用在启动时向用户展示一个启动界面，并控制该启动界面在适当的时候隐藏。如该字段置为false，
则启动页需要开发者自行调相关接口关闭(api.removeLaunchView)。置为true，则引擎自动关闭。默认显示3秒后关闭，
如3秒内网页未加载完毕则一直等待，直到网页加载完毕再关闭启动页。 -->
    <preference name="autoLaunch" value="true"/>
    <!-- 配置应用是否全屏运行。默认值：false  -->
    <!-- 描述：配置应用是否全屏运行。如果该字段为true，应用将以全屏的方式启动，并以全屏方式运行。
运行过程中可随时通过APICloud开放的API（api.setFullScreen）控制退出全屏或重新进入全屏。云编译有效。 -->
    <preference name="fullScreen" value="false"/>
    <!-- 配置应用是否自动检测更新。默认：true -->
    <!-- 描述：配置应用是否自动检测更新。如果该字段为true，应用在启动时将自动与云端握手，
并检查本应用是否有更新，是否被强制关闭，是否强制更新等（以上控制可在云端控制台“版本”中设置）。
应用运行过程中会根据这些设置进行相关操作，如：自动下载、强制关闭应用等；若配置为false，则不会弹出任何更新提示。云编译有效。 -->
    <preference name="autoUpdate" value="true"/>
    <!-- 配置应用是否支持增量更新、云修复。默认：false -->
    <!-- 描述：配置应用是否支持增量更新以及云修复。如果该字段为true，应用在启动时将自动与云端握手，
并检查本应用当前版本下是否有增量包更新，是否需要进行云修复。应用运行过程中会根据这些设置进行相关操作，如：提示更新下载、静默更新下载等。云编译有效。 -->
    <preference name="smartUpdate" value="false"/>
    <!-- 配置应用开启/关闭调试模式。默认false -->
    <!-- 描述：配置应用是否处于调试模式。如果该字段为true，标识应用进入调试模式，
应用运行过程中发生的因代码书写失误等原因导致的Js报错（引起执行中断）信息，将会以弹窗的方式覆盖在应用最上方，供开发者参考。 -->
    <preference name="debug" value="true"/>
    <!-- 配置状态栏和页面是否重合（沉浸式效果。默认：true） -->
    <!-- 描述：配置应用界面是否和设备状态栏重合，表现效果为系统的状态栏是否覆盖在当前应用上，即“沉浸式效果”。
支持iOS7及以上、Android4.4及以上系统。 -->
    <preference name="statusBarAppearance" value="true"/>
    <!-- Permission -->
    <!-- Permission用于声明本应用用到的所有系统权限。APPCloud开放的API接口以及提供的服务或者功能中，
  可能需要向操作系统申请某些权限，APPCloud将这些权限归类并抽象后提供给开发者，开发者通过简单的字段声明，
  APPCloud云端在编译应用时，将会判别permission字段并给应用安装包添加相应的系统权限（即应用安装时，系统向用户展示的权限列表）。 -->
    <!-- 权限描述：允许该应用访问设备的电话功能。此权限可以让该应用确定本机号码和设备ID、是否处于通话状态以及拨打的号码
使用该权限的接口：api.ajax()、api.download()、api.getLocation() -->
    <permission name="readPhoneState"/>
    <!-- 权限描述：允许应用在用户未执行操作的情况下直接拨打电话号码。此权限可能会导致意外收费或呼叫。此权限不允许该应用拨打紧急电话号码。
使用该权限的接口：api.call() -->
    <permission name="call"/>
    <!-- 允许该应用使用相机拍摄照片和视频。此权限可以让应用随时使用相机，而无需用户确认。使用该权限的接口：api.getPicture() -->
    <permission name="camera"/>
<!-- 允许该应用访问设备的麦克风，并进行录音。该权限可能导致用户隐私的泄露。api.startRecord() -->
    <permission name="record"/>
<!-- 允许该应用访问位置提供程序根据GPS、基站和WLAN等网络源确定用户的的大概或者精确位置，
当这些位置服务可用且处于启用状态时，此权限可让该应用确定用户的位置。使用该类服务时，用户的设备也会消耗更多的电量。
使用该权限的接口：api.startLocation()、api.getLocation() -->
    <permission name="location"/>
<!-- 允许应用读取或写入内部存储及外部SD卡。 -->
<!-- 使用该权限的接口：api.readFile()、api.writeFile()、api.startRecord()、api.getPicture() -->
    <permission name="fileSystem"/>
<!-- 权限描述：允许应用创建网络套接字和使用自定义网络协议。查看网络连接的相关信息，查看WLAN状态、更改WLAN状态，更改网络设置，访问设备WIFI信息等。 -->
<!-- 使用该权限的接口：api.ajax()、api.download()、api.startLocation()、api.getLocation() -->
    <permission name="internet"/>
<!-- 权限描述：允许该应用在系统启动完成后立即自动启动。这可能会导致延长手机的启动时间，并允许应用始终运行，从而导致手机总体运行速度减慢。
使用该权限的接口：基于推送的相关服务 -->
    <permission name="bootCompleted"/>
<!-- 权限描述：允许应用控制闪光灯、振动器、防止手机休眠等。
使用该权限的接口：api.getPicture()、基于推送的相关服务 -->
    <permission name="hardware"/>
    <!-- 访问设备通讯录 -->
    <!-- 权限描述：允许该应用访问和修改用户手机上存储的联系人的相关数据。
使用该权限的接口：api.openContacts() -->
    <permisssion name="contact"/>
</widget>