模块审核规范-H5

本文档适用于使用Html5开发的模块

  以下为APICloud平台技术人员在审核开发者提交的模块时的参考标准，模块开发者应熟悉这些标准，并且在提交模块之前，参考这些标准自审模块，减小被驳回的概率，提升效率，共同保障模块的品质。

2.1 运行审核

  开发者提交的H5模块，必须是可直接在标准手机浏览器或者AppLoader环境下运行的代码，运行入口应为1.1模块包及结构中所约定的入口html文件或者test.html文件，同时运行效果需与readme.md文档或者模块运行截图一致。

  如模块包代码无法运行，或者运行效果和功能与描述不一致，一律驳回

2.2 最外层目录审核

  模块包的最外层目录必须为该模块的模块名，如rongChatList，且必须使用zip压缩工具将该目录压缩成zip格式文件（将windows下的rar格式后缀名改为zip属于无效格式）。如下图：

  凡不符合此规范，一律驳回并指导开发者做修改

2.3 子目录或文件审核

  模块包内部子目录原则上遵循widget目录命名规范和文件归纳，不做特殊要求，但不允许有汉字或者大写字母命名的文件夹。

  如开发者提交的模块包中，包含汉字或者大写字母命名的目录，一律驳回并指导开发者做修改

2.4 命名规范审核：

  原则上需要对模块包中所有文件，依据1.2命名规范中的要求进行命名规范的审核。

  该审核为非强制，如果开发者模块资源命名不规范，可做引导性指导修正。目的在于防止潜在的模块冲突问题

2.5 readme.md文件审核

  readme.md为标准的Markdown语法文件，可为使用者快速提供帮助参考，同时也有利于模块Store在特定的位置展示该文档。

一个全面的readme.md文件参考如下：

# 功能描述

    描述…

# 依赖的模块

    module1、module2 …

# 快速使用

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

# 特别说明

    使用本模块需要特别注意的地方，或者可能存在哪些问题，技术支持、帮助信息等

结合以上信息，readme.md审核时，应该满足以下规范：

2.5.1 功能描述

  功能描述为必须项，需清晰的描述该模块具备的功能或者提供的效果。

  如描述模糊或者无法理解，一律驳回并要求开发者做修改

2.5.2 依赖的模块

  此项为可选项，如果本H5模块不依赖其他原生模块，可为空。

  如此项为空，而在运行测试过程中发现报找不到模块的错误，一律驳回并指导开发者做更改

2.5.3 快速使用

  此项是重要项，开发者需要清晰的描述本模块的使用流程，开放API，可定制的代码访问等

  如此项为空，或者描述模糊、无法理解等，一律驳回并要求开发者做修改

2.5.4 特别说明

  此项不做强制审核。

2.6 封面及运行截图审核

  模块封面图必须是具备审美设计的图片，不应为随意生成的粗糙图片；模块需至少提供2张运行截图。

  如封面图存在明显低劣或者未提供2张及以上运行截图，一律驳回