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

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

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

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

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

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

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

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

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

2. Добавьте исходный код приложения.

   Откройте файл 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
   
   

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

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

4. Развертывание приложения.

   После отладки и тестирования программы создайте файлы для развертывания с помощью приложения. Чтобы опубликовать из 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-доступ, так как установка происходит на уровне всей системы.

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

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

1. Используйте диспетчер пакетов NuGet , чтобы добавить ссылку на пакет NuGet в проект; и если пакет еще недоступен в вашей системе, установите его. Чтобы открыть диспетчер пакетов, выберите Tools>NuGet Package Manager>Manage NuGet Packages for Solution.

2. Убедитесь, что сторонние зависимости (например, Newtonsoft.Json) установлены в системе и, если они нет, установите их. На вкладке "Установленные" перечислены пакеты NuGet, установленные в системе. Если Newtonsoft.Json он не указан в списке, выберите вкладку "Обзор" и введите "Newtonsoft.Json" в поле поиска. Выберите Newtonsoft.Json и в правой области выберите проект перед установкой.

3. Если Newtonsoft.Json уже установлено на вашей системе, добавьте его в проект, открыв проект в правой области на вкладке «Управление пакетами для решения».

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

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

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

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

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

2. Добавьте исходный код приложения.

   Откройте файл 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
   
   

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

   Особенно если приложение предназначено для 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>
   

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

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

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

Завершив отладку, вы можете опубликовать автономное развертывание:

Visual Studio 15.6 и более ранних версий

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

Чтобы опубликовать приложение из Visual Studio, сделайте следующее:

1. Определите платформы, на которые будет нацелено ваше приложение.

   1. Щелкните проект правой кнопкой мыши (а не решение) в обозревателе решений и выберите Изменить SCD.csproj.

   2. <RuntimeIdentifiers> Создайте тег в <PropertyGroup> разделе csproj-файла, который определяет платформы, целевые объекты приложения, и укажите идентификатор среды выполнения (RID) каждой целевой платформы. Кроме того, необходимо добавить точку с запятой для разделения идентификаторов. Список идентификаторов среды выполнения см. в каталоге идентификаторов среды выполнения.

   Например, в следующем примере указано, что приложение работает в 64-разрядных операционных системах Windows и 64-разрядной операционной системе OS X.

   <PropertyGroup>
      <RuntimeIdentifiers>win-x64;osx-x64</RuntimeIdentifiers>
   </PropertyGroup>
   

   Элемент <RuntimeIdentifiers> может включаться в любой <PropertyGroup>, который есть у вас в файле csproj. Полный пример csproj-файла появится далее в этом разделе.

2. Опубликуйте приложение.

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

   Чтобы опубликовать приложение из 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), необходимых для запуска приложения.

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

Разверните опубликованные файлы таким образом, как вам нравится. Например, вы можете упаковать их в 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 15.7 и более поздних версий

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

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

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

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

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

   Откроется диалоговое окно выбора целевого объекта публикации .

2. Выберите расположение, в котором Visual Studio публикует приложение.

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

   Если вы публикуете на нескольких платформах, добавьте строку, которая указывает на целевую платформу. Например, если вы добавляете строку "linux" в путь к файлу, Visual Studio публикует развертывание приложения, зависящее от платформы, в <каталог project-directory>\bin\Release\netcoreapp2.1\publish\linux directory.

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

4. Укажите, что вы публикуете автономное развертывание и определяете платформу, на которую будет нацелено ваше приложение.

   1. В диалоговом окне "Публикация" выберите ссылку "Настройка ", чтобы открыть диалоговое окно "Параметры профиля ".

   2. Выберите "Автономный " в списке "Режим развертывания ".

   3. В списке целевой среды выполнения выберите одну из платформ, предназначенных для приложения.

   4. Нажмите кнопку "Сохранить", чтобы принять изменения и закрыть диалоговое окно.

5. Присвойте своему профилю имя.

   1. Выберите "Действия>переименовать профиль", чтобы присвоить имя профиля.

   2. Назначьте профиль имени, которое идентифицирует целевую платформу, а затем нажмите кнопку *Сохранить.

Повторите эти действия, чтобы определить все дополнительные целевые платформы, предназначенные для приложения.

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

1. Если окно публикации в настоящее время не открыто, щелкните правой кнопкой мыши проект (а не решение) в обозревателе решений и выберите "Опубликовать".

2. Выберите профиль, который вы хотите опубликовать, а затем нажмите кнопку "Опубликовать". Сделайте это для каждого профиля, который будет опубликован.

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

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

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

Ниже приведен полный файл 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>

Автономное развертывание с сторонними зависимостями

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

1. Используйте диспетчер пакетов NuGet , чтобы добавить ссылку на пакет NuGet в проект; и если пакет еще недоступен в вашей системе, установите его. Чтобы открыть диспетчер пакетов, выберите Tools>NuGet Package Manager>Manage NuGet Packages for Solution.

2. Убедитесь, что сторонние зависимости (например, Newtonsoft.Json) установлены в системе и, если они нет, установите их. На вкладке "Установленные" перечислены пакеты NuGet, установленные в системе. Если Newtonsoft.Json он не указан в списке, выберите вкладку "Обзор" и введите "Newtonsoft.Json" в поле поиска. Выберите Newtonsoft.Json и в правой области выберите проект перед установкой.

3. Если Newtonsoft.Json уже установлено на вашей системе, добавьте его в проект, открыв проект в правой области на вкладке «Управление пакетами для решения».

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

Visual Studio 15.6 и более ранних версий

<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>

Visual Studio 15.7 и более поздних версий

<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
• Каталог идентификатора среды выполнения .NET Core (RID)