How ArcGIS Explorer finds and loads add-ins


Summary This topic describes what an add-in file is, what it contains, and describes the add-ins cache - a location that ArcGIS Explorer load add-ins from.

The ArcGIS Explorer add-in file (.eaz)

The deployment unit of an ArcGIS Explorer add-in is a zip archive with the file extension .eaz, known as an add-in file. An add-in file contains an ArcGIS Explorer Addins.xml file which describes the customizations contained in the file, compiled code and supporting files for the customizations, and also any images used to display buttons on the ArcGIS Explorer Ribbon. One or more customizations may be packaged into a single add-in file. When ArcGIS Explorer needs to load an add-in, it will unpack the contents of the add-in file.
If you want to browse the contents of the .eaz file, you can rename the file to .zip and use Windows Explorer to investigate the contents.
Every add-in file includes an XML file called AddIns.xml - this is a manifest describing the customizations contained in the add-in. For more information about the contents of this file, see the About AddIn.xml add-in manifest files topic.

Add-In Cache

ArcGIS Explorer looks in a known location under the user profile to load add-ins. By default this location is:
  • Windows XP - C:\Documents and Settings\<username>\Application Data\ESRI\ArcGIS Explorer\AddIns
  • Windows Vista and Windows 7 - C:\Users\<username>\AppData\Roaming\ESRI\ArcGIS Explorer\AddIns
The Visual Studio Tools for ArcGIS Explorer that are used to create new add-in projects contain MSBuild tasks which create the add-in file for automatically when the project is built. For more information about MSBuild, see the MSDN MSBuild Reference documentation.
When a new add-in file is found in this location by ArcGIS Explorer, it will unpack the contents of the file into a cache. ArcGIS Explorer will check if any add-ins have been updated in this location on startup, and if necessary unpack the updated files so that the latest version is used.
For more information about the add-in file creation, see the Visual Studio tools for ArcGIS Explorer topic.


See Also:

MSDN MSBuild Reference
About AddIn.xml add-in manifest files