Upgrading to version 3.3

To upgrade ArcGIS Viewer for Silverlight to version 3.3, see the following sections in this topic. Seamless upgrade is included for the Application Builder and Viewer applications. Simply run the 3.3 setup program without first uninstalling the previous version, then upgrade existing applications by clicking the Upgrade button in the Application Builder.

Tip:

You can upgrade to 3.3 from version 1.0.1, 3.0, 3.1, or 3.2.

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 upgrade.

1. Double-click the ArcGISSilverlightViewer_3_3_x64.exe (64-bit operating systems) or ArcGISSilverlightViewer_3_3_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, select the I accept the license agreement option and click Next.

3. The installation wizard detects the previous version of ArcGIS Viewer for Silverlightand automatically sets the installation options. Verify these are correct and then click Upgrade.

   

Upgrading existing Applications

After installing version 3.3 of the ArcGIS Viewer for Silverlight, open the Application Builder. On the Home page, each existing application will have a button next to it for upgrading, as shown in the image below. To upgrade an application, simply click this button. 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 the previous version (2.4, 3.0, 3.1, or 3.2.) and then you can install version 3.3. For installation instructions, see the Installation guide.

Upgrading existing Add-ins

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

Note:

At version 3.0, the Layouts.xml file was added to the Config\Layouts folder in the Viewer website. If you are migrating custom layouts from version 1.0.1, you'll need to add this file to the Website project in the Visual Studio solution that includes your layouts.

1. Update the Viewer.xap file in the Visual Studio project. (Copy the new one from C:\inetpub\wwwroot\Builder\Templates\Config).
2. If you are upgrading an add-in that was created for version 1.0.1 of the Viewer or earlier, update the .Addins project to target Silverlight 5. If your add-in was created for version 3.0, 3.1 or 3.2, skip this step.
3. Update the ArcGIS API for Silverlight and Extensibility API references to 3.3. This includes assemblies such as ESRI.ArcGIS.Client, ESRI.ArcGIS.Client.Toolkit, ESRI.ArcGIS.Client.Extensibility, and so on.
4. If you are upgrading an add-in that was created for version 1.0.1 of the Viewer or earlier, remove the Search and Print tools from Tools.xml, if present. Search and Print were upgraded at version 3.0 and therefore will not work properly if left in the Tools.xml file. If your add-in was created for version 3.0, 3.1, or 3.2, skip this step.