Развертывание приложений .NET Core с помощью Visual Studio

Статья
04/11/2023

Приложение .NET Core можно развернуть как развертывание, зависящее от платформы, которое содержит двоичные файлы приложений, но зависит от наличия .NET Core в целевой системе, или как автономное развертывание, которое содержит и приложение, и двоичные файлы .NET Core. Общие сведения о развертывании приложений .NET Core см. в разделе Развертывание приложений .NET Core.

В разделах ниже содержатся сведения об использовании Microsoft Visual Studio для создания следующих типов развертывания:

Развертывание, зависящее от платформы
развертывание, зависящее от платформы, с зависимостями сторонних разработчиков;
Автономное развертывание
Автономное развертывание с зависимостями сторонних разработчиков

Сведения об использовании Visual Studio для разработки приложений .NET Core см. в статье Зависимости и требования для .NET Core.

Развертывание, зависящее от платформы

Если развертывание, зависящее от платформы, не содержит зависимостей сторонних разработчиков, то необходимо просто выполнить сборку, протестировать и опубликовать приложение. Проиллюстрируем этот процесс на примере простого приложения, написанного на языке C#.

Создание проекта.

Выберите File>New>Project ( Файл > Создать > Проект). В диалоговом окне Создать проект разверните категории проекта своего языка (C# или Visual Basic) на панели типов проектов Установлено, выберите .NET Core, а затем выберите шаблон Консольное приложение (.NET Core) на центральной панели. В поле Имя введите имя проекта, например "FDD". Выберите кнопку ОК.

Добавление исходного кода приложения.

Откройте файл Program.cs или Program.vb в редакторе и замените автоматически созданный код приведенным ниже кодом. Он выводит запрос на ввод текста и отображает отдельные слова, введенные пользователем. Для разделения слов во введенном тексте в нем используется регулярное выражение \w+.

using System;
using System.Text.RegularExpressions;

namespace Applications.ConsoleApps
{
    public class ConsoleParser
    {
        public static void Main()
        {
            Console.WriteLine("Enter any text, followed by <Enter>:\n");
            String? s = Console.ReadLine();
            ShowWords(s ?? "You didn't enter anything.");
            Console.Write("\nPress any key to continue... ");
            Console.ReadKey();
        }

        private static void ShowWords(String s)
        {
            String pattern = @"\w+";
            var matches = Regex.Matches(s, pattern);
            if (matches.Count == 0)
            {
                Console.WriteLine("\nNo words were identified in your input.");
            }
            else
            {
                Console.WriteLine($"\nThere are {matches.Count} words in your string:");
                for (int ctr = 0; ctr < matches.Count; ctr++)
                {
                    Console.WriteLine($"   #{ctr,2}: '{matches[ctr].Value}' at position {matches[ctr].Index}");
                }
            }
        }
    }
}

Imports System.Text.RegularExpressions

Namespace Applications.ConsoleApps
    Public Module ConsoleParser
        Public Sub Main()
            Console.WriteLine("Enter any text, followed by <Enter>:")
            Console.WriteLine()
            Dim s = Console.ReadLine()
            ShowWords(s)
            Console.Write($"{vbCrLf}Press any key to continue... ")
            Console.ReadKey()
        End Sub

        Private Sub ShowWords(s As String)
            Dim pattern = "\w+"
            Dim matches = Regex.Matches(s, pattern)
            Console.WriteLine()   
            If matches.Count = 0 Then
                Console.WriteLine("No words were identified in your input.")
            Else
                Console.WriteLine($"There are {matches.Count} words in your string:")
                For ctr = 0 To matches.Count - 1
                    Console.WriteLine($"   #{ctr,2}: '{matches(ctr).Value}' at position {matches(ctr).Index}")
                Next
            End If
            Console.WriteLine()
        End Sub
    End Module
End Namespace

Создайте отладочную сборку приложения.

Выберите Сборка>Собрать решение. Также можно скомпилировать и выполнить отладочную сборку приложения, выбрав Отладка>Начать отладку.
Развертывание приложения.

Отладив и протестировав программу, создайте файлы, которые будут развертываться с приложением. Для публикации из Visual Studio выполните следующие действия.
1. На панели инструментов измените конфигурацию решения с Отладка на Выпуск, чтобы собрать версию выпуска (а не отладочную версию) приложения.
2. Щелкните правой кнопкой мыши проект (не решение) в обозревателе решений и выберите Опубликовать.
3. На вкладке Публикация выберите Опубликовать. Visual Studio записывает файлы, которые составляют приложение, в локальную файловую систему.
4. Теперь на вкладке Публикация отображается один профиль — FolderProfile. Параметры конфигурации профиля отображаются на вкладке в разделе Сводка.
Итоговые файлы помещаются в каталог с именем Publish в Windows и publish в системах Unix, который находится в подкаталоге каталога проекта .\bin\release\netcoreapp2.1.

Помимо файлов приложения, процесс публикации создает файл базы данных программы (PDB), который содержит отладочную информацию о приложении. Файл используется в основном для отладки исключений. Его можно не упаковывать вместе с файлами приложения. Однако его следует сохранить на случай, если потребуется выполнить отладку сборки выпуска приложения.

Любым способом разверните полный набор файлов приложения. Например, их можно упаковать в ZIP-файл, использовать простую команду copy или развернуть их с помощью любого установочного пакета на ваш выбор. После установки пользователи могут выполнять приложение с помощью команды dotnet, указав имя файла приложения, например dotnet fdd.dll.

Помимо двоичных файлов приложения, установщик должен либо включать в себя установщик общей платформы, либо проверять наличие платформы в процессе установки приложения. Установка общей платформы требует наличия прав администратор или root, так как она производится на уровне всего компьютера.

развертывание, зависящее от платформы, с зависимостями сторонних разработчиков;

Для зависящего от платформы развертывания с одной или более зависимостями сторонних разработчиков требуется, чтобы зависимости были доступны в проекте. Перед сборкой приложения следует выполнить два дополнительных действия.

С помощью диспетчера пакетов NuGet добавьте ссылку на пакет NuGet в проект, а если пакет еще недоступен в системе, установите его. Чтобы открыть диспетчер пакетов, последовательно выберите Сервис>Диспетчер пакетов NuGet>Управление пакетами NuGet для решения.
Убедитесь, что в вашей системе установлены зависимости от сторонних разработчиков (например, Newtonsoft.Json), если это не так, установите их. На вкладке Установленные перечислены пакеты NuGet, установленные в системе. Если Newtonsoft.Json отсутствует в списке, откройте вкладку Обзор и введите "Newtonsoft.Json" в поле поиска. Выберите Newtonsoft.Json и в области справа выберите проект, прежде чем нажать кнопку Установить.
Если Newtonsoft.Json уже установлен в системе, добавьте его в проект, выбрав проект в правой области на вкладке Управление пакетами для решения.

Переносимость зависящего от платформы развертывания с зависимостями сторонних разработчиков напрямую зависит от переносимости этих зависимостей. Например, если библиотека стороннего разработчика поддерживает только Mac OS, приложение нельзя перенести в системы Windows. Это происходит, если зависимость стороннего разработчика сама зависит от машинного кода. Хорошим примером является сервер Kestrel, требующий собственной зависимости от libuv. Когда зависящее от платформы развертывание создается для приложения с таким типом зависимости стороннего разработчика, опубликованные выходные данные содержат папку для каждого идентификатора среды выполнения (RID), поддерживаемого зависимостью (и имеющегося в ее пакете NuGet).

Автономное развертывание без сторонних зависимостей

Выполнение автономного развертывания без зависимостей сторонних разработчиков предполагает создание проекта, изменение файла csproj, сборку, тестирование и публикацию приложения. Проиллюстрируем этот процесс на примере простого приложения, написанного на языке C#. Вы начнете с создания, программирования и тестирования проекта, как и при развертывании, зависимом от платформы.

Создание проекта.

Выберите File>New>Project ( Файл > Создать > Проект). В диалоговом окне Создать проект разверните категории проекта своего языка (C# или Visual Basic) на панели типов проектов Установлено, выберите .NET Core, а затем выберите шаблон Консольное приложение (.NET Core) на центральной панели. В поле Имя введите имя проекта, например "SCD", а затем нажмите кнопку ОК.

Добавление исходного кода приложения.

using System;
using System.Text.RegularExpressions;

namespace Applications.ConsoleApps
{
    public class ConsoleParser
    {
        public static void Main()
        {
            Console.WriteLine("Enter any text, followed by <Enter>:\n");
            String? s = Console.ReadLine();
            ShowWords(s ?? "You didn't enter anything.");
            Console.Write("\nPress any key to continue... ");
            Console.ReadKey();
        }

        private static void ShowWords(String s)
        {
            String pattern = @"\w+";
            var matches = Regex.Matches(s, pattern);
            if (matches.Count == 0)
            {
                Console.WriteLine("\nNo words were identified in your input.");
            }
            else
            {
                Console.WriteLine($"\nThere are {matches.Count} words in your string:");
                for (int ctr = 0; ctr < matches.Count; ctr++)
                {
                    Console.WriteLine($"   #{ctr,2}: '{matches[ctr].Value}' at position {matches[ctr].Index}");
                }
            }
        }
    }
}

Imports System.Text.RegularExpressions

Namespace Applications.ConsoleApps
    Public Module ConsoleParser
        Public Sub Main()
            Console.WriteLine("Enter any text, followed by <Enter>:")
            Console.WriteLine()
            Dim s = Console.ReadLine()
            ShowWords(s)
            Console.Write($"{vbCrLf}Press any key to continue... ")
            Console.ReadKey()
        End Sub

        Private Sub ShowWords(s As String)
            Dim pattern = "\w+"
            Dim matches = Regex.Matches(s, pattern)
            Console.WriteLine()   
            If matches.Count = 0 Then
                Console.WriteLine("No words were identified in your input.")
            Else
                Console.WriteLine($"There are {matches.Count} words in your string:")
                For ctr = 0 To matches.Count - 1
                    Console.WriteLine($"   #{ctr,2}: '{matches(ctr).Value}' at position {matches(ctr).Index}")
                Next
            End If
            Console.WriteLine()
        End Sub
    End Module
End Namespace

Определите, хотите ли вы использовать инвариантный режим глобализации.

Особенно в том случае, если приложение предназначено для Linux, вы можете уменьшить размер развертывания, используя преимущества инвариантного режима глобализации. Инвариантный режим глобализации подходит для приложений, которые не имеют глобальных параметров и могут использовать соглашения о форматировании, соглашения о регистре, сравнение строк и порядок сортировки для инвариантного языка и региональных параметров.

Чтобы включить инвариантный режим, щелкните правой кнопкой мыши проект (не решение) в обозревателе решений и выберите Изменить SCD.csproj или Изменить SCD.vbproj. Затем добавьте следующие выделенные строки в файл:
```
<Project Sdk="Microsoft.NET.Sdk">

  <PropertyGroup>
    <TargetFramework>net8.0</TargetFramework>
    <Nullable>enable</Nullable>
  </PropertyGroup>

  <ItemGroup>
    <RuntimeHostConfigurationOption Include="System.Globalization.Invariant" Value="true" />
  </ItemGroup> 

</Project>
```
Создание отладочной сборки приложения.

Выберите Сборка>Собрать решение. Также можно скомпилировать и выполнить отладочную сборку приложения, выбрав Отладка>Начать отладку. Этот шаг отладки позволяет выявить проблемы в приложении, когда оно выполняется на вашей платформе. Его все равно придется тестировать на каждой целевой платформе.

Если вы включили инвариантный режим глобализации, обязательно проверьте, подходит ли отсутствие данных, зависящих от языка и региональных параметров, для вашего приложения.

Когда вы закончите отладку, вы можете опубликовать автономное развертывание.

Visual Studio 15.6 и более ранние версии
Visual Studio 15.7 и более поздние версии

Создание после отладки и тестирования программы файлов, которые будут развертываться с приложением, для каждой целевой платформы.

Для публикации приложения из Visual Studio выполните следующие действия.

Определите платформы, для которых будет предназначено приложение.
1. Щелкните правой кнопкой мыши проект (не решение) в обозревателе решений и выберите Изменить SCD.csproj.
2. В разделе <PropertyGroup> файла csproj создайте тег <RuntimeIdentifiers>, определяющий платформы, для которых предназначено приложение, и укажите идентификатор среды выполнения (RID) каждой целевой платформы. Для разделения идентификаторов RID необходимо добавлять точку с запятой. Список идентификаторов сред выполнения см. в каталоге идентификаторов сред выполнения.
Например, в следующем примере указано, что приложение работает в 64-разрядных операционных системах Windows и 64-разрядной операционной системе OS X.
```
<PropertyGroup>
   <RuntimeIdentifiers>win-x64;osx-x64</RuntimeIdentifiers>
</PropertyGroup>
```
Элемент <RuntimeIdentifiers> можно переносить в другие группы <PropertyGroup> в пределах файла csproj. Полный пример файла csproj будет приведен далее в этом разделе.
Опубликуйте приложение.

Создание после отладки и тестирования программы файлов, которые будут развертываться с приложением, для каждой целевой платформы.

Для публикации приложения из Visual Studio выполните следующие действия.
1. На панели инструментов измените конфигурацию решения с Отладка на Выпуск, чтобы собрать версию выпуска (а не отладочную версию) приложения.
2. Щелкните правой кнопкой мыши проект (не решение) в обозревателе решений и выберите Опубликовать.
3. На вкладке Публикация выберите Опубликовать. Visual Studio записывает файлы, которые составляют приложение, в локальную файловую систему.
4. Теперь на вкладке Публикация отображается один профиль — FolderProfile. Параметры конфигурации профиля отображаются в разделе сводки на вкладке. Целевая среда выполнения определяет, какая среда выполнения была опубликована, а целевое расположение определяет, где были записаны файлы для автономного развертывания.
5. По умолчанию Visual Studio записывает все опубликованные файлы в один каталог. Для удобства рекомендуется создать отдельные профили для каждой целевой среды выполнения и размещать опубликованные файлы в каталоге для определенной платформы. Это предполагает создание отдельного профиля публикации для каждой целевой платформы. Теперь выполните повторную сборку приложения для каждой платформы следующим образом.
  1. Выберите Создать новый профиль в диалоговом окне Публикация.
  2. В диалоговом окне выбора целевого объекта публикации измените расположение папки на bin\Release\PublishOutput\win-x64. Нажмите ОК.
  3. В списке профилей выберите новый профиль (FolderProfile1) и убедитесь, что параметр Целевая среда выполнения имеет значение win-x64. В противном случае выберите Параметры. В диалоговом окне Параметры профиля измените значение параметра Целевая среда выполнения на win-x64, а затем нажмите кнопку Сохранить. В противном случае выберите Отмена.
  4. Выберите Опубликовать, чтобы опубликовать приложение для 64-разрядных платформ Windows 10.
  5. Выполните приведенные выше шаги еще раз, чтобы создать профиль для платформы osx-x64. Целевое расположение — bin\Release\PublishOutput\osx-x64, а целевая среда выполнения — osx-x64. Visual Studio присваивает этому профилю имя FolderProfile2.
Каждое целевое расположение содержит полный набор файлов (как файлов приложения, так и всех файлов .NET Core), необходимых для запуска приложения.

Разверните опубликованные файлы любым способом. Например, их можно упаковать в ZIP-файл, использовать простую команду copy или развернуть их с помощью любого установочного пакета на ваш выбор.

Ниже приведено полное содержимое файла csproj для этого проекта.

<Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <OutputType>Exe</OutputType>
    <TargetFramework>netcoreapp2.1</TargetFramework>
    <RuntimeIdentifiers>win-x64;osx-x64</RuntimeIdentifiers>
  </PropertyGroup>
</Project>

Создание после отладки и тестирования программы файлов, которые будут развертываться с приложением, для каждой целевой платформы. Это предполагает создание отдельного профиля для каждой целевой платформы.

Для каждой платформы, для которой предназначено приложение, выполните следующие действия.

Создайте профиль для целевой платформы.

Если это первый созданный профиль, щелкните правой кнопкой мыши проект (не решение) в обозревателе решений и выберите Опубликовать.

Если вы уже создали профиль, щелкните правой кнопкой мыши проект, чтобы открыть диалоговое окно Опубликовать, если оно еще не открыто. Затем выберите Создать профиль.

Откроется диалоговое окно Выбрать целевой объект для публикации.
Выберите расположение, где Visual Studio опубликует приложение.

Если вы публикуете только одну платформу, вы можете принять значение по умолчанию в текстовом поле "Выбор папки "; это публикует развертывание приложения, зависящее от платформы, в <каталог project-directory>\bin\Release\netcoreapp2.1\publish .

Если публикация выполняется для нескольких платформ, добавьте строку, которая указывает целевую платформу. Например, если добавить строку "linux" в путь к файлу, Visual Studio публикует развертывание, зависящее от платформы, в <каталог project-directory>\bin\Release\netcoreapp2.1\publish\linux .
Создайте профиль, щелкнув значок раскрывающегося списка рядом с полем Опубликовать и нажав Создать профиль. Затем нажмите на кнопку Создать профиль, чтобы создать профиль.
Укажите, что вы публикуете автономное развертывание, и определите платформу, для которой будет предназначено приложение.
1. В диалоговом окне Опубликовать нажмите на ссылку Настройка, чтобы открыть диалоговое окно Параметры профиля.
2. Выберите Автономное в списке Режим развертывания.
3. В списке Целевая среда выполнения выберите одну из платформ, для которой предназначено приложение.
4. Нажмите Сохранить, чтобы принять изменения и закрыть диалоговое окно.
Укажите имя профиля.
1. Выберите Действия>Переименовать профиль, чтобы указать имя профиля.
2. Выберите для профиля имя, которое указывает на целевую платформу, а затем нажмите *Сохранить.

Повторите эти шаги, чтобы определить любые дополнительные целевые платформы, для которых предназначено приложение.

Вы настроили профили и готовы опубликовать приложение. Для этого:

Если диалоговое окно Опубликовать еще не открыто, щелкните правой кнопкой мыши проект (не решение) в обозревателе решений и выберите Опубликовать.
Выберите профиль, который вы хотите опубликовать, а затем нажмите Опубликовать. Повторите это действие для каждого профиля.

Каждое целевое расположение (в нашем примере bin\release\netcoreapp2.1\publish\profile-name) содержит полный набор файлов (как файлов приложения, так и всех файлов .NET Core), необходимых для запуска приложения.

Ниже приведено полное содержимое файла csproj для этого проекта.

<Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <OutputType>Exe</OutputType>
    <TargetFramework>netcoreapp2.1</TargetFramework>
  </PropertyGroup>
</Project>

Кроме того, Visual Studio создает отдельный профиль публикации (*.pubxml) для каждой целевой платформы. Например, файл для профиля linux (linux.pubxml) выглядит следующим образом:

<?xml version="1.0" encoding="utf-8"?>
<!--
https://go.microsoft.com/fwlink/?LinkID=208121.
-->
<Project ToolsVersion="4.0" xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
  <PropertyGroup>
    <PublishProtocol>FileSystem</PublishProtocol>
    <Configuration>Release</Configuration>
    <Platform>Any CPU</Platform>
    <TargetFramework>netcoreapp2.1</TargetFramework>
    <PublishDir>bin\Release\netcoreapp2.1\publish\linux</PublishDir>
    <RuntimeIdentifier>win-x86</RuntimeIdentifier>
    <SelfContained>true</SelfContained>
    <_IsPortable>false</_IsPortable>
  </PropertyGroup>
</Project>

Автономное развертывание с зависимостями сторонних разработчиков

Выполнение автономного развертывания с одной или несколькими зависимостями сторонних разработчиков предполагает добавление этих зависимостей. Перед сборкой приложения следует выполнить два дополнительных действия.

С помощью диспетчера пакетов NuGet добавьте ссылку на пакет NuGet в проект, а если пакет еще недоступен в системе, установите его. Чтобы открыть диспетчер пакетов, последовательно выберите Сервис>Диспетчер пакетов NuGet>Управление пакетами NuGet для решения.
Убедитесь, что в вашей системе установлены зависимости от сторонних разработчиков (например, Newtonsoft.Json), если это не так, установите их. На вкладке Установленные перечислены пакеты NuGet, установленные в системе. Если Newtonsoft.Json отсутствует в списке, откройте вкладку Обзор и введите "Newtonsoft.Json" в поле поиска. Выберите Newtonsoft.Json и в области справа выберите проект, прежде чем нажать кнопку Установить.
Если Newtonsoft.Json уже установлен в системе, добавьте его в проект, выбрав проект в правой области на вкладке Управление пакетами для решения.

Ниже приведено полное содержимое файла csproj для этого проекта:

Visual Studio 15.6 и более ранние версии
Visual Studio 15.7 и более поздние версии

<Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <OutputType>Exe</OutputType>
    <TargetFramework>netcoreapp2.1</TargetFramework>
    <RuntimeIdentifiers>win-x64;osx-x64</RuntimeIdentifiers>
  </PropertyGroup>
  <ItemGroup>
    <PackageReference Include="Newtonsoft.Json" Version="10.0.2" />
  </ItemGroup>
</Project>

<Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <OutputType>Exe</OutputType>
    <TargetFramework>netcoreapp2.1</TargetFramework>
  </PropertyGroup>
  <ItemGroup>
    <PackageReference Include="Newtonsoft.Json" Version="10.0.2" />
  </ItemGroup>
</Project>

При развертывании приложения все зависимости сторонних разработчиков, используемые в нем, также содержатся в файлах приложения. Библиотеки сторонних разработчиков не требуются в системе, в которой выполняется приложение.

Автономное развертывание с библиотекой стороннего разработчика возможно только на платформах, которые поддерживаются этой библиотекой. Это похоже на наличие сторонних зависимостей с собственными зависимостями в развертывании, зависящем от платформы, где собственные зависимости существуют в целевой платформе, только если они были установлены в ней ранее.

Поделиться через

Развертывание приложений .NET Core с помощью Visual Studio

Развертывание, зависящее от платформы

развертывание, зависящее от платформы, с зависимостями сторонних разработчиков;

Автономное развертывание без сторонних зависимостей

Автономное развертывание с зависимостями сторонних разработчиков

См. также

Дополнительные ресурсы