forked from Azure/azure-sdk-for-net
-
Notifications
You must be signed in to change notification settings - Fork 0
/
libraries.msbuild
468 lines (402 loc) · 20.3 KB
/
libraries.msbuild
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
<?xml version="1.0" encoding="utf-8"?>
<Project DefaultTargets="DeveloperBuild" ToolsVersion="4.0" xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
<!-- Product properties -->
<PropertyGroup>
<CommonSolution>WindowsAzureCommonLibraries.sln</CommonSolution>
<ManagementLibrariesSolution>WindowsAzureManagementLibraries.sln</ManagementLibrariesSolution>
<ProductFriendlyName>Windows Azure Management Libraries</ProductFriendlyName>
<ProductSourceFolder>$(MSBuildThisFileDirectory)src</ProductSourceFolder>
</PropertyGroup>
<!-- NuGet Packages -->
<Import Project="nuget.targets" />
<!-- Developer-specific properties -->
<Import Project="developer\$(USERNAME)\build.props" Condition="Exists('developer\$(USERNAME)\build.props')" />
<!--
Windows Azure Management Libraries SDK Builder Guide
- - -
Available Targets:
/t:DeveloperBuild
Builds the .NET solution using the development key pair.
/t:OfficialBuild
Builds officially delay signed binaries.
Drops into the binaries\unsigned folder.
/t:BuildPackages
Builds NuGet packages using the binaries folder contents.
The packages will drop to .\binaries\packages.
/t:PublishPackages
Publishes the built packages. You will need to include your
publishing key when running. Include: /p:NuGetKey=YOUR_PUBLISHING_KEY
Targets for build servers:
/t:NightlyBuild
/t:ContinuousIntegrationBuild
/t:OfficialSignedBuild
Properties of interest:
/p:BuildVersionSuffix=BUILD_SUFFIX
Inserts a string suffix value at the end of all the NuGet package versions
built and published.
/p:NuGetKey=NUGET_PUBLISHING_KEY
Provides the key used to publish to a NuGet or MyGet server.
This key should never be committed to source control.
/p:PublishSymbolSourcePackages
A true/false value indicating whether to push the symbol + source
packages to a symbol server.
/p:NuGetPublishingSource=Uri
The NuGet Server to push packages to.
/p:NuGetSymbolPublishingSource=Uri
The NuGet Server to push symbol + source packages to.
-->
<!--
Helpful build tasks in this tree
-->
<Import Project="tools\Microsoft.WindowsAzure.Build.msbuild" />
<UsingTask AssemblyFile="tools\Microsoft.WindowsAzure.Build.Tasks.dll" TaskName="ValidateStrongNameSignatureTask" />
<UsingTask AssemblyFile="tools\Microsoft.WindowsAzure.Build.Tasks.dll" TaskName="RegexReplacementTask" />
<!--
Build tasks (on-premise only)
-->
<UsingTask Condition=" Exists($(OnPremiseBuildTasks)) " TaskName="CodeSigningTask" AssemblyFile="$(OnPremiseBuildTasks)\Microsoft.WindowsAzure.Tools.Build.Tasks.OnPremise.dll" />
<UsingTask Condition=" Exists($(OnPremiseBuildTasks)) " TaskName="CorporateValidation" AssemblyFile="$(OnPremiseBuildTasks)\Microsoft.WindowsAzure.Tools.Build.Tasks.OnPremise.dll" />
<Import Condition=" Exists($(OnPremiseBuildTasks)) " Project="$(OnPremiseBuildTasks)\Microsoft.WindowsAzure.Build.OnPremise.msbuild" />
<PropertyGroup>
<OnPremiseBuild Condition=" Exists($(OnPremiseBuildTasks)) ">true</OnPremiseBuild>
<OnPremiseBuild Condition=" ! Exists($(OnPremiseBuildTasks)) ">false</OnPremiseBuild>
</PropertyGroup>
<!--
Build version parameters
-->
<PropertyGroup>
<BuildVersionSuffix></BuildVersionSuffix>
<AdditionalVersionSuffix></AdditionalVersionSuffix>
</PropertyGroup>
<!--
Compliance signing properties
- - -
Developer builds are signed using the c66ce9294aae1300 full key pair that
is unofficial and provided to the public via the Development.snk key pair.
Official builds should never use the developer key pair token.
-->
<PropertyGroup>
<MicrosoftLibrariesStrongNameToken>31bf3856ad364e35</MicrosoftLibrariesStrongNameToken>
</PropertyGroup>
<!-- Package and source/symbol publishing configuration -->
<PropertyGroup>
<NuGetPublishingSource></NuGetPublishingSource>
<NuGetSymbolPublishingSource></NuGetSymbolPublishingSource>
<NuGetKey></NuGetKey>
</PropertyGroup>
<!--
Hydra related profiles
-->
<PropertyGroup>
<GenerateHydraSpecs Condition=" '$(GenerateHydraSpecs)' == '' ">true</GenerateHydraSpecs>
</PropertyGroup>
<!--
Build profiles
-->
<PropertyGroup>
<DeveloperBuildProperties>Configuration=Debug;Platform=Any CPU;CopyToBinaries=true;GenerateHydraSpecs=$(GenerateHydraSpecs)</DeveloperBuildProperties>
<OfficialMSBuildProperties>Configuration=Release;OfficialBuild=true;Platform=Any CPU;GenerateHydraSpecs=$(GenerateHydraSpecs)</OfficialMSBuildProperties>
<Net40BuildProperty>BuildSecondConfiguration=true</Net40BuildProperty>
</PropertyGroup>
<!--
Regular developer build
-->
<Target Name="DeveloperBuild" DependsOnTargets="BuildEngineeringDependencies">
<MSBuild Projects="$(CommonSolution)"
Properties="$(DeveloperBuildProperties)"
Targets="Rebuild" />
<MSBuild Projects="$(CommonSolution)"
Properties="$(DeveloperBuildProperties);$(Net40BuildProperty)"
Targets="Rebuild" />
<MSBuild Projects="$(ManagementLibrariesSolution)"
Properties="$(DeveloperBuildProperties)"
Targets="Rebuild" />
<MSBuild Projects="$(ManagementLibrariesSolution)"
Properties="$(DeveloperBuildProperties);$(Net40BuildProperty)"
Targets="Rebuild" />
</Target>
<!--
Clean produced binaries and object files
-->
<Target Name="Clean">
<MSBuild Projects="$(CommonSolution)"
Properties="$(DeveloperBuildProperties)"
Targets="Clean" />
<MSBuild Projects="$(CommonSolution)"
Properties="$(DeveloperBuildProperties);$(Net40BuildProperty)"
Targets="Clean" />
<MSBuild Projects="$(ManagementLibrariesSolution)"
Properties="$(DeveloperBuildProperties)"
Targets="Clean" />
<MSBuild Projects="$(ManagementLibrariesSolution)"
Properties="$(DeveloperBuildProperties);$(Net40BuildProperty)"
Targets="Clean" />
<RemoveDir Directories="binaries" Condition="Exists('binaries\')" ContinueOnError="true" />
</Target>
<!--
Run all tests
-->
<UsingTask TaskName="Xunit.Runner.msbuild.xunit" AssemblyFile="tools\xunit.runner.msbuild.dll" />
<ItemGroup>
<TestDlls Include=".\src\*.Test\bin\*\*Test.dll"/>
</ItemGroup>
<Target Name="RunTests">
<MakeDir Directories="$(MSBuildProjectDirectory)\TestResults"/>
<Message Text="%(TestDlls.Filename)" />
<xunit Assemblies="@(TestDlls)" Html="$(MSBuildProjectDirectory)\TestResults\MAML.xunit.results.html" ContinueOnError="ErrorAndContinue" />
</Target>
<!--
An official build is designed for use while shipping. It generates a release
build and places binaries ready for the official Microsoft signing process
inside the binaries\unsigned folder.
After signing is complete, additional work is required to prepare the NuGet
packages for shipping.
This target can be run on any machine, but only on-premise build servers will
be able to generate and ship a complete product build as this is only part of
the story.
-->
<Target Name="OfficialBuild"
DependsOnTargets="BuildEngineeringDependencies;Clean">
<CallTarget Targets="BuildServerPreparation" />
<MSBuild Projects="$(CommonSolution)"
Properties="$(OfficialMSBuildProperties)"
Targets="Rebuild" />
<MSBuild Projects="$(CommonSolution)"
Properties="$(OfficialMSBuildProperties);$(Net40BuildProperty)"
Targets="Rebuild" />
<MSBuild Projects="$(ManagementLibrariesSolution)"
Properties="$(OfficialMSBuildProperties)"
Targets="Rebuild" />
<MSBuild Projects="$(ManagementLibrariesSolution)"
Properties="$(OfficialMSBuildProperties);$(Net40BuildProperty)"
Targets="Rebuild" />
</Target>
<!--
Nightly and continuous builds. Nightly builds can push to a NuGet server.
-->
<Target Name="NightlyBuild"
DependsOnTargets="BuildEngineeringDependencies; Clean; NightlyBuildSetProperties">
<Error Condition=" '$(NuGetKey)' == '' " Text="NuGetKey is not set." />
<CallTarget Targets="BuildServerPreparation" />
<Message Text="Packages will have the version suffix of: $(BuildVersionSuffix)$(AdditionalVersionSuffix)" Importance="high" />
<CallTarget Targets="OfficialSignedBuild; PublishPackages" />
</Target>
<Target Name="NightlyBuildSetProperties"
DependsOnTargets="GetGeneratedBuildDate">
<Message Text="Nightly builds today have the date of $(GeneratedBuildDate)." />
<CreateProperty Value="-pre-$(GeneratedBuildDate)">
<Output PropertyName="BuildVersionSuffix" TaskParameter="Value" />
</CreateProperty>
</Target>
<Target Name="ContinuousIntegrationBuild"
DependsOnTargets="BuildEngineeringDependencies; Clean; ContinuousIntegrationBuildSetProperties">
<CallTarget Targets="BuildServerPreparation" />
<Message Text="Packages will have the version suffix of: $(BuildVersionSuffix)$(AdditionalVersionSuffix)" Importance="high" />
<CallTarget Targets="OfficialSignedBuild" />
</Target>
<Target Name="ContinuousIntegrationBuildSetProperties"
DependsOnTargets="GetGeneratedBuildDate">
<CreateProperty Value="-ci-$(GeneratedBuildDate)">
<Output PropertyName="BuildVersionSuffix" TaskParameter="Value" />
</CreateProperty>
</Target>
<Target Name="FastUnsignedBuild"
DependsOnTargets="BuildEngineeringDependencies; Clean; ContinuousIntegrationBuildSetProperties">
<CallTarget Targets="BuildServerPreparation" />
<Message Text="Packages will have the version suffix of: $(BuildVersionSuffix)$(AdditionalVersionSuffix)" Importance="high" />
<CallTarget Targets="DeveloperBuild" />
<CallTarget Targets="BuildPackages" />
</Target>
<!--
Perform an on-premise official build server drop of this project. Sign the
generated binaries, build officially-versioned packages, perform compliance
validation tasks. Only build servers will be able to execute this target.
-->
<Target Name="OfficialSignedBuild" DependsOnTargets="OfficialSignedBuildNoPublish" />
<Target Name="OfficialSignedBuildNoPublish"
DependsOnTargets="OfficialBuild">
<Message Text="Validate the unsigned files" />
<CallTarget Targets="ValidateOfficialBuildBinariesBeforeSigning" />
<Error Condition=" !Exists($(OnPremiseBuildTasks)) " Text="No OnPremiseBuildTasks available, the official build will be unable to continue. $(OnPremiseBuildTasks)" />
<Message Text="Code signing" Importance="high" />
<ItemGroup>
<AssembliesToBuild Include="binaries\unsigned\Microsoft.*Azure.*.dll" />
<Net40AssembliesToBuild Include="binaries\net40\unsigned\Microsoft.*Azure.*.dll" />
</ItemGroup>
<CodeSigningTask
Description="Windows Azure SDK"
Keywords="Windows Azure .NET SDK"
UnsignedFiles="@(AssembliesToBuild)"
DestinationPath="binaries\"
SigningLogPath="binaries\signing.log"
ToolsPath="$(OnPremiseBuildTasks)" />
<Error Condition=" !Exists('binaries\Microsoft.WindowsAzure.Common.dll') " Text="The Microsoft.WindowsAzure.Common.dll binary is not in the .\binaries\ folder. Code signing likely failed." />
<Message Text="Signing .NET Framework 4.0 assemblies..." />
<CodeSigningTask
Description="Windows Azure SDK"
Keywords="Windows Azure .NET SDK"
UnsignedFiles="@(Net40AssembliesToBuild)"
DestinationPath="binaries\net40\"
SigningLogPath="binaries\net40\signing.log"
ToolsPath="$(OnPremiseBuildTasks)" />
<Error Condition=" !Exists('binaries\net40\Microsoft.WindowsAzure.Common.dll') " Text="The Microsoft.WindowsAzure.Common.dll binary is not in the .\binaries\ folder. .NET 4.0 code signing likely failed." />
<Message Text="Validate the signed files" />
<CallTarget Targets="ValidateOfficialBuildBinaries" />
<Message Text="Validating the source tree, binaries, packages and more..." />
<CallTarget Targets="ValidateCorporateCompliance" />
<Message Text="Build the official NuGet packages" />
<CallTarget Targets="BuildPackages" />
<RemoveDir Directories="binaries\unsigned" Condition="Exists('binaries\unsigned')" ContinueOnError="true" />
<RemoveDir Directories="binaries\net40\unsigned" Condition="Exists('binaries\net40\unsigned')" ContinueOnError="true" />
<Message Text="Have a nice day." />
</Target>
<!--
Everything should be delay-signed with the corporate public key token before
code signing is performed. Otherwise, the build may have mixed official and
developer-signed bits.
-->
<Target Name="ValidateOfficialBuildBinariesBeforeSigning">
<GetFrameworkSdkPath>
<Output TaskParameter="Path" PropertyName="WindowsSdkPath"/>
</GetFrameworkSdkPath>
<ItemGroup>
<DelaySignedAssembliesToValidate Include="binaries\unsigned\*.dll" />
<DelaySignedAssembliesToValidate Include="binaries\net40\unsigned\*.dll" />
</ItemGroup>
<ValidateStrongNameSignatureTask
WindowsSdkPath="$(WindowsSdkPath)"
Assembly="%(DelaySignedAssembliesToValidate.Identity)"
ExpectedTokenSignature="$(MicrosoftLibrariesStrongNameToken)"
ExpectedDelaySigned="true"
ContinueOnError="ErrorAndContinue" />
</Target>
<!--
After code signing, officially-signed bits will be available on on-premise
build servers.
-->
<Target Name="ValidateOfficialBuildBinaries">
<GetFrameworkSdkPath>
<Output TaskParameter="Path" PropertyName="WindowsSdkPath"/>
</GetFrameworkSdkPath>
<ItemGroup>
<AfterSignedAssembliesToValidate Include="binaries\*.dll" />
<AfterSignedAssembliesToValidate Include="binaries\net40\*.dll" />
</ItemGroup>
<ValidateStrongNameSignatureTask
WindowsSdkPath="$(WindowsSdkPath)"
Assembly="%(AfterSignedAssembliesToValidate.Identity)"
ExpectedTokenSignature="$(MicrosoftLibrariesStrongNameToken)"
ExpectedDelaySigned="false"
ContinueOnError="ErrorAndContinue" />
</Target>
<!--
Publish packages to a NuGet Server (nuget.org or myget.org).
-->
<Target Name="PublishPackages" DependsOnTargets="BuildPackages">
<CallTarget Targets="PublishPackagesOnly" />
</Target>
<!--
Pre-build the tasks file used for validating strong name signatures,
providing date-based build numbers, and processing regular expression
replacements in files such as NuGet specs.
-->
<Target Name="BuildEngineeringDependencies" DependsOnTargets="ForceRestorePackages">
<MSBuild Projects="tools\Microsoft.WindowsAzure.Build.Tasks\Microsoft.WindowsAzure.Build.Tasks.csproj"
Targets="Build"
Properties="Configuration=Debug;Platform=AnyCPU" />
</Target>
<!--
Force nuget package restore so that packages that include .targets files
don't need to be checked into source control.
Assumes use of a private feed, requires the following environment variables
to be set:
PRIVATE_FEED_URL: The url of the feed to pull from (in addition to the public default feed)
PRIVATE_FEED_USER_NAME: User name for access to the feed
PRIVATE_FEED_PASSWORD: Password for access to the feed
-->
<Target Name="ForceRestorePackages" Condition=" '$(GenerateHydraSpecs)' == 'true' ">
<PropertyGroup>
<NuGetRestoreConfigFile>$(MSBuildProjectDirectory)\restore.config</NuGetRestoreConfigFile>
<NuGetRestoreConfigSwitch>-ConfigFile "$(NuGetRestoreConfigFile)"</NuGetRestoreConfigSwitch>
</PropertyGroup>
<Error Text="The code generation target ForceRestorePackages requires an environment variable: PRIVATE_FEED_URL. Please see libraries.msbuild for more information." Condition=" '$(PRIVATE_FEED_URL)'=='' " />
<Error Text="The code generation target ForceRestorePackages requires an environment variable: PRIVATE_FEED_USER_NAME. Please see libraries.msbuild for more information." Condition=" '$(PRIVATE_FEED_USER_NAME)'=='' " />
<Error Text="The code generation target ForceRestorePackages requires an environment variable: PRIVATE_FEED_PASSWORD. Please see libraries.msbuild for more information." Condition=" '$(PRIVATE_FEED_PASSWORD)'=='' " />
<!-- Create config for user name and password for private feed access -->
<Delete Files="$(NuGetRestoreConfigFile)" />
<Exec Command="$(NuGetCommand) sources add -Name Hydra -Source "$(PRIVATE_FEED_URL)" $(NuGetRestoreConfigSwitch)" />
<Exec Command="$(NuGetCommand) sources Update -Name Hydra -UserName $(PRIVATE_FEED_USER_NAME) -Password "$(PRIVATE_FEED_PASSWORD)" $(NuGetRestoreConfigSwitch)"
EchoOff="true" />
<Exec Command="$(NuGetCommand) restore $(CommonSolution) $(NuGetRestoreConfigSwitch)" ContinueOnError="ErrorAndContinue" />
<Exec Command="$(NuGetCommand) restore $(ManagementLibrariesSolution) $(NuGetRestoreConfigSwitch)" ContinueOnError="ErrorAndContinue" />
<!-- delete config file, don't want to leave passwords hanging around on the build server file system -->
<Delete Files="$(NuGetRestoreConfigFile)" />
</Target>
<!--
Force nuget package restore so that packages that include .targets files
don't need to be checked into source control. Skips all private packages.
-->
<Target Name="ForceRestorePublicPackages">
<Exec Command="$(NuGetCommand) restore $(CommonSolution)" ContinueOnError="ErrorAndContinue" />
<Exec Command="$(NuGetCommand) restore $(ManagementLibrariesSolution)" ContinueOnError="ErrorAndContinue" />
</Target>
<!--
We have some important work to do when building our official product bits.
-->
<PropertyGroup>
<CorporateScanPaths>
$([System.IO.Path]::GetFullPath('$(MSBuildThisFileDirectory)\src'))
</CorporateScanPaths>
</PropertyGroup>
<Target Name="ValidateCorporateCompliance">
<Message Text="$(CorporateScanPaths)" />
<Error Text="This target must be run in an on-premise build server." Condition=" '$(OnPremiseBuild)'=='false' " />
<CallTarget Targets="CorporateValidation" />
</Target>
<!--
Tasks that should be performed on any build server before getting to work.
-->
<Target Name="BuildServerPreparation">
<!-- Log server information -->
<Message Text="Build Server Information" Importance="high" />
<Message Text="Hostname : $(COMPUTERNAME)" />
<Message Text="Build Account : $(USERDOMAIN)\$(USERNAME)" />
<!-- Useful variables to log -->
<Message Text="Build Properties and Variables" Importance="high" />
<Message Text="Common Solution : $(CommonSolution)" />
<Message Text="Libraries Solution : $(ManagementLibrariesSolution)" />
<Message Text="Product : $(ProductFriendlyName)" />
<Message Text="Source folder : $(ProductSourceFolder)" />
<!-- Modify local files -->
<CallTarget Targets="BurnBuildVersions" />
</Target>
<!--
Burn the build information into the assembly file information, NuGet specs,
and other source files before beginning a build.
This updates the AssemblyFileVersion for .NET assemblies. This is not the
same thing as an AssemblyVersion; it is only used typically by test teams and
developers when reporting bugs and associating a build to report.
WARNING:
This target actively modifies source files and should only be used in build
server scenarios where the source tree is archived or discarded after use,
but not used again for additional builds.
If you accidentally run this within your enlistment, revert AssemblyInfo.cs
changes before commiting to Git.
-->
<Target Name="BurnBuildVersions"
DependsOnTargets="GetGeneratedBuildDate">
<Message Text="Destructive burn of assembly file versions to include the build number in the revision component." />
<ItemGroup>
<AssemblyInfoFilesToUpdate Include="$(ProductSourceFolder)\**\Properties\AssemblyInfo.cs" />
</ItemGroup>
<RegexReplacementTask Files="@(AssemblyInfoFilesToUpdate)"
Find="AssemblyFileVersion\("(?<semver>\d{1,3}\.\d{1,3}\.\d{1,3}).(?<revision>)\d{1,3}"\)"
Replace="AssemblyFileVersion("${semver}.$(GeneratedBuildDate)")"
LogReplacement="true" /><!--
CONSIDER:
A future nice-to-have might be to burn the associated
NuGet semver for each assembly along with the build
information, but this would require refactoring the
build item groups. -->
</Target>
</Project>