The ArcGIS Maps SDK for Kotlin Toolkit contains components that will simplify your Kotlin app development. It is built off of the new ArcGIS Maps SDK for Kotlin.
View the API reference for the toolkit here.
Please see the developer setup for a complete description of requirements
The ArcGIS Maps SDK for Kotlin Toolkit has a Minimum SDK version of 26, meaning that it can run on devices with Android Oreo (8.0) or newer.
Add the maven repository to your project's gradle file:
repositories {
maven {
url = uri("https://esri.jfrog.io/artifactory/arcgis")
}
}
The ArcGIS Maps SDK for Kotlin Toolkit is released with a "bill of materials" (BOM). The releasable BOM is versioned and represents a set of versions of the toolkit components which are compatible with one another. You may specify dependencies as follows
implementation(platform("com.esri:arcgis-maps-kotlin-toolkit-bom:200.8.0"))
implementation("com.esri:arcgis-maps-kotlin-toolkit-authentication")
implementation("com.esri:arcgis-maps-kotlin-toolkit-basemapgallery")
implementation("com.esri:arcgis-maps-kotlin-toolkit-compass")
implementation("com.esri:arcgis-maps-kotlin-toolkit-featureforms")
implementation("com.esri:arcgis-maps-kotlin-toolkit-geoview-compose")
implementation("com.esri:arcgis-maps-kotlin-toolkit-legend")
implementation("com.esri:arcgis-maps-kotlin-toolkit-offline")
implementation("com.esri:arcgis-maps-kotlin-toolkit-indoors")
implementation("com.esri:arcgis-maps-kotlin-toolkit-popup")
implementation("com.esri:arcgis-maps-kotlin-toolkit-scalebar")
implementation("com.esri:arcgis-maps-kotlin-toolkit-utilitynetworks")
implementation("com.esri:arcgis-maps-kotlin-toolkit-ar")
The template and TemplateApp modules are for bootstrapping new modules.
Please see the package structure documentation for more details.
Accessing Esri location servicesSome toolkit components may require access to Esri location services, including basemaps, routing, and geocoding, which requires authentication using either an API Key or an ArcGIS identity. The toolkit code is set up to easily use an API key.
A long-lived access token that gives your application access to ArcGIS location services. Go to the Create an API key tutorial to obtain a new API key access token. Ensure that the following privileges are enabled:
The components in this repository have been structured to use an access token, set once. Set your access token in the local.properties in the same folder as the secrets.defaults.properties as shown below.
API_KEY=YOUR_ACCESS_TOKEN
An ArcGIS named user account that is a member of an organization in ArcGIS Online or ArcGIS Enterprise can be used as an alternative to API keys. Most toolkit micro apps don't make use of named user authentication. See User authentication for more information.
Find a bug or want to request a new feature enhancement? Please let us know by submitting an issue.
Esri welcomes contributions from anyone and everyone. Please see our guidelines for contributing.
Creating a New Toolkit ComponentA new toolkit component can be added to this project by running the bash script at the top level ./new-component-starter.sh
This script will prompt for you to input a name for the new component and ask if you want to create a new app module for it. Capitalization isn't necessary, but it won't capitalize anything but the first letter if none is specified.
A new microapp can be added by running the bash script ./new-microapp-starter.sh. This script will prompt for you to input a name for the new microapp.
This script requires bash 4.0 or higher.
The project is structured into two folders, microapps and toolkit each containing many modules, and a folder for releasing a bill of materials (BOM).
arcgis-maps-sdk-kotlin-toolkit
├── bom
│ └── build.gradle.kts
├── microapps
│ └── TemplateApp
│ ├── ...App
├── toolkit
│ ├── template
│ ├── ...
├── build.gradle.kts
└── settings.gradle.kts
The toolkit folder contains releasable libraries -- these are the components of the toolkit. For each module in the toolkit folder there is a corresponding app in the microapps folder which depends on it. The apps are not released but are useful for working on a particular component in isolation.
The template and TemplateApp modules are for bootstrapping new modules.
Please see the package structure documentation for more details.
In order to run local (non-instrumented) tests of all modules and get an aggregated test report, run the following at the root folder of the project:
./gradlew testAggregatedReport --continue
The test report for local tests can be located under arcgis-maps-sdk-kotlin-toolkit/build/reports.
In order to run connected (instrumented) tests of all modules and get the test reports in a centralized folder, run the following at the root folder of the project:
./gradlew connectedDebugAndroidTest --continue
The test reports for connected tests can be located under arcgis-maps-sdk-kotlin-toolkit/connectedTestReports.
Copyright 2019-2025 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
http://www.apache.org/licenses/LICENSE-2.0
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 file.
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4