cuggisrs / arcgis-runtime-samples-java

ArcGIS Runtime SDK for Java samples

ArcGIS Runtime Java SDK Samples

This repo contains a set of sample projects demonstrating how to accomplish various mapping and GIS tasks with the ArcGIS Runtime SDK for Java.

Browse the category directories to explore the samples. Each sample is an individual Gradle project that can be run standalone. The Gradle buildscripts have tasks for running the application, building a jar, and distributing the app as a zip.

Installing Gradle is not necessary since each sample includes the Gradle wrapper.

Instructions

IntelliJ IDEA

1. Open IntelliJ IDEA and select File > Open....
2. Choose one of the sample project directories (not the category folder) and click OK.
3. Select File > Project Structure... and ensure that the Project SDK and language level are set to use Java 11.
4. Open the Gradle view with View > Tool Windows > Gradle.
5. In the Gradle view, double-click the run task under Tasks > application to run the app.

Eclipse

1. Open Eclipse and select File > Import.
2. In the import wizard, choose Gradle > Existing Gradle Project, then click Next.
3. Choose one of the sample project directories (not the category folder) as the project root directory.
4. Click Finish to complete the import.
5. Open the Gradle Tasks view with Window > Show View > Other... > Gradle > Gradle Tasks.
6. In the Gradle Tasks view, double-click the run task under {project_name} > application to run the app.

Terminal

1. cd into one of the sample project directories (not the category folder).
2. Run ./gradlew run on Linux/Mac or gradlew.bat run on Windows to run the app.

Java 11

Java 11 users may find exceptions when running the project if their library path is still set for Oracle JDK 1.8 (see the OpenJavaFX docs for more information). A workaround for this is to add the following argument in the run task of the Gradle buildscript:

systemProperty "java.library.path", "C:\tmp"

Offline sample data

Some samples require offline data. A samples-data directory will automatically download to the project root when the Gradle project is configured/imported.

Requirements

See the Runtime SDK's system requirements.

Resources

• ArcGIS Runtime SDK for Java
• Toolkit
• ArcGIS Blog
• Esri Twitter

Issues

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

Contributing

Esri welcomes contributions from anyone and everyone. Please see our guidelines for contributing.

New to Git? Check out our Working with Git guide.

Licensing

Copyright 2019 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.txt file.