Quickly build maps for Android with this library and sample app.
Java CSS Perl
Latest commit 5d6dfc8 Apr 14, 2014 @andygup andygup Deprecation notice
Failed to load latest commit information.
EsriQuickStartSample v1.2.2 supports ArcGIS Runtime SDK for Android v10.2 Nov 5, 2013
CHANGELOG.md v1.2.2 supports ArcGIS Runtime SDK for Android v10.2 Nov 5, 2013
license.txt Added new license file Nov 27, 2012
quickstart-android.png Added screenshot Nov 30, 2012



Deprecated As of April 2014, please start using the maps-app-android repository. Is is designed to replace this quickstart with the latest software development patterns in the ArcGIS Runtime SDK for Android.

A library, sample app and starter template for getting started with Esri's Android Runtime SDK.

See the repo's wiki for additional details: https://github.com/Esri/quickstart-map-android/wiki



  • Simplifies common coding patterns down to one or a couple of lines of code
  • Goes beyond the SDK samples in demonstrating best practices for building mapping applications on Android.
  • Includes EsriQuickStart library project, fully functional sample app, and a Hello World template app that you can quickly build upon.
  • As of Version 1.1 the library project and associated jar file contain the Javadoc.


  1. Make sure you have installed both the Google Android SDK and the ArcGIS Runtime SDK for Android. I have tested this with the ADT Bundle if that is the easiest way for you to go.
  2. Download and unzip the .zip file or clone the repo.
  3. Create new three new local git projects out of the three included directories: EsriQuickStart, EsriQuickStartSample and EsriQuickStartTemplate.
  4. Import each of the projects into Eclipse or ADT Bundle using the following four steps:
    • Step 1: File > Import > Git > Projects from Git > Next
    • Step 2: Select Repository Source > Local > Next > Add > Browse > Finish
    • Step 3: In the Select a Wizard To Use for Importing Projects window, select Import Existing Project > Next. Note: Your git directory will also become the project directory. If you get an error that says project already exists, try editing the .project file and changing the "name" property.
    • Step 4: Look for any project errors in Eclipse. Most commonly you will need to right click on the project > Android Tools > Fix Project Properties. Then run Project > Clean.
  5. For the EsriQuickStart project, right click on the project name in the Package Explorer > Properties > Android > Library > Check the "Is Library" option > OK. Once that is done clean your project.
  6. To add the javadoc so that you get access to the code comments via intellisense right click on the EsriQuickStart library project name in the Package Explorer > Properties > Java Build Path > Source > Add Folder > [Select the directory where the javadoc is] > OK. Once that is done clean your project.

New to Github? Get started here.




Find a bug or want to request a new feature? Please let us know by submitting an Issue.


Anyone and everyone is welcome to contribute.


Copyright 2013 Esri

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at


Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

A copy of the license is available in the repository's license.txt file.