『.NET Core CLI工具文档』dotnet-publish

最新推荐文章于 2024-08-17 17:41:27 发布
最新推荐文章于 2024-08-17 17:41:27 发布
阅读量2.7k 收藏 9
点赞数 3
分类专栏： # 『C#_常用语法』 文章标签： dotnet cli
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/qq_34202873/article/details/115348433
版权

dotnet publish

发布时主要关注一下这几个配置

配置（Relese - Any CPU）：-c Relese ，根据配置不同后面的可能是-c Debug/Test

目标框架(netcoreapp3.1)：-f netcoreapp3.1 ，根据目标框架进行填写

部署模式(框架依赖)：--self-contained false，框架依赖为false，独立部署为true

目标运行时（win-x64）： -r win-x64 ，根据目标运行时选择进行填写，部署【可移植】时该命令不需要加

因此以上的配置部署命令为 ：dotnet publish -c Release -r win-x64 -f netcoreapp3.1  --self-contained false

 

 

以下转载自https://docs.microsoft.com/zh-cn/dotnet/core/tools/dotnet-publish

dotnet publish

  • 2021/02/03本文适用于： ✔️ .NET Core 2.1 SDK 及更高版本

“属性”

dotnet publish - 将应用程序及其依赖项发布到文件夹以部署到托管系统。

摘要

.NET Core CLI复制

dotnet publish [<PROJECT>|<SOLUTION>] [-c|--configuration <CONFIGURATION>]
    [-f|--framework <FRAMEWORK>] [--force] [--interactive]
    [--manifest <PATH_TO_MANIFEST_FILE>] [--no-build] [--no-dependencies]
    [--no-restore] [--nologo] [-o|--output <OUTPUT_DIRECTORY>]
    [-p:PublishReadyToRun=true] [-p:PublishSingleFile=true] [-p:PublishTrimmed=true]
    [-r|--runtime <RUNTIME_IDENTIFIER>] [--self-contained [true|false]]
    [--no-self-contained] [-v|--verbosity <LEVEL>]
    [--version-suffix <VERSION_SUFFIX>]

dotnet publish -h|--help

描述

dotnet publish 编译应用程序、读取 project 文件中指定的所有依赖项并将生成的文件集发布到目录。 输出包括以下资产：

  • 扩展名为 dll 的程序集中的中间语言 (IL) 代码。
  • 包含项目所有依赖项的 .deps.json 文件。
  • .runtimeconfig.json 文件，其中指定了应用程序所需的共享运行时，以及运行时的其他配置选项（例如垃圾回收类型）。
  • 应用程序的依赖项，将这些依赖项从 NuGet 缓存复制到输出文件夹。

dotnet publish 命令的输出可供部署至托管系统（例如服务器、电脑、Mac、笔记本电脑）以便执行。 若要准备用于部署的应用程序，这是唯一正式受支持的方法。 根据项目指定的部署类型，托管系统不一定已在其上安装 .NET 共享运行时。 有关详细信息，请参阅使用 .NET CLI 发布 .NET 应用。

隐式还原

无需运行 dotnet restore，因为它由所有需要还原的命令隐式运行，如 dotnet new、dotnet build、dotnet run、dotnet test、dotnet publish 和 dotnet pack。 若要禁用隐式还原，请使用 --no-restore 选项。

在执行显式还原有意义的某些情况下，例如 Azure DevOps Services 中的持续集成生成中，或在需要显式控制还原发生时间的生成系统中，dotnet restore 命令仍然有用。

有关如何使用 NuGet 源的信息，请参阅 dotnet restore 文档。

MSBuild

dotnet publish 命令调用 MSBuild，后者会调用 Publish 目标。 任何传递给 dotnet publish 的参数都将传递给 MSBuild。 -c和 -o 参数分别映射到 MSBuild 的 Configuration 和 PublishDir 属性。

dotnet publish 命令接受 MSBuild 选项，如用来设置属性的 -p 和用来定义记录器的 -l。 例如，可以使用以下格式设置 MSBuild 属性：-p:<NAME>=<VALUE>。

还可通过引用 .pubxml 文件（自 .NET Core 3.1 SDK 起可用）设置与发布相关的属性。 例如：

