ArcGIS Runtime SDK Quick Start Guide

Table of contents

System requirements

Download, extract, and install the ArcGIS Runtime SDK

Authorizing ArcGIS Runtime

Troubleshooting

More information about ArcGIS

Getting support

System requirements

Prior to installing, please review the ArcGIS Runtime SDK for Java and the ArcGIS Runtime SDK for WPF system requirements.

Download, extract, and install ArcGIS Runtime SDKs

Windows

  1. To begin development of ArcGIS Runtime-based applications on Windows, you will need to install an ArcGIS Runtime SDK. There are two choices for ArcGIS Runtime development on Windows. You can install the WPF and/or Java SDKs. The different SDKs provide the necessary API reference, documentation, and samples to help you get started with ArcGIS Runtime development.
  2. Make sure you have write access to your download directory location as well as your ArcGIS installation directory location, and that no one is accessing it.
  3. Click on the product's download link on Esri's Customer Care Portal. Recommended: Use the Esri Download Manager to manage your downloads.
    CautionCaution:

    When downloading with the Esri Download Manager, you can select and download multiple products. However, only one product should be started at a time when the downloads are complete.

  4. The first panel of the extraction wizard will allow you to indicate the location on your computer to which you would like the installation files extracted. When satisfied, click OK.
    NoteNote:

    If you choose to change the destination location when starting the .exe (either from the Launch option in the Esri Download Manager or running the downloaded self-extracting .exe manually), be sure to choose a unique location to extract the files.

  5. You will be notified when the file extraction is complete. To automatically install the software, leave the Launch the setup program check box on the final panel of the extraction wizard checked. To install the software at a later time, uncheck the check box. You can install the software at any time by browsing to the product's extracted location and running the setup.exe. The setup program will guide you through the installation process.
    NoteNote:

    Administrative privileges will be required for installing the ArcGIS software product. If you do not have the necessary privileges, an administrator on your system can install the software by running the setup.exe at the product's extracted location.

Linux

  1. To begin development of ArcGIS Runtime Java applications on Linux, you will need to install the ArcGIS Runtime SDK for Java. The Java SDK provides the necessary API references, documentation, and samples to help you get started with ArcGIS Runtime development.
  2. Make sure you have read-write-execute (rwx) access to your intended ArcGIS installation location.
  3. Click on the product's download link on Esri's Customer Care Portal.
  4. Save the file to a disk location large enough to hold both the gzip file and the tar file.
  5. gunzip the ArcGIS Runtime gzip file for Linux to get the tar file. Ensure that the last letters of the file name are .gz. Otherwise, the gunzip command will not work. At the prompt, type % gunzip <file_name>.tar.gz.
  6. Extract the product tar file to create the installation directory: % tar xvf <file_name>.tar.
  7. Change directory (cd) into the extracted tar file directory, and run the provided ./Setup script to install the ArcGIS Runtime Java SDK. The setup program will guide you through the installation process.

Authorizing ArcGIS Runtime

NoteNote:

Recommended: Use an Internet connection to complete the authorization steps below. If you do not have an Internet connection for the machine on which you intend to install the software, you can authorize the software via e-mail or Web site from a separate machine with Internet access.

Windows

  1. After the ArcGIS Runtime SDK setup program completes, the Software Authorization wizard will launch automatically. Alternatively, you can launch the Software Authorization wizard by going to Start > Programs > ArcGIS > Runtime SDK > Runtime Tools.
  2. In the Software Authorization wizard, select the default option I have installed my software and need to authorize it.
  3. Select Authorize with ESRI now using the Internet.
  4. Enter your personal information.
  5. Enter your ArcGIS Runtime authorization number (RUSxxxxxxxxx). This information is provided to you by Esri Customer Service. If you do not have this information, contact Esri Customer Service.
  6. Click Finish after the authorization process is complete.
  7. Use the License Viewer utility to view the license strings needed for authorizing your ArcGIS Runtime applications. You can launch the License Viewer utility by going to Start > Programs > ArcGIS > Runtime SDK > Runtime Tools.
  8. To license your application, copy the license strings from the License Viewer into the licensing section of your application's code. For more information on licensing your application, refer to the licensing documentation provided by the specific SDK you are using.

Linux

  1. After the ArcGIS Runtime SDK setup program completes, the Software Authorization wizard will launch automatically. Alternatively, you can launch the Software Authorization wizard by going to Applications > ArcGIS > Runtime SDK for Java > Runtime Tools > Software Authorization Wizard.
  2. Select the default option I have installed my software and need to authorize it and click Next.
  3. Select Authorize with ESRI now using the Internet and click Next.
  4. Enter your personal information.
  5. Enter your ArcGIS Runtime authorization number (RUSxxxxxxxxx). This information is provided to you by Esri Customer Service. If you do not have this information, contact Esri Customer Service
  6. Click Finish after the authorization process is complete.
  7. Use the License Viewer utility to view the license strings needed for authorizing your ArcGIS Runtime applications. You can launch the License Viewer utility by going to Applications > ArcGIS > Runtime SDK for Java > Runtime Tools > License Viewer.
  8. To license your application, copy the license strings from the License Viewer into the licensing section of your application's code. For more information on licensing your application, refer to the licensing documentation provided by the specific SDK you are using.

More information about ArcGIS

More information and assistance for ArcGIS products are available via the ArcGIS Resources website. Use the ArcGIS Resources website as your portal to ArcGIS Resources, such as finding out what's new at the latest release, help, forums, blogs, downloads, samples, and knowledge base articles.

Getting support

Your Esri office or distributor provides support of ArcGIS and the ArcGIS Runtime SDKs. For your Esri office or distributor's contact information, please visit http://support.esri.com/en/phoneSupport.

6/21/2013