管理涉及多个相互依赖的包的大型 javascript 或 typescript 项目对于开发人员和开发团队来说可能是一项重大挑战。通常,开发人员依赖每个包的多个存储库,这会导致代码维护、依赖项管理和协作方面的开销。
lerna 是一个为管理 monorepos 开发的强大工具,它简化了这个过程。 monorepos 使团队能够在单个存储库中托管多个包,从而简化依赖关系管理并使团队之间的协作更加顺畅。
这本电子书旨在提供使用 lerna 有效管理您的 monorepos 的完整指南。无论您是处理组件库还是具有多个互连包的大型项目,您都会发现有价值的见解,帮助您通过 lerna 最大限度地提高生产力。
lerna 是一个开源工具,有助于管理 monorepo 中的多个包。它提供了强大的功能,例如自动依赖管理、版本控制和发布,使大规模维护 javascript 和 typescript 项目变得更加容易。
立即学习“Java免费学习笔记(深入)”;
monorepos 是许多大型项目的架构选择,因为它们提供了多种好处:
尽管有这些好处,管理单一存储库也会带来独特的挑战,特别是在管理依赖项和版本控制方面。 lerna 旨在正面应对这些挑战,为 monorepos 提供优化的工作流程。
开始之前,请确保您已安装 node.js 和 npm(或 yarn)。 lerna 与 npm 和 yarn 兼容。
您可以通过 npm 在全局安装 lerna:
npm install --global lerna
或者,您可以将 lerna 添加为项目中的开发依赖项:
npm install --save-dev lerna
安装后,通过导航到项目目录并运行来初始化您的 monorepo:
lerna init
这将创建必要的配置文件,包括 lerna.json,并设置一个包文件夹来存放您的各个包。
在 lerna 项目中,每个包都位于 packages 下自己的子文件夹中。每个包必须有自己的 package.json 文件用于依赖管理。
示例结构:
/my-project /packages /package-a /package-b lerna.json package.json
管理多个包之间的依赖关系是 lerna 的核心优势之一。
lerna 允许您向特定包添加依赖项。例如,如果只有 package-a 需要 lodash,则可以运行:
lerna add lodash --scope=package-a
当多个包共享依赖项时,您可以将这些依赖项提升到 monorepo 的根目录。这减少了冗余并加快了安装速度。要启用提升,请将其添加到 lerna.json:
{ "hoist": true }
要安装相互依赖的依赖项和链接包,请运行:
lerna bootstrap
这可确保安装所有必需的外部依赖项,并且包可以正确地相互引用。
lerna 可以轻松地在 monorepo 中的所有包中执行脚本(例如构建、测试、lint)。
要在所有包中运行诸如构建之类的脚本,请使用:
lerna run build
如果您只想运行某些包中的脚本,请使用 --scope 标志:
lerna run test --scope=package-a
这种灵活性可以实现更有针对性的执行,从而节省开发时间。
lerna 提供强大的版本控制和发布功能,使您可以轻松版本和发布软件包。
在固定模式下,所有包共享相同的版本号。当任何软件包更新时,所有软件包的版本号都会增加。
独立模式下,每个包都有自己的版本号。当软件包发生更改时,仅更新该软件包的版本。
要切换到独立模式,请修改lerna.json:
{ "version": "independent" }
要将包发布到 npm,请运行:
lerna publish
lerna 将根据您的配置处理版本控制和发布。
将 lerna 与 yarn workspaces 相结合可以通过提升更多共享依赖项来进一步优化依赖项管理。
要启用 yarn 工作区,请修改 lerna.json 文件:
{ "npmclient": "yarn", "useworkspaces": true }
然后更新你的 package.json:
{ "workspaces": ["packages/*"] }
这种集成提高了性能并简化了大型项目的管理。
lerna 允许过滤为特定包运行命令或排除某些包。
在特定包上运行的示例:
lerna run build --scope=package-a --scope=package-b
排除包裹的示例:
lerna run build --ignore=package-c
您可以在 package.json 中为专门的工作流程定义自定义 lerna 命令。然后可以在您的包中运行这些命令。
lerna 是管理 monorepos 的宝贵工具,提供简化复杂工作流程(从依赖管理到版本控制和发布)的功能。通过采用 lerna,团队可以降低复杂性、简化流程并改善协作,从而更轻松地维护大型项目。
无论您是在开发简单的组件库还是多包生态系统,lerna 都能提供有效管理项目所需的工具。继续尝试 lerna 的高级功能,以释放其全部潜力。
快乐编码:)