search

Esri / java-gradle-starter-project

Starter project for the ArcGIS Maps SDK for Java with Gradle
Apache License 2.0
8 stars 86 forks source link
arcgis-maps-sdk arcgis-maps-sdk-for-java gradle java javafx native-development

readme

java-gradle-starter-project

Here is a starter project for the ArcGIS Maps SDK for Java with Gradle.

The project includes the Gradle wrapper, so there is no need to install Gradle to run the app.

The app launches a window displaying a map.

screenshot

Instructions

IntelliJ IDEA

  1. Open IntelliJ IDEA and select File > Open....
  2. Choose the java-gradle-starter-project directory and click OK.
  3. Select File > Project Structure... and ensure that the Project SDK and language level are set to use Java 17.
  4. Open the Gradle view with View > Tool Windows > Gradle.
  5. In the Gradle view, double-click copyNatives under Tasks > build. This will unpack the native library dependencies to $USER_HOME/.arcgis.
  6. In the Gradle view, double-click run 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. Select the java-gradle-starter-project directory as the project root directory.
  4. Click Finish to complete the import.
  5. Select Project > Properties . In Java Build Path, ensure that under the Libraries tab, Modulepath is set to JRE System Library (JavaSE-17). In Java Compiler, ensure that the Use compliance from execution environment 'JavaSE-17' on the 'Java Build Path' checkbox is selected.
  6. Right-click the project in the Project Explorer or Package Explorer and choose Gradle > Refresh Gradle project.
  7. Open the Gradle Tasks view with Window > Show View > Other... > Gradle > Gradle Tasks.
  8. In the Gradle Tasks view, double-click copyNatives under java-gradle-starter-project > build. This will unpack the native library dependencies to $USER_HOME/.arcgis.
  9. In the Gradle Tasks view, double-click run under java-gradle-starter-project > application to run the app.

Command Line

  1. cd into the project's root directory.
  2. Run ./gradlew clean build on Linux/Mac or gradlew.bat clean build on Windows.
  3. Run ./gradlew copyNatives on Linux/Mac or gradlew.bat copyNatives on Windows. This will unpack the native library dependencies to $USER_HOME.arcgis.
  4. Run ./gradlew run on Linux/Mac or gradlew.bat run on Windows to run the app.

Requirements

See the Java Maps SDK system requirements.

Resources

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.

Licensing

Copyright 2023 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.