私有设置对 MSBuild 项目文件中的 ProjectReference 有什么作用？

Question

前几天我在一个项目文件中看到了这个：

<ProjectReference Include="Foo\Bar\Baz.csproj">
    <Project>{A GUID HERE}</Project>
    <Name>Baz</Name>
    <Private>False</Private> <!-- ??? -->
    <ReferenceOutputAssembly>False</ReferenceOutputAssembly>
</ProjectReference>

ProjectReference 中的每个节点似乎都是不言自明的（引用的项目文件、GUID、在解决方案资源管理器中显示的名称，以及当前项目是否应该链接到引用的项目），Private 除外， Common MSBuild Project Items 页面没有记录这个值。 （有一个 Private 设置记录为 Reference 而不是 ProjectReference - 但它有 Never、Always 和 PreserveNewest 设置，不是真假）

这个设置有什么作用？

Answer 1

我只想声明，当使用<MSBuild Projects="$(MSBuildProjectFullPath)" Targets="Publish" Properties="$(_MSBuildProperties)" /> 和项目$(MSBuildProjectFullPath) 具有ProjectReferences 具有<None><CopyToPublishDirectory>PreserveNewest</CopyToPublishDirectory></None> 时，<Private>false</Private>（您可以应用于ProjectReferences）可能不起作用 .我已经阅读了 https://github.com/dotnet/sdk/blob/master/src/Tasks/Microsoft.NET.Build.Tasks/targets/Microsoft.NET.Publish.targets 周围的源代码并找到了解决方案。您需要定义_GetChildProjectCopyToPublishDirectoryItems=false，例如：<MSBuild Projects="$(MSBuildProjectFullPath)" Targets="Publish" Properties="TargetFramework=$(TargetFramework);_GetChildProjectCopyToPublishDirectoryItems=false" />

Answer 2

Private 标记维护用户对 Visual Studio 引用文件夹中“复制本地”复选框的覆盖。这控制是否使用来自 GAC 的引用，或者是否将引用的程序集复制到构建目录。

虽然我找不到任何关于此效果的 MSDN 文档（令人惊讶的是），但从行为和应用它的from the comment in Microsoft.Common.CurrentVersion.targets:1742 可以明显看出：

这在MSDN > Common MSBuild project items 中有记录，从行为和应用它的from the comment in Microsoft.Common.CurrentVersion.targets:1742 可以明显看出：

  <!--
    ============================================================

                                        ResolveAssemblyReferences

    Given the list of assemblies, find the closure of all assemblies that they depend on. These are
    what we need to copy to the output directory.

        [IN]
        @(Reference) - List of assembly references as fusion names.
        @(_ResolvedProjectReferencePaths) - List of project references produced by projects that this project depends on.

            The 'Private' attribute on the reference corresponds to the Copy Local flag in IDE.
            The 'Private' flag can have three possible values:
                - 'True' means the reference should be Copied Local
                - 'False' means the reference should not be Copied Local
                - [Missing] means this task will decide whether to treat this reference as CopyLocal or not.

        [OUT]
        @(ReferencePath) - Paths to resolved primary files.
        @(ReferenceDependencyPaths) - Paths to resolved dependency files.
        @(_ReferenceRelatedPaths) - Paths to .xmls and .pdbs.
        @(ReferenceSatellitePaths) - Paths to satellites.
        @(_ReferenceSerializationAssemblyPaths) - Paths to XML serialization assemblies created by sgen.
        @(_ReferenceScatterPaths) - Paths to scatter files.
        @(ReferenceCopyLocalPaths) - Paths to files that should be copied to the local directory.
    ============================================================
    -->