nodejs模块发布及命令行程序开发
前置技能
- npm工具为nodejs提供了一个模块和管理程序模块依赖的机制,当我们希望把模块贡献出去给他人使用时,可以把我们的程序发布到npm提供的公共仓库中,为了方便模块的管理,npm规定要使用一个叫package.json的文件来描述我们模块的名称、版本等信息。
- 我们贡献出去的程序模块,可能也依赖了别人所编写的模块,所以需要在package.json中写明我们依赖了哪些模块,便于别人安装。
- 简单的nodejs程序可以通过 node xxx.js 来运行,当我们希望直接在控制台中使用xxx命令运行nodejs程序时,需要创建一个cmd命令文件(windows下),并把它放到path路径下,npm提供了一个自动完成这个工作的流程,这个也是在package.json里边配置的。
基于以上几点,我觉得有必要挨个理解一下package.json里边的配置项:我理解翻译的package.json文档
模块发布
发布一个npm模块非常简单。
注册npm账户
这个账户注册体验多好啊,不过记得密码别搞忘记了。
npm adduser
Username: zoucz
Password: ******
Email: 405966530@qq.com
创建一个测试模块
新建一个文件夹,npm init,一路enter ,要注意的是name不能是已经被别人抢占的,可以到http://npmjs.org这里查询。
此时文件夹下会生成一个package.json文件,如果看过package.json里边配置的含义,这里就比较好理解了。
新建一个index.js,内容如下:
此时模块就创建完毕了,简单吧!
发布模块
在刚刚新建的文件夹下打开cmd,运行npm publish ,模块发布完毕!
要注意的是每次发布的时候都需要增加版本号。
此时在http://npmjs.org这里就可以查询到刚刚发布的模块了,我测试模块名称是zoucz,那么此时别人也可以通过 npm install zoucz来使用我发布的模块了。
开发控制台命令程序
以windows下为例,我们怎么样才能创建一个cmd命令呢?
1.在环境变量里边添加一段:";D:/test"
2.在d盘test目录下创建一个mycmd.cmd文件
这时就可以使用mycmd命令了。那么要怎么在cmd中调用node程序呢? 很简单:
3.在那个mycmd.cmd文件里边写上 node path/to/xxx.js,就可以了。
使用npm创建控制台命令程序,我们不需要自己完成上面的步骤,只需要增加一行配置就可以了
添加要执行的nodejs代码文件
在模块根目录下添加bin目录
新建zoucz.js内容如下:
#!/usr/bin/env node
var util=require("util");
console.log("hello,i'm zouchegnzhuo,you can type command name/site/email");
var cmd=process.argv[2];
if(cmd){
switch(cmd){
case "name":
console.log("邹成卓");
break;
case "site":
console.log("http://zoucz.com");
break;
case "email":
console.log("405966530@qq.com");
break;
}
}
要注意的是,文件首行的 #!/usr/bin/env node 一定要添加 ,这一行的意思是生成cmd文件的时候用什么路径的什么程序来运行上面的代码,文章末尾的demo中给出了不加的后果。
在package.json中配置bin
在package.json中配置
模块在npm install的时候会生成zoucz和zoucz_err两个cmd文件。
发布模块
添加好上面的配置后,发布模块,别的码农就可以安装使用此命令了。
安装使用控制台命令程序
在cmd中 npm install -g zoucz ,就可以安装上面的模块,安装完成后可以使用zoucz命令和zoucz_err命令。
zoucz_err是没有在js文件首行写#!/usr/bin/env node的后果:
运行命令之后:
我们顺着图片中的路径,在C:\Users\czzou\AppData\Roaming\npm目录下可以找到npm为我们创建的cmd文件路径:
可以看到npm创建cmd文件的同时也创建了linux下使用的文件。
现在来看一下为什么执行zoucz_err会报错,分别打开两个cmd文件:
zoucz.cmd
zoucz_err.cmd
后者压根就没有用node去执行那段代码,当然会报错了~
这里要注意的是npm install -g 全局安装的时候,cmd文件是被创建在上面的路径下的,如果没有-g选项,局部安装,则会被创建在项目根目录node_modules/.bin 目录下。
最后
npm可以帮我们做很多事情,做node开发的同学们都有必要花时间慢慢把npm的文档啃完https://docs.npmjs.com
本文所使用的demo地址:https://github.com/zouchengzhuo/nodejsLearn/tree/master/zoucz
本文转自我的个人网站,原文地址,欢迎前往交流讨论