在处理多包项目时,我常常会遇到一个棘手的问题:如何有效地管理这些包的依赖和版本?特别是当这些包都放在同一个仓库中时,事情变得更加复杂。我尝试过手动管理,但这不仅耗时,而且容易出错。幸运的是,我找到了symplify/monorepo-builder这个库,它让我在处理多包单仓库(monorepo)时变得更加高效和可靠。
首先,通过Composer安装symplify/monorepo-builder非常简单:
composer require symplify/monorepo-builder --dev
安装完成后,你可以使用monorepo-builder命令来管理你的Monorepo。以下是一些常用的功能:
- 快速初始化Monorepo:如果你对Monorepo还不熟悉,可以使用以下命令快速初始化:
vendor/bin/monorepo-builder init
- 合并本地composer.json到根目录:你可以使用merge命令将各个包的composer.json合并到根目录的composer.json中,这样你只需编辑各个包的composer.json,然后让脚本同步到根目录:
vendor/bin/monorepo-builder merge
- 提升包间依赖版本:当你发布新版本时,你可以使用bump-interdependency命令来更新包之间的依赖版本。例如,发布symplify/symplify 4.0版本时:
vendor/bin/monorepo-builder bump-interdependency "^4.0"
- 保持包版本同步:在同步的Monorepo中,保持所有包使用相同的版本是很重要的。你可以使用validate命令来检查是否所有包都使用相同的版本:
vendor/bin/monorepo-builder validate
- 保持包别名最新:你可以使用package-alias命令来更新包的别名,确保它们始终是最新的:
vendor/bin/monorepo-builder package-alias
-
拆分目录到git仓库:如果你需要将Monorepo中的目录拆分到不同的Git仓库中,可以使用symplify/github-action-monorepo-split来配置。具体配置可以参考我们的示例设置。
-
发布流程:发布新版本时,你需要执行许多步骤,如更新依赖、打标签、推送标签、更新CHANGELOG.md等。如果你忘记了某一步或顺序错误,可能会导致发布失败。使用release命令可以让你安全地发布新版本:
vendor/bin/monorepo-builder release v7.0
你还可以配置发布工作流来自动化这些步骤:
use SymplifyMonorepoBuilderConfigMBConfig; use SymplifyMonorepoBuilderReleaseReleaseWorkerAddTagToChangelogReleaseWorker; use SymplifyMonorepoBuilderReleaseReleaseWorkerPushNextDevReleaseWorker; use SymplifyMonorepoBuilderReleaseReleaseWorkerPushTagReleaseWorker; use SymplifyMonorepoBuilderReleaseReleaseWorkerSetCurrentMutualDependenciesReleaseWorker; use SymplifyMonorepoBuilderReleaseReleaseWorkerSetNextMutualDependenciesReleaseWorker; use SymplifyMonorepoBuilderReleaseReleaseWorkerTagVersionReleaseWorker; use SymplifyMonorepoBuilderReleaseReleaseWorkerUpdateBranchAliasReleaseWorker; use SymplifyMonorepoBuilderReleaseReleaseWorkerUpdateReplaceReleaseWorker; return static function (MBConfig $mbConfig): void { $mbConfig->workers([ UpdateReplaceReleaseWorker::class, SetCurrentMutualDependenciesReleaseWorker::class, AddTagToChangelogReleaseWorker::class, TagVersionReleaseWorker::class, PushTagReleaseWorker::class, SetNextMutualDependenciesReleaseWorker::class, UpdateBranchAliasReleaseWorker::class, PushNextDevReleaseWorker::class, ]); };
使用symplify/monorepo-builder后,我发现管理多包单仓库变得更加简单和高效。这个工具不仅帮助我自动化了许多繁琐的操作,还减少了人为错误的可能性。如果你也在处理多包项目,不妨试试这个库,它会让你在管理Monorepo时更加得心应手。
© 版权声明
文章版权归作者所有,未经允许请勿转载。
THE END