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="[email protected]" 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>