Incrementalist：优化大型解决方案构建的利器

Incrementalist：优化大型解决方案构建的利器

Incrementalist Git-based incremental build and testing platform for .NET and .NET Core. 项目地址: https://gitcode.com/gh_mirrors/in/Incrementalist

Incrementalist 是一个针对大型 .NET 解决方案进行增量构建的工具。通过利用 libgit2sharp 和 Roslyn，它可以计算大型解决方案的增量构建步骤，有效优化 CI/CD 流程，只构建和测试受您更改影响的项目。

项目介绍

Incrementalist 专为处理大型解决方案而设计，能够显著减少构建时间，特别是当解决方案包含数十甚至数百个项目时。它适用于单仓库多项目（Monorepos）、微服务架构、以及具有复杂依赖关系的项目。通过智能分析项目的更改和依赖关系，Incrementalist 只编译和测试受影响的部分，从而加快构建和部署的速度。

项目技术分析

Incrementalist 利用了 .NET 生态系统中的两个重要库：libgit2sharp 和 Roslyn。libgit2sharp 是一个用于处理 Git 存储库的库，而 Roslyn 则是 .NET 编译平台的代码分析工具。通过这两个库的配合，Incrementalist 能够精确地识别出项目中的更改，并计算出哪些项目需要重新构建。

此外，Incrementalist 支持使用 JSON 配置文件存储常用设置，避免了重复输入相同的命令行参数。配置文件的使用提供了灵活性，使得构建过程可以轻松适应不同的环境和需求。

项目及技术应用场景

Incrementalist 的应用场景广泛，以下是一些主要的使用案例：

1. 大型解决方案：对于包含众多项目的解决方案，Incrementalist 能够通过只构建受影响的项目来减少构建时间。
2. 单仓库多项目：在单仓库中管理多个应用程序或服务时，Incrementalist 可以识别并只构建受影响的组件。
3. 微服务架构：在包含多个微服务的仓库中，Incrementalist 只构建和测试受更改影响的服务。
4. 复杂依赖关系：当项目之间有复杂的依赖关系时，Incrementalist 能够自动确定受影响的构建图。
5. CI/CD 优化：通过跳过不必要的构建和测试，Incrementalist 可以减少 CI/CD 管道的执行时间。

项目特点

Incrementalist 的以下特点使其成为一个强大的工具：

• 增量构建：只构建和测试受更改影响的项目，显著提高构建效率。
• 灵活配置：支持 JSON 配置文件，方便存储和复用常用设置。
• 命令行工具：提供全局和本地安装选项，支持多种命令行操作，易于集成到现有工作流程。
• 并行执行：支持并行执行构建和测试命令，进一步提高执行速度。
• 自定义输出：可以生成项目列表和文件夹列表，方便在其他自动化工具中使用。

以下是详细的项目特点和用法：

安装与使用

Incrementalist 可以以库的形式安装，也可以作为命令行工具安装。全局安装后，可以直接使用 incrementalist 命令运行，而本地安装则需要通过 dotnet tool run 调用。

# 全局安装
dotnet tool install --global Incrementalist.Cmd

# 本地安装
dotnet new tool-manifest
dotnet tool install Incrementalist.Cmd

命令行选项

Incrementalist 使用基于动词的命令结构，提供了一系列常用选项，包括指定解决方案文件、输出文件、Git 分支、工作目录等。

# 通用选项
  -s, --sln             指定解决方案文件
  -f, --file            指定输出文件
  -b, --branch          指定 Git 分支
  -d, --dir             指定工作目录
  --verbose             启用调试日志
  -t, --timeout         设置解决方案加载超时时间
  -c, --config          指定配置文件路径
  --continue-on-error   设置是否在错误发生时继续执行
  --parallel            设置是否并行执行命令
  --fail-on-no-projects 设置在无受影响项目时是否失败
  --skip-glob           设置排除模式
  --target-glob         设置包含模式
  --help                显示帮助信息
  --version             显示版本信息

运行命令

使用 run 动词可以针对受影响的项目执行 dotnet CLI 命令。例如，以下命令将构建受影响的项目：

# 构建受影响的项目
incrementalist run -b dev -- build -c Release --nologo

过滤项目

在确定受影响的项目后，可以使用 glob 模式进一步细化项目列表，包括仅包含匹配模式的项目或排除特定项目。

# 只包含匹配模式的项目
incrementalist run -b dev --target-glob "src/*.Tests.csproj" -- build -c Release

# 排除特定项目
incrementalist run -b dev --skip-glob "**/*.Tests.csproj" -- build -c Release

通过以上特点和应用场景的介绍，可以看出 Incrementalist 是一个在大型解决方案构建中极具价值的工具。它不仅能够提高构建效率，还能够灵活地适应不同的工作流程和需求，是优化 CI/CD 流程的绝佳选择。

Incrementalist Git-based incremental build and testing platform for .NET and .NET Core. 项目地址: https://gitcode.com/gh_mirrors/in/Incrementalist