npm-cli-package v1.0.0
NPM发布和使用命令行(CLI)工具
前言
在项目中我们经常会用到一些Node脚本命令来简化开发的工作量,例如Element的package.json
的npm 脚本命令build:file
(使用脚本生成Webpack的入口源文件)。简单的Node脚本命令可以解决当务之急,但是如果该Node脚本实现的功能相对复杂繁多,并且多人使用同一个脚手架生成的多个项目里有相同的Node脚本,则可能会产生以下问题:
- 对于长期的维护而言会变得相对困难
- 对于复杂的Node脚本,很难做到精准的版本控制,导致开发上沟通成本增加
- 将Node脚本植入脚手架对应的文件夹从而污染了原始文件夹是一件比较难以容忍的事情
- 如果Node脚本本身需要一些额外的依赖,那么脚手架还需要实时维护这些依赖的版本,导致脚手架可见的依赖增加
为了解决Node脚本命令产生的上述问题,可以采用NPM发布命令行(CLI)工具(具体可查看Creating and publishing unscoped public packages)的形式实现Node脚本命令的功能。
NPM包管理器
NPM包管理器允许用户将自己编写的包或命令行工具上传到NPM服务器供别人使用,开发人员只需要从NPM服务器下载并安装该命令行工具到本地即可使用。同时命令行工具可以通过更新NPM服务器上的命令行程序版本进行远程升级,开发人员可以再次通过NPM服务器更新命令行工具的版本进行工具升级。
发布的命令行工具可以实现本地项目依赖安装和全局安装两种方式。采用本地项目依赖安装会将发布的命令行工具加入开发态依赖列表,这不能解决项目依赖增加的问题,如果需要解决该问题,可以采用全局方式安装,从而将NPM命令行工具的命令链接到全局执行环境(此时Node脚本不会植入到项目中,而是存放在操作系统的用户文件夹中),实现工具命令的全局使用。
这里列举几个常见的命令行工具:
发布和使用命令行工具
命令行工具构建
首先新建NPM命令行工具的项目文件,使用npm init
命令创建package.json
命令行工具的描述文件,创建后的package.json
包含项目名称、版本、描述、项目入口文件(在发布命令行工具时并不需要main
字段信息,该信息主要用于发布依赖包而不是命令行工具)、作者信息等。执行npm init
:
PS C:\Users\ziyi2\Desktop\npm-demo> npm init
This utility will walk you through creating a package.json file.
It only covers the most common items, and tries to guess sensible defaults.
See `npm help json` for definitive documentation on these fields
and exactly what they do.
Use `npm install <pkg>` afterwards to install a package and
save it as a dependency in the package.json file.
Press ^C at any time to quit.
package name: (npm-demo)
version: (1.0.0)
description: NPM命令行工具示例
entry point: (index.js)
test command:
git repository: 如果关联远程仓库,会自动生成
keywords: npm cli
author: ziyi2
license: (ISC)
About to write to C:\Users\ziyi2\Desktop\npm-demo\package.json:
{
"name": "npm-demo",
"version": "1.0.0",
"description": "NPM命令行工具示例",
"main": "index.js",
"scripts": {
"test": "echo \"Error: no test specified\" && exit 1"
},
"repository": {
"type": "git",
"url": "如果关联远程仓库,会自动生成"
},
"keywords": [
"npm",
"cli"
],
"author": "ziyi2",
"license": "ISC"
}
Is this OK? (yes)
执行完后生成的package.json
描述文件如下:
{
"name": "npm-demo",
"version": "1.0.0",
"description": "NPM命令行工具示例",
"main": "index.js",
"scripts": {
"test": "echo \"Error: no test specified\" && exit 1"
},
"repository": {
"type": "git",
"url": "如果关联远程仓库,会自动生成"
},
"keywords": [
"npm",
"cli"
],
"author": "ziyi2",
"license": "ISC"
}
其次NPM命令行工具需要配置在PATH路径下的可执行文件,在package.json
里配置一个bin
属性(具体查看https://www.npmjs.com.cn/files/package.json/#bin),该属性对应的是可执行文件的路径(当使用`npm link或者全局安装命令行工具时,NPM会为
bin中配置的文件在
bin目录下创建一个软连接,对于Windows系统,默认会在
C:\Users{username}\AppData\Roaming\npm目录下,若是局部安装则会在项目的
./node_modules/.bin`目录下创建一个软连接)。
例如将bin
对应的可执行文件路径配置为当前项目下的src/index.js
:
"bin": {
// npm-demo是一个可执行的命令,该命令指向了`src/index.js`脚本(这里暂时还不清楚该脚本的解释器)
"npm-demo": "src/index.js"
},
配置bin
属性的模块路径后,可以开始设计可执行文件。为了使入口文件使用Node作为解释程序,需要在入口文件的头部写入#! /usr/bin/env node
,目的是使用env来寻找Node,并将Node作为程序的解释器(在env中包含了一些环境变量,包括我们安装的一些环境的路径等。在不同的操作系统中,我们安装Node的路径可能会有所不同,但是其环境变量会存在于env中,这里我们使用env来找到Node的执行路径。所以,env的主要目的就是让我们的脚本在不同的操作系统上都能够正常的被解释和启动)。例如在src/index.js
入口文件写入一个打印信息的Node脚本:
#! /usr/bin/env node
console.info('npm-demo:', '1.0.0')
NPM软链接
命令行工具构建完成后,接下来是测试该命令行工具能否被正常使用,此时可以通过npm link
命令将NPM命令行工具链接到全局执行环境,从而在系统的任意路径下都可以使用该NPM命令行工具。执行npm link
:
PS C:\Users\ziyi2\Desktop\npm-demo> npm link
up to date in 0.428s
C:\Users\ziyi2\AppData\Roaming\npm\npm-demo -> C:\Users\ziyi2\AppData\Roaming\npm\node_modules\npm-demo\src\index.js
C:\Users\ziyi2\AppData\Roaming\npm\node_modules\npm-demo -> C:\Users\ziyi2\Desktop\npm-demo
当执行npm link
后,可以看到在Windows系统下该命令主要做了两件事:
- 为NPM命令行工具的可执行文件(
package.json
文件的bin
属性所配置的可执行文件目录src/index.js
)创建一个软链接,将其链接到C:\Users\{username}\AppData\Roaming\npm\<package>
- 为NPM命令行工具所在代码目录(项目的具体路径,例如在以上示例中放在了用户桌面的
npm-demo
文件目录中)创建一个软链接,将其链接到C:\Users\{username}\AppData\Roaming\npm\node_modules\{package}
因此在全局环境执行<name>
命令时(pageage.json
中的name
字段,默认如果bin
不配置执行的命令名称时,使用name
字段作为命令,这里演示中将执行的命令名称配置成了npm-demo
),会启用Node去执行package.json
中bin
字段对应的可执行文件,此时可在任意位置执行npm-demo
命令:
PS C:\Users\ziyi2\Desktop> npm-demo
npm-demo: 1.0.0
可以发现在当前项目外的任意路径都可以使用该命令成功打印信息,说明Node解释器和软链接都设置成功。此时你也可以到用户目录C:\Users\{username}\AppData\Roaming\npm\node_modules
下查看npm-demo
包的软链接,并且可以在C:\Users\{username}\AppData\Roaming\npm
中找到npm-demo
(Shell)和npm-demo.cmd
(Cmd)两个可执行文件。
在真正设计CLI工具时,你可能需要一些额外功能的依赖,例如:
依赖名称 | 描述 |
---|---|
commander | 一个帮助快速开发Node.js命令行工具的依赖 |
chalk | 终端打印信息的颜色工具 |
babel-register | 对Node.js环境中require命令加载的文件进行babel转码 |
NPM命令行工具发布
通过npm link
以及命令行的使用测试,发现命令行工具没有任何问题,此时想将该工具分享给他人使用,可以利用NPM包管理器的发布机制。在发布命令行工具之前,需要在NPM官网注册账号,注册成功后,需要在命令终端中使用npm login
链接你注册的账号(npm login
会将账号登录的证书信息保存在本地电脑,从而不需要再次登录账号),同时会在npm的网站中生成你当前登录的token信息,登录后可以通过npm whoami
命令查看当前登录账号名。需要注意登录的时候不要使用NPM淘宝镜像地址,需要使用NPM官方地址,可以通过npm config set registry https://registry.npmjs.org/
命令设置成NPM官方的包发布地址。。
PS C:\Users\ziyi2\Desktop> npm login
Username: ziyi2
Password:
Email: (this IS public) 115840480@qq.com
Logged in as ziyi2 on https://registry.npmjs.org/.
PS C:\Users\ziyi2\Desktop> npm whoami
ziyi2
npm login
后会在npm官网产生token信息。
使用npm publish
命令发布命令行工具(因为这里已经有人发布了npm-demo
的包名称,因此采用npm-demo-ziyi2
包名):
PS C:\Users\ziyi2\Desktop\npm-demo> npm publish
npm notice
npm notice package: npm-demo-ziyi2@1.0.0
npm notice === Tarball Contents ===
npm notice 428B package.json
npm notice 58B src/index.js
npm notice === Tarball Details ===
npm notice name: npm-demo-ziyi2
npm notice version: 1.0.0
npm notice package size: 468 B
npm notice unpacked size: 486 B
npm notice shasum: 5ea45fcf9aa1868f992314148306abc710bd6d96
npm notice integrity: sha512-f1rziU3iaglgM[...]aZfAs314u9s7g==
npm notice total files: 2
npm notice
+ npm-demo-ziyi2@1.0.0
此时可以查看NPM官网中的个人账号信息,可以发现发布了该命令行工具的1.0.0
版本。
命令行工具下载安装
包的发布,主要是为了解决2中所描述的各种问题。所有开发者可以通过使用npm install –g对 进行全局安装(演示的demo也可以通过npm install npm-demo-ziyi2 –g进行全局安装),如图4-11和4-12所示。
图12 安装成功信息
由图4-11和4-12中的安装打印信息可以发现,最终命令行工具的软链接指向了C:users{username}\AppData\Roaming\npm\node_modules\下的可执行脚步文件。
命令行工具的使用
命令行工具包安装成功之后,可以在项目中使用指定的命令行工具,如图4-13所示是
图13 命令执行
总结
命令行工具如果有功能需要扩展,可以再次通过npm publish命令发布新版本的NPM包,此时其他开发者通过npm install全局安装的形式更新新发布版本的包,因此使用发布NPM包的形式可以使命令工具的版本升级和维护更方便。
参考文献
5 years ago