.NET Core CLI复制

dotnet publish -p:PublishProfile=FolderProfile

前面的示例使用 <project_folder>/Properties/PublishProfiles 文件夹中的 FolderProfile.pubxml 文件。 如果在设置 PublishProfile 属性时指定路径和文件扩展名，则它们会被忽略。 默认情况下，MSBuild 会在 Properties/PublishProfiles 文件夹中查找，并假定 .pubxml 文件扩展名。 若要指定包含扩展名的路径和文件名，请设置 PublishProfileFullPath 属性，而不是 PublishProfile 属性。

有关更多信息，请参见以下资源：

自变量

  • PROJECT|SOLUTION

    要发布的项目或解决方案。

    • PROJECT 是 C#、F# 或 Visual Basic 项目文件的路径和文件名，或包含 C#、F# 或 Visual Basic 项目文件的目录的路径。如果未指定目录，则默认为当前目录。

    • SOLUTION 是解决方案文件（扩展名为 .sln）的路径和文件名，或包含解决方案文件的目录的路径。 如果未指定目录，则默认为当前目录。 自 .NET Core 3.0 SDK 起可用。

选项

  • -c|--configuration <CONFIGURATION>

    定义生成配置。 大多数项目的默认配置为 Debug，但你可以覆盖项目中的生成配置设置。

  • -f|--framework <FRAMEWORK>

    为指定的目标框架发布应用程序。 必须在项目文件中指定目标框架。

  • --force

    强制解析所有依赖项，即使上次还原已成功，也不例外。 指定此标记等同于删除 project.assets.json 文件。

  • -h|--help

    打印出有关命令的简短帮助。

  • --interactive

    允许命令停止并等待用户输入或操作。 例如，完成身份验证。 自 .NET Core 3.0 SDK 起可用。

  • --manifest <PATH_TO_MANIFEST_FILE>

    指定一个或多个目标清单，用于剪裁与应用程序一同发布的一组包。 清单文件是 dotnet store 命令输出的一部分。 若要指定多个清单，请为每个清单添加一个 --manifest 选项。

  • --no-build

    发布前不生成项目。 还将隐式设置 --no-restore 标记。

  • --no-dependencies

    忽略项目间引用，仅还原根项目。

  • --nologo

    不显示启动版权标志或版权消息。 自 .NET Core 3.0 SDK 起可用。

  • --no-restore

    运行此命令时不执行隐式还原。

  • -o|--output <OUTPUT_DIRECTORY>

    指定输出目录的路径。

    如果未指定，则默认为依赖框架的可执行文件和跨平台二进制文件的路径 [project_file_folder]/bin/[configuration]/[framework]/publish/。 默认为独立的可执行文件路径 [project_file_folder]/bin/[configuration]/[framework]/[runtime]/publish/。

    在 Web 项目中，如果输出文件夹位于项目文件夹，则连续的 dotnet publish 命令将产生嵌套的输出文件夹。 例如，如果项目文件夹是“myproject”，发布输出文件夹是“myproject/publish”，并且运行 dotnet publish 两次，则第二次运行会将“.config”和“.json”等内容文件放入“myproject/publish/publish” 。 若要避免嵌套发布文件夹，请指定一个不在项目文件夹正下方的发布文件夹，或从项目中排除发布文件夹。 若要排除名为“publishoutput”的发布文件夹，请将以下元素添加到“.csproj”文件中的 PropertyGroup 元素中 ：

    XML复制

    <DefaultItemExcludes>$(DefaultItemExcludes);publishoutput**</DefaultItemExcludes>

    • .NET Core 3.x SDK 和更高版本

      如果在发布项目时指定相对路径，则生成的输出目录相对于当前工作目录，而不是项目文件位置。

      如果在发布解决方案时指定相对路径，则所有项目的所有输出都会进入相对于当前工作目录的指定文件夹中。 若要使发布输出进入每个项目的单独文件夹，请使用 msbuild PublishDir 属性（而不是 --output 选项）指定相对路径。 例如，dotnet publish -p:PublishDir=.\publish 将每个项目的发布输出发送到包含项目文件的文件夹下的 publish 文件夹中。

    • .NET Core 2.x SDK

      如果在发布项目时指定相对路径，则生成的输出目录相对于项目文件位置，而不是当前工作目录。

      如果在发布解决方案时指定相对路径，则每个项目的输出会进入相对于项目文件位置的单独文件夹中。 如果在发布解决方案时指定绝对路径，则所有项目的所有发布输出都会进入指定文件夹中。

  • -p:PublishReadyToRun=true

    以 ReadyToRun (R2R) 格式编译应用程序集。 R2R 是一种预先 (AOT) 编译形式。 有关详细信息，请参阅 ReadyToRun 图像。 自 .NET Core 3.0 SDK 起可用。

    若要查看有关缺少的依赖项可能导致运行时失败的警告，请使用 -p:PublishReadyToRunShowWarnings=true。

    建议在发布配置文件中而不是在命令行中指定此选项。 有关详细信息，请参阅 MSBuild。

  • -p:PublishSingleFile=true

    将应用打包到特定于平台的单个文件可执行文件中。 该可执行文件是自解压缩文件，包含运行应用所需的所有依赖项（包括本机依赖项）。 首次运行应用时，应用程序将根据应用名称和生成标识符自解压缩到一个目录中。 再次运行应用程序时，启动速度将变快。 除非使用了新版本，否则应用程序无需再次进行自解压缩。 自 .NET Core 3.0 SDK 起可用。

    有关单文件发布的详细信息，请参阅单文件捆绑程序设计文档。

    建议在发布配置文件中而不是在命令行中指定此选项。 有关详细信息，请参阅 MSBuild。

  • -p:PublishTrimmed=true

    在发布自包含的可执行文件时，剪裁未使用的库以减小应用的部署大小。 有关详细信息，请参阅剪裁自包含部署和可执行文件。 从 .NET Core 3.0 开始，SDK 作为预览功能提供。

    建议在发布配置文件中而不是在命令行中指定此选项。 有关详细信息，请参阅 MSBuild。

  • --self-contained [true|false]

    .NET 运行时随应用程序一同发布，因此无需在目标计算机上安装运行时。 如果指定了运行时标识符，并且项目是可执行项目（而不是库项目），则默认值为 true。 有关详细信息，请参阅 .NET 应用程序发布和使用 .NET CLI 发布 .NET 应用。

    如果在未指定 true 或 false 的情况下使用此选项，则默认值为 true。 在这种情况下，请不要紧接在 --self-contained后放置解决方案或项目参数，因为该位置需要 true 或 false。

  • --no-self-contained

    等效于 --self-contained false。 自 .NET Core 3.0 SDK 起可用。

  • -r|--runtime <RUNTIME_IDENTIFIER>

    发布针对给定运行时的应用程序。 有关运行时标识符 (RID) 的列表，请参阅 RID 目录。 有关详细信息，请参阅 .NET 应用程序发布和使用 .NET CLI 发布 .NET 应用。

  • -v|--verbosity <LEVEL>

    设置命令的详细级别。 允许使用的值为 q[uiet]、m[inimal]、n[ormal]、d[etailed] 和 diag[nostic]。 默认值是 minimal。

  • --version-suffix <VERSION_SUFFIX>

    定义版本后缀来替换项目文件的版本字段中的星号 (*)。

