Msbuild что это за программа и нужна ли она? msbuild что это за программа и нужна ли она

Расширение путиExtend the path

Прежде чем использовать MSBuild, необходимо расширить переменную среду PATH, чтобы включить все необходимые средства.Before you can use MSBuild, you must extend the PATH environment variable to include all the required tools. Для этого можно использовать командную строку разработчика для Visual Studio.You can use the Developer Command Prompt for Visual Studio. В Windows 10 ее можно найти в поле поиска на панели задач Windows.Search for it on Windows 10 in the search box in the Windows task bar. Чтобы настроить среду в обычной командой строке или в среде скриптов, запустите файл VSDevCmd.bat, находящийся в подпапке Common7/Tools каталога, в котором установлено решение Visual Studio.To set up the environment in an ordinary command prompt or in a scripting environment, run VSDevCmd.bat in the Common7/Tools subfolder of a Visual Studio installation.

License

Copyright (c) 2016, LoreSoft
All rights reserved.

Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:

• Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
• Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
• Neither the name of LoreSoft nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS «AS IS» AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

Причины ошибок в файле MSBuild.exe

Проблемы MSBuild.exe могут быть отнесены к поврежденным или отсутствующим файлам, содержащим ошибки записям реестра, связанным с MSBuild.exe, или к вирусам / вредоносному ПО.

Более конкретно, данные ошибки MSBuild.exe могут быть вызваны следующими причинами:

• Поврежденные ключи реестра Windows, связанные с MSBuild.exe / Windows.
• Вирус или вредоносное ПО, которые повредили файл MSBuild.exe или связанные с Windows программные файлы.
• Другая программа злонамеренно или по ошибке удалила файлы, связанные с MSBuild.exe.
• Другая программа находится в конфликте с Windows и его общими файлами ссылок.
• Поврежденная загрузка или неполная установка программного обеспечения Windows.

Создание минимального файла проекта MSBuildCreating a Minimal MSBuild Project File

Теперь, когда у вас есть минимальный исходный файл приложения, вы можете создать минимальный файл проекта для построения приложения.Now that you have a minimal application source file, you can create a minimal project file to build the application. Такой файл проекта содержит следующие элементы.This project file contains the following elements:

• Необходимый корневой узел .The required root node.

• Узел для хранения элементов.An node to contain item elements.

• Элемент, который ссылается на исходный файл приложения.An item element that refers to the application source file.

• Узел для хранения задач, которые требуются для построения приложения.A node to contain tasks that are required to build the application.

• Элемент для запуска компилятора Visual C# для построения приложения.A element to start the Visual C# compiler to build the application.

Создание файла минимального проекта MSBuildTo create a minimal MSBuild project file

В текстовом редакторе замените существующий текст с помощью следующих двух строк:In the text editor, replace the existing text by using these two lines:

Вставьте следующий узел в качестве дочернего элемента узла :Insert this node as a child element of the node:

Обратите внимание, что узел уже содержит элемент.Notice that this already contains an item element.

Добавьте узел в качестве дочернего элемента узла .Add a node as a child element of the node. Назовите узел .Name the node .

Вставьте следующий элемент задачи в качестве дочернего элемента узла .Insert this task element as a child element of the node:

Сохраните этот файл проекта и назовите его Helloworld.csproj.Save this project file and name it Helloworld.csproj.
Минимальный файл проекта должен выглядеть следующим образом:Your minimal project file should resemble the following code:. Задачи в целевом объекте сборки выполняются последовательно.Tasks in the Build target are executed sequentially

В этом случае задача компилятора Visual C# является единственной.In this case, the Visual C# compiler task is the only task. Она ожидает список исходных файлов для компилирования, который задается значением элемента .It expects a list of source files to compile, and this is given by the value of the item. Элемент ссылается на единственный исходный файл Helloworld.cs.The item references just one source file, Helloworld.cs

Задачи в целевом объекте сборки выполняются последовательно.Tasks in the Build target are executed sequentially. В этом случае задача компилятора Visual C# является единственной.In this case, the Visual C# compiler task is the only task. Она ожидает список исходных файлов для компилирования, который задается значением элемента .It expects a list of source files to compile, and this is given by the value of the item. Элемент ссылается на единственный исходный файл Helloworld.cs.The item references just one source file, Helloworld.cs.

Примечание

В элементе можно использовать подстановочный знак (*) для ссылки на все файлы, которые имеют расширение имени файла .CS:In the item element, you can use the asterisk wildcard character (*) to reference all files that have the .cs file name extension, as follows:

