教程:使用 Visual Studio Code 发布 .NET 控制台应用程序
本教程演示如何发布控制台应用,以便其他用户可以运行它。 发布应用程序会创建运行应用程序所需的一组文件。 若要部署文件,请将文件复制到目标计算机。
.NET CLI 用于发布应用,因此可以根据需要使用 Visual Studio Code 以外的代码编辑器来学习本教程。
先决条件
- 本教程适用于在使用 Visual Studio Code 创建 .NET 控制台应用程序中创建的控制台应用。
发布应用
启动 Visual Studio Code。
打开在使用 Visual Studio Code 创建 .NET 控制台应用程序中创建的 HelloWorld 项目文件夹。
从主菜单中选择“视图”>“终端” 。
终端在 HelloWorld 文件夹中打开。
运行下面的命令:
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
命令。
在下面的步骤中,查看由发布过程创建的文件。
在左侧导航栏中选择“资源管理器”。
展开 bin/Release/net7.0/publish。
如下图所示,已发布的输出包括以下文件:
HelloWorld.deps.json
这是应用程序的运行时依赖项文件。 该文件定义了运行应用所需的 .NET 组件和库(包括包含应用程序的动态链接库)。 有关详细信息,请参阅运行时配置文件。
HelloWorld.dll
这是应用程序的依赖于框架的部署版本。 若要运行此动态链接库,请在命令提示符处输入
dotnet HelloWorld.dll
。 这种运行应用的方法适用于安装了 .NET 运行时的任何平台。HelloWorld.exe(在 Linux 或 macOS 上是 HelloWorld。)
这是应用程序的依赖于框架的可执行文件版本。 文件特定于操作系统。
HelloWorld.pdb(对于部署是可选的)
这是调试符号文件。 尽管应在需要调试应用程序的已发布版本时保存此文件,但无需将此文件与应用程序一起部署。
HelloWorld.runtimeconfig.json
这是应用程序的运行时配置文件。 该文件标识用于运行应用程序的 .NET 版本。 还可向其添加配置选项。 有关详细信息,请参阅 .NET 运行时配置设置。
运行已发布的应用
在“资源管理器”中,右键单击“发布”文件夹(在 macOS 上按住 Ctrl 单击),然后选择“在集成终端中打开”。
在 Windows 或 Linux 上,使用可执行文件运行应用。
在 Windows 上,输入
.\HelloWorld.exe
,然后按 Enter。在 Linux 上,输入
./HelloWorld
,然后按 Enter。输入一个名字以响应提示,并按任意键退出。
在任何平台上,使用
dotnet
命令运行应用:输入
dotnet HelloWorld.dll
,然后按 Enter。输入一个名字以响应提示,并按任意键退出。
其他资源
后续步骤
在本教程中,你发布了一个控制台应用。 在下一教程中,你将创建类库。
本教程演示如何发布控制台应用,以便其他用户可以运行它。 发布应用程序会创建运行应用程序所需的一组文件。 若要部署文件,请将文件复制到目标计算机。
.NET CLI 用于发布应用,因此可以根据需要使用 Visual Studio Code 以外的代码编辑器来学习本教程。
先决条件
- 本教程适用于在使用 Visual Studio Code 创建 .NET 控制台应用程序中创建的控制台应用。
发布应用
启动 Visual Studio Code。
打开在使用 Visual Studio Code 创建 .NET 控制台应用程序中创建的 HelloWorld 项目文件夹。
从主菜单中选择“视图”>“终端” 。
终端在 HelloWorld 文件夹中打开。
运行下面的命令:
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
命令。
在下面的步骤中,查看由发布过程创建的文件。
在左侧导航栏中选择“资源管理器”。
展开 bin/Release/net7.0/publish。
如下图所示,已发布的输出包括以下文件:
HelloWorld.deps.json
这是应用程序的运行时依赖项文件。 该文件定义了运行应用所需的 .NET 组件和库(包括包含应用程序的动态链接库)。 有关详细信息,请参阅运行时配置文件。
HelloWorld.dll
这是应用程序的依赖于框架的部署版本。 若要运行此动态链接库,请在命令提示符处输入
dotnet HelloWorld.dll
。 这种运行应用的方法适用于安装了 .NET 运行时的任何平台。HelloWorld.exe(在 Linux 上而不是在 macOS 上创建的 HelloWorld)
这是应用程序的依赖于框架的可执行文件版本。 文件特定于操作系统。
HelloWorld.pdb(对于部署是可选的)
这是调试符号文件。 尽管应在需要调试应用程序的已发布版本时保存此文件,但无需将此文件与应用程序一起部署。
HelloWorld.runtimeconfig.json
这是应用程序的运行时配置文件。 该文件标识用于运行应用程序的 .NET 版本。 还可向其添加配置选项。 有关详细信息,请参阅 .NET 运行时配置设置。
运行已发布的应用
在“资源管理器”中,右键单击“发布”文件夹(在 macOS 上按住 Ctrl 单击),然后选择“在终端中打开”。
在 Windows 或 Linux 上,使用可执行文件运行应用。
在 Windows 上,输入
.\HelloWorld.exe
,然后按 Enter。 在具有 Bash 终端的 Windows 上,输入./HelloWorld.exe
。在 Linux 上,输入
./HelloWorld
,然后按 Enter。输入一个名字以响应提示,并按任意键退出。
在任何平台上,使用
dotnet
命令运行应用:输入
dotnet HelloWorld.dll
,然后按 Enter。输入一个名字以响应提示,并按任意键退出。
其他资源
后续步骤
在本教程中,你发布了一个控制台应用。 在下一教程中,你将创建类库。
本教程演示如何发布控制台应用,以便其他用户可以运行它。 发布应用程序会创建运行应用程序所需的一组文件。 若要部署文件,请将文件复制到目标计算机。
.NET CLI 用于发布应用,因此可以根据需要使用 Visual Studio Code 以外的代码编辑器来学习本教程。
先决条件
- 本教程适用于在使用 Visual Studio Code 创建 .NET 控制台应用程序中创建的控制台应用。
发布应用
启动 Visual Studio Code。
打开在使用 Visual Studio Code 创建 .NET 控制台应用程序中创建的 HelloWorld 项目文件夹。
从主菜单中选择“视图”>“终端” 。
终端在 HelloWorld 文件夹中打开。
运行下面的命令:
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
命令。
在下面的步骤中,查看由发布过程创建的文件。
在左侧导航栏中选择“资源管理器”。
展开 bin/Release/net6.0/publish。
如下图所示,已发布的输出包括以下文件:
HelloWorld.deps.json
这是应用程序的运行时依赖项文件。 该文件定义了运行应用所需的 .NET 组件和库(包括包含应用程序的动态链接库)。 有关详细信息,请参阅运行时配置文件。
HelloWorld.dll
这是应用程序的依赖于框架的部署版本。 若要运行此动态链接库,请在命令提示符处输入
dotnet HelloWorld.dll
。 这种运行应用的方法适用于安装了 .NET 运行时的任何平台。HelloWorld.exe(在 Linux 上而不是在 macOS 上创建的 HelloWorld)
这是应用程序的依赖于框架的可执行文件版本。 文件特定于操作系统。
HelloWorld.pdb(对于部署是可选的)
这是调试符号文件。 尽管应在需要调试应用程序的已发布版本时保存此文件,但无需将此文件与应用程序一起部署。
HelloWorld.runtimeconfig.json
这是应用程序的运行时配置文件。 该文件标识用于运行应用程序的 .NET 版本。 还可向其添加配置选项。 有关详细信息,请参阅 .NET 运行时配置设置。
运行已发布的应用
在“资源管理器”中,右键单击“发布”文件夹(在 macOS 上按住 Ctrl 单击),然后选择“在终端中打开”。
使用可执行文件运行应用。
在 Windows 上,输入
.\HelloWorld.exe
,然后按 Enter。在 Linux 或 macOS 上,输入
./HelloWorld
,然后按 Enter。输入一个名字以响应提示,并按任意键退出。
在任何平台上,使用
dotnet
命令运行应用:输入
dotnet HelloWorld.dll
,然后按 Enter。输入一个名字以响应提示,并按任意键退出。
其他资源
后续步骤
在本教程中,你发布了一个控制台应用。 在下一教程中,你将创建类库。