• 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:

1. 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/

2. Download the distribution

   • If you are a member of Capgemini: download devonfw current distribution (for devonfw please find the setup guide within the devon-dist).

     

3. Choose a project location for your project (e.g. C:\projects\devonfw, 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.

4. 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.

5. 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/devonfw/my-thai-star.git

   Do another check whether there are files in folder workspaces\main\my-thai-star\!

6. Run the script eclipse-main.bat to start the Eclipse IDE.

7. 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).

8. 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.

   

9. Open console.bat.

10. Goto the folder workspaces\main\my-thai-star\angular in the console.bat terminal.

11. Execute the command: yarn install. Wait till everything is finished.

12. Execute the command: yarn start.

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

Next chapter: creating a devon4j project