Установите одного из клиентских проектов в качестве стартового и запустите приложение; оно будет функционировать точно так же, как ранее.
Смените номер версии библиотеки
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>
<b> <IncludeNativeLibrariesForSelfExtract>true</b>
