# 一、工具的作用
移动端H5的代码原则上是一套源代码，通过S3工具编辑后，能生成多端运行的代码。本质就是通过此工具将html、s3js、css三种后缀文件中的类似 ${data:dependencies.cmp} 这种格式的静态资源路径进行一个替换，如：
PS：如果不通过此工具构建，相关的html、js、css是无法用程序运行的
# 二、支持的构建标签
| 序号 | 标签 | 说明 |
|---|---|---|
| 1 | ${data:dependencies.cmp} | 常见的标签，对应单个应用模块的路径 |
| 2 | <s3:import type="css"></s3:import> | 对于一些有共性的页面元素，可以抽取成组件模板，编辑的时候会将此标签对应的模型进行替换，相当于PC端JSP页面的include |
| 3 | <s3:data name='CollDatas.headerScript' /> | 同上，只是共性的模型更聚焦，比如此处就是协同模块的头部script标签的统一导入，因为在协同模块的每一个页面都会有这样的模板元素 |
| 4 | ${data:buildversion} | 对js、css等静态资源添加后缀，用于版本控制，更重要的是清除浏览器静态资源缓存 |
# 三、工具的获取
1、下载：点击此链接下载工具[[S3工具下载链接|attach:S3Script.zip]] 2、安装：将文件解压到任何目录都可以使用 PS：有点不太友好的是此工具不支持苹果操作系统
# 四、工具的使用
# 1、认识工具的组成结构
【java】：该工具由java语言开发，相关的功能使用由jar在此文件夹中，开发者无需关注此文件夹
【publishcmd】：应用构建脚本集合，所有的H5应用微协同版本和M3应用zip包版本的脚本集合，根据配置信息启动工具构建不同的静态文件版本
【publishoutput】：构建完成后的可运行文件的输出目录,此目录构建出来的文件是可以直接运行的
【workspace】：项目源码的开发路径，此文件夹的路径，开发者最好按照此文件夹结构将开发项目源码导入进去，这样减少其他的学习成本
【文档】：此工具的一些说明性文档，开发者可以不用过多关注
【batchbuild.cmd】：批量构建脚本，通过配置可以将多个模块进行构建，可以同时构建出zip包和微协同模式的运行代码，一般用于某个开发者同时涉及多个应用模块的开发，开发者关注此文件
# 2、batchbuild 批量构建脚本
# 3、publishcmd 文件夹
此文件夹已经将62个标准应用的微信同模式和M3应用包模式的脚本进行了预置，后续如果开发者有新增模块，只需在对应的应用模块组里添加cmd文件即可，再在batchbuild中添加模块名称进行构建即可
# 五、规范
为减少工具学习成本，开发者最好按照文件夹结构来做工程源码文件夹结构和输出路径文件夹结构配置，这样只需按照规范来，就可以简简单单地完成源码开发、构建输出、代码调试查看的流程
