使用 Visual Studio 部署 .NET Core 应用

项目
05/10/2023

可将 .NET Core 应用程序部署为依赖框架的部署或独立部署，前者包含应用程序二进制文件，但依赖目标系统上存在的 .NET Core，而后者同时包含应用程序和 .NET Core 二进制文件。有关 .NET Core 应用程序部署的概述，请参阅 .NET Core 应用程序部署。

以下各节演示如何使用 Microsoft Visual Studio 创建下列各类部署：

依赖框架的部署
包含第三方依赖项的依赖框架的部署
独立部署
包含第三方依赖项的独立部署

有关使用 Visual Studio 开发 .NET Core 应用程序的信息，请参阅 .NET Core 依赖项和要求。

依赖框架的部署

如果不使用第三方依赖项，部属依赖框架的部署只包括生成、测试和发布应用。一个用 C# 编写的简单示例可说明此过程。

创建项目。

选择“文件”>“新建”>“项目”。在“新建项目”对话框中，在“已安装”项目类型窗格中展开你的语言的（C# 或 Visual Basic）项目类别，选择“.NET Core”，然后在中心窗格中选择控制台应用 (.NET Core) 模板。在“名称”文本框中输入项目名称，如“FDD”。选择“确定”按钮。

添加应用程序的源代码。

在编辑器中打开 Program.cs 文件或 Program.vb 文件，然后使用下列代码替换自动生成的代码。它会提示用户输入文本，并显示用户输入的个别词。它使用正则表达式 \w+ 来将输入文本中的词分开。

using System;
using System.Text.RegularExpressions;

namespace Applications.ConsoleApps
{
    public class ConsoleParser
    {
        public static void Main()
        {
            Console.WriteLine("Enter any text, followed by <Enter>:\n");
            String? s = Console.ReadLine();
            ShowWords(s ?? "You didn't enter anything.");
            Console.Write("\nPress any key to continue... ");
            Console.ReadKey();
        }

        private static void ShowWords(String s)
        {
            String pattern = @"\w+";
            var matches = Regex.Matches(s, pattern);
            if (matches.Count == 0)
            {
                Console.WriteLine("\nNo words were identified in your input.");
            }
            else
            {
                Console.WriteLine($"\nThere are {matches.Count} words in your string:");
                for (int ctr = 0; ctr < matches.Count; ctr++)
                {
                    Console.WriteLine($"   #{ctr,2}: '{matches[ctr].Value}' at position {matches[ctr].Index}");
                }
            }
        }
    }
}

Imports System.Text.RegularExpressions

Namespace Applications.ConsoleApps
    Public Module ConsoleParser
        Public Sub Main()
            Console.WriteLine("Enter any text, followed by <Enter>:")
            Console.WriteLine()
            Dim s = Console.ReadLine()
            ShowWords(s)
            Console.Write($"{vbCrLf}Press any key to continue... ")
            Console.ReadKey()
        End Sub

        Private Sub ShowWords(s As String)
            Dim pattern = "\w+"
            Dim matches = Regex.Matches(s, pattern)
            Console.WriteLine()   
            If matches.Count = 0 Then
                Console.WriteLine("No words were identified in your input.")
            Else
                Console.WriteLine($"There are {matches.Count} words in your string:")
                For ctr = 0 To matches.Count - 1
                    Console.WriteLine($"   #{ctr,2}: '{matches(ctr).Value}' at position {matches(ctr).Index}")
                Next
            End If
            Console.WriteLine()
        End Sub
    End Module
End Namespace

创建应用的调试版本。

选择“生成”>“生成解决方案”。也可通过选择“调试”>“开始调试”来编译和运行应用程序的调试版本。
部署应用。

调试并测试程序后，创建要与应用一起部署的文件。若要从 Visual Studio 发布，请执行以下操作：
1. 将工具栏上的解决方案配置从“调试”更改为“发布”，生成应用的发布（而非调试）版本。
2. 在“解决方案资源管理器”中右键单击项目（而非解决方案），然后选择“发布”。
3. 在“发布”选项卡上，选择“发布”。 Visual Studio 将包含应用程序的文件写入本地文件系统。
4. “发布”选项卡现在显示单个配置文件 FolderProfile。该配置文件的配置设置显示在选项卡的“摘要”部分。
生成的文件位于 Windows 上名为 Publish 的目录（对于 Unix 系统，是名为 publish 的目录）中的项目 \bin\release\netcoreapp2.1 子目录的子目录中。

