https://github.com/esri/java-gradle-starter-project
Starter project for the ArcGIS Maps SDK for Java with Gradle
https://github.com/esri/java-gradle-starter-project
arcgis-maps-sdk arcgis-maps-sdk-for-java gradle java javafx native-development
Last synced: 6 days ago
JSON representation
Starter project for the ArcGIS Maps SDK for Java with Gradle
- Host: GitHub
- URL: https://github.com/esri/java-gradle-starter-project
- Owner: Esri
- License: apache-2.0
- Created: 2019-02-20T17:20:46.000Z (over 6 years ago)
- Default Branch: main
- Last Pushed: 2024-10-28T13:32:37.000Z (8 months ago)
- Last Synced: 2025-06-09T17:12:32.386Z (14 days ago)
- Topics: arcgis-maps-sdk, arcgis-maps-sdk-for-java, gradle, java, javafx, native-development
- Language: Java
- Homepage:
- Size: 920 KB
- Stars: 8
- Watchers: 7
- Forks: 86
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
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.
## 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](https://developers.arcgis.com/java/reference/system-requirements/).
## Resources
* [ArcGIS Maps SDK for Java](https://developers.arcgis.com/java/)
* [ArcGIS Blog](https://www.esri.com/arcgis-blog/developers/)
* [Esri Twitter](https://twitter.com/arcgisdevs)
## 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](https://github.com/esri/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.