1、创建package.json文件
参考npm文档:如何创建 Node.js 模块
特别注意!!!模块的名称一定要在npm搜索不到的才可以,一定要起一个不重名的模块名称。
$ md xxx-plugin // 创建插件项目文件夹
$ cd xxx-plugin // 进入新建项目目录
$ npm init // 创建package.json文件
// 进入配置操作
package name: (xxx-plugin) // 插件名
version: (1.0.0) // 插件版本
description: // 插件的作用描述
entry point: (index.js) // 插件入口
test command: // 测试脚本
git repository: // git地址(可以先不填)
keywords: // 关键词
author: // 作者
license: (ISC) // 许可证
此处入口文件(entry point)默认设置的index.js,在xxx-plugin文件夹下新建index.js文件如下:
exports.printMsg = function() {
console.log("This is a message from the demo package");
}
这个最简单的模块就完成了
2、需要一个npm账号
打开npm官网:https://www.npmjs.com/。按流程注册账号,注册好了之后注册邮箱会收到激活邮件,一定要激活,不然发布模块时会报错,提示激活邮箱。
3、npm里添加用户
$ npm adduser // 添加账户
之后按需输入上一步注册的账户名、注册邮箱、登陆密码。
想检查是否添加成功,如下:
$ npm whoami // 查询当前账户
如果添加账户时发现镜像地址不对,是淘宝或者其他地址,怎么办?
推荐安装nrm查看npm的镜像源
https://www.npmjs.com/package/nrm
$ npm install -g nrm // 安装nrm镜像源管理工具
$ nrm ls // 查询npm镜像源,*为当前镜像源
$ nrm use npm // 切换为npm原始镜像
$ nrm -h // 帮助文档
$ nrm -V // 版本
4、发布node模块
以上都完成了,就可以在xxx-plugin目录下发布模块了。
再次提醒,模块名称必须是npm上唯一的,才能发布成功。
$ npm publish // 发布包到npm官方库
发布成功后,在npm官网就能搜索到刚才自己发布的模块了。
撤销已发布的模块,同名模块发布需要24小时间隔。
5、测试新模块
新建项目,安装模块
$ md new-project // 创建项目文件夹
$ cd new-project // 进入项目目录
$ npm install test-plugin // 安装刚发布的插件
此时new-project -> node_modules文件夹下应该就有自己的node模块test-plugin了。
项目根目录下新建test.js文件,引入新模块:
const plugin = require('test-plugin');
plugin.printMsg()
运行test.js:
$ node test.js
This is a message from the demo package
得到这条message就代表模块运行成功啦!~
6、本地开发:调试和测试
在本地开发npm模块的时候,我们可以使用npm link命令,将npm模块链接到对应的运行项目中去,方便地对模块进行调试和测试。推荐阅读以下文章:
npm link的使用
7、npm开发其它常用命令
$ npm login // 发布包时登录npm账号用的
$ npm publish // 发布包到npm官方库
$ npm unpublish xxx // 撤销已发布的xxx包
$ npm unpublish xxx --force // 强制撤销xxx包
$ npm unpublish xxx@1.0.2 // 撤销xxx包的1.0.2版本
$ npm link // 全局安装当前目录的包
$ npm unlink // 全局卸载当前目录的包
网友评论