ArcMap AddIn - Developers

A developers guide to the GBDX ArcMap AddIn

Step 1: Install Software Packages

  1. ArcGIS Desktop 10.4
  2. Visual Studio 2012 (Including the following NuGet packages installed)

    • Json.NET (Popular high-performance JSON framework for .NET)
    • NLog (Logging platform for .NET with rich log routing and management capabilities)
    • SmartThreadPool (Smart Thread Pool, implemented in .NET)
    • RhinoMocks (Uses Castle Dynamic Proxy to handle proxying the types it needs to mock)
    • RestSharp (REST and HTTP API Client)
    • WPF Toolkit
    • Extended WPF Toolkit

    To install NuGet packages, go to: Tools toolbar\Library Package Manager\Manage NuGet Packages for Soluation…

  3. ArcObjects SDK 10.4

Step 2: Download the DGConnect-ESRI GitHub repository

Step 3: Open the Microsoft Visual Studio Solution

Open the Microsoft Visual Studio Solution “smarc.sln” file, from the ESRI Addin folder that you downloaded or cloned, in Microsoft Visual Studio 2012. When Microsoft Visual Studio opens, you will notice the different “Projects” that the Solution (entire application) is comprised of.

  • GBDX: This project encompasses the majority of the front end functionality and contains the definitions for the various tools that implement the ITool interface from ESRI. In addition, this project will construct the actual addin.
  • Logging: The wrapper class/project for the NLog class.
  • NetworkConnections: Contains all of the code that makes the actual calls to the various web services.
  • Raster: Contains helper classes that allow for the Raster WMS to be added to ArcMap.
  • StoredQueries: Contains the functionality to communicate with the stored query service.

Step 4: Build Application

When you are ready to build the application, go to: Build toolbar\Build Solution. This will begin the build sequence and create the ESRI Addin File.

Step 5: Successful Build

Once the build is complete, navigate through the Addin directory to the "Debug" subfolder: ...\GBDX\bin\Debug. If the build was successful, the Gbdx.esri.Addin file should have been generated here.

Step 6: Install Built GBDX AddIn

Double click the Addin file and a dialog will confirm the installation. The DigitalGlobe GBDX Addin should now appear on the toolbar in ArcMap.

Note: If the Addin does not automatically appear on the toolbar, you may have to add it manually by going to: Customize tab > Toolbars > GBDX Toolbar.