Versions Compared

Old Version 1

changes.mady.by.user Dennis Marcheel (Unlicensed)

Saved on

compared with

New Version Current

changes.mady.by.user Candice Louw (Unlicensed)

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Development Environment Setup

This step-by-step guide explains how to set up your development environment, using either Eclipse or IntelliJ for the backend and web UI and Android Studio for the mobile app. Please follow it strictly to ensure that your code adheres to our guidelines and that development will run smoothly.

Please note that these instructions are optimized for Windows and Linux systems. If you're developing on a Mac, we would be glad to get your feedback about extending this guide with OS-specific instructions through our

SORMAS Project (web application)

Please note that these instructions are optimized for Windows and Linux systems. If you're developing on a Mac, we would be glad to get your feedback about extending this guide with OS-specific instructions through our GitHub Discussions/SORMAS Community platform (community.sormas.org).

Step 1: Check Out the SORMAS Repository

...

git config --global branch.development.rebase true

Step 2: Install JAVA

  • Download and install the Java 11 JDK (not JRE) for your operating system, which is also needed for the Server Setup. We suggest using Zulu OpenJDK. If you're running Linux, please refer to the official documentation on how to install Zulu OpenJDK on your system.

...

  • The SORMAS CI is using JDK 17 to build all modules. The only known difference though is slight differences in the Java time API that affect unit tests, so again there is no need to setup two JDKs on your local system.

Step 3: Install and configure IDE

Here we can see the step-by-step process of how to set up the SORMAS project in your local environment using an Integrated Development Environment(IDE) for Developers.

IntelliJ

Reference: click here

Project repository check-out process

...

  • Optional: Clone the SORMAS-Project repository if you haven't done so already.

  • Open the project in IntelliJ. Make sure the project is recognized by IntelliJ as a maven project; if not, right-click the pom.xml file in sormas-base and select Add as a maven project.

  • Make sure that under File -> Project Structure -> Modules all modules EXCEPT sormas-app are recognized; if not, add the missing modules with the + button.

...

  • Navigate to File -> Settings -> Plugins and make sure that Glassfish integration is enabled.

...

  • Make a copy of the sormas-base/dev.env.example, rename it to dev.env, and set GLASSFISH_DOMAIN_ROOT to the location of the SORMAS domain inside your Payara installation.

  • Run mvn install on the sormas-base project (e.g. by opening the Maven view and executing sormas-base -> Lifecycle -> install).

...

  • Alternatively, execute the dev/build.sh script. You can create a run configuration and use the Git bash executable as an interpreter to directly run it from the IDE.

  • Execute dev/deploy-serverlibs.sh script

  • Add a Payara server to IntelliJ:

  • Open Run -> Edit Configurations, add a new configuration and choose the Glassfish server template

  • Click on Configure next to the Application server and create a new server configuration by selecting your Payara installation directory

  • Check the After launch checkbox and specify the browser that you want SORMAS to open in once the server has been deployed

  • Enter http://localhost:6080/sormas-ui into the URL field

  • Make sure that the correct JRE is specified (your Java 11 JDK)

  • Enter the path to the SORMAS domain and the credentials that you've specified when setting up the server

Finally, it looks like

...

  • Open the Deployment tab and add the artifacts sormas-ear, sormas-rest, and sormas-ui (make sure to respect this order as there are dependencies between artifacts at startup)

  • Open the Logs tab and add a new log file pointing to the logs/server.log file in your SORMAS domain

  • Open the Startup/Connection tab and make sure that Pass environment variables are NOT checked; ignore warnings about the debug configuration not being correct

  • Open the config/domain.xml file in your domain directory and make sure that the java-config node contains the following code

...

Optional: Setup database access from Intellij: Open View -> Tool View -> Database, click on the + icon select DataSource -> PostgreSQL, and configure the database (set user and password and download the missing driver files if needed)

Eclipse(IDE)

  • Download and install the latest Eclipse IDE for Enterprise Java and Web Developers

  • Set the default JRE of Eclipse to the installed JDK: Assigning the default JRE for the workbench

  • Optional: Clone the SORMAS-Project repository if you haven't done so already via File -> Import -> Git -> Projects from Git and cancel the process when you're asked to create a new project from the cloned repository

  • Import the projects from the SORMAS-Project repository into your workspace via File -> Import -> Maven -> Existing Maven Projects

  • Install the Payara Tools plugin

  • Install the Vaadin Plugin for Eclipse; the commercial UI designer is not needed

  • Add a Payara server to Eclipse and enter the credentials you specified when setting up the local SORMAS server

  • Make a copy of sormas-base/dev.env.example, rename it to dev.env and set GLASSFISH_DOMAIN_ROOT to the location of the SORMAS domain inside your Payara installation

  • Either run mvn install on the sormas-base project or execute the dev/build.sh script (for example with Git Bash)

  • Execute dev/deploy-serverlibs.sh script

  • Highlight all Eclipse projects and choose Maven -> Update Project from the right-click menu; perform the update for all projects

  • Start the Glassfish server and deploy sormas-ear, sormas-rest, and sormas-ui by dragging the respective projects onto it, or use the Add and Remove... function by right-clicking on the server (make sure to respect this order as there are dependencies between artifacts at startup)

  • Open your browser and type in http://localhost:6080/sormas-ui to test whether the server and IDE have been set up correctly.

Android Studio

Please note: You only need to install Android Studio if you're developing code for the Android app. This is likely the case when you're adding new fields or entities to the system, or if you specifically want to work on the mobile app.

...

Important: Whenever you do or pull changes in the sormas-api project that you want to use in the mobile app or that are referenced there already, you need to execute the dev/build.sh script to notify the sormas-app project of the changes.

...

...

Info

Under construction. Please check back later.

SORMAS App (Android application)

Android Studio setup

Project repository check-out process

Installation of supporting plugins

Data Synchronization

Version and Update

Device Encryption

Data Storage

Firebase Crashlytics & Performance Monitoring

...

SORMAS SERVER (LINUX)

...