Eclipse installation
You should download the latest version of the Eclipse IDE for your operating system from the website:: https://www.eclipse.org/downloads/
Pay attention to the compatibility of Eclipse with Tomcat server - if you have an older version of Eclipse, you may face problems with the operation of the latest version of Tomcat server (whose installation is the next step).
Configuration
Edit eclipse.ini file
Add data to the eclipse.ini file (located in the main folder with eclipse installed):
-Duser.name=Jan Kowalski
Code editing settings
Eclipse
Window -> Preferences -> Java -> Code Style -> Formatter:
suncode-java-formatter-eclipse.xml
Window -> Preferences -> Java -> Code Style -> Code Templates:
IntelliJ
File -> Settings -> Editor -> Code Style -> Java
suncode-java-formatter-intellij.xml
Prettier
Installation in IntelliJ:
- Build the plusworkflow system using the Maven tool. The prettier dependency from the package.json file of the plusworkflow-web project will be automatically installed
- Install the Prettier plugin (File -> Settings -> Plugins).
- Change the settings of the Prettier plugin (File -> Settings -> Langugages & Frameworks -> JavaScript -> Prettier):
- Set the prettier package in the Prettier package field (the package will appear there after step 1).
- In the Run for files field, paste "plusworkflow-web/src/main/frontend/**/*.{js,ts,jsx,tsx,vue}".
- Check the On 'Reformat Code' action and On save boxes.
Edit the settings.xml file
In order for maven to use our local repository, we need to modify the settings.xml file located in maven's home directory:
windows: C:/Documents and Settings/<username>/.m2
unix: /home/<username>/.m2
Configuration
In order for maven to use our local repository, we need to modify the settings.xml file located in maven's home directory:
- windows: C:/Documents and Settings/<nazwa użytkownika>/.m2
unix: /home/<nazwa użytkownika>/.m2
If the settings.xml file does not exist, create it.
The recommended configuration is to use the Suncode repository as a mirror of all repositories, so that all artifacts are downloaded from our local repository:
<settings> <mirrors> <mirror> <id>nexus</id> <mirrorOf>*</mirrorOf> <url>http://192.168.1.51:8081/nexus/content/groups/public</url> </mirror> </mirrors> <profiles> <profile> <id>nexus</id> <repositories> <repository> <id>central</id> <url>http://central</url> <releases><enabled>true</enabled></releases> <snapshots><enabled>true</enabled></snapshots> </repository> </repositories> <pluginRepositories> <pluginRepository> <id>central</id> <url>http://central</url> <releases><enabled>true</enabled></releases> <snapshots><enabled>true</enabled></snapshots> </pluginRepository> </pluginRepositories> </profile> </profiles> <activeProfiles> <activeProfile>nexus</activeProfile> </activeProfiles> </settings>
settings.xml
If you often work remotely, it's a good idea to just add a new known repository, so you can still download artifacts from other repositories if you're not connected to Suncode VPN.
<settings> <profiles> <profile> <id>nexus</id> <repositories> <repository> <id>suncode</id> <url>http://192.168.1.51:8081/nexus/content/groups/public</url> <releases><enabled>true</enabled></releases> <snapshots><enabled>true</enabled></snapshots> </repository> </repositories> <pluginRepositories> <pluginRepository> <id>suncode</id> <url>http://192.168.1.51:8081/nexus/content/groups/public</url> <releases><enabled>true</enabled></releases> <snapshots><enabled>true</enabled></snapshots> </pluginRepository> </pluginRepositories> </profile> </profiles> <activeProfiles> <activeProfile>nexus</activeProfile> </activeProfiles> </settings>
Note
When working with the project from outside the company network (without VPN) in the settings.xml file as the address of the system repository instead of the http://192.168.1.51:8081/nexus/content/groups/public address should be provided: http://www.api.plusworkflow.pl/nexus/content/groups/public
Installation of the necessary plugins
You need to download 3 plugins from nexus: cuf-components, PWE, DBexplorer. These are some of the most commonly used plugins.
Home directory
You need to download a zip of the home directory(unfortunately it is too big to upload here, you can take from another developer).
Then create a 'plusworkflow-home.properties' file in the project in plusworkflow-web/src/main/resources. This file will indicate the path to your home directory.
plusworkflow.home=/home/kamil/Work/plusworkflow-home