与应用程序的文件一起，发布过程将发出包含应用调试信息的程序数据库 (.pdb) 文件。该文件主要用于调试异常。可以选择不使用应用程序文件打包该文件。但是，如果要调试应用的发布版本，则应保存该文件。

可以采用任何喜欢的方式部署完整的应用程序文件集。例如，可以使用简单的 copy 命令将其打包为 Zip 文件，或者使用选择的安装包进行部署。安装成功后，用户可通过使用 dotnet 命令或提供应用程序文件名（如 dotnet fdd.dll）来执行应用程序。

除应用程序二进制文件外，安装程序还应捆绑共享框架安装程序，或在安装应用程序的过程中将其作为先决条件进行检查。安装共享框架需要管理员/根访问权限，因为它属于计算机范围。

包含第三方依赖项的依赖框架的部署

要使用一个或多个第三方依赖项来部署依赖框架的部署，需要任何依赖项都可供项目使用。在生成应用之前，还需执行以下额外步骤：

使用 NuGet 包管理器向项目添加对 NuGet 包的引用；如果系统上还没有此包，请先安装它。要打开包管理器，请选择“工具”>“NuGet 包管理器”>“管理解决方案的 NuGet 包”。
确认系统上安装了第三方依赖项（例如，Newtonsoft.Json）；如果没有，请安装它们。 “已安装”选项卡列出了系统中已安装的 NuGet 包。如果此处未列出 Newtonsoft.Json，请选择“浏览”选项卡，然后在搜索框中输入“Newtonsoft.Json”。选择 Newtonsoft.Json，在右侧窗格中选择项目，然后选择“安装”。
如果系统中已安装 Newtonsoft.Json，请在“管理解决方案包”选项卡的右侧窗格中选择项目，将其添加到项目。

如果依赖框架的部署具有第三方依赖项，则其可移植性只与第三方依赖项相同。例如，如果某个第三方库只支持 macOS，该应用将无法移植到 Windows 系统。当第三方依赖项本身取决于本机代码时，也可能发生此情况。 Kestrel 服务器就是一个很好的示例，它需要 libuv 的本机依赖项。当为具有此类第三方依赖项的应用程序创建 FDD 时，已发布的输出会针对每个本机依赖项支持（存在于 NuGet 包中）的运行时标识符 (RID) 包含一个文件夹。

不包含第三方依赖项的独立部署

部署没有第三方依赖项的独立部署包括创建项目、修改 csproj 文件、生成、测试以及发布应用。一个用 C# 编写的简单示例可说明此过程。首先，对项目进行创建、编码及测试，就像对依赖框架的部署的操作一样：

创建项目。

选择“文件”>“新建”>“项目”。在“新建项目”对话框中，在“已安装”项目类型窗格中展开你的语言的（C# 或 Visual Basic）项目类别，选择“.NET Core”，然后在中心窗格中选择控制台应用 (.NET Core) 模板。在“名称”文本框中输入项目名称如“SCD”，然后选择“确定”按钮。

添加应用程序的源代码。

在编辑器中打开 Program.cs 或 Program.vb 文件，然后使用下列代码替换自动生成的代码。它会提示用户输入文本，并显示用户输入的个别词。它使用正则表达式 \w+ 来将输入文本中的词分开。

using System;
using System.Text.RegularExpressions;

namespace Applications.ConsoleApps
{
    public class ConsoleParser
    {
        public static void Main()
        {
            Console.WriteLine("Enter any text, followed by <Enter>:\n");
            String? s = Console.ReadLine();
            ShowWords(s ?? "You didn't enter anything.");
            Console.Write("\nPress any key to continue... ");
            Console.ReadKey();
        }

