2 ***********************************************************************************************
\r
3 Microsoft.Common.CrossTargeting.targets
\r
5 WARNING: DO NOT MODIFY this file unless you are knowledgeable about MSBuild and have
\r
6 created a backup copy. Incorrect changes to this file will make it
\r
7 impossible to load or build your projects from the command-line or the IDE.
\r
9 Copyright (C) Microsoft Corporation. All rights reserved.
\r
10 ***********************************************************************************************
\r
13 <Project DefaultTargets="Build" xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
\r
15 <ImportByWildcardBeforeMicrosoftCommonCrossTargetingTargets Condition="'$(ImportByWildcardBeforeMicrosoftCommonCrossTargetingTargets)' == ''">true</ImportByWildcardBeforeMicrosoftCommonCrossTargetingTargets>
\r
17 <Import Project="$(MSBuildExtensionsPath)\$(MSBuildToolsVersion)\Microsoft.Common.CrossTargeting.targets\ImportBefore\*.targets"
\r
18 Condition="'$(ImportByWildcardBeforeMicrosoftCommonCrossTargetingTargets)' == 'true' and exists('$(MSBuildExtensionsPath)\$(MSBuildToolsVersion)\Microsoft.Common.CrossTargeting.targets\ImportBefore')"/>
\r
20 <Import Project="$(CustomBeforeMicrosoftCommonCrossTargetingTargets)" Condition="'$(CustomBeforeMicrosoftCommonCrossTargetingTargets)' != '' and Exists('$(CustomBeforeMicrosoftCommonCrossTargetingTargets)')"/>
\r
22 <Target Name="_ComputeTargetFrameworkItems" Returns="@(InnerOutput)">
\r
24 <_TargetFramework Include="$(TargetFrameworks)" />
\r
29 ============================================================
\r
30 DispatchToInnerBuilds
\r
32 Builds this project with /t:$(InnerTarget) /p:TargetFramework=X for each
\r
33 value X in $(TargetFrameworks)
\r
36 $(TargetFrameworks) - Semicolon delimited list of target frameworks.
\r
37 $(InnerTargets) - The targets to build for each target framework
\r
40 @(InnerOutput) - The combined output items of the inner targets across
\r
41 all target frameworks..
\r
42 ============================================================
\r
44 <Target Name="DispatchToInnerBuilds"
\r
45 DependsOnTargets="_ComputeTargetFrameworkItems"
\r
46 Returns="@(InnerOutput)">
\r
47 <!-- If this logic is changed, also update Clean -->
\r
48 <MSBuild Projects="$(MSBuildProjectFile)"
\r
49 Condition="'$(TargetFrameworks)' != '' "
\r
50 Targets="$(InnerTargets)"
\r
51 Properties="TargetFramework=%(_TargetFramework.Identity)">
\r
52 <Output ItemName="InnerOutput" TaskParameter="TargetOutputs" />
\r
57 ============================================================
\r
60 Cross-targeting version of Build.
\r
63 $(TargetFrameworks) - Semicolon delimited list of target frameworks.
\r
65 $(InnerTargets) - The targets to build for each target framework. Defaults
\r
66 to 'Build' if unset, but allows override to support
\r
67 `msbuild /p:InnerTargets=X;Y;Z` which will build X, Y,
\r
68 and Z targets for each target framework.
\r
71 @(InnerOutput) - The combined output items of the inner targets across
\r
73 ============================================================
\r
75 <Target Name="Build" DependsOnTargets="_SetBuildInnerTarget;DispatchToInnerBuilds" />
\r
77 <Target Name="_SetBuildInnerTarget" Returns="@(InnerOutput)">
\r
78 <PropertyGroup Condition="'$(InnerTargets)' == ''">
\r
79 <InnerTargets>Build</InnerTargets>
\r
85 ============================================================
\r
88 Cross-targeting version of clean.
\r
90 Inner-build dispatch is a clone of DispatchToInnerBuilds;
\r
91 the only reason it's replicated is that it must be a different
\r
92 target to be run in the same build (e.g. by Rebuild or by
\r
93 a /t:Clean;Build invocation.
\r
94 ============================================================
\r
96 <Target Name="Clean"
\r
97 DependsOnTargets="_ComputeTargetFrameworkItems">
\r
98 <!-- If this logic is changed, also update DispatchToInnerBuilds -->
\r
99 <MSBuild Projects="$(MSBuildProjectFile)"
\r
100 Condition="'$(TargetFrameworks)' != '' "
\r
102 Properties="TargetFramework=%(_TargetFramework.Identity)" />
\r
106 ============================================================
\r
109 Cross-targeting version of rebuild.
\r
110 ============================================================
\r
112 <Target Name="Rebuild" DependsOnTargets="Clean;Build" />
\r
115 This will import NuGet restore targets, which is a special case separate from the package -> project extension
\r
116 mechanism below. For obvious reasons, we need restore to work before any package assets are available.
\r
118 TODO: https://github.com/Microsoft/msbuild/issues/1061: This is now generalized with less coupling to nuget,
\r
119 but this codepath should remain as a compat shim until NuGet and the CLI use the CrossTargeting imports.
\r
122 <ImportByWildcardAfterMicrosoftCommonTargets Condition="'$(ImportByWildcardAfterMicrosoftCommonTargets)' == ''">true</ImportByWildcardAfterMicrosoftCommonTargets>
\r
124 <Import Project="$(MSBuildExtensionsPath)\$(MSBuildToolsVersion)\Microsoft.Common.targets\ImportAfter\*.NuGet.*.targets"
\r
125 Condition="'$(ImportByWildcardAfterMicrosoftCommonTargets)' == 'true' and exists('$(MSBuildExtensionsPath)\$(MSBuildToolsVersion)\Microsoft.Common.targets\ImportAfter')"/>
\r
127 <Import Project="$(CustomAfterMicrosoftCommonCrossTargetingTargets)" Condition="'$(CustomAfterMicrosoftCommonCrossTargetingTargets)' != '' and Exists('$(CustomAfterMicrosoftCommonCrossTargetingTargets)')"/>
\r
130 Allow extensions like NuGet restore to work before any package assets are available.
\r
133 <ImportByWildcardAfterMicrosoftCommonCrossTargetingTargets Condition="'$(ImportByWildcardAfterMicrosoftCommonCrossTargetingTargets)' == ''">true</ImportByWildcardAfterMicrosoftCommonCrossTargetingTargets>
\r
135 <Import Project="$(MSBuildExtensionsPath)\$(MSBuildToolsVersion)\Microsoft.Common.CrossTargeting.targets\ImportAfter\*.targets"
\r
136 Condition="'$(ImportByWildcardAfterMicrosoftCommonCrossTargetingTargets)' == 'true' and exists('$(MSBuildExtensionsPath)\$(MSBuildToolsVersion)\Microsoft.Common.CrossTargeting.targets\ImportAfter')"/>
\r
139 Import project extensions which usually come from packages. Package management systems will create a file at:
\r
140 $(MSBuildProjectExtensionsPath)\$(MSBuildProjectFile).<SomethingUnique>.targets
\r
142 Each package management system should use a unique moniker to avoid collisions. It is a wild-card iport so the package
\r
143 management system can write out multiple files but the order of the import is alphabetic because MSBuild sorts the list.
\r
145 This is the same import that would happen in an inner (non-cross targeting) build. Package management systems are responsible for generating
\r
146 appropriate conditions based on $(IsCrossTargetingBuild) to pull in only those package targets that are meant to participate in a cross-targeting
\r
150 <ImportProjectExtensionTargets Condition="'$(ImportProjectExtensionTargets)' == ''">true</ImportProjectExtensionTargets>
\r
153 <Import Project="$(MSBuildProjectExtensionsPath)$(MSBuildProjectFile).*.targets" Condition="'$(ImportProjectExtensionTargets)' == 'true' and exists('$(MSBuildProjectExtensionsPath)')" />
\r
156 <ImportDirectoryBuildTargets Condition="'$(ImportDirectoryBuildTargets)' == ''">true</ImportDirectoryBuildTargets>
\r
160 Determine the path to the directory build targets file if the user did not disable $(ImportDirectoryBuildTargets) and
\r
161 they did not already specify an absolute path to use via $(DirectoryBuildTargetsPath)
\r
163 <PropertyGroup Condition="'$(ImportDirectoryBuildTargets)' == 'true' and '$(DirectoryBuildTargetsPath)' == ''">
\r
164 <_DirectoryBuildTargetsFile Condition="'$(_DirectoryBuildTargetsFile)' == ''">Directory.Build.targets</_DirectoryBuildTargetsFile>
\r
165 <_DirectoryBuildTargetsBasePath Condition="'$(_DirectoryBuildTargetsBasePath)' == ''">$([MSBuild]::GetDirectoryNameOfFileAbove($(MSBuildProjectDirectory), '$(_DirectoryBuildTargetsFile)'))</_DirectoryBuildTargetsBasePath>
\r
166 <DirectoryBuildTargetsPath Condition="'$(_DirectoryBuildTargetsBasePath)' != '' and '$(_DirectoryBuildTargetsFile)' != ''">$([System.IO.Path]::Combine('$(_DirectoryBuildTargetsBasePath)', '$(_DirectoryBuildTargetsFile)'))</DirectoryBuildTargetsPath>
\r
169 <Import Project="$(DirectoryBuildTargetsPath)" Condition="'$(ImportDirectoryBuildTargets)' == 'true' and exists('$(DirectoryBuildTargetsPath)')"/>
\r
171 <!-- TODO: https://github.com/Microsoft/msbuild/issues/1062: Remove this temporary hook when possible. -->
\r
172 <Import Project="$(CoreCrossTargetingTargetsPath)"
\r
173 Condition="'$(CoreCrossTargetingTargetsPath)' != '' and Exists('$(CoreCrossTargetingTargetsPath)')" />
\r