Installation Tips for Silverlight Tools Beta 1 for Visual Studio 2008
As many of you know Silverlight 2 Beta 1 was release today at MIX08. What an awesome day. The new applications under development based on Silverlight 2 are truly incredible! Check out http://www.microsoft.com/silverlight/
To get started with Silverlight 2 you can download "Silverlight Tools Beta 1 for Visual Studio 2008" here.
The Silverlight Tools installer will install everything needed to start working with Silverlight 2 in Visual Studio 2008.
It installs the following:
- Silverlight 2 Beta 1
- Silverlight 2 SDK Beta 1
- KB949325 for Visual Studio 2008
- Silverlight Tools Beta 1 for Visual Studio 2008
Even if you've previously installed Silverlight 1.0 or Silverlight 2 Beta 1 the installer will proceed and install the additional components.
That's it! You're now ready to start creating rich Internet applications with Silverlight 2 and Visual Studio 2008.
While the installation is that simple in most cases, there have been some installation issues reported. I've listed below the issues and solutions I've run into so far. I'll update this post if new issues are reported.
Installation Error
If you do run into an installation error, it's most like due to a previous installation of Silverlight 1.1 Alpha or any of the Silverlight SDKs, including the Silverlight 2 Beta 1 SDK. You must uninstall all these components before installing Silverlight Tools Beta1 for VS08. If you don't uninstall these products first you'll get this error dialog from the installer.
If you see this dialog, be sure to uninstall all the dependent components and restart the installer.
Can't Find KB949325 to Uninstall?
If you ever need to uninstall KB949325, you can do this through Add and Remove Programs. However it does not show up by default in Add and Remove Programs.
Instead you need to select "View Installed Updates"
Now you'll see all the updates and patches installed to applications on your computers. Scroll down and you'll find KB949325. It will be listed as:
It should not come as a surprise that if you uninstall KB949325, you will not be able to use Silverlight projects in Visual Studio. Only uninstall KB949325 if you're planning on returning VS08 to its RTM condition or if you're attempting to reinstall Silverlight Tools.
Prompt for installation source media
In some cases you may get a prompted for the installation CD-ROM for Visual Studio 2008.
Heath Stewart has an excellent blog post on some of the issues users are encountering when installing patches for Visual Studio 2008. You can read his entire post here. Heath has a new post specific to this prompt when installing Silverlight Tools here.
One of the scenarios causing this to happen with the Silverlight Tools installer is when Visual C++ is not installed. The other component that will cause this to happen is if you don't have the "Microsoft Visual Studio Web Authoring Component".
You can manually get around this. First you'll need to extract the individual installers from the Silverlight Tools Beta 1 for VS08 chained installer. To do this download and save the Silverlight Tools chained installer from here and save it locally.
To extract the individual installers run this command: silverlight_chainer.exe /extract
This will extract the following installers, along with other support files.
- Silverlight.2.0.exe
- VS90-KB949325.msp
- silverlight_sdk.msi
- VS_SilverlightTools_Beta1_Setup.exe
It critical that you install these components in the order listed above. (Silverlight 2, KB949325, SDK, Tools) To install KB949325 w/o being prompted for media run this command:
msiexec /p VS90-KB949325.msp /L*vx VS90-KB949325.log REINSTALL=ALL
Note: this command will require administrative rights and it does not add the KB to Add/Remove Programs.
To list these Silverlight tools in Visual Studio's Help->About dialog and to be able to uninstall these tools from Add/Remove Programs (ARP), install the patch again using the following command:
msiexec /p VS90-KB949325.msp /L*vx VS90-KB949325-2.log ADDLOCAL=KB947520,KB949325
Finally run the VS_SilverlightTools_Beta1_Setup.exe installer to complete the Silverlight Tools installation.
The project type is not supported by this installation
Even when installed successfully, some users have seen this error:
This is happening for users who have installed previous builds of Silverlight Tools and for one reason or another the Silverlight package for Visual Studio has been disabled. You can re-enable the Silverlight package by running the following command.
devenv.exe /resetskippkgs
The ASP.NET Silverlight controls show appear in the Toolbox for .aspx pages
This happens if the Silverlight SDK is installed before KB949325. As listed above the install order is important. To fix this uninstall the Silverlight SDK and re-install it.
Help Files don't show up in Visual Studio
To integrate the VS help files included in the Silverlight 2 SDK follow the instructions in this readme.txt installed with the SDK.
[Program Files]\Microsoft SDKs\Silverlight\v2.0\Documentation\VS-Help\Readme.txt
The installer is hung?
At the end of the installation process the installer appears to be hung.
The installer can take up to 10 minutes at the end of the installation process. What's going on? The last thing the installer does is merge the help dictionaries. If you've installed the help files for VS locally this can take some time. Don't kill the process, it's not hung.
Where to go for Installation Help?
Be sure to check out the Silverlight 2 Beta 1 readme for known issues.
If you run into installation issues not covered here please post your question in the "Installation and Setup" forum here: http://silverlight.net/forums/13.aspx