        private static void ShowWords(String s)
        {
            String pattern = @"\w+";
            var matches = Regex.Matches(s, pattern);
            if (matches.Count == 0)
            {
                Console.WriteLine("\nNo words were identified in your input.");
            }
            else
            {
                Console.WriteLine($"\nThere are {matches.Count} words in your string:");
                for (int ctr = 0; ctr < matches.Count; ctr++)
                {
                    Console.WriteLine($"   #{ctr,2}: '{matches[ctr].Value}' at position {matches[ctr].Index}");
                }
            }
        }
    }
}

Imports System.Text.RegularExpressions

Namespace Applications.ConsoleApps
    Public Module ConsoleParser
        Public Sub Main()
            Console.WriteLine("Enter any text, followed by <Enter>:")
            Console.WriteLine()
            Dim s = Console.ReadLine()
            ShowWords(s)
            Console.Write($"{vbCrLf}Press any key to continue... ")
            Console.ReadKey()
        End Sub

        Private Sub ShowWords(s As String)
            Dim pattern = "\w+"
            Dim matches = Regex.Matches(s, pattern)
            Console.WriteLine()   
            If matches.Count = 0 Then
                Console.WriteLine("No words were identified in your input.")
            Else
                Console.WriteLine($"There are {matches.Count} words in your string:")
                For ctr = 0 To matches.Count - 1
                    Console.WriteLine($"   #{ctr,2}: '{matches(ctr).Value}' at position {matches(ctr).Index}")
                Next
            End If
            Console.WriteLine()
        End Sub
    End Module
End Namespace

确定是否要使用全球化固定模式。

特别是如果应用面向 Linux，则可以通过利用全球化固定模式来减小部署的总规模。全球化固定模式适用于不具有全局意识且可以使用固定区域性的格式约定、大小写约定以及字符串比较和排序顺序的应用程序。

要启用固定模式，右键单击“解决方案资源管理器”中的项目（不是解决方案），然后选择“编辑 SCD.csproj”或“编辑 SCD.vbproj” 。然后将以下突出显示的行添加到文件中：
```
<Project Sdk="Microsoft.NET.Sdk">

  <PropertyGroup>
    <TargetFramework>net8.0</TargetFramework>
    <Nullable>enable</Nullable>
  </PropertyGroup>

  <ItemGroup>
    <RuntimeHostConfigurationOption Include="System.Globalization.Invariant" Value="true" />
  </ItemGroup> 

</Project>
```
创建应用程序的调试版本。

选择“生成”>“生成解决方案”。也可通过选择“调试”>“开始调试”来编译和运行应用程序的调试版本。通过此调试步骤，可以识别应用程序在主机平台上运行时出现的问题。仍然必须在每个目标平台上对其进行测试。

如果已启用全球化固定模式，请特别确保测试缺少对文化敏感的数据是否适合应用程序。

完成调试后，可以发布独立部署：

Visual Studio 15.6 及更早版本
Visual Studio 15.7 及更高版本

调试并测试程序后，为应用的每个目标平台创建要与应用一起部署的文件。

若要从 Visual Studio 发布应用，请执行以下操作：

定义应用的目标平台。
1. 在“解决方案资源管理器”中右键单击项目（而非解决方案），然后选择“编辑 SCD.csproj” 。
2. 在 csproj 文件（该文件用于定义应用的目标平台）的 <PropertyGroup> 部分中创建 <RuntimeIdentifiers> 标记，然后指定每个目标平台的运行时标识符 (RID)。还需要添加分号来分隔 RID。请查看运行时标识符目录，获取运行时标识符列表。
例如，以下示例表明应用在 64 位 Windows 操作系统和 64 位 OS X 操作系统上运行。
```
<PropertyGroup>
   <RuntimeIdentifiers>win-x64;osx-x64</RuntimeIdentifiers>
</PropertyGroup>
```
<RuntimeIdentifiers> 元素可能会进入 csproj 文件的任何 <PropertyGroup> 中。本节后面部分将显示完整的示例 csproj 文件。
发布你的应用。

调试并测试程序后，为应用的每个目标平台创建要与应用一起部署的文件。

