模塊審核規(guī)范-H5

本文檔適用于使用Html5開發(fā)的模塊

??以下為APICloud平臺(tái)技術(shù)人員在審核開發(fā)者提交的模塊時(shí)的參考標(biāo)準(zhǔn)，模塊開發(fā)者應(yīng)熟悉這些標(biāo)準(zhǔn)，并且在提交模塊之前，參考這些標(biāo)準(zhǔn)自審模塊，減小被駁回的概率，提升效率，共同保障模塊的品質(zhì)。

2.1 運(yùn)行審核

??開發(fā)者提交的H5模塊，必須是可直接在標(biāo)準(zhǔn)手機(jī)瀏覽器或者AppLoader環(huán)境下運(yùn)行的代碼，運(yùn)行入口應(yīng)為1.1模塊包及結(jié)構(gòu)中所約定的入口html文件或者test.html文件，同時(shí)運(yùn)行效果需與readme.md文檔或者模塊運(yùn)行截圖一致。

如模塊包代碼無法運(yùn)行，或者運(yùn)行效果和功能與描述不一致，一律駁回

2.2 最外層目錄審核

??模塊包的最外層目錄必須為該模塊的模塊名，如rongChatList，且必須使用zip壓縮工具將該目錄壓縮成zip格式文件（將windows下的rar格式后綴名改為zip屬于無效格式）。如下圖：

凡不符合此規(guī)范，一律駁回并指導(dǎo)開發(fā)者做修改

2.3 子目錄或文件審核

??模塊包內(nèi)部子目錄原則上遵循widget目錄命名規(guī)范和文件歸納，不做特殊要求，但不允許有漢字或者大寫字母命名的文件夾。

如開發(fā)者提交的模塊包中，包含漢字或者大寫字母命名的目錄，一律駁回并指導(dǎo)開發(fā)者做修改

2.4 命名規(guī)范審核：

??原則上需要對(duì)模塊包中所有文件，依據(jù)1.2命名規(guī)范中的要求進(jìn)行命名規(guī)范的審核。

??該審核為非強(qiáng)制，如果開發(fā)者模塊資源命名不規(guī)范，可做引導(dǎo)性指導(dǎo)修正。目的在于防止?jié)撛诘哪K沖突問題

2.5 readme.md文件審核

??readme.md為標(biāo)準(zhǔn)的Markdown語法文件，可為使用者快速提供幫助參考，同時(shí)也有利于模塊Store在特定的位置展示該文檔。

一個(gè)全面的readme.md文件參考如下：

## 功能描述


    描述…


## 依賴的模塊


    module1、module2 …


## 快速使用


    使用流程描述，API描述，代碼更改定制幫助等…


## 特別說明


    使用本模塊需要特別注意的地方，或者可能存在哪些問題，技術(shù)支持、幫助信息等

結(jié)合以上信息，readme.md審核時(shí)，應(yīng)該滿足以下規(guī)范：

2.5.1 功能描述

??功能描述為必須項(xiàng)，需清晰的描述該模塊具備的功能或者提供的效果。

如描述模糊或者無法理解，一律駁回并要求開發(fā)者做修改

2.5.2 依賴的模塊

??此項(xiàng)為可選項(xiàng)，如果本H5模塊不依賴其他原生模塊，可為空。

如此項(xiàng)為空，而在運(yùn)行測(cè)試過程中發(fā)現(xiàn)報(bào)找不到模塊的錯(cuò)誤，一律駁回并指導(dǎo)開發(fā)者做更改

2.5.3 快速使用

??此項(xiàng)是重要項(xiàng)，開發(fā)者需要清晰的描述本模塊的使用流程，開放API，可定制的代碼訪問等

如此項(xiàng)為空，或者描述模糊、無法理解等，一律駁回并要求開發(fā)者做修改

2.5.4 特別說明

??此項(xiàng)不做強(qiáng)制審核。

2.6 封面及運(yùn)行截圖審核

??模塊封面圖必須是具備審美設(shè)計(jì)的圖片，不應(yīng)為隨意生成的粗糙圖片；模塊需至少提供2張運(yùn)行截圖。

如封面圖存在明顯低劣或者未提供2張及以上運(yùn)行截圖，一律駁回