Тем не менее мы не рекомендуем использовать подстановочные знаки, так как это создает сложности при отладке и постановке выборочных задач в случае добавления или удаления исходных файлов.However, we do not recommend the use of wildcard characters because it makes debugging and selective targeting more difficult if source files are added or deleted.

Çoklu sürüm desteğiMultitargeting

Visual Studio ‘yu kullanarak, .NET Framework çeşitli sürümlerinden herhangi birini çalıştırmak için bir uygulamayı derleyebilirsiniz.By using Visual Studio, you can compile an application to run on any one of several versions of .NET Framework. Örneğin, bir uygulamayı 32 bit platformda .NET Framework 2,0 ‘ de çalışacak şekilde derleyebilir ve aynı uygulamayı bir 64-bit platformunda .NET Framework 4,5 üzerinde çalışacak şekilde derleyebilirsiniz.For example, you can compile an application to run on .NET Framework 2.0 on a 32-bit platform, and you can compile the same application to run on .NET Framework 4.5 on a 64-bit platform. Birden fazla çerçeveye derleme yeteneği Çoklu hedefleme olarak adlandırılır.The ability to compile to more than one framework is named multitargeting.

Çoklu hedefleme avantajlarından bazıları şunlardır:These are some of the benefits of multitargeting:

• .NET Framework önceki sürümlerini hedefleyen uygulamalar geliştirebilirsiniz, örneğin 2,0, 3,0 ve 3,5 sürümleri.You can develop applications that target earlier versions of .NET Framework, for example, versions 2.0, 3.0, and 3.5.

• Örneğin, Silverlight gibi .NET Framework dışındaki çerçeveleri hedefleyebilirsiniz.You can target frameworks other than .NET Framework, for example, Silverlight.

• Hedef çerçevenin önceden tanımlanmış bir alt kümesi olan bir çerçeve profilinihedefleyebilirsiniz.You can target a framework profile, which is a predefined subset of a target framework.

• Geçerli .NET Framework sürümü için bir hizmet paketi yayınlanmışsa, hedefleyebilirsiniz.If a service pack for the current version of .NET Framework is released, you could target it.

• Çoklu hedefleme, bir uygulamanın yalnızca hedef çerçeve ve platformda kullanılabilir olan işlevleri kullanmasını güvence altına alır.Multitargeting guarantees that an application uses only the functionality that’s available in the target framework and platform.

Daha fazla bilgi için bkz. Çoklu hedefleme.For more information, see Multitargeting.

Supplying Parameters to the VCC Build Tools

You can pass additional parameters directly to the VCC Build Tools installer. This tool does not
check if the parameters make sense — passing incorrect parameters might break the whole
installation.

Supply parameters to as a JSON array. Here’s quick example (note the double quotes):

If you run with , these parameters are available:

• : Specifies the installation control file.
• : Specifies the location to create a control file that can then be used
• : Set Custom install location.
• : Always restart the system after installation.
• : Install all product features.
• : <item1;item2;…;itemN> Choose which selectable item(s) to be installed.
  -selectable item to be installed, just pass in this switch without any value.
• : Create a copy of the media in specified folder.
• : Prevent setup checking for updates from the internet.
• : Do not restart during or after installation.
• : Prevent setup downloading from the internet.
• : Display progress but do not wait for user input.
• : <25-character product key> Set custom product key (no dashes).
• : Prompt the user before restarting the system.
• : Repair the product.
• : Uninstall the product.
• : Uninstall the product and features shared with other products.

By default, will download the latest installers from Microsoft each time
it’s installed. Alternatively, you can prepare a folder that contains installers. They need to
have their original names:

• Visual Studio Build Tools: or
• Python: or

Then, run with the argument:

npm install -g windows-build-tools --offline-installers="C:\Users\John\installers"

Ayrıca bkz.See also

ОбновленияUpdates

