Язык программирования C#9 и платформа .NET5 - Эндрю Троелсен

Добавьте в каталог решения новый файл по имени NuGet.Config со следующим содержимым:

<?xml version="1.0" encoding="utf-8"?>

<configuration>

    <packageSources>

        <add key="local-packages" value=".CarLibraryPublish" />

    </packageSources>

</configuration>

Кроме того, вы можете очищать список источников пакетов, добавляя в узел <packageSources> элемент <clear />:

<?xml version="1.0" encoding="utf-8"?>

<configuration>

  <packageSources>

    <clear />

    <add key="local-packages" value=".CarLibraryPublish" />

    <add key="NuGet" value="https://api.nuget.org/v3/index.json" />

  </packageSources>

</configuration>

На заметку! В случае работы в Visual Studio вам придется перезапустить IDE-среду, чтобы обновленные настройки NuGet.Config вступили в силу.

Удалите ссылки на проекты из проектов CSharpCarClient и VisualBasicCarClient, после чего добавьте ссылки на пакет (находясь в каталоге решения):

dotnet add CSharpCarClient package CarLibrary

dotnet add VisualBasicCarClient package CarLibrary

Установив ссылки, скомпилируйте решение и просмотрите целевой каталог (binDebugnew5.0). Вы увидите, что в целевом каталоге находится файл CarLibrary.dll, а файл CarLibrary.nupkg отсутствует. Причина в том, что исполняющая среда .NET Core распаковывает файл CarLibrary.nupkg и добавляет содержащиеся в нем сборки как прямые ссылки.

Установите одного из клиентских проектов в качестве стартового и запустите приложение; оно будет функционировать точно так же, как ранее.

Смените номер версии библиотеки CarLibrary на 1.0.0.4 и снова создайте пакет. Теперь в каталоге Publish присутствуют два NuGet-пакета CarLibrary. Если вы опять выполните команды add package, то проект обновится для использования новой версии. На тот случай, когда предпочтительнее более старая версия, команда add package позволяет добавить номер версии для определенного пакета.

Опубликование консольных приложений (обновление в версии .NET 5)

Итак, имея приложение CarClient на C# (и связанную с ним сборку CarLibrary), каким образом вы собираетесь передавать его своим пользователям? Пакетирование приложения вместе с его зависимостями называется опубликованием. Опубликование приложений .NET Framework требовало, чтобы на целевой машине была установлена инфраструктура, и приложения .NET Core также могут быть опубликованы похожим способом, который называется развертыванием, зависящим от инфраструктуры. Однако приложения .NET Core вдобавок могут публиковаться как автономные, которые вообще не требуют наличия установленной платформы .NET Core! Когда приложение публикуется как автономное, вы обязаны указать идентификатор целевой исполняющей среды. Идентификатор исполняющей среды применяется для пакетирования вашего приложения, ориентированного на определенную ОС. Полный список доступных идентификаторов исполняющих сред приведен в каталоге .NET Core RID Catalog по ссылке https://docs.microsoft.com/ru-ru/dotnet/core/rid-catalog.

На заметку! Опубликование приложений ASP. NET Core — более сложный процесс, который будет раскрыт позже в книге.

Опубликование приложений, зависящих от инфраструктуры

Развертывание, зависящее от инфраструктуры, представляет собой стандартный режим для команды dotnet publish. Чтобы создать пакет с вашим приложением и обязательными файлами, понадобится лишь выполнить следующую команду в интерфейсе командной строки:

dotnet publish

На заметку! Команда publish использует стандартную конфигурацию для вашего проекта, которой обычно является Debug.

Приведенная выше команда помещает ваше приложение и поддерживающие его файлы (всего 16 файлов) в каталог binDebugnet5.0publish. Заглянув в упомянутый каталог, вы обнаружите два файла *.dll (CarLibrary.dll и CSharpCarClient.dll), которые содержат весь прикладной код. В качестве напоминания: файл CSharpCarClient.exe представляет собой пакетированную версию dotnet.exe, сконфигурированную для запуска CSharpCarClient.dll. Дополнительные файлы в каталоге — это файлы .NET Core, которые не входят в состав .NET Core Runtime.

Чтобы создать версию Release (которая будет помещена в каталог binreleasenet5.0publish), введите такую команду:

dotnet publish -c release

Опубликование автономных приложений

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

dotnet publish  -r win-x64 -c release -o selfcontained --self-contained true

На заметку! При создании автономного развертывания обязателен идентификатор исполняющей среды, чтобы процессу опубликования было известно, какие файлы .NET Core Runtime добавлять к вашему прикладному коду.

Команда помещает ваше приложение и его поддерживающие файлы (всего 235 файлов) в каталог selfcontained. Если вы скопируете эти файлы на другой компьютер с 64-разрядной ОС Windows, то сможете запускать приложение, даже если исполняющая среда .NET 5 на нем не установлена.

Опубликование автономных приложений в виде единственного файла

В большинстве ситуаций развертывание 235 файлов (для приложения, которое выводит всего лишь несколько строк текста) вряд ли следует считать наиболее эффективным способом предоставления вашего приложения пользователям. К счастью, в .NET 5 значительно улучшена возможность опубликования вашего приложения и межплатформенных файлов исполняющей среды в виде единственного файла. Не включаются только файлы собственных библиотек, которые должны существовать вне одиночного файла ЕХЕ.

Показанная ниже команда создает однофайловое автономное развертывание для 64-разрядных ОС Windows и помещает результат в каталог по имени singlefile:

dotnet publish -r win-x64 -c release -o singlefile --self-contained 

true -p:PublishSingleFile=true

Исследуя файлы, которые были созданы, вы обнаружите один исполняемый файл (CSharpCarClient.exe), отладочный файл (CSharpCarClient.pdb) и четыре DLL-библиотеки, специфичные для ОС. В то время как предыдущий процесс опубликования производил 235 файлов, однофайловая версия CSharpCarClient.exe имеет размер 54 Мбайт! Создание однофайлового развертывания упаковывает 235 файлов в единственный файл. За снижение количества файлов приходится платить увеличением размера файла.

Напоследок важно отметить, что собственные библиотеки тоже можно поместить в единственный файл. Модифицируйте файл CSharpCarClient.csproj следующим образом:

<Project Sdk="Microsoft.NET.Sdk">

  <ItemGroup>

    <PackageReference Include="CarLibrary" Version="1.0.0.3" />

  </ItemGroup>

  <PropertyGroup>

    <OutputType>Exe</OutputType>

    <TargetFramework>net5.0</TargetFramework>

    <IncludeNativeLibrariesForSelfExtract>true

    </IncludeNativeLibrariesForSelfExtract>

  </PropertyGroup>

</Project>

После запуска приведенной выше команды dotnet publish на выходе окажется одиночный файл. Тем не менее, это только механизм транспортировки. При запуске приложения файлы собственных библиотек будут извлечены во временное местоположение на целевой машине.

Определение местонахождения сборок исполняющей средой .NET Core

Все сборки, построенные до сих пор, были связаны напрямую (кроме только что законченного примера с пакетом NuGet). Вы добавляли либо ссылку на проект, либо прямую ссылку между проектами. В таких случаях (и в примере с NuGet)