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

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

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

.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

便宜好用的国外VPS推荐