config.xml應用配置說明

2022-06-20 10:20 更新

概述

每一個Widget 包必須有一個名為 config.xml (大小寫敏感)的配置文件,它位于Widget包的根目錄下。該配置文件包含了關于該Widget的重要信息,如:名稱、作者信息、描述、云端ID、偏好設置、權限配置、模塊概覽等等,并且該配置文件也是整個Widget的入口。

一個簡單的config.xml文件配置清單如下:

<widget id="A12345678901"  version="0.0.1">
    <name>API Example</name>
    <description>
        API Example App.
    </description>
    <author email="developer@apicloud.com"  rel="external nofollow" target="_blank" >
        APICloud.SIR
    </author>
    <content src="index.html" />
    <access origin="*" />
    <preference name="windowBackground" value="#FFF" />
    <permission name="call" />
    <feature name="weiXin">
        <param name="urlScheme" value="wx7779c7c063a9d4d9" />
    </feature>
</widget>
注:該XML文件必須采用UTF-8編碼。

配置清單描述

widget父元素描述了該Widget的基本屬性,如表1所示。

  • 表1. widget父元素的屬性
屬性名 描述 備注
id 應用ID,由云服務器自動分配。它是該Widget在云端的唯一標識。云服務器根據(jù)此ID對Widget進行管理并提供輔助服務,如:更新升級、統(tǒng)計分析、推送服務等。 必選
version Widget的版本號 必選
sandbox 配置此屬性后,APICloud應用在運行之初,將會在設備的SD卡上建立與此屬性同名的文件夾根目錄,并將該目錄默認為本應用的沙箱根路徑,此后應用運行過程中所有涉及的文件操作如:文件讀寫,拍照、下載等等,操作結果的文件都將存放在該路徑下。該屬性僅Android平臺生效 可選

配置中的XML元素如表2所示。

  • 表2. Widget配置元素
元素名 描述 備注
name Widget的名稱。如:QQ、新浪微博、微信等 必選
description Widget的簡單描述信息 可選
author Widget的作者信息 可選
content Widget運行的起始頁,支持相對/絕對路徑 必選
access 在哪些頁面里面可以訪問APICloud的擴展API。一般配置“*”,代表所有頁面都允許訪問 可選
preference 偏好設置。配置Widget的一些運行時屬性,如:頁面是否支持彈動效果、窗口默認背景、頁面是否顯示滾動條等。該配置可在APICloud Studio的GUI界面中選擇并使用。詳細請參考Preference Guide 可選
permission 權限配置。通過此配置向系統(tǒng)聲明Widget所用到的系統(tǒng)權限。如:直接撥打電話、直接發(fā)送短信、發(fā)起定位等。該配置可在APICloud Studio的GUI界面中選擇并使用。詳細請參考Platform Permission 必選
feature 功能配置。通過此配置,向系統(tǒng)聲明需要使用哪些功能,以及需要傳遞給該功能的數(shù)據(jù)。如:使用新浪微博、使用微信分享等。該配置可在APICloud Studio的GUI界面中選擇并使用。詳細請參考Feature Guide 可選
font 字體配置。通過此配置,將自定義字體加入到應用中,使其可以在前端頁面使用該字體 可選
以上內容是否對您有幫助:
在線筆記
App下載
App下載

掃描二維碼

下載編程獅App

公眾號
微信公眾號

編程獅公眾號