若要从 Visual Studio 发布应用，请执行以下操作：
1. 将工具栏上的解决方案配置从“调试”更改为“发布”，生成应用的发布（而非调试）版本。
2. 在“解决方案资源管理器”中右键单击项目（而非解决方案），然后选择“发布”。
3. 在“发布”选项卡上，选择“发布”。 Visual Studio 将包含应用程序的文件写入本地文件系统。
4. “发布”选项卡现在显示单个配置文件 FolderProfile。该配置文件的配置设置显示在选项卡的“摘要”部分。目标运行时用于标识已发布的运行时，目标位置用于标识独立部署文件的写入位置。
5. 默认情况下，Visual Studio 将所有已发布文件写入单个目录。为了方便起见，最好为每个目标运行时创建单个配置文件，并将已发布文件置于特定于平台的目录中。这包括为每个目标平台创建单独的发布配置文件。现在，请执行下列操作，为每个平台重新生成应用程序：
  1. 在“发布”对话框中选择“创建新配置文件”。
  2. 在“选取发布目标”对话框中，将“选择文件夹”位置更改为 bin\Release\PublishOutput\win-x64。选择“确定”。
  3. 在配置文件列表中选择新配置文件 (FolderProfile1) ，并确保“目标运行时”为 win-x64。如果不是，请选择“设置”。在“配置文件设置”对话框中，将“目标运行时”更改为 win-x64，然后选择“保存”。否则，选择“取消”。
  4. 选择“发布”，发布 64 位 Windows 10 平台的应用。
  5. 请再次按照上述步骤创建 osx-x64 平台的配置文件。 “目标位置”为 bin\Release\PublishOutput\osx-x64，“目标运行时”为 osx-x64。 Visual Studio 分配给此配置文件的名称是 FolderProfile2。
每个目标位置中都包含启动应用所需的完整文件集（既包含应用文件，又包含所有 .NET Core 文件）。

可按照任何喜欢的方式部署已发布的文件。例如，可以使用简单的 copy 命令将其打包为 Zip 文件，或者使用选择的安装包进行部署。

下面是此项目完整的 csproj 文件。

<Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <OutputType>Exe</OutputType>
    <TargetFramework>netcoreapp2.1</TargetFramework>
    <RuntimeIdentifiers>win-x64;osx-x64</RuntimeIdentifiers>
  </PropertyGroup>
</Project>

调试并测试程序后，为应用的每个目标平台创建要与应用一起部署的文件。这包括为每个目标平台创建单独的配置文件。

对于应用程序所针对的每个平台，请执行以下操作：

创建目标平台的配置文件。

如果这是创建的首个配置文件，在“解决方案资源管理器”中右键单击项目（而非解决方案），然后选择“发布” 。

如果已创建配置文件，请右键单击该项目以打开“发布”对话框（如果尚未打开）。然后选择“新建配置文件”。

“选取发布目标”对话框随即打开。
选择 Visual Studio 发布应用程序的位置。

如果仅发布到单个平台，则可以在“选择文件夹”文本框中接受默认值；这会将应用程序的依赖框架的部署发布到 <project-directory>\bin\Release\netcoreapp2.1\publish 目录。

如果要发布到多个平台，请附加标识目标平台的字符串。例如，如果将字符串“linux”追加到文件路径，Visual Studio 将应用程序的依赖框架的部署发布到 <project-directory>\bin\Release\netcoreapp2.1\publish\linux 目录。
通过选择“发布”按钮旁边的下拉列表图标并选择“创建配置文件”来创建配置文件。然后选择“创建配置文件”按钮以创建配置文件。
指示要发布独立部署，并定义应用所面向的平台。
1. 在“发布”对话框中，选择“配置”链接以打开“配置文件设置”对话框。
2. 在“部署模式”列表框中选择“独立” 。
3. 在“目标运行时”列表框中，选择应用程序所面向的某个平台。
4. 选择“保存”以接受更改并关闭对话框。
为配置文件命名。
1. 选择“操作”>“重命名配置文件”，为配置文件命名。
2. 为配置文件分配标识目标平台的名称，然后选择 *“保存”。

重复上述步骤，定义应用程序所针对的任何其他目标平台。

