Skip To Content

Deploy an app

In this topic

Apps built with ArcGIS Runtime SDK for .NET can be deployed to your users by uploading your app package to the Windows Store, or by sideloading it directly onto a device. In either case, you'll need to prepare your app for deployment and test it on real devices to ensure a quality experience before putting it in the hands of your users.

The following broad steps are required to prepare your app for deployment:

  1. License your app.
  2. Add attribution.
  3. Create a deployment of ArcGIS Runtime (for the platforms you want to support).
  4. Deploy to a device for testing
Note:

Deployment steps differ for each platform in the ArcGIS Runtime SDK for .NET (Windows Desktop, Windows Store, and Windows Phone). Please consult the deployment information for each platform you want to deploy.

License your app

Before creating a deployment, you must ensure that your app includes logic to apply the proper licensing for the functionality it provides. Consult the License your app topic for licensing requirements and instructions.

Note:

There is no need to license your app when deploying to devices for testing. You can deploy your app for testing using a developer license.

Add attribution

You are required to attribute Esri in your Windows Store app according to the following guidelines.

  • ArcGIS Runtime SDK for .NET—About and Credit screens must include the following text: Mapping API provided by Esri ArcGIS Runtime SDK for .NET.
  • Map data—All map data used in an application must be attributed in the About and Credit screens using the Copyright Text section of the REST endpoint or endpoints being used. For example, ESRI_Imagery_World_2D service must use Copyright:© 2009 ESRI, i-cubed, GeoEye.
  • Esri logo—If your application uses data served by Esri through ArcGIS Online, display a logo on the map pursuant to the logo guidelines below. Examples of such data can be found on the ArcGIS Online maps page.
Note:

When using Bing Maps in your application, it's important to include the proper attribution information. See the Branding Guidelines from Microsoft for more information.

Esri logo guidelines

The following guidelines must be followed when applying logo attribution.

  • Minimum size of the logo is 43 x 25 pixels.
  • Place the logo directly on the map with no background.
  • Logo should be located on the bottom left corner of the map.
  • Do not apply transparency to the logo.
  • Do not overlap with another logo or visual component (excluding elements of the map).

Download Esri logos.

Deploy to a device for testing

While Windows 8.1 apps are generally deployed through the Windows Store, you can sideload an app by creating an app package (*.appx) and manually loading it onto a device. The basic steps are described below, consult the links provided in the instructions for more detailed information.

  1. Ensure that you have satisfied the prerequisites described on the Windows Store apps Dev Center.
  2. Open the project for the app you want to deploy in Visual Studio.
  3. In the Visual Studio Configuration Manager dialog box for your project, specify the Platform for your deployment (x86, x64, or ARM).
  4. Build your project.
  5. From the Project menu, choose Store > Create app packages. Choose No when prompted to create a package to upload to the Windows Store. Choose an output folder for the package.Create package wizard

    A new app package is created in the folder you specified in the wizard. Everything needed to run the app is included in the package. The following image shows the contents for a typical app package output folder.

    Contents of a local app package folder

    The app package is the file with an *.appx extension. This is an archive file that contains the required files for your app. To view its contents, you can change the extension to *.zip and open it in Windows Explorer. Inside, you'll find your app's executable, the ArcGIS Runtime assembly, and an ArcGIS Runtime deployment folder (if you created one). The output folder also contains a *.cer file, which is the developer's certificate that was used to sign the app package, and a PowerShell script (*.ps1) that can be used to install the package on the target device.

  6. Copy the deployment folder (not just the *.appx file) to the target device.
  7. Open the folder on the device and run the PowerShell script (*.ps1). The script will guide you through installing the app.
  8. When the installation is complete, you can launch the app from the WIndows 8 Apps menu for testing.
    New app installed from the *.appx package
Note:

Consult the System requirements topic for the supported target machine requirements.

For more information about sideloading Windows Store apps, consult the following links:

Related topics