NuGet Pack Action

NuGet Pack

Name

A friendly name for this action (will be displayed in the actions workflow area).

Enabled

Determines if this action will be run within the relevant stage.

Project/NuSpec File

The location of the .nuspec file. For further information on creating these files, please see the NuSpec documentation.

Output directory

The location to place the resultant .nupkg files. [--OutputDirectory]

Base Path

The base path of the files defined in the nuspec file (optional). [--BasePath]

Version

The version of the package. This value will overwrite the version number provided in the nuspec file. This can be very useful for allocating version numbers based off build variables (for example $Build.Version$). [--Version]

Command Line Version

Select the version of the NuGet command line that is installed on the agent. Some other settings and options may be unavailable depending which the command line version is selected.

Using

The Using drop down is populated with any property collector whose namespace matches the pattern defined by the NuGet Pack action. The pattern for this action is ^NuGet.*

If you create a property collector for this action, make sure you select the Path Finder PlugIn type and give it a name that will match the pattern above in blue. Example names listed here, search the table's Plugin column for "NuGet Pack".

For more in-depth explanations on property collectors see Property Collectors.

Alternatively, you can select the Custom option from the Using drop down list and specify a path in the resulting input field that will be displayed. Please read Why it's a good idea to use a property collector before using this option.

Build

Build project

Determines if the project should be built before building the package. [--Build]

Configuration

The configuration to use when packaging. This option is relevant when building a .proj file. [--Properties Configuration=]

MSBuild Version

The version of MSBuild to use with this command. Leave blank to default to the MSBuild executable in your path, or otherwise the highest installed version of MSBuild. [--MSBuildVersion].

MSBuild Path

The path to the MSBuild executable to use with the command. This takes precedence over the MSBuild Version. [--MSBuildPath].

No package analysis

Skip package analysis (running of package rules). At the time of writing this includes things like checking for: Invalid Framework Folders, Misplaced Assemblies, Misplaced Script Files, Missing package descriptions etc. [--NoPackageAnalysis]

Properties

Properties

A list of properties that override values in the project file. [--Properties]

Filtering

Exclude Patterns

Specify one or more wildcard patterns, one per line, to match files to exclude when creating the package. [--Exclude]

Prevent default exclusions

Prevent default exclusion of NuGet package files and files and folders starting with a dot, such as .svn and .gitignore. [--NoDefaultExcludes]

Exclude empty directories

Prevent inclusion of empty directories when building the package. [--ExcludeEmptyDirectories]

Settings

Configuration File

A specific NuGet configuration file to use. Leave blank to use %AppData%\NuGet\nuget.config. [--ConfigFile]

Version Suffix

A suffix to append to the internally generated version number. This is typically used for appending build or other pre-release identifiers. [--Suffix].

Min Client Version

Specify the minimum version of the NuGet client that can install the created package. [--MinClientVersion]

The package contains sources and symbols

Specifies that the package contains sources and symbols. [--Symbols]

Symbol Package Format

This field is visible only if the 'The package contains sources and symbols' checkbox is selected.

Select the symbol package format. Defaults to legacy symbol package format 'symbols.nupkg'. [--SymbolPackageFormat]

Use the tool folder

Determines if the output files of the project should be put in the tool folder. [--Tool]

Include referenced projects

Include referenced projects either as dependencies or as part of the package. If a referenced project has a corresponding nuspec file that has the same name as the project, then that referenced project is added as a dependency. Otherwise, the referenced project is added as part of the package. [--IncludeReferencedProjects]

Install the package to the output directory

Prepare the package output directory to support share as feed. [--InstallPackageToOutputPath]

Output filenames without version

Prepare the package output name without the version. [--OutputFileNamesWithoutVersion]

Options

Verbosity

How much information should the command line output? [--Verbosity]

Force English output

Forces the command line to run using an invariant, English-based culture. [--ForceEnglishOutput]

Timeout (in seconds)

How long to wait for the action to finish running before timing out. Leaving this blank (or zero) will default to 86400 seconds (24 hours).

Treat failure as warning

Tick to continue build on failure marking the action with a warning status.

Ignore warnings

If this is ticked, any warnings logged will not mark the action with a warning status.

Environment

Environment Variables

Multiple environment variables can be defined - one per line. These are set before the command line is run.

Log environment variables

If this is ticked, environment variable values are written to the build log.

Generate system environment variables

Tick this checkbox to set up a list of new environment variables prefixed with 'ContinuaCI.' for all current system expression objects and variables.

Mask sensitive variable values in system environment variables

This checkbox is visible only if the 'Generate system environment variables' checkbox is ticked.

If this is ticked, the values of any variables marked as sensitive will be masked with **** when setting system environment variables. Clear this to expose the values.