已配置配置文件，并且现已准备好发布应用。具体方法为：

如果当前未打开“发布”窗口，在“解决方案资源管理器”中右键单击项目（而非解决方案），然后选择“发布” 。
选择想要发布的配置文件，然后选择“发布”。对要发布的每个配置文件执行此操作。

每个目标位置（示例中为 bin\release\netcoreapp2.1\publish\profile-name）都包含启动应用所需的一套完整文件（应用文件和所有 .NET Core 文件）。

可按照任何喜欢的方式部署已发布的文件。例如，可以使用简单的 copy 命令将其打包为 Zip 文件，或者使用选择的安装包进行部署。

下面是此项目完整的 csproj 文件。

<Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <OutputType>Exe</OutputType>
    <TargetFramework>netcoreapp2.1</TargetFramework>
  </PropertyGroup>
</Project>

此外，Visual Studio 还针对所面向的每个平台创建单独的发布配置文件（*.pubxml）。例如，linux 配置文件 (linux.pubxml) 的文件如下所示：

<?xml version="1.0" encoding="utf-8"?>
<!--
https://go.microsoft.com/fwlink/?LinkID=208121.
-->
<Project ToolsVersion="4.0" xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
  <PropertyGroup>
    <PublishProtocol>FileSystem</PublishProtocol>
    <Configuration>Release</Configuration>
    <Platform>Any CPU</Platform>
    <TargetFramework>netcoreapp2.1</TargetFramework>
    <PublishDir>bin\Release\netcoreapp2.1\publish\linux</PublishDir>
    <RuntimeIdentifier>win-x86</RuntimeIdentifier>
    <SelfContained>true</SelfContained>
    <_IsPortable>false</_IsPortable>
  </PropertyGroup>
</Project>

包含第三方依赖项的独立部署

部署包含一个或多个第三方依赖项的独立部署包括添加依赖项。在生成应用之前，还需执行以下额外步骤：

使用 NuGet 包管理器向项目添加对 NuGet 包的引用；如果系统上还没有此包，请先安装它。要打开包管理器，请选择“工具”>“NuGet 包管理器”>“管理解决方案的 NuGet 包”。
确认系统上安装了第三方依赖项（例如，Newtonsoft.Json）；如果没有，请安装它们。 “已安装”选项卡列出了系统中已安装的 NuGet 包。如果此处未列出 Newtonsoft.Json，请选择“浏览”选项卡，然后在搜索框中输入“Newtonsoft.Json”。选择 Newtonsoft.Json，在右侧窗格中选择项目，然后选择“安装”。
如果系统中已安装 Newtonsoft.Json，请在“管理解决方案包”选项卡的右侧窗格中选择项目，将其添加到项目。

下面是此项目的完整 csproj 文件：

Visual Studio 15.6 及更早版本
Visual Studio 15.7 及更高版本

<Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <OutputType>Exe</OutputType>
    <TargetFramework>netcoreapp2.1</TargetFramework>
    <RuntimeIdentifiers>win-x64;osx-x64</RuntimeIdentifiers>
  </PropertyGroup>
  <ItemGroup>
    <PackageReference Include="Newtonsoft.Json" Version="10.0.2" />
  </ItemGroup>
</Project>

<Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <OutputType>Exe</OutputType>
    <TargetFramework>netcoreapp2.1</TargetFramework>
  </PropertyGroup>
  <ItemGroup>
    <PackageReference Include="Newtonsoft.Json" Version="10.0.2" />
  </ItemGroup>
</Project>

部署应用程序时，应用中使用的任何第三方依赖项也包含在应用程序文件中。运行应用的系统上不需要第三方库。

可以只将具有一个第三方库的独立部署部署到该库支持的平台。这与依赖框架的部署中具有本机依赖项和第三方依赖项相似，其中的本机依赖项不会存在于目标平台上，除非之前在该平台上安装了该依赖项。

通过

使用 Visual Studio 部署 .NET Core 应用

依赖框架的部署

包含第三方依赖项的依赖框架的部署

不包含第三方依赖项的独立部署

包含第三方依赖项的独立部署

请参阅

其他资源