Inside the Microsoft Build Engine: Using MSBuild and Team Foundation Build, First Edition

Cover
......Page 1
Copyright page
......Page 2
Dedication
......Page 3
Contents at a Glance......Page 5
Table of Contents......Page 7
Foreword......Page 15
William Bartholomew......Page 17
Introduction......Page 19
Organization of This Book......Page 20
System Requirements......Page 21
Support for This Book......Page 22
Part I: Overview......Page 23
Project File Details......Page 25
Properties and Targets......Page 26
Items......Page 30
Item Metadata......Page 33
Simple Conditions......Page 37
Default/Initial Targets......Page 39
MSBuild.exe Command Line Usage......Page 40
Extending the Build Process......Page 42
Properties......Page 45
Environment Variables......Page 48
Reserved Properties......Page 49
Command Line Properties......Page 51
Dynamic Properties......Page 52
Items......Page 54
Copy Task......Page 56
Well-Known Item Metadata......Page 60
Custom Metadata......Page 64
Item Transformations......Page 65
Dynamic Properties and Items: MSBuild 3.5......Page 71
Dynamic Properties and Items: MSBuild 2.0......Page 78
Property and Item Evaluation......Page 82
Importing Files......Page 85
Extending the Build Process......Page 90
Part II: Customizing MSBuild......Page 97
Custom Task Requirements......Page 99
Creating Your First Task......Page 100
Task Input/Output......Page 102
Supported Task Input and Output Types......Page 107
Using Arrays with Task Inputs and Outputs......Page 109
Extending ToolTask......Page 113
ToolTask Methods......Page 114
ToolTask Properties......Page 115
Debugging Tasks......Page 120
Overview......Page 125
Console Logger......Page 127
File Logger......Page 128
ILogger Interface......Page 130
Creating Custom Loggers......Page 131
Extending the Logger Abstract Class......Page 137
Extending Existing Loggers......Page 143
FileLoggerBase and XmlLogger......Page 149
Debugging Loggers......Page 155
Part III: Advanced MSBuild Topics......Page 159
Batching Overview......Page 161
Task Batching......Page 164
Target Batching......Page 168
Combining Task and Target Batching......Page 170
Multi-batching......Page 173
Using Batching to Build Multiple Configurations......Page 176
Batching Using Multiple Expressions......Page 179
Batching Using Shared Metadata......Page 182
Incremental Building......Page 187
Partially Building Targets......Page 189
Exec Task......Page 193
MSBuild Task......Page 197
MSBuild and Visual Studio Known Error Message Formats......Page 203
Creating Reusable Build Elements......Page 204
NUnit......Page 206
FxCop......Page 215
Part IV: MSBuild Cookbook......Page 221
Setting the Assembly Version......Page 223
Building Multiple Projects......Page 225
Attaching Multiple File Loggers......Page 232
Custom Before/After Build Steps in the Build Lab......Page 233
Handling Errors......Page 235
Replacing Values in Config Files......Page 236
Extending the Clean......Page 239
Starting and Stopping Services......Page 245
Web Deployment Project Overview......Page 246
Zipping Output Files, Then Uploading to an Ftp Site......Page 251
Compressing JavaScript Files......Page 254
Encrypting web.config......Page 256
Building Dependent Projects......Page 258
Extending the Clean Process......Page 259
Deployment Using Web Deployment Projects......Page 261
Part V: Team Foundation Build......Page 265
Team Build Features......Page 267
High-Level Architecture......Page 268
Build Agents......Page 269
What Makes a Good Build Agent?......Page 270
Setting Up a Build Agent......Page 271
Creating a Build Definition......Page 275
Workspace......Page 276
Project File......Page 278
Retention Policy......Page 281
Trigger......Page 283
Visual Studio Team System......Page 286
From the Command Line......Page 293
Team Build Security......Page 297
Service Accounts......Page 298
Permissions......Page 300
Default Build Processes......Page 303
End-to-End Build Process......Page 304
Desktop Build Process......Page 305
Setting Properties and Populating Item Groups......Page 306
Overriding Extensibility Targets......Page 307
Customizing End-to-End Build Initialization......Page 308
Customizing Clean......Page 312
Customizing Get......Page 313
Customizing Label......Page 317
Customizing Compilation......Page 319
Customizing Getting Changesets and Updating Work Items......Page 324
Customizing Testing......Page 325
Customizing Generating Documentation and Packaging Binaries......Page 326
Customizing Build Failures......Page 327
Changing Communications Ports......Page 329
Requiring SSL......Page 330
Configuring Client Authentication......Page 331
Running Interactively......Page 332
Configuring Build Definition Download......Page 333
Enabling Tracing......Page 334
Team Build API......Page 335
Creating a Project......Page 336
Connecting to Team Foundation Server......Page 337
Working with Build Agents......Page 338
Working with Build Definitions......Page 340
Working with Builds......Page 341
Upgrading from Team Build 2005......Page 344
Supporting 2005 and 2008 Clients......Page 345
Generating API Documentation Using Sandcastle......Page 349
Load Balancing Builds between Build Agents......Page 354
Configuring Team Build to Use TFS Proxy Server......Page 355
Running Processes on Remote Machines......Page 357
Sharing Customizations between Build Definitions......Page 358
Executing Multiple Targets from an Extensibility Target......Page 363
Adding Build Steps to the Build Details Window......Page 364
Deploying Source Code with the Binaries......Page 366
Adding Symbols to Symbol Server......Page 367
Assembly Versioning......Page 369
Properties and Items Declared Inside Targets......Page 373
Multiprocessor Support......Page 376
Multitargeting......Page 378
ItemDefinitionGroup......Page 380
Registry Syntax......Page 381
New Reserved Properties......Page 382
MSBuild Task Changes......Page 383
Exec Task Changes......Page 384
Common Properties......Page 385
Reference......Page 393
COMFileReference......Page 394
Compile......Page 395
Content......Page 396
None......Page 397
Build Process Designer......Page 399
Build Activities......Page 400
Build Templates......Page 401
Build Controllers......Page 402
Gated Check-in......Page 405
Private Builds......Page 407
Improved Control over Build Deletion......Page 408
Integration with Symbol and Source Server, WiX, Visual Studio Team System for Database Professionals, and MSTest......Page 409
Usability Improvements to Build Details......Page 410
Where Does This Leave MSBuild?......Page 412
A......Page 413
B......Page 414
C......Page 415
D......Page 417
E,F......Page 418
G,H,I......Page 419
J,K,L......Page 420
M......Page 421
N,O......Page 422
P......Page 423
Q,R,S......Page 424
T......Page 426
U,V......Page 427
W,X,Z......Page 428
William Bartholomew......Page 429