Пошаговое руководство. Сборка приложения Walkthrough: Build an application

Выполнив это пошаговое руководство, вы ознакомитесь с несколькими параметрами, которые можно настроить при создании приложений с помощью Visual Studio. By completing this walkthrough, you’ll become more familiar with several options that you can configure when you build applications with Visual Studio. Вы создадите настраиваемую конфигурацию сборки, скроете определенные предупреждения и расширите выходные данные сборки для примера приложения. You’ll create a custom build configuration, hide certain warning messages, and increase build output information for a sample application.

Установите пример приложения Install the sample application

Скачайте пример Общие сведения о сборке приложений WPF. Download the Introduction to building WPF applications sample. Выберите язык C# или Visual Basic. Choose either C# or Visual Basic. После загрузки файла .zip извлеките его содержимое и откройте файл ExpenseItIntro.sln с помощью Visual Studio. After the .zip file has downloaded, extract it and open the ExpenseItIntro.sln file using Visual Studio.

Создание настраиваемой конфигурации сборки Create a custom build configuration

При создании решения конфигурации отладочной сборки и сборки выпуска и их целевые платформы по умолчанию определяются для решения автоматически. When you create a solution, debug and release build configurations and their default platform targets are defined for the solution automatically. Затем вы можете настроить эти конфигурации или создать собственные. You can then customize these configurations or create your own. Конфигурации указывают тип сборки. Build configurations specify the build type. Целевые платформы указывают операционную систему, на которое ориентировано приложение для этой конфигурации. Build platforms specify the operating system that an application targets for that configuration. См. дополнительные сведения о конфигурациях сборки, платформах сборки и конфигурациях отладки и выпуска проекта. For more information, see Understand build configurations, Understand build platforms, and How to: Set debug and release configurations.

Конфигурации и параметры платформы можно изменять или создавать с помощью диалогового окна Диспетчер конфигураций. You can change or create configurations and platform settings by using the Configuration Manager dialog box. В этой процедуре вы создадите конфигурацию сборки для тестирования. In this procedure, you’ll create a build configuration for testing.

Создание конфигурации сборки Create a build configuration

Откройте диалоговое окно Диспетчер конфигураций. Open the Configuration Manager dialog box.

В списке Активная конфигурация решения выберите . In the Active solution configuration list, choose .

В диалоговом окне Создание конфигурации решения введите для новой конфигурации имя Test , скопируйте параметры из существующей конфигурации Отладка и нажмите кнопку ОК. In the New Solution Configuration dialog box, name the new configuration Test , copy settings from the existing Debug configuration, and then choose the OK button.

В списке Активная платформа решения выберите . In the Active solution platform list, choose .

В диалоговом окне Создание платформы решения выберите x64 и не копируйте параметры из платформы x86. In the New Solution Platform dialog box, choose x64, and don’t copy settings from the x86 platform.

Нажмите кнопку ОК . Choose the OK button.

Активная конфигурация решения была изменена на Тест, а для активной платформы решения задано значение x64. The active solution configuration has been changed to Test with the active solution platform set to x64.

Нажмите кнопку Закрыть. Choose Close.

Активную конфигурацию решения можно быстро проверить или изменить с помощью списка Конфигурации решения на панели инструментов Стандартная. You can quickly verify or change the active solution configuration by using the Solution Configurations list on the Standard toolbar.

создание приложения; Build the application

Далее вам предстоит создать решение с помощью настраиваемой конфигурации сборки. Next, you’ll build the solution with the custom build configuration.

Выполните сборку решения. Build the solution

В строке меню последовательно выберите Сборка > Собрать решение (или нажмите CTRL+SHIFT+B). On the menu bar, choose Build > Build Solution, or press Ctrl+Shift+B.

Окно Вывод отображает результат сборки. The Output window displays the results of the build. Сборка успешно завершена. The build succeeded.

Скрытие предупреждений компилятора Hide compiler warnings

Далее мы добавим код, который приводит к созданию предупреждения компилятором. Next we’ll introduce some code that causes a warning to be generated by the compiler.

В проекте C# откройте файл ExpenseReportPage.xaml.cs. In the C# project, open the ExpenseReportPage.xaml.cs file. В методе ExpenseReportPage добавьте следующий код: int i; . In the ExpenseReportPage method, add the following code: int i; .

В проекте Visual Basic откройте файл ExpenseReportPage.xaml.vb. In the Visual Basic project, open the ExpenseReportPage.xaml.vb file. В пользовательском конструкторе Public Sub New. добавьте следующий код: Dim i . In the custom constructor Public Sub New. , add the following code: Dim i .

Создайте решение. Build the solution.

Окно Вывод отображает результат сборки. The Output window displays the results of the build. Сборка была выполнена успешно, но были созданы предупреждения: The build succeeded, but warnings were generated:

Вы можете временно скрыть некоторые предупреждения во время сборки, чтобы они не засоряли выходные данные сборки. You can temporarily hide certain warning messages during a build rather than have them clutter up the build output.

Скрытие определенного предупреждения C# Hide a specific C# warning

В обозревателе решений выберите узел проекта верхнего уровня. In Solution Explorer, choose the top-level project node.

В строке меню выберите Вид > Страницы свойств. On the menu bar, choose View > Property Pages.

Открывается Конструктор проектов. The Project Designer opens.

Выберите страницу Сборка и затем в поле Отключить предупреждения укажите номер предупреждения 0168. Choose the Build page and then, in the Suppress warnings box, specify the warning number 0168.

Создайте решение. Build the solution.

Окно Вывод отображает только сводные данные о сборке. The Output window displays only summary information for the build.

Отключение всех предупреждений сборки в Visual Basic Suppress all Visual Basic build warnings