• В элемент Project добавлен атрибут .Project element has a new attribute. Также атрибут стал необязательным.Also the attribute is now optional. Дополнительные сведения об использовании атрибута см в статьях Информация об использовании пакетов SDK проекта MSBuild, Пакеты, метапакеты и платформы и Дополнения к формату CSPROJ для .NET Core.For more information on the attribute, see How to: Use MSBuild project SDKs, Packages, metapackages, and frameworks and Additions to the csproj format for .NET Core.
• Для внешних целевых объектов элемента Item добавлен атрибут .Item element outside targets has a new attribute. Кроме того, снято ограничение на атрибут .Also, the restriction on the attribute has been eliminated.
• Пользовательский файл Directory.Build.props содержит настройки персонализации для проектов в своем каталоге.Directory.Build.props is a user-defined file that provides customizations to projects under a directory. Этот файл автоматически импортируется из Microsoft.Common.props, если свойству не задано значение false.This file is automatically imported from Microsoft.Common.props unless the property is set to false. Directory.Build.targets импортируется с помощью Microsoft.Common.targets.Directory.Build.targets is imported by Microsoft.Common.targets.
• Все метаданные с именами, которые не противоречат текущему списку атрибутов, можно по желанию разработчика выразить в виде атрибута.Any metadata with a name that doesn’t conflict with the current list of attributes can optionally be expressed as an attribute. For more information, see Item element.

在命令提示符处使用 MSBuildUse MSBuild at a command prompt

若要在命令提示符处运行 MSBuild，请将项目文件随相应的命令行选项一起传递到 MSBuild.exe。To run MSBuild at a command prompt, pass a project file to MSBuild.exe, together with the appropriate command-line options. 命令行选项允许你设置属性、执行特定的目标，以及设置可控制生成过程的其他选项。Command-line options let you set properties, execute specific targets, and set other options that control the build process. 例如，使用以下命令行语法生成文件 MyProj.proj，并将 属性设置为 。For example, you would use the following command-line syntax to build the file MyProj.proj with the property set to .

有关 MSBuild 命令行选项的详细信息，请参阅命令行参考。For more information about MSBuild command-line options, see Command-line reference.

重要

在下载项目之前，请确定代码的可信度。Before you download a project, determine the trustworthiness of the code.

请参阅See also

Распространенные сообщения об ошибках в MSBuild.exe

Наиболее распространенные ошибки MSBuild.exe, которые могут возникнуть на компьютере под управлением Windows, перечислены ниже:

• «Ошибка приложения MSBuild.exe.»
• «MSBuild.exe не является приложением Win32.»
• «Возникла ошибка в приложении MSBuild.exe. Приложение будет закрыто. Приносим извинения за неудобства.»
• «Файл MSBuild.exe не найден.»
• «MSBuild.exe не найден.»
• «Ошибка запуска программы: MSBuild.exe.»
• «Файл MSBuild.exe не запущен.»
• «Отказ MSBuild.exe.»
• «Неверный путь к приложению: MSBuild.exe.»

Такие сообщения об ошибках EXE могут появляться в процессе установки программы, когда запущена программа, связанная с MSBuild.exe (например, Windows), при запуске или завершении работы Windows, или даже при установке операционной системы Windows

Отслеживание момента появления ошибки MSBuild.exe является важной информацией при устранении проблемы

Bir komut isteminde MSBuild kullanmaUse MSBuild at a command prompt

MSBuild ‘i komut isteminde çalıştırmak için, uygun komut satırı seçenekleriyle birlikte MSBuild.exebir proje dosyası geçirin.To run MSBuild at a command prompt, pass a project file to MSBuild.exe, together with the appropriate command-line options. Komut satırı seçenekleri özellikleri ayarlamanıza, belirli hedefleri yürütmenizi ve yapı sürecini denetleyen diğer seçenekleri ayarlamanıza olanak sağlar.Command-line options let you set properties, execute specific targets, and set other options that control the build process. Örneğin, özelliği olarak ayarlanmış myproj. proj dosyasını oluşturmak için aşağıdaki komut satırı sözdizimini kullanın .For example, you would use the following command-line syntax to build the file MyProj.proj with the property set to .

MSBuild komut satırı seçenekleri hakkında daha fazla bilgi için bkz. komut satırı başvurusu.For more information about MSBuild command-line options, see Command-line reference.

Önemli

Bir projeyi indirmadan önce kodun güvenilirliğini saptayın.Before you download a project, determine the trustworthiness of the code.

Новые функции свойствNew property functions

• добавляет завершающую косую черту к пути, если она отсутствует. adds a trailing slash to a path if one doesn’t already exist.
• объединяет элементы пути и проверяет, что выходная строка имеет правильные знаки разделения для каталогов, используемые в текущей операционной системе. combines path elements and ensures that the output string has the correct directory separator characters for the current operating system.
• объединяет элементы пути, добавляет косую черту при необходимости и проверяет, что выходная строка имеет правильные знаки разделения для каталогов, используемые в текущей операционной системе. combines path elements, ensures a trailing slash, and ensures that the output string has the correct directory separator characters for the current operating system.
• возвращает путь к файлу, непосредственно предшествующему данному. returns the path of the file immediately preceding this one. Она функционально эквивалентна вызову такой инструкции: It is functionally equivalent to calling

