Skip to content

Starter project for the ArcGIS Maps SDK for Java with Maven

License

Notifications You must be signed in to change notification settings

Esri/java-maven-starter-project

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

37 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

java-maven-starter-project

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

The project includes the Maven wrapper, so there is no need to install Maven 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-maven-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 Maven view with View > Tool Windows > Maven.
  5. In the Maven view, under Plugins > dependency, double-click the dependency:unpack goal. This will unpack the native libraries into $USER_HOME/.arcgis.
  6. In the Maven view, run the compile phase under Lifecycle and then the exec:java goal to run the app.

Eclipse

  1. Open Eclipse and select File > Import.
  2. In the import wizard, choose Maven > Existing Maven Projects, then click Next.
  3. Select the java-maven-starter-project 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-11). In Java Compiler, ensure that the Use compliance from execution environment 'JavaSE-11' on the 'Java Build Path' checkbox is selected.
  6. Right-click the project in the Project Explorer or Package Explorer and choose Run As > Maven Build.... In the Edit Configuration dialog, create a new configuration with name unpack. In the Goals field, enter dependency:unpack. Click Run to run the goal. This will unpack the native libraries into $USER_HOME/.arcgis.
  7. Again, create a new run configuration with name run. In the Goals field, enter compile exec:java. Click Run to run the goal. The app should compile and launch the JavaFX window.

Command Line

  1. cd into the project's root directory.
  2. Run ./mvnw dependency:unpack on Linux/Mac or mvnw.cmd dependency:unpack on Windows to unpack the native libraries to $USER_HOME/.arcgis.
  3. Run ./mvnw compile exec:java on Linux/Mac or mvnw.cmd compile exec:java 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:https://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.