Skip to content

Latest commit

 

History

History
70 lines (51 loc) · 3.43 KB

setup.asciidoc

File metadata and controls

70 lines (51 loc) · 3.43 KB
Raw
Table of Contents

Setup

Install devonfw-ide:

  • Install git if not already installed (download and run installer or run winget install Git.Git in PowerShell or CMD)

  • Create the folder C:\Projects\devonfw-training (if you do not have Windows, use projects/devonfw-training in root or if not permitted in home).

  • Download devonfw-ide-scripts package from here

  • Extract the contents of devonfw-ide-scripts package into the above created folder devonfw-training. The contents of the package shall be directly in the folder devonfw-training without any sub-folder such as devonfw-ide-scripts. If you have no idea how to do this, install 7-Zip (winget install 7zip.7zip) and use it to extract.

  • Run the setup script (on Windows setup.bat) from devonfw-training folder.

  • Enter this settings-URL: https://github.com/devonfw-training/java-quarkus-settings.git

  • Read and confirm the terms-of-use.

  • wait until the setup process has completed.

  • Select workspaces folder of your installation in windows explorer and chose Git Bash here from the context menu.

  • If you do not have already Docker Desktop or Rancher Desktop installed, you should do so by running in Git-Bash the command: devon docker setup

Build Backend

Now we build our application backend:

  • Go to folder workspaces/main/java-quarkus/ in devonfw-training.

  • In Windows-Explorer right-click it and select Git Bash Here.

  • In the git-bash at this folder run the following command:

    mvn clean install -DskipTests

Import into an IDE

Please choose your favorite IDE:

Eclipse

Next, we import the new backend project into our Eclipse IDE:

  • devon eclipse

  • In Eclipse Import as Existing Maven Project, there click Browse and choose your backend folder in workspaces/main/java-quarkus.

  • Now find the green bug icon in the Eclipse toolbar and click on the down-arrow right to it.

  • Click Debug Configuration from the menu

  • In the appearing Debug Configuration popup window select Quarkus application from the list on the left.

  • Click on the first icon from the bar above that list (with tooltip New launch configuration)

  • Change the Name to app and ensure the Project is set to app.

  • Click on Debug to start your app in debug mode.

  • Open http://localhost:8080/ in your browser and you should see the quarkus welcome page of the app.

Import into IntelliJ

  • Open IntelliJ File menu and select Project structure

  • In the Project structure Popup select Modules, click on + and Import Module

Intellij import module

  • Select the java-quarkus project and confirm with OK

Intellij select project

  • Select to import using Maven and confirm with Create

Intellij import with maven

Build Frontend

The frontend is written in react and can be build with yarn. Please go into frontend and run yarn install on a command line. Please do not use npm.

When the build was successful and the backand is running, too, you can start the frontend by running yarn start in the same directory.

The frontend is reachable under http://localhost:3000/. You can append the id of the list you want to load, default is 1: http://localhost:3000/1.

Links