How-to: Enable Smart Client Software Factory 2006 Solutions to use SCSF 2007

As you may know the version 2.0 of SCSF was shipped this weekend, so one of the main questions is how to get the existing SCSF June 2006 solutions running with this new version.

In order to do this, you have to follow this steps:

1. Uninstall SCSF June 2006, because basically SCSF May 2007 is a replacement. SCSF May 2007 does not work side-by-side with SCSF June 2006. Don’t worry if you forget this step, because a nice warning window will advise you
     
2. Uninstall GAT and GAX in order to install the February 2007 CTP.
   Note: In order to unistall GAX, ensure you don’t have any package registered, otherwise the uninstallation will fail:
   
   • Guidance Automation Extensions (February 2007 CTP)
   • Guidance Automation Toolkit (February 2007 CTP) – It’s an optional component for development (i.e. modify the Guidance Package)
3. (Optional) Read Tom Hollander’s post, to know how to get all the factories running with this new version of GAX/GAT.
4. Install SCSF May 2007. Check dependencies before install it to make sure you have all the prerequisites installed.
   
5. Copy the following assemblies from the Lib folder of the SCSF installation directory (%programfiles%\Microsoft Smart Client Factory\Lib\) to the Lib folder of your solution:
   • Microsoft.Practices.CompositeUI.dll
   • Microsoft.Practices.CompositeUI.WinForms.dll
   • Microsoft.Practices.CompositeUI.WPF.dll
   • Microsoft.Practices.EnterpriseLibary.Common.dll
   • Microsoft.Practices.EnterpriseLibary.Data.dll
   • Microsoft.Practices.EnterpriseLibary.Data.SqlCe.dll
   • Microsoft.Practices.EnterpriseLibary.ExceptionHandling.dll
   • Microsoft.Practices.EnterpriseLibary.ExceptionHandling.Logging.dll
   • Microsoft.Practices.EnterpriseLibary.Logging.dll
   • Microsoft.Practices.ObjectBuilder.dll
   • Microsoft.Practices.SmartClient.ConnectionMonitor.dll
   • Microsoft.Practices.SmartClient.DisconnectedAgent.dll
   • Microsoft.Practices.SmartClient.EndpointCatalog.dll
   • Microsoft.Practices.SmartClient.EnterpriseLibrary.dll
6. Open the solution in Visual Studio. If you have the June 2006 guidance package enabled in the solution, a dialog box appears that asks if you want to remove it. Click Yes to remove it.
7. On the Tools menu, click Guidance Package Manager. The Guidance Package Manager window will appear.
8. Click Enable / Disable Packages.
9. From the list of packages, select Smart Client Development May 2007, and then click OK. The Guidance Package Manager will enable the guidance package.
10. Click Close to close the Guidance Package Manager.

Enjoy the new version, and if you have any doubt please visit the SCSF Forum to get all the answers.

Tags: Patterns & Practices, SCSF, Smart Client Software Factory