SDK 2.0.0 模板上传验证规则详解

"SDK 2.0.0 模板上传(打包)验证规则－V1.0.0.docx" SDK 2.0.0 的模板上传和打包验证规则是一份详尽的文档，旨在确保上传的模板符合规范，保证其在不同应用场景下的稳定性和兼容性。这份规则涵盖了模板的各个方面，包括模板描述文件、皮肤、页面、模块以及JS相关的验证点。 一、模板相关 1. **模板描述文件验证 (site.xml)**：site.xml 文件是模板的核心配置文件，它包含了模板的基本信息和布局。验证时需要检查其结构正确，如 `<global>` 和 `<page>` 元素的配置，确保 header.json 和 footer.json 文件已正确配置。 2. **皮肤**：模板可以拥有多种皮肤，验证时需确保皮肤数量不超过3套，并且皮肤名称只能包含英文、数字、横线"-"和下划线"_"。同时，皮肤的CSS属性仅限于 `background-color`、`background-image`、`background-repeat`、`background-position`。 3. **模板目录结构**：模板目录应包含 assets 和 modules 文件夹，以及 site.xml 描述符和多个 JSON 文件。此外，目录结构的复杂度也有限制，文件总数不超过300个，且总大小不超过10M。 二、页面相关 1. **JSON文件**：JSON 文件用于描述页面结构和逻辑，验证时需确保它们在 site.xml 中有正确的配置，并且 index、list 和 detail 类型的页面都有相应的 JSON 定义。 三、模块相关 1. **模块描述文件 (module.xml)**：每个模块都有对应的 module.xml 文件，用于描述模块的功能和行为。验证时需要检查文件存在且内容合法。 2. **PHP文件**：模块可能包含PHP代码，验证时确保这些文件符合编程规范，无安全风险。 3. **模块目录结构**：模块目录结构应符合标准，每个模块ID对应的目录必须存在。 4. **模块皮肤**：模块也可以有自己的皮肤，验证时需检查皮肤文件的合法性和一致性。 四、JS相关 JS 文件的验证主要关注 JSON 文件的配置，确保其在 site.xml 中有正确引用，且模块ID对应的实际模块目录存在。 五、其他规则 - **模板描述信息中的元素内容**：id, name, thumbnail, language, version, apply-sites 等元素不能为空，且 `<change-notes>` 和 `<description>` 的长度限制在0-1024个字节。 - **模板缩略图**：模板缩略图文件必须存在，格式限定为 jpg、png 或 gif，且路径与默认皮肤缩略图路径一致。 - **皮肤文件**：皮肤文件内容应符合CSS属性的限制，extra.css 文件的选择器只能使用 #hd 和 #contentID。 - **模板文件类型验证**：模板目录必须包含特定文件和文件夹，如 assets、modules、site.xml 及 JSON 文件。 SDK 2.0.0 的模板上传和打包验证规则旨在确保模板的质量和功能完整性，开发者在上传模板前必须严格遵循这些规则进行自检，以确保模板的顺利部署和良好运行。