c83a2fb6f9
* Add and modify commands' README files Update those READMEs that are outdated. Add READMEs for dotnet pack and dotnet restore as well. * Removing private info, adding feedback alias
3 KiB
% DOTNET-PUBLISH(1) % Microsoft Corporation dotnetclifeedback@microsoft.com % April 2016
NAME
dotnet-publish - packs the application and all of its dependencies into a folder getting it ready for publishing
SYNOPSIS
dotnet-publish [--framework]
[--runtime] [--build-base-path] [--output]
[--version-suffix] [--configuration]
[< project >]
DESCRIPTION
dotnet-publish compiles the application, reads through its dependencies specified in project.json and publishes the resulting set of files to a directory.
Depending on the type of portable app, the directory contains the following:
- Portable application - application's intermediate language (IL) code and all of application's managed dependencies.
- Portable application with native dependencies - as above with a sub-directory for each native dependencies' supported platform.
- Self-contained application - as above as well as the entire runtime for the targeted platform.
The above types are covered in more details in the types of portable applications document.
OPTIONS
[project]
dotnet-publish needs access to project.json to work. If it is not specified on invocation via [project],
project.json in the current directory will be the default.
If no project.json can be found, dotnet-publish will error out.
-f, --framework [FID]
Publish the application for a given framework identifier (FID). If not specified, FID is read from project.json. In case of no valid framework found, the command will error out. In case of multiple valid frameworks found, the command will publish for all valid frameworks.
-r, --runtime [RID]
Publish the application for a given runtime.
-b, --build-base-path [DIR]
Directory in which to place temporary outputs
-o, --output
Specify the path where to place the directory. If not specified, will default to ./bin/[configuration]/[framework]/ for portable applications. For self-contained applications, will default to ./bin/[configuration]/[framework]/[runtime]
--version-suffix [VERSION_SUFFIX]
Defines what * should be replaced with in the version field in project.json.
-c, --configuration [Debug|Release]
Configuration to use when publishing. If not specified, will default to "Debug".
EXAMPLES
dotnet publish
Publish an application using the framework found in project.json. If project.json contains runtimes node, publish
for the RID of the current platform.
dotnet publish ~/projects/app1/project.json
Publish the application using the specified project.json.
dotnet publish --framework netcoreapp1.0
Publish the current application using the netcoreapp1.0 framework.
dotnet publish --framework netcoreapp1.0 --runtime osx.10.11-x64
Publish the current application using the netcoreapp1.0 framework and runtime for OS X 10.10. This RID has to
exist in the project.json runtimes node.
SEE ALSO
dotnet-restore(1), dotnet-compile(1)