CPack NuGet Generator¶
New in version 3.12.
When build a NuGet package there is no direct way to control an output
filename due a lack of the corresponding CLI option of NuGet, so there
is no CPACK_NUGET_PACKAGE_FILE_NAME
variable. To form the output filename
NuGet uses the package name and the version according to its built-in rules.
Also, be aware that including a top level directory
(CPACK_INCLUDE_TOPLEVEL_DIRECTORY
) is ignored by this generator.
Variables specific to CPack NuGet generator¶
The CPack NuGet generator may be used to create NuGet packages using
CPack
. The CPack NuGet generator is a CPack
generator thus
it uses the CPACK_XXX
variables used by CPack
.
The CPack NuGet generator has specific features which are controlled by the
specifics CPACK_NUGET_XXX
variables. In the "one per group" mode
(see CPACK_COMPONENTS_GROUPING
), <compName>
placeholder
in the variables below would contain a group name (uppercased and turned into
a "C" identifier).
List of CPack NuGet generator specific variables:
-
CPACK_NUGET_COMPONENT_INSTALL
¶ Enable component packaging for CPack NuGet generator
- Mandatory
No
- Default
OFF
-
CPACK_NUGET_PACKAGE_NAME
¶ -
CPACK_NUGET_<compName>_PACKAGE_NAME
¶ The NUGET package name.
CPACK_NUGET_PACKAGE_NAME
is used as the packageid
on nuget.org- Mandatory
Yes
- Default
-
CPACK_NUGET_PACKAGE_VERSION
¶ -
CPACK_NUGET_<compName>_PACKAGE_VERSION
¶ The NuGet package version.
- Mandatory
Yes
- Default
-
CPACK_NUGET_PACKAGE_DESCRIPTION
¶ -
CPACK_NUGET_<compName>_PACKAGE_DESCRIPTION
¶ A long description of the package for UI display.
- Mandatory
Yes
- Default
CPACK_COMPONENT_GROUP_<groupName>_DESCRIPTION
,
-
CPACK_NUGET_PACKAGE_AUTHORS
¶ -
CPACK_NUGET_<compName>_PACKAGE_AUTHORS
¶ A comma-separated list of packages authors, matching the profile names on nuget.org. These are displayed in the NuGet Gallery on nuget.org and are used to cross-reference packages by the same authors.
- Mandatory
Yes
- Default
-
CPACK_NUGET_PACKAGE_TITLE
¶ -
CPACK_NUGET_<compName>_PACKAGE_TITLE
¶ A human-friendly title of the package, typically used in UI displays as on nuget.org and the Package Manager in Visual Studio. If not specified, the package ID is used.
- Mandatory
No
- Default
CPACK_COMPONENT_GROUP_<groupName>_DISPLAY_NAME
-
CPACK_NUGET_PACKAGE_OWNERS
¶ -
CPACK_NUGET_<compName>_PACKAGE_OWNERS
¶ A comma-separated list of the package creators using profile names on nuget.org. This is often the same list as in authors, and is ignored when uploading the package to nuget.org.
- Mandatory
No
- Default
None
-
CPACK_NUGET_PACKAGE_HOMEPAGE_URL
¶ -
CPACK_NUGET_<compName>_PACKAGE_HOMEPAGE_URL
¶ An URL for the package's home page, often shown in UI displays as well as nuget.org.
- Mandatory
No
- Default
-
CPACK_NUGET_PACKAGE_LICENSEURL
¶ -
CPACK_NUGET_<compName>_PACKAGE_LICENSEURL
¶ Deprecated since version 3.20: Use a local license file (
CPACK_NUGET_PACKAGE_LICENSE_FILE_NAME
) or a SPDX license identifier (CPACK_NUGET_PACKAGE_LICENSE_EXPRESSION
) instead.An URL for the package's license, often shown in UI displays as well as on nuget.org.
- Mandatory
No
- Default
None
-
CPACK_NUGET_PACKAGE_LICENSE_EXPRESSION
¶ -
CPACK_NUGET_<compName>_PACKAGE_LICENSE_EXPRESSION
¶ New in version 3.20.
A Software Package Data Exchange SPDX license identifier such as
MIT
,BSD-3-Clause
, orLGPL-3.0-or-later
. In the case of a choice of licenses or more complex restrictions, compound license expressions may be formed using boolean operators, for exampleMIT OR BSD-3-Clause
. See the SPDX specification for guidance on forming complex license expressions.If
CPACK_NUGET_PACKAGE_LICENSE_FILE_NAME
is specified,CPACK_NUGET_PACKAGE_LICENSE_EXPRESSION
is ignored.- Mandatory
No
- Default
None
-
CPACK_NUGET_PACKAGE_LICENSE_FILE_NAME
¶ -
CPACK_NUGET_<compName>_PACKAGE_LICENSE_FILE_NAME
¶ The package's license file in
.txt
or.md
format.If
CPACK_NUGET_PACKAGE_LICENSE_FILE_NAME
is specified,CPACK_NUGET_PACKAGE_LICENSE_EXPRESSION
is ignored.New in version 3.20.
- Mandatory
No
- Default
None
-
CPACK_NUGET_PACKAGE_ICONURL
¶ -
CPACK_NUGET_<compName>_PACKAGE_ICONURL
¶ Deprecated since version 3.20: Use a local icon file (
CPACK_NUGET_PACKAGE_ICON
) instead.An URL for a 64x64 image with transparency background to use as the icon for the package in UI display.
- Mandatory
No
- Default
None
-
CPACK_NUGET_PACKAGE_REQUIRE_LICENSE_ACCEPTANCE
¶ When set to a true value, the user will be prompted to accept the license before installing the package.
- Mandatory
No
- Default
None
-
CPACK_NUGET_PACKAGE_ICON
¶ -
CPACK_NUGET_<compName>_PACKAGE_ICON
¶ New in version 3.20.
The filename of a 64x64 image with transparency background to use as the icon for the package in UI display.
- Mandatory
No
- Default
None
-
CPACK_NUGET_PACKAGE_DESCRIPTION_SUMMARY
¶ -
CPACK_NUGET_<compName>_PACKAGE_DESCRIPTION_SUMMARY
¶ A short description of the package for UI display. If omitted, a truncated version of description is used.
- Mandatory
No
- Default
-
CPACK_NUGET_PACKAGE_RELEASE_NOTES
¶ -
CPACK_NUGET_<compName>_PACKAGE_RELEASE_NOTES
¶ A description of the changes made in this release of the package, often used in UI like the Updates tab of the Visual Studio Package Manager in place of the package description.
- Mandatory
No
- Default
None
-
CPACK_NUGET_PACKAGE_COPYRIGHT
¶ -
CPACK_NUGET_<compName>_PACKAGE_COPYRIGHT
¶ Copyright details for the package.
- Mandatory
No
- Default
None
-
CPACK_NUGET_PACKAGE_LANGUAGE
¶ -
CPACK_NUGET_<compName>_PACKAGE_LANGUAGE
¶ New in version 3.20.
Locale specifier for the package, for example
en_CA
.- Mandatory
No
- Default
None
-
CPACK_NUGET_PACKAGE_TAGS
¶ -
CPACK_NUGET_<compName>_PACKAGE_TAGS
¶ A space-delimited list of tags and keywords that describe the package and aid discoverability of packages through search and filtering.
- Mandatory
No
- Default
None
-
CPACK_NUGET_PACKAGE_DEPENDENCIES
¶ -
CPACK_NUGET_<compName>_PACKAGE_DEPENDENCIES
¶ A list of package dependencies.
- Mandatory
No
- Default
None
-
CPACK_NUGET_PACKAGE_DEPENDENCIES_<dependency>_VERSION
¶ -
CPACK_NUGET_<compName>_PACKAGE_DEPENDENCIES_<dependency>_VERSION
¶ A version specification for the particular dependency, where
<dependency>
is an item of the dependency list (see above) transformed withstring(MAKE_C_IDENTIFIER)
command.- Mandatory
No
- Default
None
-
CPACK_NUGET_PACKAGE_DEBUG
¶ Enable debug messages while executing CPack NuGet generator.
- Mandatory
No
- Default
OFF