Файлы, связанные с MSBuild.exe

Файлы EXE, связанные с MSBuild.exe

Usage

Optional arguments:

• : Path to a folder with already downloaded installers. See
• : Use a given mirror to download Python (like ). You can alternatively set a environment variable.
• : Use a given proxy. You can alternatively set a environment variable.
• : Be extra verbose in the logger output. Equal to setting the environment variable to .
• : Enables «Strict SSL» mode. Defaults to false.
• : By default, will resume aborted downloads. Set to to disable.
• : Specifies the number of http sockets to use at once (this controls concurrency). Defaults to infinity.
• : Specifies additional parameters for the Visual C++ Build Tools 2015. See below for more detailed usage instructions.
• : The script will not output any information.
• : Install the Visual Studio 2015 Build Tools instead of the Visual Studio 2017 ones.
• : Don’t actually do anything, just print what the script would have done.
• : Include the optional Visual Studio components required to build binaries for ARM64 Windows. Only available with the 2017 and newer build tools and Node.js v12 and up.

Тестирование целей построенияTest the build targets

Для тестирования этих функций файла проекта можно запустить новые цели построения.You can exercise the new build targets to test these features of the project file:

• Построение по умолчанию.Building the default build.

• Задание имени приложения в командной строке.Setting the application name at the command prompt.

• Удаление приложения перед построением другого приложения.Deleting the application before another application is built.

• Удаление приложения без построения другого приложения.Deleting the application without building another application.

Тестирование целей построенияTo test the build targets

1. В командной строке введите msbuild helloworld.csproj -p:AssemblyName=Greetings.At the command prompt, type msbuild helloworld.csproj -p:AssemblyName=Greetings.

   Так как параметр -t для задания цели напрямую не использовался, MSBuild запускает стандартную цель «Сборка».Because you did not use the -t switch to explicitly set the target, MSBuild runs the default Build target. Параметр -p переопределяет свойство и присваивает ему новое значение .The -p switch overrides the property and gives it the new value, . В результате в папке \Bin\ создается новое приложение Greetings.exe.This causes a new application, Greetings.exe, to be created in the \Bin\ folder.

2. Чтобы убедиться, что в папке \Bin\ содержатся приложение MSBuildSample и новое приложение Greetings, введите dir Bin.To verify that the \Bin\ folder contains both the MSBuildSample application and the new Greetings application, type dir Bin.

3. Протестируйте приложение Greetings, указав в командной строке Bin\Greetings.Test the Greetings application by typing Bin\Greetings.

   Должно появиться сообщение Hello, world!The Hello, world! .message should be displayed.

4. Удалите приложение MSBuildSample с помощью команды msbuild helloworld.csproj -t:clean.Delete the MSBuildSample application by typing msbuild helloworld.csproj -t:clean.

   Это запустит задачу «Очистить» и позволит удалить приложение со значением свойства по умолчанию — .This runs the Clean task to remove the application that has the default property value, .

5. Удалите приложение Greetings с помощью команды msbuild helloworld.csproj -t:clean -p:AssemblyName=Greetings.Delete the Greetings application by typing msbuild helloworld.csproj -t:clean -p:AssemblyName=Greetings.

   Это запустит задачу «Очистить» и позволит удалить приложение с заданным значением свойства AssemblyName по умолчанию — .This runs the Clean task to remove the application that has the given AssemblyName property value, .

6. Чтобы убедиться, что папка \Bin\ пуста, введите dir Bin.To verify that the \Bin\ folder is now empty, type dir Bin.

7. Введите команду msbuild.Type msbuild.

   Несмотря на то что файл проекта не указан, MSBuild строит файл helloworld.csproj, поскольку в текущей папке присутствует только один файл проекта.Although a project file is not specified, MSBuild builds the helloworld.csproj file because there is only one project file in the current folder. В результате в папке \Bin\ создается новое приложение MSBuildSample.This causes the MSBuildSample application to be created in the \Bin\ folder.

   Чтобы убедиться, что в папке \Bin\ появилось приложение MSBuildSample, введите dir Bin.To verify that the \Bin\ folder contains the MSBuildSample application, type dir Bin.