devonfw ide setup

IDE Setup

This Tutorial explains how to setup the development environment to work on and contribute to devonfw4j with your Windows computer.

We are using a pre-configured devon-ide for development. To get started follow these steps:

Get a Git client. For Windows use:
- https://gitforwindows.org/
  
  Important: install with option Use Git from the Windows Command Prompts but without Windows Explorer integration.
- Download TortoiseGit from https://tortoisegit.org/
Download the IDE
- If you are a member of Capgemini: download devonfw ide package or the higher integrated devonfw distribution (for devonfw please find the setup guide within the devon-dist).
- If you are not member of Capgemini: We cannot distribute the package. Please consult devon-ide to setup and configure the IDE manually. If you need help, please get in touch.
Choose a project location for your project (e.g. C:\projects\oasp, referred to with $projectLoc in this setup guides following steps). Avoid long paths and white spaces to prevent trouble. Extract the downloaded ZIP files via Extract Here (e.g. using 7-Zip). Do not use the Windows native ZIP tool to extract as this is not working properly on long paths and filenames.
Run the script update-all-workspaces.bat in $projectLoc.

Hint: You can use update-all-workspaces.bat whenever you created a new folder in workspaces to separate different workspaces. This update will create new Eclipse start batches allowing to run a number of Eclipse instances using different workspaces in parallel.

You should end up having a structure like this in $projectLoc
Open console.bat and check out the git repositories you need to work on into workspaces\main. with the following commands:
```
cd workspaces/main
git clone --recursive https://github.com/oasp/my-thai-star.git
```
Do another check whether there are files in folder workspaces\main\my-thai-star\!
Run the script eclipse-main.bat to start the Eclipse IDE.
In Eclipse select File > Import > Maven > Existing Maven Projects and then choose the cloned projects from your workspace by clicking the Browse button and select the folder structure (workspaces\main\my-thai-star\java\MTSJ).
Execute the application by starting the ´SpringBootApp´. Select the class and click the right mouse button. In the context menu select the entry Run as ⇒ Java Application (or Debug as …). The application starts up and creates log entries in the Eclipse Console Tab.

Once started, the sample application runs on http://localhost:8081/mythaistar, login with waiter/waiter and have a look at the services list provided.