将 SmartAssembly 与单文件可执行文件一起使用 (.NET Core 6)

  • 将 SmartAssembly 与单文件可执行文件一起使用 (.NET Core 6)已关闭评论
  • 112 次浏览
  • A+
所属分类:.NET技术
摘要

.NET Core 6引入了创建单文件可执行文件的功能。这只允许分发一个应用程序文件,因为所有配置和依赖项都包含在二进制文件本身中。

.NET Core 6引入了创建单文件可执行文件的功能。这只允许分发一个应用程序文件,因为所有配置和依赖项都包含在二进制文件本身中。

该功能为依赖项嵌入提供了一种本机方法,这在发布生成数百个程序集的独立应用程序时最有益。它可用于依赖于框架或自包含的应用程序,但在这两种情况下都需要设置运行时标识符以针对特定环境和位数。

开始

首先,让我们看看发布 .NET Core 应用程序的常规过程是什么样的。

假设我们有一个名为 ConsoleApp 的 .NET Core 6 应用程序,由以下项目文件定义:

  1. <Project Sdk="Microsoft.NET.Sdk">
  2. <PropertyGroup>
  3. <OutputType>Exe</OutputType>
  4. <TargetFramework>netcoreapp6</TargetFramework>
  5. </PropertyGroup>
  6. </Project>

要发布此应用程序,我们将使用以下命令:

  1. dotnet publish .ConsoleApp.csproj -c Release -r win-x64

上面的命令将在“发布”模式下构建应用程序,然后发布为自包含并面向 Windows 64 位系统。所有依赖项(包括 .NET Core 框架程序集)和配置都将复制到已发布的目录中。

发布完成后,转到输出目录(对于上面的应用程序,这将是 ConsoleAppbinReleasenetcoreapp6win-x64publish)。注意目录中存在多少个文件。

发布独立 .NET Core 应用程序的过程可以可视化如下:

将 SmartAssembly 与单文件可执行文件一起使用 (.NET Core 6)

使用单文件可执行文件

现在,让我们将应用程序发布为单个文件。我们需要做的就是添加一个值设置为 true 的 PublishSingleFile 属性。

  1. <Project Sdk="Microsoft.NET.Sdk">
  2. <PropertyGroup>
  3. <OutputType>Exe</OutputType>
  4. <TargetFramework>netcoreapp6</TargetFramework>
  5. <PublishSingleFile>true</PublishSingleFile> <!-- add this line -->
  6. </PropertyGroup>
  7. </Project>

让我们再次发出发布命令:

  1. dotnet publish .ConsoleApp.csproj -c Release -r win-x64

完成此过程后,导航到已发布的目录(上述应用的 ConsoleAppbinReleasenetcoreapp6win-x64publish)。您应该只看到 1 个.exe文件和一个 .pdb 文件(可选)。

让我们看看启用单文件后发布过程有何变化:

将 SmartAssembly 与单文件可执行文件一起使用 (.NET Core 6)

集成智能装配

对于最后一步,让我们在程序集捆绑到单文件可执行文件之前保护它。

SmartAssembly 将在生成应用程序之后执行,但在发布并捆绑到单个文件之前执行。如下图所示:

将 SmartAssembly 与单文件可执行文件一起使用 (.NET Core 6)

步骤 1:创建智能程序集项目

  1. 打开智能装配。
  2. 单击“新建项目”。
  3. 单击“浏览程序集”。
  4. 导航到应用程序的输出目录,选择适当的程序集(对于上面的应用程序,它将是:ConsoleAppbinReleasenetcoreapp6win-x64ConsoleApp.dll)并打开
  5. 单击设置目的地
  6. 导航到应用程序的 obj 目录(对于上面的应用程序,它将是:ConsoleAppobjReleasenetcoreapp6win-x64ConsoleApp.dll)并保存。如果文件已存在,请单击“”进行覆盖。
  7. 根据需要配置项目。启用应用程序可能需要的任何保护。
  8. 单击保存以保存项目。建议将项目保存在与Visual Studio的项目文件相同的位置,名称相同(对于上面的应用,它将是:ConsoleAppConsoleApp.saproj)。

保护单文件程序集时,不应使用“依赖项合并”和“依赖项嵌入”。合并或嵌入程序集可能会导致意外行为,不建议用于此类应用程序。

步骤 2:将智能程序集集成到发布过程中

  1. 在 Visual Studio 中打开应用程序的项目。
  2. 右键单击项目名称,然后选择“管理 NuGet 包...”
  3. 切换到浏览选项卡。
  4. 键入 RedGate.SmartAssembly.MSBuild,然后单击它旁边的安装

就是这样!执行上述步骤后,项目文件应如下所示:

  1. <Project Sdk="Microsoft.NET.Sdk">
  2. <PropertyGroup>
  3. <OutputType>Exe</OutputType>
  4. <TargetFramework>netcoreapp6</TargetFramework>
  5. <PublishSingleFile>true</PublishSingleFile>
  6. </PropertyGroup>
  7.  
  8. <ItemGroup>
  9. <PackageReference Include="RedGate.SmartAssembly.MSBuild" Version="8.1.2.4975">
  10. <PrivateAssets>all</PrivateAssets>
  11. <IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
  12. </PackageReference>
  13. </ItemGroup>
  14. </Project>

现在让我们再次发出发布命令:

  1. dotnet publish .ConsoleApp.csproj -c Release -r win-x64

如果要运行同一项目的多个连续生成,则应在每次生成之前或之后清理项目。由于 SmartAssembly 将程序集模糊处理到 obj 目录中,因此下次生成命令可能会选取经过模糊处理的版本,从而导致双重模糊处理和其他意外结果。

要清理项目,请手动删除 obj 目录或发出以下命令(使用用于发布的相同配置和运行时标识符):

dotnet clean .ConsoleApp.csproj -c Release -r win-x64

如果一切顺利,您应该会在命令行中看到其他输出消息,确认 SmartAssembly 已成功保护您的应用程序(为清楚起见,缩短了路径):

Microsoft (R) Build Engine version 16.5.0+d4cbfca49 for .NET Core
Copyright (C) Microsoft Corporation. All rights reserved.

Restore completed in 206.38 ms for C:[..]ConsoleAppConsoleApp.csproj.
ConsoleApp -> C:[..]ConsoleAppbinReleasenetcoreapp6win-x64ConsoleApp.dll
Executing SmartAssembly from: C:PROGRA~1Red GateSmartAssembly 8SmartAssembly.com
Using project: C:[..]ConsoleAppConsoleApp.saproj
SmartAssembly v8.1.2.4975 Personal
Copyright c Red Gate Software Ltd 2005-2020
Loading project C:[..]ConsoleAppConsoleApp.saproj
Input=C:[..]ConsoleAppbinReleasenetcoreapp3.1win-x64ConsoleApp.dll
Loading...
Starting...
Analyzing...
Preparing...
Creating assembly...
Copying additional files...
OK

ConsoleApp -> C:[..]ConsoleAppbinReleasenetcoreapp3.1win-x64publish