教程:使用 Visual Studio Code 发布 .NET 控制台应用程序

本教程演示如何发布控制台应用,以便其他用户可以运行它。 发布应用程序会创建运行应用程序所需的一组文件。 若要部署文件,请将文件复制到目标计算机。

.NET CLI 用于发布应用,因此可以根据需要使用 Visual Studio Code 以外的代码编辑器来学习本教程。

先决条件

发布应用

  1. 启动 Visual Studio Code。

  2. 打开在使用 Visual Studio Code 创建 .NET 控制台应用程序中创建的 HelloWorld 项目文件夹。

  3. 从主菜单中选择“视图”>“终端” 。

    终端在 HelloWorld 文件夹中打开。

  4. 运行下面的命令:

    dotnet publish --configuration Release
    

    默认生成配置为“调试”,因此此命令指定“版本”生成配置 。 版本生成配置的输出进行了完全优化,且具有最低限度的符号调试信息。

    该命令的输出类似于以下示例:

    Microsoft (R) Build Engine version 17.8.0+b89cb5fde for .NET
    Copyright (C) Microsoft Corporation. All rights reserved.
      Determining projects to restore...
      All projects are up-to-date for restore.
      HelloWorld -> C:\Projects\HelloWorld\bin\Release\net8.0\HelloWorld.dll
      HelloWorld -> C:\Projects\HelloWorld\bin\Release\net8.0\publish\
    

检查文件

默认情况下,发布过程中会创建依赖于框架的部署,在此类部署中,已发布的应用程序在已安装 .NET 运行时的计算机上运行。 若要运行已发布的应用,可以使用可执行文件,或从命令提示符中运行 dotnet HelloWorld.dll 命令。

在下面的步骤中,查看由发布过程创建的文件。

  1. 在左侧导航栏中选择“资源管理器”。

  2. 展开 bin/Release/net7.0/publish

    Explorer showing published files

    如下图所示,已发布的输出包括以下文件:

    • HelloWorld.deps.json

      这是应用程序的运行时依赖项文件。 该文件定义了运行应用所需的 .NET 组件和库(包括包含应用程序的动态链接库)。 有关详细信息,请参阅运行时配置文件

    • HelloWorld.dll

      这是应用程序的依赖于框架的部署版本。 若要运行此动态链接库,请在命令提示符处输入 dotnet HelloWorld.dll。 这种运行应用的方法适用于安装了 .NET 运行时的任何平台。

    • HelloWorld.exe(在 Linux 或 macOS 上是 HelloWorld。)

      这是应用程序的依赖于框架的可执行文件版本。 文件特定于操作系统。

    • HelloWorld.pdb(对于部署是可选的)

      这是调试符号文件。 尽管应在需要调试应用程序的已发布版本时保存此文件,但无需将此文件与应用程序一起部署。

    • HelloWorld.runtimeconfig.json

      这是应用程序的运行时配置文件。 该文件标识用于运行应用程序的 .NET 版本。 还可向其添加配置选项。 有关详细信息,请参阅 .NET 运行时配置设置

运行已发布的应用

  1. 在“资源管理器”中,右键单击“发布”文件夹(在 macOS 上按住 Ctrl 单击),然后选择“在集成终端中打开”

    Context menu showing Open in Terminal

  2. 在 Windows 或 Linux 上,使用可执行文件运行应用。

    1. 在 Windows 上,输入 .\HelloWorld.exe,然后按 Enter

    2. 在 Linux 上,输入 ./HelloWorld,然后按 Enter

    3. 输入一个名字以响应提示,并按任意键退出。

  3. 在任何平台上,使用 dotnet 命令运行应用:

    1. 输入 dotnet HelloWorld.dll,然后按 Enter

    2. 输入一个名字以响应提示,并按任意键退出。

其他资源

后续步骤

在本教程中,你发布了一个控制台应用。 在下一教程中,你将创建类库。

本教程演示如何发布控制台应用,以便其他用户可以运行它。 发布应用程序会创建运行应用程序所需的一组文件。 若要部署文件,请将文件复制到目标计算机。

.NET CLI 用于发布应用,因此可以根据需要使用 Visual Studio Code 以外的代码编辑器来学习本教程。

先决条件

发布应用

  1. 启动 Visual Studio Code。

  2. 打开在使用 Visual Studio Code 创建 .NET 控制台应用程序中创建的 HelloWorld 项目文件夹。

  3. 从主菜单中选择“视图”>“终端” 。

    终端在 HelloWorld 文件夹中打开。

  4. 运行下面的命令:

    dotnet publish --configuration Release
    

    默认生成配置为“调试”,因此此命令指定“版本”生成配置 。 版本生成配置的输出进行了完全优化,且具有最低限度的符号调试信息。

    该命令的输出类似于以下示例:

    Microsoft (R) Build Engine version 16.7.4+b89cb5fde for .NET
    Copyright (C) Microsoft Corporation. All rights reserved.
      Determining projects to restore...
      All projects are up-to-date for restore.
      HelloWorld -> C:\Projects\HelloWorld\bin\Release\net7.0\HelloWorld.dll
      HelloWorld -> C:\Projects\HelloWorld\bin\Release\net7.0\publish\
    

检查文件

默认情况下,发布过程中会创建依赖于框架的部署,在此类部署中,已发布的应用程序在已安装 .NET 运行时的计算机上运行。 若要运行已发布的应用,可以使用可执行文件,或从命令提示符中运行 dotnet HelloWorld.dll 命令。