示例

  • 为当前目录中的项目创建一个依赖框架的跨平台二进制文件：

    .NET Core CLI复制

    dotnet publish

    自 .NET Core 3.0 SDK 起，此示例还为当前平台创建依赖框架的可执行文件。

  • 针对特定运行时，为当前目录中的项目创建独立可执行文件：

    .NET Core CLI复制

    dotnet publish --runtime osx.10.11-x64

    项目文件中必须包含 RID。

  • 针对特定平台，为当前目录中的项目创建依赖框架的可执行文件：

    .NET Core CLI复制

    dotnet publish --runtime osx.10.11-x64 --self-contained false

    项目文件中必须包含 RID。 此示例适用于 .NET Core 3.0 SDK 及更高版本。

  • 针对特定运行时和目标框架，在当前目录中发布项目：

    .NET Core CLI复制

    dotnet publish --framework netcoreapp3.1 --runtime osx.10.11-x64

  • 发布指定的项目文件：

    .NET Core CLI复制

    dotnet publish ~/projects/app1/app1.csproj

  • 发布当前应用程序，但在还原操作期间不还原项目到项目 (P2P) 引用，只还原根项目：

    .NET Core CLI复制

    dotnet publish --no-dependencies
老陈聊架构
关注
专栏目录
因为懒得下载Visual Studio，而使用dotnet-cli这件事
程序员ken的博客
08-23 1263
关于dotnet-cli的一些使用
.NET Core 发布(dotnet publish)
willingtolove的博客
11-29 3987
文章目录一、需求二、方法1、打开cmd窗口，cd到当前目录，执行如下语句：2、创建一个用于发布的bat批处理文件三、参考 一、需求 使用.net core 3.0建的项目，一般情况下，每次想发布都要打开vs，然后点击发布，选择配置； 如果想用cmd命令行发布，应该怎么写呢？ 二、方法 项目目录如下： 1、打开cmd窗口，cd到当前目录，执行如下语句： dotnet publish -c Rel...
dotnet应用发布（编译打包）
青哥的博客
09-17 1981
NET 通过命令，编译应用程序、读取 project 文件的依赖项，生成文件集并发布到目录。官方文档中，应用发布的相关内容，在部署模型章节下面。请看应用程序发布概述。
dotnet常用命令详解
最新发布
tangPHP的博客
08-17 1165
NET CLI 使用 NuGet 来查找项目需要的依赖，如果本地缓存中没找到，则下载它们放到本地缓存中，还原过程中会检测相关依赖的兼容性。nuget locals：命令清除或列出 http 请求缓存、临时缓存或计算机范围的全局包文件夹中的本地 NuGet 资源。所以此命令的场景一般用于在自动化部署的流程中控制执行流程中使用，先在其他命令中使用。run 命令会使用依赖的缓存，所以不建议在生产环境使用此命令运行应用。watch：运行项目在热重载模式下，即监听文件的变更会自动重启项目。
C# .NET .NETCORE ABP 项目发布
面朝大海，春暖花开
03-24 1387
This topic applies to: ✓.NET Core SDK 1.x✓.NET Core SDK 2.x 在项目目录用命令行运行： dotnet publish - Packs the application and its dependencies into a folder for deployment to a hosting system. dot...
.net 发布程序为exe，并且隐藏命令行窗口
weixin_41463944的博客
04-29 253
.net 发布程序为exe，并且隐藏命令行窗口
在.NET Core 3.0中发布单个Exe文件(PublishSingleFile)
qq_39110534的博客
11-04 989
假设我有一个简单的“ Hello World”控制台应用程序，我想发送给朋友来运行。朋友没有安装.NET Core，所以我知道我需要为他构建一个独立的应用程序。很简单，我只需在项目目录中运行以下命令： dotnet publish -r win-x64 -c Release --self-contained 朋友是多少位的操作系统，你就标记要发布成什么样子的，--self-co...
dotnet publish
weixin_30289831的博客
04-15 960
发布Release版本：dotnet publish --configuration Release 发布Debug版本：dotnet publish --configuration Debug 转载于:https://www.cnblogs.com/lishidefengchen/p/10710046.html
.NET：Core CLI常用命令
子昊
03-11 766
注：[]表示可选、<>表示必传、-简称、--全称、|或者 基础信息 dotnet --info 描述：查看系统安装的所有SDK的信息 dotnet --version 描述：当前使用的SDK版本 dotnet new global.json --sdk-version 3.1.200 描述：给当前目录创建一个版本文件，确定当前文件使用的SDK版本（实际上是在当前目录创建一个文件，文件中确定版本号，dotnet调用版本时是从项目的当前目录向上搜索版本文件，用以确定版本，如
dotnet-sdk-3.1.403-win-x64下载.rar
07-11
在安装此SDK后，开发者可以利用Visual Studio或命令行工具（如dotnet CLI）进行.NET 3.1应用的开发。 压缩包内的文件"dotnet下载"可能是.NET SDK的安装程序，解压后应按照指示进行安装。安装过程中，系统会自动配置...
开源项目-dotnet-cli.zip
10-20
.NET CLI是用于创建、构建、运行.NET应用程序的跨平台工具链，支持.NET Core和.NET Framework等不同版本的.NET。 描述中的“Go IDE: Why I'd never touch VSCode - even when it runs on Linux”虽然看似与标题的...
.NET6.0官方中文文档.pdf
11-15
CLI命令如`dotnet build`、`dotnet publish`等是日常开发中的常用工具，文档为每个命令提供了详尽的解释。 最后，文档还包含了一系列与NuGet包管理相关的命令，如`dotnet nuget push`用于发布包，`dotnet nuget ...
『.NET Core CLI工具文档』（十三）dotnet-publish
weixin_33782386的博客
08-03 193
说明：本文是个人翻译文章，由于个人水平有限，有不对的地方请大家帮忙更正。原文：dotnet-publish翻译：dotnet-publish 名称 dotnet-publish - 打包应用程序及其所有依赖到一个文件夹中，获取后准备发布 概要 `dotnet publish [--framework] [--runtime] [--bui...
.NET Core 跨平台发布(dotnet publish)
weixin_34217773的博客
05-09 484
.NET Core 跨平台发布(dotnet publish) ,无需安装.NET Core SDK,就可以运行。 前面讲解了.NET Core 的VSCode 开发。现在来讲讲发布（dotnet publish）。 .NET Core and ASP.NET Core 1.0 RC2 runtime and libraries 在五月中旬发布。 .NET Core and ASP.NET ...
开发日记：DotNetCore 批处理 发布
老罗传奇
07-09 129
@echo off@title 中医科院 - 发布@echo ******************************************************@echo ===============通过命令dotnet publish进行发布=========@echo 1.svn_home 安装TortoiseSVN的目录@echo 2.sourcecode_di...
.Net Core控制台生成exe能独立运行，依赖文件都单独生成在一个publish文件夹里
热门推荐
u011511086的专栏
05-23 2万+
修改项目的csproj文件内容，加入 &amp;lt;RuntimeIdentifier&amp;gt;win10-x64&amp;lt;/RuntimeIdentifier&amp;gt; 变成： &amp;lt;PropertyGroup&amp;gt; &amp;lt;OutputType&amp;gt;Exe&amp;lt;/OutputType&amp;gt; &a
.net core linux 生产环境,ASP.NET Core 发布至Linux生产环境 Ubuntu 系统
weixin_35918198的博客
05-08 242
ASP.NET Core 发布至Linux生产环境 Ubuntu 系统，之前跟大家讲解了 dotnet publish 发布，而没有将整个系统串起来。今天就跟大家综合的讲一下ASP.NET Core发布至Linux生产环境。开发及发布环境：WIN10 x64生产Linux环境：Ubuntu 14.04发布的示例代码：https://github.com/linezero/NETCoreBBS代码...
IIS安装、配置 发布网站 报错解决方案
shuai_wy的专栏
02-28 3969
IIS安装、配置 发布网站 报错解决方案 HTTP 错误 500.19- Internal Server Error法请求该页面配置，因为页面的相关配置数据无效####HTTP 错误 500.21 - Internal Server Error PageHandlerFactor 未能写入输出文件“c:\Windows\Microsoft.NET\Framework64\v4.0.30319\Temporary
dotnet+publish
12-29
dotnet publish是.NET Core CLI中的一个命令，用于将应用程序发布到指定的目标文件夹或发布配置文件中指定的目标位置。它可以将应用程序及其依赖项打包成可执行文件或可部署的文件夹。 以下是使用dotnet publish命令的示例： 1. 发布到文件夹： ```shell dotnet publish -o <output_directory> ``` 这将把应用程序及其依赖项发布到指定的输出文件夹中。 2. 使用发布配置文件： ```shell dotnet publish -p:PublishProfile=<profile_name> ``` 这将使用指定的发布配置文件将应用程序发布到目标位置。 请注意，上述示例中的`<output_directory>`和`<profile_name>`需要根据实际情况进行替换。
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

老陈聊架构

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付：¥1
获取中
扫码支付

您的余额不足，请更换扫码支付或充值

打赏作者

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值