Upgrading from version 1.0.1 to 3.0

To upgrade the ArcGIS Viewer for Silverlight to version 3.0, see the following sections in this topic. Seamless upgrade is included for the Application Builder, so you can run the 3.0 setup program without first uninstalling the previous version. You may have noticed that the version number went directly from 1.0.1 to 3.0; this is to reflect the dependency of the Viewer on the ArcGIS API for Silverlight. Moving forward, the Viewer's version number will match that of the underlying API.

See the following sections for more information:

• Upgrading the Application Builder
• Upgrading existing Applications
• Upgrading the ArcGIS Extensibility SDK for Silverlight
• Upgrading existing Add-ins

Upgrading the Application Builder

To upgrade the Application Builder, you do not need to uninstall the previous version. The ArcGIS Viewer for Silverlight setup program will automatically detect the existing version and proceed with the uprade.

1. Double-click the appropriate ArcGISSilverlightViewer_3_0_x64.exe (64-bit operating systems) or ArcGISSilverlightViewer_3_0_x86.exe (32-bit operating systems) setup program to begin the installation. The Welcome page of the Install dialog box appears. Click Next to continue.
2. Read the End User License Agreement (EULA). If you agree to the EULA, check the I accept the license agreement check box and click Next.
3. The installation wizard detects the previous version of ArcGIS Viewer for Silverlight and automatically sets the installation options. Verify these are correct and then click Upgrade.

Upgrading existing Applications

After installing ArcGIS Viewer for Silverlight 3.0, open the Application Builder. On the Home page, each existing application will have an icon next to it for upgrading. See the screenshot below. Each application must be upgraded individually.

Upgrading the ArcGIS Extensibility SDK for Silverlight

To upgrade the ArcGIS Extensibility SDK for Silverlight, you must first uninstall version 2.4 and then you can install version 3.0 according to the instructions in the Installation guide.

Upgrading existing Add-ins

To upgrade existing add-ins, follow the steps below:

Note:

Beginning at 3.0, you'll find a Layouts.xml file included in the layouts folder. You'll need to edit this to include your custom layouts.

1. Update the Viewer.xap file in the Visual Studio project. (Copy the new one from C:\inetpub\wwwroot\Builder\Templates\Config).
2. Update the .Addins project to target Silverlight 5.
3. Update the ArcGIS API for Silverlight and Extensibility API references to 3.0. This includes assemblies such as ESRI.ArcGIS.Client, ESRI.ArcGIS.Client.Toolkit, ESRI.ArcGIS.Client.Extensibility, and so on.
4. Remove the Search and Print tools from Tools.xml, if present. Search and Print have been upgraded for version 3.0 and therefore will not work properly if left in the Tools.xml file.