基于plop生成前端工程

基于plop自定义前端vue脚手架，plop是生成脚手架的框架。

plop-vue-cli演示.gif

案例npm地址

https://www.npmjs.com/package/plop-vue-cli

一、安装依赖

安装plop脚手架生成框架

npm i plop --save

安装download-git-repo，能从git等下载代码的工具，用于下载模版。

npm i download-git-repo --save

二、上代码

1、plop 配置（plopfile.js）

plopfile.js文件作为低层节点模块开始其生命周期，该模块输出一个接受该plop对象作为其第一个参数的函数。

module.exports=function(plop){// 自定义动作类型plop.setActionType('getTemplate',function(answers,config,plop){// 具体实现-省略...console.log("下载模版中...");returntrue;});// 注册plop.setGenerator('CreateVue',{// 描述description:'Create my vue project.',// 交互：提问-回答prompts:[{type:'input',// 输入值类型：Stringname:'projectName',// 获取输入值的keymessage:'Please input your project name.'// 问题描述}],// 执行操作。actions:function(){// 项目路径varbasePath=process.cwd()+'\\\\{{projectName}}\\\\'return[{// 自定义操作type:'getTemplate',// 执行自定义getTemplate类型动作speed:'slow'// 执行操作为异步时，添加该字段值},{// 新增文件操作type:'add',// 操作类型,(add：新增文件，addMany：新增多个文件，modify：修改文件，append：追加)path:"./src/test.js",// 目标文件路径templateFile:"./temp/test.hbs",// 模版文件路径force:true,// 是否强制执行该动作，（当目标文件已存在时，true则会覆盖该文件， false则不新增跳过）verbose:true// 打印每个操作成功的文件路径}]}});};

plop对象公开包含setGenerator(name, config)函数的plop api对象。这是用来（等待）为该plopfile创建生成器的函数。当plop从该目录（或任何子目录）在终端上运行时，将会显示prompts这些交互列表，最终执行actions操作列表。

主要方法和参数看plop的官方文档吧

2、下载模版代码（plopfile.js）

模版文件代码也可以放在工程里面，但是建议还是git等平台上，便于后期维护，不至于修改一下模版就发布一次脚手架。

所有这里用到的是download-git-repo工具来从git下载模版代码。

/**

* 异步获取模版

* @param {*} path

* @param {*} callback

*/functiongetTemplate(path,callback){// clone git代码模版，不加分支时，默认master。download('direct:https://github.com/JumplyCode/plop-vue-cli-template.git',path,{clone:true},callback);}

3、如何编写模版

如何通过交互获取的值，进行编写模版。编写模版 plop采用的是handlebars.js模版引擎来操作，通过预编译.hbs文件来构建Web模板。

使用方法是加两个花括号{{value}}, handlebars模板会根据当前上下文自动匹配相应的数值、对象甚至是函数。

constPUBLICPATH='web-{{projectName}}';// 上下文

假如交互时，projectName我输入的值是test，则编译后的模版就变成：

constPUBLICPATH='web-test';// 上下文

模版生成之后就会根据actions中的类型（type），或者新增或者修改文件等等。

plop 配置（plopfile.js）【完整】

vardownload=require('download-git-repo');varrm=require('rimraf').sync;constnodeFs=require('fs');constcfg=require("./config");/**

* 异步获取模版

* @param {*} path

* @param {*} callback

* 删除文件

* @param {String} filePath 文件路径

*/functiondeleteFile(filePath){try{rm(filePath);returntrue;// callback(null, `删除 ${filePath} 成功`)}catch(e){returnfalse;}}/**

* 交互：询问-输入

* 1、请输入项目名称（projectName 【String】）

* 2、是否需要vuex缓存数据（isStore 【Boolean】）

* 3、是否需要用户信息（isUser 【Boolean】）

* 4、是否需要代理信息

*//**

* 执行动作

* 1、下载模版并创建项目

* 2、根据填写内容，配置package.json

* 3、配置vue.config.js

* 4、配置src/main.js

* 6、清除.hbs文件

*/module.exports=function(plop){// 自定义动作类型-下载模版plop.setActionType('getTemplate',function(answers,config,plop){// do something// getTemplate();console.log("下载模版中...");varpath=process.cwd()+"\\"+answers.projectName||"vueDemo";returnnewPromise((resolve,reject)=>{getTemplate(path,function(error,data){if(error){reject('模版下载失败：'+error);}else{resolve('下载模版完成.');}});});});// 自定义动作类型-删除hbs文件plop.setActionType('deleteHbs',function(answers,config,plop){varbasePath=process.cwd()+"\\"+answers.projectName||"vueDemo";varisStore=answers.isStore;// var isUser = answers.isUser;returnnewPromise((resolve,reject)=>{try{vartemplates=cfg.templates;// 删除hbs文件for(varkeyintemplates){varfilePath=basePath+"/"+templates[key];deleteFile(filePath);}// 如果不需要vuex，则删除store文件if(!isStore){varstorePath=basePath+"/src/store"deleteFile(storePath);}//删除 package-lock.json 缓存文件deleteFile(basePath+"/package-lock.json");resolve('完成.');}catch(e){reject('hbs模版删除：'+error);}});});// controller generator// 注册plopplop.setGenerator('CreateSmyVue',{// 描述description:'Create smy vue project.',// 交互prompts:[{type:'input',// 输入值类型：Stringname:'projectName',// 获取输入值的keymessage:'Please input your project name.',// 问题描述description:'输入项目名',validate:function(input){// Declare function as asynchronous, and save the done callbackvardone=this.async();if(input){if(nodeFs.existsSync(process.cwd()+'/'+input)){done("项目名已存在")}done(null,true)}else{done("请输入项目名")}}},{type:'input',// 输入值类型：Stringname:'projectName_ch',// 获取输入值的keymessage:'Please input your project name for Chinese.',// 问题描述default:"项目名称",description:'输入项目的中文名',},{type:'confirm',// 输入值类型：Booleanname:'isStore',// 获取输入值的keymessage:'Do you need a vuex?',default:true,description:'是否需要vuex（缓存）',},{type:'input',// 输入值类型：Booleanname:'proxy',message:'Please enter your api proxy address.',default:"https://www.baidu.com",description:'输入后端接口代理地址',}],// 执行操作actions:function(){// 项目路径varbasePath=process.cwd()+'\\\\{{projectName}}\\\\'return[{type:'getTemplate',// 执行自定义的类型动作speed:'slow'},{type:'add',// 操作类型：新增文件path:basePath+cfg.files.packageJson,// 目标文件templateFile:basePath+cfg.templates.packageJson,// 源文件（模版文件）force:true,// 是否强制执行该动作，（当目标文件已存在时，true则会覆盖该文件， false则不新增跳过）verbose:true// 打印每个成功添加的文件路径},{type:'add',path:basePath+cfg.files.vuConfigJs,templateFile:basePath+cfg.templates.vuConfigJs,force:true,verbose:true},{type:'add',path:basePath+cfg.files.mainJs,templateFile:basePath+cfg.templates.mainJs,force:true,verbose:true},{type:'deleteHbs',speed:'slow'}]}});};

这时候基本完成通过命令行交互生成自己的工程了，只要在plopfile.js配置文件的目录下，执行plop命令，就可以开始生成之路了。

but，但是我想像vue-cli一样，全局安装vue-cli之后，不管在哪执行“vue create hello-world”命令都可以生成vue工程。

三、自定义脚手架成神之路

1、配置package.json

配置package.json，为发布npm做准备。

{"name":"plop-vue-cli","version":"0.0.1","main":"plopfile.js","license":"MIT","keywords":["plop-vue-cli","cli","vue","plop"],"scripts":{"test":"echo \"Error: no test specified\" && exit 1","plop":"plop",},"author":"作者","description":"npm描述","bin":{"create-plop-vue":"bin/index.js"},"dependencies":{"download-git-repo":"^3.0.2","plop":"^2.7.4"}}

主要字段

name：上传npm后的名称

bin：定义命令行命令，执行该命令行时会执行到对应的脚本文件。命令执行：create-plop-vue，则会执行bin/index.js文件。

2、配置bin/index.js，使其启动plop

#!/usr/bin/env nodeconstargs=process.argv.slice(2);const{Plop,run}=require('plop');constargv=require('minimist')(args);constpath=require('path');Plop.launch({cwd:argv.cwd,configPath:path.resolve(__dirname,"../plopfile.js"),// 当前依赖包文件路径下的plopfile.js文件require:argv.require,completion:argv.completion},run);

npm发布

1、登录npm

npm login

2、发布代码（更新）

npm publish

作者：有点皮的小黄皮

链接：https://www.jianshu.com/p/e5e115805d85

来源：简书

著作权归作者所有。商业转载请联系作者获得授权，非商业转载请注明出处。