Toolverse
All skills

use-bootstrap-msbuild

by dotnet

Guide for testing bug reproductions against locally-built MSBuild. Use this when you have a repro project and want to verify a fix works before submitting a PR.

Installation

Pick a client and clone the repository into its skills directory.

Installation

Quick info

Author
dotnet
Category
Testing

About this skill

Guide for testing bug reproductions against locally-built MSBuild. Use this when you have a repro project and want to verify a fix works before submitting a PR.

How to use

  1. Zbuduj MSBuild z Twoimi zmianami, uruchamiając skrypt build.cmd (Windows) lub build.sh (Unix/macOS). Proces utworzy katalog bootstrap w lokalizacji artifacts/bin/bootstrap/ zawierający kompletną instalację MSBuild z Twoimi modyfikacjami.

  2. Jeśli pracujesz z projektem .NET Core lub .NET SDK, użyj bezpośrednio dotnet CLI z katalogu bootstrap. Uruchom artifacts/bin/bootstrap/core/dotnet.exe build (Windows) lub ./artifacts/bin/bootstrap/core/dotnet build (Unix/macOS), podając ścieżkę do projektu reprodukującego błąd. Możesz stosować wszystkie standardowe argumenty wiersza poleceń, w tym -bl do generowania binlogów.

  3. Jeśli testujesz problem specyficzny dla .NET Framework MSBuild.exe używanego w Visual Studio (tylko Windows), uruchom bezpośrednio artifacts/bin/bootstrap/net472/MSBuild/Current/Bin/MSBuild.exe z ścieżką do projektu.

  4. Po każdej zmianie w kodzie MSBuild ponownie uruchom skrypt build.cmd lub build.sh, aby zaktualizować bootstrap. Jeśli napotkasz błędy dotyczące zablokowanych plików, uruchom ./artifacts/bin/bootstrap/core/dotnet build-server shutdown, aby zatrzymać procesy worker node.

  5. Sprawdź wyniki testu — jeśli poprawka działa prawidłowo na Twoim projekcie reprodukującym błąd, możesz bezpiecznie wysłać pull request.

Related skills