ReferenceAssembly.targets

<Project>
  
  <PropertyGroup>
    <EnsureReferenceAssemblyPrerequisitesDependsOn>
      $(EnsureReferenceAssemblyPrerequisitesDependsOn);
      EnsureReferenceDestination;
      CopyIntellisenseXmls
    </EnsureReferenceAssemblyPrerequisitesDependsOn>
  </PropertyGroup>
  
  <PropertyGroup>
    <CoreBuildDependsOn>
      EnsureReferenceAssemblyPrerequisites;
      $(CoreBuildDependsOn)
    </CoreBuildDependsOn>
    <ResolveReferencesDependsOn>
      EnsureReferenceAssemblyPrerequisites;
      $(ResolveReferencesDependsOn)
    </ResolveReferencesDependsOn>
  </PropertyGroup>
  
  <Target Name="EnsureReferenceAssemblyPrerequisites"
          DependsOnTargets="$(EnsureReferenceAssemblyPrerequisitesDependsOn)" />
  
  <Target Name="EnsureReferenceDestination" >
    <!-- Create and export properties used in Reference assembly generation                       -->
    <!--                                                                                          -->
    <!-- $(ArtifactsReferenceAssemblyDir) = $(ArtifactsDir)ref\                                   -->
    <!-- $(BaseReferenceAssemblyDir) = $(ArtifactsReferenceAssemblyDir)$(AssemblyName)\           -->
    <!-- $(ReferenceAssemblyDir) = $(BaseReferenceAssemblyDir)$(Configuration)$(TargetFramework)\ -->
    <CreateProperty Condition="'$(ArtifactsReferenceAssemblyDir)'==''" Value="$(ArtifactsDir)ref\">
      <Output PropertyName="ArtifactsReferenceAssemblyDir" TaskParameter="Value"/>
    </CreateProperty>

    <CreateProperty Condition="'$(BaseReferenceAssemblyDir)'==''" Value="$(ArtifactsReferenceAssemblyDir)$(AssemblyName)\">
      <Output PropertyName="BaseReferenceAssemblyDir" TaskParameter="Value"/>
    </CreateProperty>

    <CreateProperty Condition="'$(ReferenceAssemblyDir)'==''" Value="$(BaseReferenceAssemblyDir)$(Configuration)\$(TargetFramework)\">
      <Output PropertyName="ReferenceAssemblyDir" TaskParameter="Value"/>
    </CreateProperty>
  </Target>

  <Target Name="CopyIntellisenseXmls"
          Condition="'$(ReferenceProjectRepoLocation)'=='External' and '$(RepositoryName)'=='wpf'"
          Outputs="$(IntellisenseXmlDir)$(AssemblyName).xml">
    <PropertyGroup>
      <!-- Also in global.json -->
      <DotNetApiDocsNet60>0.0.0.4</DotNetApiDocsNet60>

      <!-- 
        This blob lives in Azure storage at https://netcorenativeassets.blob.core.windows.net/resource-packages/external/windows/dotnet-api-docs_net6.0/
        Instructions for updating these artifacts are at https://github.com/dotnet/wpf/blob/master/docs/intellisense.md
      -->
      <IntellisenseXmlDir>$(CommonLibrary_NativeInstallDir)\bin\dotnet-api-docs_net6.0\$(DotNetApiDocsNet60)\_intellisense\net-6.0\</IntellisenseXmlDir>
    </PropertyGroup>
    
    <Error Condition="!Exists('$(IntellisenseXmlDir)')"
           Text="Intellisense Xml sources not found: IntellisenseXmlDir=$(IntellisenseXmlDir)" />

    <!-- 
      EnsureReferenceDestination guarantees that there is exactly 1 ref assembly 
    -->
    <PropertyGroup>
      <IntellisenseXmlFile>$(IntellisenseXmlDir)$(AssemblyName).xml</IntellisenseXmlFile>
    </PropertyGroup>

    <Message Condition="!Exists('$(IntellisenseXmlFile)')"
             Text="$(IntellisenseXmlFile) is missing" />
    
    <Copy SourceFiles="$(IntellisenseXmlFile)"
          Condition="Exists('$(IntellisenseXmlFile)')"
          DestinationFolder="$(ReferenceAssemblyDir)"          
          SkipUnchangedFiles="true"/>
  </Target>

  <!-- 
    Hand crafted reference assemblies need to be copied over into the proper artifacts location. 
    This should be done only if we're dealing with a reference assembly project and that project is
    meant to be shipped from the particular repository we're building.
  -->
  <Target Name="CopyHandCraftedReferenceProjectsToRefDir" 
          AfterTargets="PrepareForRun"
          Condition="'$(ReferenceProjectRepoLocation)'=='External' and '$(RepositoryName)'=='wpf'">
    <Copy SourceFiles="$(TargetPath)"
          Condition="Exists('$(TargetPath)')"
          DestinationFolder="$(ReferenceAssemblyDir)"
          SkipUnchangedFiles="true"/>
  </Target>
  
</Project>