use-bootstrap-msbuild
Testuj poprawki MSBuild na lokalnych projektach przed wysłaniem PR-a
Instalacja
Wybierz klienta i sklonuj repozytorium do odpowiedniego katalogu skilli.
Instalacja
O skillu
Umiejętność ułatwiająca weryfikację poprawek w MSBuild. Po wprowadzeniu zmian w kodzie możesz zbudować lokalną wersję MSBuild (bootstrap) i przetestować ją na swoim projekcie reprodukującym błąd. Narzędzie obsługuje zarówno projekty .NET Core/.NET SDK, jak i .NET Framework. Pozwala upewnić się, że fix działa prawidłowo, zanim wyślesz pull request do repozytorium.
Jak używać
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.
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.
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.
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.
Sprawdź wyniki testu — jeśli poprawka działa prawidłowo na Twoim projekcie reprodukującym błąd, możesz bezpiecznie wysłać pull request.