Building Silverlight 2 and Silverlight 3 Beta applications on the same machine

23 March 2009

The Silverlight Tools don't have multi-targeting support today, so if you want to continue building Silverlight 2 applications (for production sites), while experimenting and learning about the Silverlight 3 Beta, it isn't that easy. On the Silverlight Toolkit team, we leave it up to individual team members to decide what core development environment they want. By having the Silverlight 2 and Silverlight 3 SDKs checked into our source enlistment, our TFS build server can produce Silverlight 2 and Silverlight 3 binaries, and we can also msbuild the same bits on our machines, regardless of the Silverlight Tools, SDK, or runtime installed on our machines. I blogged about this back in late January about "building Silverlight code on machines without the SDK installed," though really it was more about "building Silverlight code for multiple Silverlight versions."

Select your primary development environment

Decide whether you would like to do primarily Silverlight 2 or 3 development. Then, install the accompanying tools install, and Expression Blend version. It is time consuming to move between the two environments, but you can actually uninstall/reinstall the shipping runtime or developer runtime versions of Silverlight if you need to test an app in a specific configuration, without having to do a full reinstall of the tools.

Preparing your source enlistment

On the Toolkit, we have a directory of external tools and engineering resources. One of these contains the Silverlight SDK’s assemblies, libraries, and build scripts, as shown in the video.

  • Create a directory to store the MsBuild assets for Silverlight, and copy in the files from %programfiles%MSBuild\Microsoft\Silverlight\v2.0.
  • Copy the “Reference Assemblies” directory from %programfiles%\Microsoft SDKs\Silverlight\v2.0\ into the tools directory.
  • Copy the “Libraries” directory from %programfiles%\Microsoft SDKs\Silverlight\v2.0\ into the directory.

You can then use relative paths in your projects or custom build targets to get things rolling.

How we use a custom <Import /> element in projects

Our source code enlistment is broken up into a Silverlight 2 and a Silverlight 3 branch of nearly-identical trees of code. By using a centralized msbuild .targets file, we're able to leave it up to a single file in the branch to select which verison of Silverlight the application should build with. This actually even works when building in Visual Studio, so opening a project that uses this method, while using the Silverlight 3 Tools, but building a Silverlight 2 app, will build with the verison 2 SDK. Do note that the design-time experience won't work in this scenario.

Silverlight.CSharp.targets

All of our VB and C# source projects for Silverlight, within the source enlistment, reference a relative path, typically something like ..\..\Silverlight.CSharp.targets, instead of the standard Silverlight CSharp targets from the Silverlight MSBuild scripts. Inside this relative path, it defines the properties. For Silverlight 2:

<Project

  ToolsVersion="3.5"

  DefaultTargets="Build"

  xmlns="http://schemas.microsoft.com/developer/msbuild/2003">



  <PropertyGroup>

    <!-- Define the ExternalTools property first -->

    <SilverlightBuildResources>$(ExternalTools)\Silverlight\v2.0\</SilverlightBuildResources>

    <TargetFrameworkDirectory>$(SilverlightBuildResources)Reference Assemblies\</TargetFrameworkDirectory>

    <TargetFrameworkSDKDirectory>$(SilverlightBuildResources)Libraries\Client\</TargetFrameworkSDKDirectory>

    <SilverlightRuntimeVersion>2.0.31005.0</SilverlightRuntimeVersion>

  </PropertyGroup>

  <Import Project="$(SilverlightBuildResources)Microsoft.Silverlight.CSharp.targets"/>



</Project>

And for Silverlight 3 Beta:

<Project

  ToolsVersion="3.5"

  DefaultTargets="Build"

  xmlns="http://schemas.microsoft.com/developer/msbuild/2003">



  <PropertyGroup>

    <!-- Define the ExternalTools property first -->

    <SilverlightBuildResources>$(ExternalTools)\Silverlight\v3.0\</SilverlightBuildResources>

    

    <TargetFrameworkDirectory>$(SilverlightBuildResources)Reference Assemblies\</TargetFrameworkDirectory>

    <TargetFrameworkSDKDirectory>$(SilverlightBuildResources)Libraries\Client\</TargetFrameworkSDKDirectory>

    <SilverlightRuntimeVersion>3.0.40217.0</SilverlightRuntimeVersion>

  </PropertyGroup>

  <Import Project="$(SilverlightBuildResources)Microsoft.Silverlight.CSharp.targets"/>

</Project>

Hope this helps and is useful to you and your development team.

Jeff Wilcox is a Software Engineer at Microsoft in the Open Source Programs Office (OSPO), helping Microsoft engineers use, contribute to and release open source at scale.

comments powered by Disqus