简介
cmaki 是一个基于 Node.js 开发的 npm 包,旨在提供一个易于使用的自动化构建工具,可以帮助前端工程师更快地创建项目。该工具对 Node.js 的本地包管理器 npm 进行封装,提供了一些常用的工程建设操作,如创建项目、生成模块、安装依赖等,并提供模板定制功能,方便开发人员根据具体需求创建项目结构。
安装
全局安装 cmaki:
npm install -g cmaki
在命令行中使用 cmaki
命令,如果正常输出版本信息,则安装成功。
基本语法
以下是 cmaki 中常用的命令语法:
cmaki [command] [options]
其中 command
可以是以下命令:
- create:创建新项目。
- generate:生成新的模块。
- install:从 package.json 中安装已有依赖包。
- add:添加新的依赖包。
- remove:移除已有依赖包。
options
对应具体命令的不同选项,如:
--template
指定创建项目时要使用的模板。--module
指定要生成的模块名称。--version
指定要安装的依赖包版本。
创建新项目
使用 create
命令可以创建新项目:
cmaki create [project_name] [options]
其中 project_name
是项目名称,options
可以是以下选项:
--template
指定项目模板,该选项默认值为default
,即默认模板,当然你也可以创建自己的模板,后文将介绍该功能。--author
项目作者信息。--license
项目使用的开源协议类型。
例如:
cmaki create myProject --template react --author "John Doe"
以上命令将使用 react 模板创建一个名为 myProject 的项目,项目作者为 John Doe。
生成新模块
使用 generate
命令可以生成新的模块:
cmaki generate [module_name] [options]
其中 module_name
是模块名称,options
可以是以下选项:
--force
如果有重名模块,是否覆盖,默认为false
。--template
指定模块模板。
例如:
cmaki generate myModule --template react
以上命令将生成一个名为 myModule 的 react 模块。
定制模板
cmaki 支持自定义模板,即创建自己的项目和模块模板。可以通过 --template
选项来指定使用自定义模板。自定义模板可以是一个包含项目或模块所有文件的文件夹,也可以是一个使用类似 ejs 语法的模板文件。
以下是使用模板自定义项目的步骤:
- 创建自己的模板文件夹,该文件夹应该包含项目中用到的所有文件和文件夹。以下是一个示例,该模板用于创建一个基于 react 的博客网站项目:
-- -------------------- ---- ------- --------- --- --- - --- ---------- - - --- ------ - - --- ------- - - --- --- - --- ----- - - --- ------- - - --- -------- - - --- --- - --- ------ - - --- -------- - - --- --- - --- -------- - --- --------- - --- --- --- ------ - --- ---------- - --- -------- - --- --- --- ------------
- 在模板文件夹下创建一个名为
cmaki.json
的文件,用于定义模板信息:
{ "name": "React Project Template", "description": "A react project template for cmaki", "author": "John Doe", "license": "MIT" }
- 将模板文件夹打包成一个压缩包(.zip 或 .tar),并上传到 npm 上。注意模板文件夹应该直接位于压缩包的根目录。例如,上传后的压缩包应该是这样的:
-- -------------------- ---- ------- ---------------------------- --- --------- - --- --- - - --- ---------- - - --- - --- ------ - --- - --- ------------ --- ------------
- 在创建项目时,使用
--template
选项指定模板名称和版本即可:
cmaki create myProject --template myProject-template@1.0.0
总结
cmaki 是一个非常方便的自动化构建工具,能够帮助前端工程师更快更高效地创建项目,并提供了定制模板的能力。希望这篇文章能够让读者更好地了解 cmaki 的使用方法。
示例代码:https://github.com/cmaki-io/cmaki-examples
来源:JavaScript中文网 ,转载请注明来源 https://www.javascriptcn.com/post/60055fe881e8991b448dd8c6