微擎模塊開(kāi)發(fā)manifest.xml文件詳解

微擎在安裝或卸載模塊時(shí)會(huì)根據(jù)manifest.xml生成（或刪除）數(shù)據(jù)庫(kù)中相應(yīng)記錄，并執(zhí)行manifest.xml里指定的腳本。

<application setting='true'>
	<name><![CDATA[壹應(yīng)用]]></name>
	<identifie><![CDATA[jq_first]]></identifie>
	<version><![CDATA[1.4]]></version>
	<ability><![CDATA[第一個(gè)應(yīng)用]]></ability>
	<type><![CDATA[other]]></type>
	<description><![CDATA[第一個(gè)應(yīng)用]]></description>
	<author><![CDATA[zhiqiang]]></author>
	<url><![CDATA[]]></url>
	<setting><![CDATA[]]></setting>
</application>
<platform>
    <!--定義此模塊需要訂閱的事件-->
    <subscribes>
        <message type="text" />
        <message type="image" />
        <message type="voice" />
        <message type="video" />
        <message type="shortvideo" />
        <message type="location" />
        <message type="link" />
        <message type="subscribe" />
        <message type="unsubscribe" />
        <message type="qr" />
        <message type="trace" />
        <message type="click" />
        <message type="view" />
        <message type="merchant_order" />
    </subscribes>
    <!--定義此模塊需要處理的事件-->
    <handles>
        <message type="text" />
        <message type="image" />
        <message type="voice" />
        <message type="video" />
        <message type="shortvideo" />
        <message type="location" />
        <message type="link" />
        <message type="subscribe" />
        <message type="qr" />
        <message type="trace" />
        <message type="click" />
        <message type="merchant_order" />
    </handles>
    <!--定義此模塊是否需要規(guī)則觸發(fā)-->
    <rule embed="false" />
    <card embed="false" />
    </platform>
<bindings>
	<rule>
		<entry title="應(yīng)用入口" do="enter" state="" direct="false" />
	</rule>
	<menu>
		<entry title="基本設(shè)置" do="setting" state="" direct="false" />
	</menu>
	<system_welcome>
		<entry title="壹應(yīng)用" do="first" state="" direct="false" />
	</system_welcome>
</bindings>
<install><![CDATA[]]></install>
<uninstall><![CDATA[]]></uninstall>
<upgrade><![CDATA[]]></upgrade>

manifest.xml文件內(nèi)容詳細(xì)介紹如下：

manifest - xmlns *（新增）*

用來(lái)為此模塊XML的命令空間，此處必須填寫(xiě)"[http://www.we7.cc](http://www.we7.cc/)".

manifest - versionCode

用來(lái)說(shuō)明當(dāng)前模塊適用于哪個(gè)版本的微擎, 用來(lái)保證模塊的兼容性. 多個(gè)支持的版本請(qǐng)使用逗號(hào)隔開(kāi).

manifest - application 用來(lái)定義模塊的基本設(shè)置屬性

manifest - application - setting 用來(lái)說(shuō)明此模塊是否有針對(duì)模塊的設(shè)置項(xiàng), 設(shè)置項(xiàng)可以保存此模塊需要的配置參數(shù)(此參數(shù)針對(duì)不同的公眾號(hào)分別保存)

manifest - application - name

模塊的名稱(chēng)

manifest - application - identifie

模塊標(biāo)識(shí)符, 應(yīng)對(duì)應(yīng)模塊文件夾的名稱(chēng), 微擎系統(tǒng)按照此標(biāo)識(shí)符查找模塊定義

manifest - application - version

模塊當(dāng)前版本, 此版本用于模塊的版本更新

manifest - application - type *（新增）*

模塊的類(lèi)型,方便在左側(cè)菜單中歸類(lèi)與顯示, 目前分為 business(主要業(yè)務(wù)),customer(客戶(hù)關(guān)系),activity(營(yíng)銷(xiāo)及活動(dòng)),services(常用服務(wù)及工具),other(其他)

manifest - application - ability

模塊功能描述, 使用簡(jiǎn)單的語(yǔ)言描述模塊的作用, 來(lái)吸引用戶(hù)

manifest - application - description

