Уменьшить размер консольного .NET 5.0 приложения

Target Framework Moniker

Давайте знакомиться. В .NET 5.0 для использования Windows Forms или WPF нам недостаточно просто указать net5.0:

<PropertyGroup>   <TargetFramework>net5.0</TargetFramework>   <UseWindowsForms>true</UseWindowsForms> </PropertyGroup>

При попытке использования Windows Forms или WPF мы получаем ошибку

C:\Program Files\dotnet\sdk\5.0.201\Sdks\Microsoft.NET.Sdk\targets\Microsoft.NET.Sdk.DefaultItems.targets(369,5): error NETSDK1136: The target platform must be set to Windows (usually by including '-windows' in the TargetFramework property) when using Windows Forms or WPF, or referencing projects or packages that do so.

Решение, как подсказывает ошибка состоит в указании Target Framework Moniker

<PropertyGroup>   <TargetFramework>net5.0-windows</TargetFramework>   <UseWindowsForms>true</UseWindowsForms> </PropertyGroup>

Как это работает

При сборки автоматически импортируются файлы из Microsoft.NET.Sdk\targets.
Далее в dotnet\sdk\5.0\Sdks\Microsoft.NET.Sdk.WindowsDesktop\targets\Microsoft.NET.Sdk.WindowsDesktop.props содержится код:

    <FrameworkReference Include="Microsoft.WindowsDesktop.App" IsImplicitlyDefined="true"                         Condition="('$(UseWPF)' == 'true') And ('$(UseWindowsForms)' == 'true')"/>      <FrameworkReference Include="Microsoft.WindowsDesktop.App.WPF" IsImplicitlyDefined="true"                         Condition="('$(UseWPF)' == 'true') And ('$(UseWindowsForms)' != 'true')"/>      <FrameworkReference Include="Microsoft.WindowsDesktop.App.WindowsForms" IsImplicitlyDefined="true"                         Condition="('$(UseWPF)' != 'true') And ('$(UseWindowsForms)' == 'true')"/>

Где проблема

Дело в том, что FrameworkReference это транзитивная зависимость: Документ дизайна .NET , Документация NuGet

Это значит, что если у нас есть где-то сборка, которая использует тип из Windows Forms или из WPF мы должны будем все зависимые сборки перевести на ‘net5.0-windows’.

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

Если весь код использует Windows Forms или WPF проблемы нет, а если мы в итоге создаём консольное приложение то получаем дополнительные 60МБ при создании самодостаточного файла.

Пример

Библиотека

using System.Windows.Forms;  namespace Library {     public class Demo     {         void ShowForm()         {             var f = new Form();             f.Show();         }     } } 

Консольное приложение

using System;  class Program {     public static void Main()     {         Console.WriteLine("Hello World!");     } }

Обратим внимание, что мы не используем класс Library.Demo.

Соберём самодостаточное приложение с помощью dotnet publish:

dotnet publish ConsoleApp.csproj --self-contained -c Release -r win-x64 /p:PublishSingleFile=true /p:PublishTrimmed=true /p:IncludeAllContentForSelfExtract=true

Результат 81,8МБ !

Благодаря IncludeAllContentForSelfExtract при запуске приложение в %TEMP%\.net мы можем посмотреть из чего оно состоит.

Как же так ?
Мы не использовали Library.Demo, мы указали PublishTrimmed, а Windows Forms к нам пришёл.

Решение

Как видим dotnet publish при обычных настройках не справился со своей работой, поэтому поможем ему !

Шаг 1

В библиотеке укажем вручную зависимость фреймворка и попросим не создавать транзитивную зависимость:

<Project Sdk="Microsoft.NET.Sdk">    <PropertyGroup>     <TargetFramework>net5.0</TargetFramework>     <!-- Укажем зависимости явно -->     <DisableImplicitFrameworkReferences>true</DisableImplicitFrameworkReferences>   </PropertyGroup>     <ItemGroup>     <!-- .NET Runtime -->     <!-- В данном случае неважно будет PrivateAssets="all" или нет, всегда добавляется при сборке -->     <FrameworkReference Include="Microsoft.NETCore.App" />          <!-- Windows Desktop -->     <!-- PrivateAssets="all" - зависимость не идёт дальше -->     <FrameworkReference Include="Microsoft.WindowsDesktop.App" PrivateAssets="all"  />          <!-- Можно указать и более конкретно:       Microsoft.WindowsDesktop.App.WPF       Microsoft.WindowsDesktop.App.WindowsForms -->   </ItemGroup>  </Project>

Документация для DisableImplicitFrameworkReference

Ключевая часть PrivateAssets=»all». которая не даёт зависимости распространяться дальше.

Шаг 2

Меняем .net5.0-windows на .net5.0 в нашем консольном приложении

Результат

Собираем той же командой:

dotnet publish ConsoleApp.csproj --self-contained -c Release -r win-x64 /p:PublishSingleFile=true /p:PublishTrimmed=true /p:IncludeAllContentForSelfExtract=true

Получаем файл размером всего 18.8МБ со следующим содержимым

Заключение

Стоит ли делать так в библиотеках ?
Однозначно да !
С одной стороны это позволяет использовать типы из Windows Forms или WPF, с другой стороны у сборщика получается выкинуть всё неиспользованное и выдать меньший размер файла.