В обозревателе решений выберите узел проекта верхнего уровня. In Solution Explorer, choose the top-level project node.

В строке меню выберите Вид > Страницы свойств. On the menu bar, choose View > Property Pages.

Открывается Конструктор проектов. The Project Designer opens.

На странице Компиляция установите флажок Выключить все предупреждения. On the Compile page, select the Disable all warnings check box.

Создайте решение. Build the solution.

Окно Вывод отображает только сводные данные о сборке. The Output window displays only summary information for the build.

Отображение дополнительных сведений о сборке в окне вывода Display additional build details in the Output window

Вы можете изменить объем информации, отображаемый о процессе сборки в окне Вывод. You can change how much information about the build process appears in the Output window. В общем случае задан минимальный уровень детализации сборки, при котором в окне Вывод отображается только сводка по процессу сборки вместе с высокоприоритетными предупреждениями или ошибками. Build verbosity is usually set to Minimal, which means that the Output window displays only a summary of the build process along with any high priority warnings or errors. Чтобы отобразить дополнительные сведения о сборке, см. раздел Диалоговое окно «Параметры», «Проекты и решения», «Сборка и запуск». You can display more information about the build by using the Options dialog box, Projects and Solutions, Build and Run.

При отображении дополнительных сведений сборка будет занимать больше времени. If you display more information, the build will take longer to complete.

Изменение объема сведений в окне вывода Change the amount of information in the Output window

Откройте диалоговое окно Параметры. Open the Options dialog box.

Выберите категорию Проекты и решения и затем страницу Сборка и запуск. Choose the Projects and Solutions category, and then choose the Build and Run page.

В списке Степень подробности сообщений при сборке проекта MSBuild выберите значение Обычная и нажмите кнопку ОК. In the MSBuild project build output verbosity list, choose Normal, and then choose the OK button.

В строке меню выберите Сборка > Очистить решение. On the menu bar, choose Build > Clean Solution.

Выполните сборку решения и просмотрите сведения в окне Вывод. Build the solution, and then review the information in the Output window.

Сведения о сборке включают в себя время запуска сборки (находится в начале) и порядок обработки файлов. The build information includes the time that the build started (located at the beginning) and the order in which files were processed. Они также включают фактический синтаксис компилятора, запускаемый Visual Studio при сборке. This information also includes the actual compiler syntax that Visual Studio runs during the build.

Например, параметр /nowarn в сборке C# выводит указанный вами ранее код предупреждения 0168, а также три других предупреждения. For example, in the C# build, the /nowarn option lists the warning code, 0168, that you specified earlier in this topic, along with three other warnings.

В сборке Visual Basic параметр /nowarn не включает в себя определенные исключаемые предупреждения, поэтому предупреждения не отображаются. In the Visual Basic build, /nowarn doesn’t include specific warnings to exclude, so no warnings appear.

В окне Вывод можно искать содержимое, отобразив диалоговое окно Найти нажатием клавиш CTRL+F. You can search the contents of the Output window if you display the Find dialog box by choosing the Ctrl+F keys.

Создание сборки выпуска Create a Release Build

Вы можете создать версию примера приложения, оптимизированную для поставки. You can build a version of the sample application that’s optimized for shipping it. Для сборки выпуска вы указываете, что исполняемый файл копируется в общую сетевую папку перед запуском сборки. For the release build, you’ll specify that the executable is copied to a network share before the build is kicked off.

Указание сборки выпуска для Visual Basic Specify a release build for Visual Basic

Открывается Конструктор проектов. Open the Project Designer.

Откройте вкладку Компиляция. Choose the Compile page.

В списке Конфигурация выберите Выпуск. In the Configuration list, choose Release.

В списке Платформа выберите x86. In the Platform list, choose x86.

В поле Выходной путь сборки укажите сетевой путь. In the Build output path box, specify a network path.

Например, так: \\myserver\builds . For example, you can specify \\myserver\builds .

Может появиться окно с предупреждением о том, что указанная вами сетевая общая папка может быть ненадежна. A message box might appear, warning you that the network share that you’ve specified might not be a trusted location. Если вы доверяете указанному расположению, нажмите кнопку ОК в окне сообщения. If you trust the location that you’ve specified, choose the OK button in the message box.

Создайте приложение. Build the application.

Указание сборки выпуска для C# Specify a release build for C#

Открывается Конструктор проектов. Open the Project Designer.

Перейдите на страницу Сборка. Choose the Build page.

В списке Конфигурация выберите Выпуск. In the Configuration list, choose Release.

В списке Платформа выберите x86. In the Platform list, choose x86.

В поле Путь для создаваемых файлов укажите сетевой путь. In the Output path box, specify a network path.

Например, можно указать \\myserver\builds . For example, you could specify \\myserver\builds .

Может появиться окно с предупреждением о том, что указанная вами сетевая общая папка может быть ненадежна. A message box might appear, warning you that the network share that you’ve specified might not be a trusted location. Если вы доверяете указанному расположению, нажмите кнопку ОК в окне сообщения. If you trust the location that you’ve specified, choose the OK button in the message box.

На стандартной панели инструментов выберите в качестве конфигураций решения Выпуск, а в качестве платформ решения — x86. On the Standard toolbar, set the Solution Configurations to Release and the Solution Platforms to x86.

Создайте приложение. Build the application.

Исполняемый файл копируется в указанный сетевой путь. The executable file is copied to the network path that you specified. Путем к нему будет \\myserver\builds\\FileName.exe . Its path would be \\myserver\builds\\FileName.exe .

Поздравляем! Congratulations! Вы успешно выполнили это пошаговое руководство. You’ve successfully completed this walkthrough.