การตั้งค่าส่วนตัวทำอะไรกับ ProjectReference ในไฟล์โครงการ MSBuild

ฉันเห็นสิ่งนี้ในไฟล์โครงการเมื่อวันก่อน:

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

ทุกโหนดใน a ProjectReferenceดูเหมือนจะอธิบายได้ด้วยตนเอง (ไฟล์โปรเจ็กต์อ้างอิง GUID ชื่อที่จะแสดงในตัวสำรวจโซลูชันและโปรเจ็กต์ปัจจุบันควรเชื่อมโยงกับโปรเจ็กต์ที่อ้างอิงหรือไม่) ยกเว้นPrivateและเพจCommon MSBuild Project Itemsไม่ ' t บันทึกค่านี้ (มีเป็นPrivateตั้งค่าเอกสารสำหรับReferenceมากกว่าProjectReference- แต่มันก็มีNever, AlwaysและPreserveNewestการตั้งค่าไม่เป็นความจริงและเท็จ)

การตั้งค่านี้ทำอะไร

Privateแท็กยังคงใช้แทนที่การ "คัดลอกท้องถิ่น" ช่องทำเครื่องหมายในภาพโฟลเดอร์อ้างอิงสตูดิโอ สิ่งนี้ควบคุมว่าจะใช้การอ้างอิงจาก GAC หรือว่าจะคัดลอกแอสเซมบลีที่อ้างอิงไปยังไดเร็กทอรีบิลด์

ในขณะที่ฉันไม่พบเอกสาร MSDN ใด ๆ สำหรับเอฟเฟกต์นี้ (แปลกใจแปลกใจ) เห็นได้ชัดจากพฤติกรรมและจากความคิดเห็นMicrosoft.Common.CurrentVersion.targets:1742ที่นำไปใช้:

เอกสารนี้อยู่ในMSDN> ไอเท็มโครงการ MSBuild ทั่วไปและเห็นได้ชัดจากพฤติกรรมและจากความคิดเห็น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.
    ============================================================
    -->

ฉันต้องการเพียงแค่ให้อยู่ในสถานะที่<Private>false</Private>(ซึ่งคุณสามารถนำไปใช้กับProjectReferences) อาจไม่ทำงานเมื่อใช้<MSBuild Projects="$(MSBuildProjectFullPath)" Targets="Publish" Properties="$(_MSBuildProperties)" />และโครงการ$(MSBuildProjectFullPath)มีProjectReferences <None><CopyToPublishDirectory>PreserveNewest</CopyToPublishDirectory></None> ที่มี ฉันอ่านซอร์สโค้ดรอบ ๆ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" />