进阶 oclif.io 2026-10-18 02:37:03 · 20 阅读

第4章 oclif 当前 Node 支持策略详解:CI 配置与 Node 8 弃用指南

oclif 对 Node 版本的支持策略 2019 年 10 月 31 日 · 阅读时间 3 分钟 为了保持项目的健康演进,oclif 遵循并支持 Node Active LTS 版本,当前对应的是 Node 10 和 Node 12。这意味着我们要确保 oclif 能与即将到来的 Active LTS Node 版本以及生态系统中的其他包良好协作。向前迈进也意味着我们要逐步放弃对旧版本的支持。从 2020 年开始,Node 官方将停止维护 Node 8,届时我们也计划停止支持该版本。让我们看看我们将如何支持这一变化。 CI 环境 未来使用 oclif cli 创建的命令行工具将自动生成包含 Node 10 和 12 的 CircleCI 配置,以及使用 Node 10 的 Appveyor 配置。我们还在 CircleCI 中加入了 Node latest 环境,以便在 Node 版本发生变更时进行早期预警(Node latest 由 CircleCI 管理)。 我们已经更新了所有 oclif 仓库的 CI 配置以反映这些变化。 如果你的现有 CLI 使用 Appveyor 或 CircleCI,也可以相应地更新配置文件,如下所示: .circleci/config.yml 你的 CircleCI 配置应包含一个别名为 test 的 node-latest 任务。在此基础上,应有两个基于该任务扩展出来的配置,分别对应 Active LTS Node 版本 Node 10 和 Node 12。 node-10:
<<: *node-latest
docker:
- image: node:10
node-12:
<<: *node-latest
docker:
- image: node:12
请注意,这些声明仅更改了用于运行该任务的 Docker Node 镜像。 此外,workflows 中列出的任务也必须更新以反映配置的变化: jobs:
- node-latest
- node-10
- node-12
appveyor.yml 在 Appveyor 上,我们目前仅测试最旧的 Active LTS Node 版本,即 Node 10。请在 appveyor.yml 文件中更新 nodejs_version 属性以反映此设置。 environment:
nodejs_version: "10"
弃用 Node 8 并更新 package.json 的 engines 字段 2020 年 1 月,Node 8 将停止维护。oclif 也将随之把包中 package.json 的 engines 字段设为 >=10,并提升包的主版本号。 根据 CLI 的发布方式,你可能也需要在自己的 CLI package.json 中同步提升 engines 版本。关于 engines 配置的具体影响,可以参阅 npm 文档。 另外也可以考虑让 CLI 自带独立版本的 Node。 打包时的 Node 版本 使用 dev-cli 打包 CLI 时,会使用 package.json 中 oclif.update.node.version 字段指定的 Node 版本。该值应设为处于 Active LTS 阶段的 Node 版本(dev-cli 目前不会强制校验版本)。 面向未来的支持 在升级过程中,社区可能会遇到一些问题。如果发现与 oclif 相关的问题,欢迎在组织内对应的 oclif 包下提交 issue 或 pull request。 我们期待引入 Node 和社区带来的最新特性,并持续保持 oclif 的健康稳定。

评论 (0)