You can easily customize and configure
devonfw-ide for the requirements of your project.
In order to do so, you need to create your own project-specific settings git repository and provide the URL to all developers for the setup.
With tools such as gitlab, bitbucket or github every developer can easily propose changes and improvements.
However, we suggest that one team member is responsible to ensure that everything stays consistent and works.
We will call this person the ide-admin of your project.
The following are the suggested step-by-step instructions how an ide-admin should prepare
devonfw-ide for his new project:
Fork ide-settings to a git repository specific for your project (e.g. a new project in the
production-lineinstance). In case you are using github, all you need to do is use the
Forkbutton. In other cases simply create a new and empty git repository and clone this to your machine. Then add the default ide-settings as origin, fetch and pull from it:
git remote add upstream https://github.com/devonfw/ide-settings.git git fetch upstream git pull upstream master git push
Now you should have a full fork as a copy of the
settingsgit repo with all its history that is ready for upstream merges.
Study the structure of this git repository to understand where to find which configuration.
Study the configuration and understand that general settings can be tweaked in the toplevel
devon.propertiesfile of your settings git repository.
Configure the tools and their versions for your project. Here is an example:
DEVON_IDE_TOOLS=(java mvn eclipse) ECLIPSE_VERSION=2020-06 # use e.g. 8u242b08 for Java 8 #JAVA_VERSION=8u242b08 JAVA_VERSION=11.0.5_10 MAVEN_VERSION=3.6.2
This way you will take over control of the tools and their versions for every developer in your project team and ensure that things get reproducible.
In case you need a proprietary or unsupported tool, you can study how to include custom tools.
In case you have very restrictive policies about downloading tools from the internet, you can create and configure a software repository for your project or company.
settingsgit repository you will find a
projectsfolder. Here you will find configurations files for every git project relevant for your actual project. Feel free to create new projects for your needs and delete the
devonfwspecific default projects. The projects documentation will explain you how to do this.
For every IDE you will also find an according folder in your
settingsgit repository. Here are the individual configuration settings for that IDE. You can change them by directly editing the according configuration files directly with a text-editor in your
settingsgit repository. However, this is a really complex way and will take you a lot of time to find the right file and property to tweak for your actual need. Instead we suggest to study how to customize IDE specific settings.
You may also create new sub-folders in your
settingsgit repository and put individual things according to your needs. E.g. you could add scripts for greasemonkey or tampermonkey, as well as scripts for your database or whatever may be useful and worth to share in your team. However, to share and maintain knowledge we recommend to use a wiki instead.
You may want to customize the Eclipse spellchecker dictionary for your project and your language.
All described in the above steps (except the first one) can be used to manage and update the configuration during the project lifecycle. However, when you have done changes especially in a larger project, please consider the following best-practices to avoid that a large teams gets blocked by a non-functional IDE:
Commit your changes to a feature-branch.
First test the changes yourself.
If all works as expected, pick a pilot user of the team to test the changes from the feature branch (go to
git checkout -t origin/feature/«name»,
devon ide update).
Only after that works well for a couple of days, inform the entire team to update.
Announce changes to your team
In order to roll out the perfectly configured
devonfw-ide to your project initially or when new members join, you only have to provide the
Settings URL to the developers of your team.
You can also provide a specific branch with
Settings URL#branch to use variations of common settings or to test new settings before making them public to the team.
After you changed and tested your
settings git repository (main branch), you only need to announce this to your developers (e.g. via email or some communication tool) so that they will can
devon ide update and automatically get up-to-date with the latest changes (see update).
In case you want to go to a new version of
devonfw-ide itself, developers have to call
devon ide update scripts.