完成物料集下所有物料的开发和发布之后,需要生成这个物料集合的物料数据,请确保所有物料都已发布,发布流程可看上一章《物料开发》。
生成物料数据只需在物料仓库根目录下执行以下命令即可:
$ iceworks generate
1
iceworks 会遍历所有物料,批量查询每个物料的 npm 信息,并将这些信息结构化后存储到 build/materials.json
文件中,这一步需要消耗一定时间,请耐心等待。
以 ice 官方 React 物料为例(地址:materials.json (opens new window)),materials.json
包含以下字段:
- type:指定物料类型,来源自
package.json
中的materialConfig
,例如: react、vue、angular、bootstrap 等 - name:物料名称,来源自
package.json
中的name
- components:包含所有组件信息的数组
- blocks:包含所有区块信息的数组
- scaffolds:包含所有项目模版信息的数组
- description:(可选)物料描述,来源自
package.json
中的description
- logo:(可选)物料品牌 logo,来源自
package.json
中的materialConfig
- homepage:(可选)物料主页,来源自
package.json
中的homepage
- author:(可选)物料作者,来源自
package.json
中的author
除可选的字段外,其他字段都是必不可少的。物料数据生成后,请检查是否包含必选的字段。
对于 components、blocks、pages 和 scafflods 下的每一个元素,也有特定的物料数据协议需要遵守,否则无法在 AppWorks 中正常使用,具体数据协议可参考 《物料数据协议》。