Przeczytaj w języku angielskim

Udostępnij za pośrednictwem


Co nowego w programie MSBuild 15

Program MSBuild jest teraz dostępny jako część zestawu .NET Core SDK i może tworzyć projekty platformy .NET Core w systemach Windows, macOS i Linux.

Zmieniona ścieżka

Program MSBuild jest teraz instalowany w folderze w każdej wersji programu Visual Studio. Na przykład C:\Program Files (x86)\Microsoft Visual Studio\2017\Enterprise\MSBuild. Możesz również użyć następującego modułu programu PowerShell, aby zlokalizować program MSBuild: vssetup.powershell.

Program MSBuild nie jest już zainstalowany w globalnej pamięci podręcznej zestawów. Aby programowo odwołać się do programu MSBuild, użyj pakietów NuGet. Aby uzyskać więcej informacji, zobacz Aktualizowanie istniejącej aplikacji dla programu MSBuild 15.0.

Zmienione właściwości

Następujące właściwości programu MSBuild zostały zaktualizowane z powodu nowego numeru wersji.

  • MSBuildToolsVersion dla tej wersji narzędzi jest 15.0. Wersja zestawu to 15.1.0.0.

  • MSBuildToolsPath nie ma już stałej lokalizacji. Domyślnie znajduje się w folderze MSBuild\15.0\Bin względem lokalizacji instalacji programu Visual Studio, ale lokalizację instalacji programu Visual Studio można zmienić w czasie instalacji.

  • ToolsVersion wartości nie są już ustawiane w rejestrze.

  • Właściwości SDK35ToolsPath i SDK40ToolsPath wskazują zestaw .NET Framework SDK spakowany przy użyciu tej wersji programu Visual Studio (na przykład 10.0A dla narzędzi 4.X).

Aktualizacje

  • Element projektu ma nowy SDK atrybut. Xmlns Ponadto atrybut jest teraz opcjonalny. Aby uzyskać więcej informacji na temat atrybutuSDK, zobacz How to: Use MSBuild project SDKs, Packages, metapackages, and frameworks and Adds to the csproj format for .NET Core (Instrukcje: używanie zestawów SDK projektu MSBuild, pakietów, metapakietów i struktur oraz dodatków do formatu csproj dla platformy .NET Core).
  • Element elementu poza obiektami docelowymi ma nowy Update atrybut. Ponadto ograniczenie atrybutu Remove zostało wyeliminowane.
  • Directory.Build.props i Directory.Build.targets to pliki zdefiniowane przez użytkownika, które zapewniają dostosowania do projektów w katalogu. Plik Directory.Build.props jest automatycznie importowany z pliku Microsoft.Common.props , chyba że właściwość ImportDirectoryBuildProps jest ustawiona na false. Directory.Build.targets jest automatycznie importowany przez obiekty Microsoft.Common.targets , chyba że właściwość ImportDirectoryBuildTargets jest ustawiona na false.
  • Wszelkie metadane o nazwie, które nie powodują konfliktu z bieżącą listą atrybutów, mogą być opcjonalnie wyrażone jako atrybut. Aby uzyskać więcej informacji, zobacz Element elementu.

Nowe funkcje właściwości

  • EnsureTrailingSlash Dodaje ukośnik końcowy do ścieżki, jeśli jeszcze nie istnieje.
  • NormalizePath łączy elementy ścieżki i zapewnia, że ciąg wyjściowy ma poprawne znaki separatora katalogu dla bieżącego systemu operacyjnego.
  • NormalizeDirectory łączy elementy ścieżki, zapewnia końcowy ukośnik i zapewnia, że ciąg wyjściowy zawiera poprawne znaki separatora katalogu dla bieżącego systemu operacyjnego.
  • GetPathOfFileAbove Zwraca ścieżkę pliku bezpośrednio poprzedzającą ten plik. Jest ona funkcjonalnie równoważna wywołaniu <Import Project="$([MSBuild]::GetDirectoryNameOfFileAbove($(MSBuildThisFileDirectory), dir.props))\dir.props" />