Skip to content

Commit 7334909

Browse files
Document ArtifactsProjectName property in artifacts output layout (#51757)
* Initial plan * Document ArtifactsProjectName property in artifacts output layout docs Co-authored-by: DamianEdwards <249088+DamianEdwards@users.noreply.github.com> --------- Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com> Co-authored-by: DamianEdwards <249088+DamianEdwards@users.noreply.github.com>
1 parent 4e98dc5 commit 7334909

File tree

1 file changed

+9
-1
lines changed

1 file changed

+9
-1
lines changed

docs/core/sdk/artifacts-output.md

Lines changed: 9 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -21,7 +21,7 @@ The following table shows the default values for each level in the folder struct
2121
| Folder level | Description | Examples |
2222
|----------------|-----------------------------------|------------------------------------|
2323
| Type of output | Categories of build outputs, such as binaries, intermediate/generated files, published applications, and NuGet packages. | `bin`, `obj`, `publish`, `package` |
24-
| Project name† | Separates output by each project. | `MyApp` |
24+
| Project name† | Separates output by each project. Defaults to the MSBuild project name. Can be [customized](#how-to-configure) using the `ArtifactsProjectName` MSBuild property. | `MyApp` |
2525
| Pivot† | Distinguishes between builds of a project for different configurations, target frameworks, and runtime identifiers. If multiple elements are needed, they're joined by an underscore (`_`). Can be [customized](#how-to-configure) using the `ArtifactsPivots` MSBuild property. | `debug`, `debug_net8.0`, `release`, `release_linux-x64` |
2626

2727
† The project name subfolder is omitted for package output paths. In addition, the pivot subfolder includes only the configuration.
@@ -74,3 +74,11 @@ The "pivot" folder name defaults to a combination of target framework moniker (T
7474
<ArtifactsPivots>$(ArtifactsPivots)_MyCustomPivot</ArtifactsPivots>
7575
</PropertyGroup>
7676
```
77+
78+
The "project name" folder name defaults to the MSBuild project name. To customize it for a specific project, set the `ArtifactsProjectName` MSBuild property in the project file. For example:
79+
80+
```xml
81+
<PropertyGroup>
82+
<ArtifactsProjectName>CustomProjectName</ArtifactsProjectName>
83+
</PropertyGroup>
84+
```

0 commit comments

Comments
 (0)