Installing the LuciadRIA distribution
The LuciadRIA product is a JavaScript library designed to display an interactive geographical map in your web application. It’s offered as a collection of NPM packages, available as ES6 modules.
Before installing LuciadRIA, check that your system complies with the System requirements.
To install LuciadRIA:
-
Make sure you have a Java Runtime Environment (JRE) installed (Java 17 or higher).
-
Download all files to a (temporary) directory.
-
Navigate to this directory and run
install.jar
, either by double-clicking on the archive or executingjava -jar install.jar
in a console. -
Follow the instructions of the installer.
If you don’t want to use the installer:
-
Unzip all the LuciadRIA zip files in the same folder.
-
Store a valid LuciadRIA developer license file in the
licenses
folder in your LuciadRIA installation folder.
To start the LuciadRIA samples:
-
Run the
startSampleServer.bat
orstartSampleServer.sh
script, available in the root of your LuciadRIA installation folder. This starts a Jetty web server that hosts the LuciadRIA samples. -
Browse to http://localhost:8072.
-
Navigate to the Samples page, and click the available links to open a sample.
Next steps
-
For more information about the contents of your LuciadRIA distribution, see the Contents of the LuciadRIA distribution article .
-
Learn more about LuciadRIA, its API and features by browsing the API reference documentation and the supporting LuciadRIA documentation. If the sample server is running, this documentation is available at http://localhost:8072 .
-
Change the sample code to experiment with LuciadRIA features.
-
Start from the Hello World tutorial to learn how to integrate LuciadRIA into your own project, and follow along with the other basic application tutorials to develop your first LuciadRIA application.
Upgrading your LuciadRIA application to LuciadRIA 2020.0
If you want to upgrade your AMD-based LuciadRIA application to LuciadRIA 2020.0, and switch to ES6 modules, see Migrating your LuciadRIA application from AMD to ES6 modules.
Migrating your LuciadRIA application to LuciadRIA 2023.0 ES Modules
Starting with the LuciadRIA 2023.0 release, LuciadRIA modules fully comply with the ECMAScript Modules (ESM) resolution algorithm. All NodeJS build scripts in a LuciadRIA release have also been converted to ESM. To migrate your existing sample-based application to ES6 Modules, see ES modules as of LuciadRIA 2023.0.