APICloud的config.xml應用配置的說明
一．APICloud的config.xml應用配置的說明
每一個Widget 包必須有一個名為 config.xml （大小寫敏感）的配
置檔案，它位於Widget包的根目錄下。該配置檔案包含了關於該Widget的重要資訊，如：名稱、作者資訊、描述、雲端ID、偏好設定、許可權配置、模組概覽等等，並且該配置檔案也是整個Widget的入口。
以下是整個配置檔案：
配置清單描述：
widget父元素描述了該Widget的基本屬性，如表1所示。
-
表1. widget父元素的屬性
屬性名
描述
備註
id
應用ID，由雲伺服器自動分配。它是該
必選
version
Widget的版本號
必選
sandbox
配置此屬性後，APICloud應用在執行之初，將會在裝置的SD卡上建立與此屬性同名的資料夾根目錄，並將該目錄預設為本應用的沙箱根路徑，此後應用執行過程中所有涉及的檔案操作如：檔案讀寫，拍照、下載等等，操作結果的檔案都將存放在該路徑下。該屬性僅Android平臺生效
可選
配置中的XML元素如表2所示。
-
表2. Widget配置元素
元素名
描述
備註
name
Widget的名稱。如：QQ、新浪微博、微信等
必選
description
Widget的簡單描述資訊
可選
author
Widget的作者資訊
可選
content
Widget執行的起始頁，支援相對/絕對路徑
必選
access
在哪些頁面裡面可以訪問APICloud的擴充套件API。一般配置“*”，代表所有頁面都允許訪問
可選
preference
偏好設定。配置Widget的一些執行時屬性，如：頁面是否支援彈動效果、視窗預設背景、頁面是否顯示滾動條等。該配置可在
可選
permission
許可權配置。通過此配置向系統宣告Widget所用到的系統許可權。如：直接撥打電話、直接傳送簡訊、發起定位等。該配置可在APICloud Studio的GUI介面中選擇並使用。詳細請參考
必選
feature
功能配置。通過此配置，向系統宣告需要使用哪些功能，以及需要傳遞給該功能的資料。如：使用新浪微博、使用微信分享等。該配置可在APICloud Studio的GUI介面中選擇並使用。詳細請參考
可選
font
字型配置。通過此配置，將自定義字型加入到應用中，使其可以在前端頁面使用該字型
可選
Preference
Preference用於宣告本應用的一些全域性設定或者屬性，該欄位以鍵值對的形式存在。APICloud應用在啟動及執行過程中會隨時參考這些屬性，以達到應用執行的最優狀態。
Feature
Feature用於宣告本應用使用到的平臺擴充套件模組功能、第三方SDK等接入規範、執行時元件，並宣告該模組預設需要傳入的引數及值（param），每個Feature對應一個或多個引數值。APICloud應用通過這些模組為使用者提供特定的功能。其基本結構和欄位如下：
//forceBind欄位表示是否強制繫結模組，為true時在網站上面該模組會被自動勾選上且不能去掉。預設值為true
<feature name="moduleName"forceBind="true">
<param name="xxx"value="xxx" />
</feature>
Permission
Permission用於宣告本應用用到的所有系統許可權。APPCloud開放的API介面以及提供的服務或者功能中，可能需要向作業系統申請某些許可權，APPCloud將這些許可權歸類並抽象後提供給開發者，開發者通過簡單的欄位宣告，APPCloud雲端在編譯應用時，將會判別permission欄位並給應用安裝包新增相應的系統許可權（即應用安裝時，系統向用戶展示的許可權列表）。
關於配置檔案的屬性詳情瀏覽。