模塊詳細(xì)描述, 詳細(xì)介紹模塊的功能和使用方法

manifest - application - author

模塊的作者, 留下你的大名吧

manifest - application - url

模塊的發(fā)布頁(yè), 可以通過(guò)這個(gè)url來(lái)訪問(wèn)你的模塊最新情況

manifest - platform

用來(lái)定義模塊用以處理公眾平臺(tái)消息的設(shè)置項(xiàng)

manifest - platform - subscribes

消息訂閱器定義(消息訂閱器提供了一種處理公眾平臺(tái)消息的方式, 可以接受到指定類(lèi)型的消息, 來(lái)進(jìn)行分析和統(tǒng)計(jì), 不能用以處理消息返回結(jié)果. 這種處理是并行的, 同一個(gè)消息會(huì)被每一個(gè)訂閱它的模塊接收到)

manifest - platform - subscribes - message

定義需要被訂閱器訂閱的消息類(lèi)型, 這里的消息被 WeModuleReceiver 處理

manifest - platform - handles

消息處理器定義(消息處理器用于接收公眾平臺(tái)的消息, 并返回相應(yīng)的處理結(jié)果. 這種處理是互斥的, 同一個(gè)消息只能從一個(gè)模塊返回處理結(jié)果)

manifest - platform - handles - message

定義需要被處理器處理的消息類(lèi)型, 這里的消息被 WeModuleProcessor 處理

manifest - platform - rule *（變更）*

定義此模塊是否需要規(guī)則觸發(fā)

manifest - platform - rule - embed

當(dāng)前模塊進(jìn)行消息處理時(shí)需要定義規(guī)則, 是否使用規(guī)則路由. (使用規(guī)則路由必須要能處理text類(lèi)型消息, handles節(jié)點(diǎn)中必須包含 )

manifest - bindings *（新增）*

定義此模塊的封面,管理菜單,微站菜單及規(guī)則擴(kuò)展菜單

manifest - bindings - cover

定義模塊的封面入口,封面入口為單條圖文信息即是模塊需要對(duì)用戶(hù)開(kāi)放的**入口地址**.

manifest - bindings - cover - call

定義模塊動(dòng)態(tài)擴(kuò)展菜單項(xiàng), 此值對(duì)應(yīng) WeModuleSite 類(lèi)中的方法, 返回的值結(jié)構(gòu)與entry相同, 將成為此節(jié)點(diǎn)的菜單項(xiàng).

manifest - bindings - cover - entry

模塊綁定菜單的定義結(jié)構(gòu). 需要定義 title - 操作的名稱(chēng), do - 模塊操作入口, state - 附加的用戶(hù)參數(shù)(定義于WeModuleSite)

manifest - bindings - rule

定義規(guī)則的附加操作, 每個(gè)entry代表一個(gè)附加操作.

manifest - bindings - menu

定義模塊在左側(cè)本模塊菜單下拉列表中的附加菜單操作, 每一個(gè)entry代表一個(gè)菜單操作.

manifest - bindings - home

定義模塊在微站首頁(yè)的擴(kuò)展菜單項(xiàng), 每一個(gè)entry代表一個(gè)微站首頁(yè)菜單項(xiàng).

manifest - bindings - profile

定義模塊在微站個(gè)人中心的擴(kuò)展菜單項(xiàng), 每一個(gè)entry代表一個(gè)微站個(gè)人中心菜單項(xiàng).

manifest - bindings - shortcut

定義模塊在微站快捷菜單的擴(kuò)展菜單項(xiàng), 每一個(gè)entry代表一個(gè)微站快捷菜單項(xiàng).

manifest - install

安裝執(zhí)行腳本, 這里支持兩種形式: php腳本和sql語(yǔ)句. 如果安裝時(shí)只需要寫(xiě)入數(shù)據(jù)庫(kù)相關(guān)內(nèi)容, 可以在此直接定義sql語(yǔ)句. 也可以使用php文件, 例如: install.php 代表執(zhí)行模塊定義目錄下的 install.php

manifest - uninstall

卸載執(zhí)行腳本, 參上

manifest - upgrade

升級(jí)執(zhí)行腳本, 參上