在下面的步骤中,查看由发布过程创建的文件。

  1. 在左侧导航栏中选择“资源管理器”。

  2. 展开 bin/Release/net7.0/publish

    Explorer showing published files

    如下图所示,已发布的输出包括以下文件:

    • HelloWorld.deps.json

      这是应用程序的运行时依赖项文件。 该文件定义了运行应用所需的 .NET 组件和库(包括包含应用程序的动态链接库)。 有关详细信息,请参阅运行时配置文件

    • HelloWorld.dll

      这是应用程序的依赖于框架的部署版本。 若要运行此动态链接库,请在命令提示符处输入 dotnet HelloWorld.dll。 这种运行应用的方法适用于安装了 .NET 运行时的任何平台。

    • HelloWorld.exe(在 Linux 上而不是在 macOS 上创建的 HelloWorld)

      这是应用程序的依赖于框架的可执行文件版本。 文件特定于操作系统。

    • HelloWorld.pdb(对于部署是可选的)

      这是调试符号文件。 尽管应在需要调试应用程序的已发布版本时保存此文件,但无需将此文件与应用程序一起部署。

    • HelloWorld.runtimeconfig.json

      这是应用程序的运行时配置文件。 该文件标识用于运行应用程序的 .NET 版本。 还可向其添加配置选项。 有关详细信息,请参阅 .NET 运行时配置设置

运行已发布的应用

  1. 在“资源管理器”中,右键单击“发布”文件夹(在 macOS 上按住 Ctrl 单击),然后选择“在终端中打开”。

    Context menu showing Open in Terminal

  2. 在 Windows 或 Linux 上,使用可执行文件运行应用。

    1. 在 Windows 上,输入 .\HelloWorld.exe,然后按 Enter。 在具有 Bash 终端的 Windows 上,输入 ./HelloWorld.exe

    2. 在 Linux 上,输入 ./HelloWorld,然后按 Enter

    3. 输入一个名字以响应提示,并按任意键退出。

  3. 在任何平台上,使用 dotnet 命令运行应用:

    1. 输入 dotnet HelloWorld.dll,然后按 Enter

    2. 输入一个名字以响应提示,并按任意键退出。

其他资源

后续步骤

在本教程中,你发布了一个控制台应用。 在下一教程中,你将创建类库。

本教程演示如何发布控制台应用,以便其他用户可以运行它。 发布应用程序会创建运行应用程序所需的一组文件。 若要部署文件,请将文件复制到目标计算机。

.NET CLI 用于发布应用,因此可以根据需要使用 Visual Studio Code 以外的代码编辑器来学习本教程。

先决条件

发布应用

  1. 启动 Visual Studio Code。

  2. 打开在使用 Visual Studio Code 创建 .NET 控制台应用程序中创建的 HelloWorld 项目文件夹。

  3. 从主菜单中选择“视图”>“终端” 。

    终端在 HelloWorld 文件夹中打开。

  4. 运行下面的命令:

    dotnet publish --configuration Release
    

    默认生成配置为“调试”,因此此命令指定“版本”生成配置 。 版本生成配置的输出进行了完全优化,且具有最低限度的符号调试信息。

    该命令的输出类似于以下示例:

    Microsoft (R) Build Engine version 16.7.0+b89cb5fde for .NET
    Copyright (C) Microsoft Corporation. All rights reserved.
      Determining projects to restore...
      All projects are up-to-date for restore.
      HelloWorld -> C:\Projects\HelloWorld\bin\Release\net6.0\HelloWorld.dll
      HelloWorld -> C:\Projects\HelloWorld\bin\Release\net6.0\publish\
    

检查文件

默认情况下,发布过程中会创建依赖于框架的部署,在此类部署中,已发布的应用程序在已安装 .NET 运行时的计算机上运行。 若要运行已发布的应用,可以使用可执行文件,或从命令提示符中运行 dotnet HelloWorld.dll 命令。

在下面的步骤中,查看由发布过程创建的文件。

  1. 在左侧导航栏中选择“资源管理器”。

  2. 展开 bin/Release/net6.0/publish。

    Explorer showing published files

    如下图所示,已发布的输出包括以下文件:

    • HelloWorld.deps.json

      这是应用程序的运行时依赖项文件。 该文件定义了运行应用所需的 .NET 组件和库(包括包含应用程序的动态链接库)。 有关详细信息,请参阅运行时配置文件

    • HelloWorld.dll

      这是应用程序的依赖于框架的部署版本。 若要运行此动态链接库,请在命令提示符处输入 dotnet HelloWorld.dll。 这种运行应用的方法适用于安装了 .NET 运行时的任何平台。

    • HelloWorld.exe(在 Linux 上而不是在 macOS 上创建的 HelloWorld)

      这是应用程序的依赖于框架的可执行文件版本。 文件特定于操作系统。

    • HelloWorld.pdb(对于部署是可选的)

      这是调试符号文件。 尽管应在需要调试应用程序的已发布版本时保存此文件,但无需将此文件与应用程序一起部署。

    • HelloWorld.runtimeconfig.json

      这是应用程序的运行时配置文件。 该文件标识用于运行应用程序的 .NET 版本。 还可向其添加配置选项。 有关详细信息,请参阅 .NET 运行时配置设置

运行已发布的应用

  1. 在“资源管理器”中,右键单击“发布”文件夹(在 macOS 上按住 Ctrl 单击),然后选择“在终端中打开”。

    Context menu showing Open in Terminal

  2. 使用可执行文件运行应用。

    1. 在 Windows 上,输入 .\HelloWorld.exe,然后按 Enter

    2. 在 Linux 或 macOS 上,输入 ./HelloWorld,然后按 Enter

    3. 输入一个名字以响应提示,并按任意键退出。

  3. 在任何平台上,使用 dotnet 命令运行应用:

    1. 输入 dotnet HelloWorld.dll,然后按 Enter

    2. 输入一个名字以响应提示,并按任意键退出。

其他资源

后续步骤

在本教程中,你发布了一个控制台应用。 在下一教程中,你将创建类库。