随着 Node.js 的“走红”，使用 Node.js 开发命令行工具越来越简单。一个成熟的命令行工具应该从一开始就要考虑好之后的版本更新如何“优雅”的告知用户。最好的方法当然是当用户在终端执行命令时，将相关信息提示给用户。
这篇文章将给出一个易用、高效、可定制的方法。源码在这里： GITHUB ，欢迎大家顺手点赞。接下来我将讲解其实现思路。
使用
我们先简单看看这个 npm 包的使用方法：
const updater = require('pkg-updater');
const pkg = require('./package.json'); // 命令行工具自己的 package 信息
updater({'pkg': pkg}) .then(() => { /* 在这里启动命令行工具 */ });
updater({
'pkg': pkg,
// 自定义 registry
'registry': 'http://xxx.registry.com',
// 自定义请求的 dist-tag，默认是 latest
'tag': 'next',
// 自定义检查间隔，默认是 1h
'checkInterval': 24 * 60 * 60 * 1000,
// 自定义更新提示信息
'updateMessage': 'package update from <%=current%> to <%=latest%>.',
// 自定义强制更新的版本更新级别，默认是 major
'level': 'minor'
}).then(() => { /* 在这里启动命令行工具 */ });
updater({
'pkg': pkg,
// 完全自定义版本更新时的逻辑
'onVersionChange': function* (opts) {
}
}).then(() => { /* 在这里启动命令行工具 */ });
效果如图：
实现
使用方法很简单，我们一起来看看其实现方法。
需求
我们先来梳理下需求，一个命令行检查更新器应该至少提供如下功能：
能从远程获取最新版本
能根据检查结果进行提示
在版本不兼容时可以直接退出，强制用户升级程序
获取版本
获取最新版本这个功能看起来很简单，就是发送一个请求从“某处”获取信息。但是有一些问题需要我们考虑：
从哪里获取版本信息？
获取版本信息的策略是怎样的？（什么时候获取？获取的信息如何处理？）
从哪里获取版本信息
我们的命令行工具一般都是使用 npm 进行分发，最简便的方法就是直接通过 registry 获取。通过请求 https://registry.npmjs.org/{name}/{dist-tag} 就可以得到 package 对应 tag 的版本信息。结果类似下面这样：
// https://registry.npmjs.org/co/latest
{
"name": "co",
"version": "4.5.0"
}
在实际实现时，我们应该允许调用者自定义 registry 地址、请求的 dist-tag 等，这样可以有更多的定制性。
获取版本信息的策略
首先想到的方法是用户每次执行命令时都去获取一次版本信息，这样的获取策略应该是最简单和实时的。
但是这个策略其实并不合适：
每次执行命令都要去发请求进行检查，如果网络延迟，会阻塞命令执行，影响用户体验
工具的版本更新其实并不会很频繁，没有必要进行实时检查
网络请求的影响因素很多，不能保证每次都成功，应该提供本地缓存机制来存储请求成功的结果，避免版本信息的不可用
综合上面的几点，我们设计如下的获取策略：
将发送网络请求获取版本信息的逻辑放在一个独立的后台进程去执行，保证不阻塞主命令执行
请求成功后将版本信息、检查时间缓存到用户机器
每次执行命令时，只是读取本地缓存下来的版本信息，不去发送网络请求
根据缓存下来的检查时间和当前时间，在一个间隔之内不去额外创建后台检查进程
将上面的策略翻译成代码大概就是下面这样：
// 读取本地缓存的检查结果
const checkInfo = yield updater.readCheckInfo(opts);
const lastCheck = checkInfo.lastCheck;
const lastVersion = checkInfo.lastVersion;
// 根据版本信息提示用户
// ...
// 在时间间隔内，直接返回
if (Date.now() - lastCheck < opts.checkInterval) {
return;
}
// 创建后台检查进程
try {
require('child_process').spawn(
process.execPath,
[require('path').join(__dirname, '_check.js'), JSON.stringify({
'pkg': opts.pkg, // package 信息
'tag': opts.tag, // 检查的 dist-tag
'logFile': opts.logFile, // 缓存文件路径
'registry': opts.registry // registry 地址
})],
{'stdio': ['ignore', 'ignore', 'ignore'], 'detached': true}
).unref();
} catch(e) {}
后台进程执行的 _check.js 文件也很简单，如下所示：
const opts = JSON.parse(process.argv[2]);
let lastVersion = '';
try {
// 发送请求获取最新版本
const url = normalizeUrl(opts.registry + '/' + opts.pkg.name + '/' + (opts.tag || 'latest'));
const res = yield got.get(url, {
'json': true,
'timeout': 60 * 1000
});
if (res && res.body && res.body.version) {
lastVersion = res.body.version;
}
} catch(e) {}
// 如果获取失败了，最新版本就是当前版本（package.version）
if (!lastVersion) {
lastVersion = opts.pkg.version;
}
let data = yield util.readJson(opts.logFile);
if (!data[opts.pkg.name]) {
data[opts.pkg.name] = {};
}
data[opts.pkg.name].lastVersion = lastVersion; // 最新版本
data[opts.pkg.name].lastCheck = Date.now(); // 检查时间
// 写入缓存
yield util.writeJson(opts.logFile, data);
提示
当版本更新了，我们应该在终端提示用户。这里有两个问题：
提示文案的问题
提示文案显示间隔的问题（一直显示？每隔一段时间显示？）
这里我们采取的策略是：
提供默认提示文案，清晰的说明当前版本、最新版本、更新方法，允许调用者自定义提示文案
只要有更新就一直显示提示文案，因为我们希望用户经常的进行更新
实现代码大概如下：
// 比对版本
const type = updater.diffType(opts.pkg.version, lastVersion, opts.level);
if (type) {
// 根据模板渲染提示信息
const str = updater.template(opts.updateMessage || updater.defaultOpts.updateMessage)({
'colors': updater.colors,
'name': opts.pkg.name,
'current': opts.pkg.version,
'latest': opts.lastVersion,
'command': 'npm i -g ' + opts.pkg.name
});
// 进行提示
console.log(
updater.boxen(str, {
'padding': 1,
'margin': 1,
'borderStyle': 'classic'
})
);
}
强制升级
对于 npm 模块来说，版本 a.b.c 的更新一般有三种情况：
patch：c 位，小版本更新，一般是 bug 修复
minor：b 位，中版本更新，一般增加新功能、bug 修复
major，a 位，大版本更新，一般是不兼容的升级
我们希望当远程版本的更新如果是 major 形式，命令行工具将直接退出，强制用户进行升级后才能使用。这可以保证我们推送一个大版本后，所有的用户都能够马上更新掉，而不是继续使用老版本，造成版本碎片的问题。
实现代码大致如下：
// 比对版本
const type = updater.diffType(opts.pkg.version, lastVersion, opts.level);
if (type) {
// 根据模板渲染提示信息
const str = updater.template(opts.updateMessage || updater.defaultOpts.updateMessage)({
'colors': updater.colors,
'name': opts.pkg.name,
'current': opts.pkg.version,
'latest': opts.lastVersion,
'command': 'npm i -g ' + opts.pkg.name
});
// 进行提示
console.log(
updater.boxen(str, {
'padding': 1,
'margin': 1,
'borderStyle': 'classic'
})
);
// 不兼容的更新，直接让进程退出
if (type == 'incompatible') {
process.exit(1);
}
}
总结
命令行检查更新看似简单，其实仔细思考，还是有很多细节。希望这篇文章对你有所启发。
免责声明：本站文章均来自网站采集或用户投稿，网站不提供任何软件下载或自行开发的软件！ 如有用户或公司发现本站内容信息存在侵权行为，请邮件告知！ 858582#qq.com
这一波大模型产业落地浪潮里，不少企业其实处在 “干瞪眼“的状态。
一种情况是，很多大模型产品看得见却摸不着，在台上一个个遥遥领先——今天Sora技精四座，明天英伟达的机器人又赢得满堂彩，可是到了台下一问：啥时候能用上啊？答曰：遥遥无期。
另一种情况是，企业想用上大模型，却又难免瞻前顾后——既要考虑场景融合，又得兼顾安全性，还要考虑打通现有系统，再加上各种部署成本和繁琐的采购流程……最后只能拂袖：罢了，再等等吧。
稳了！魔兽国服回归的3条重磅消息！官宣时间再确认！
昨天有一位朋友在大神群里分享，自己亚服账号被封号之后居然弹出了国服的封号信息对话框。
这里面让他访问的是一个国服的战网网址，com.cn和后面的zh都非常明白地表明这就是国服战网。
而他在复制这个网址并且进行登录之后，确实是网易的网址，也就是我们熟悉的停服之后国服发布的暴雪游戏产品运营到期开放退款的说明。这是一件比较奇怪的事情，因为以前都没有出现这样的情况，现在突然提示跳转到国服战网的网址，是不是说明了简体中文客户端已经开始进行更新了呢？