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欄位並給應用安裝包新增相應的系統許可權(即應用安裝時,系統向用戶展示的許可權列表)。
關於配置檔案的屬性詳情瀏覽。