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 IDE oasp4j-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 oasp-ide package or the higher integrated devon distribution (for devon please find the setup guide within the devon-dist).
- If you are not member of Capgemini: We cannot distribute the package. Please consult oasp4j-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.
Create a file named $projectLoc\variables-customized.bat in your project location with the following contents:
```
set SETTINGS_REL_PATH=oasp4j\oasp4j-ide\oasp4j-ide-settings\src\main\settings
```
Open console.bat and check out the git repositories you need to work on into $projectLoc\workspaces\main. with the following commands:
```
cd workspaces/main
git clone --recursive https://github.com/oasp/my-thai-star.git
```
Run the script $projectLoc\update-all-workspaces.bat.

Hint: You can use update-all-workspaces.bat whenever you created a new project folder in your workspaces folder to separate different project-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

Do another check whether there are files in folder $projectLoc\workspaces\main\oasp4j\oasp4j-ide!
Run the script $projectLoc\eclipse-main.bat to start the Eclipse IDE.
In Eclipse select File > Import > Maven > and Import existing Maven Project and then choose the cloned projects from your workspace. Root Directory: $projectLoc\workspaces\main. You can also click the Browse button and select the folder structure. (If there is a exception: Auto share git projects (Waiting) - choose Run in Background)
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.