variables.asciidoc

Table of Contents

• Variables

Variables

The devonfw-ide defines a set of standard variables to your environment for configuration via variables[.bat] files. These environment variables are described by the following table. Those variables printed bold are also exported in your shell (except for windows CMD that does not have such concept). Variabels with the value - are not set by default but may be set via configuration to override defaults. Please note that we are trying to minimize any potential side-effect from devonfw-ide to the outside world by reducing the number of variables and only exporting those that are required.

Table 1. Varialbes of devonfw-ide

Variable	Value	Meaning
DEVON_IDE_HOME	e.g. /projects/my-project	The toplevel directory of your devonfw-ide structure.
PATH	$PATH:$DEVON_IDE_HOME/software/java:…​	You system path is adjusted by devon command.
DEVON_HOME_DIR	~	The platform independent home directory of the current user. In some edge-cases (e.g. in cygwin) this differs from ~ to ensure a central home directory for the user on a single machine in any context or environment.
DEVON_IDE_TOOLS	java mvn eclipse vscode node npm ng	List of tools that should be installed and upgraded by default for your current IDE.
DEVON_OLD_PATH	…​	A "backup" of PATH before it was extended by devon to allow restting it. Internal variable that should never be set or tweaked.
WORKSPACE	main	The workspace you are currently in. Defaults to main if you are not inside a workspace. Never touch this variable in any varibales file.
WORKSPACE_PATH	$DEVON_IDE_HOME/workspaces/$WORKSPACE	Absoulte path to current workspace. Never touch this variable in any varibales file.
JAVA_HOME	$DEVON_IDE_HOME/software/java	Path to JDK
SETTINGS_PATH	$DEVON_IDE_HOME/settings	Path to your settings. To keep oasp4j-ide legacy behaviour set this to $DEVON_IDE_HOME/workspaces/main/development/settings.
M2_REPO	$DEVON_IDE_HOME/conf/.m2/repository	Path to your local maven repository. For projects without high security demands, you may change this to the maven default ~/.m2/repository and share your repository amongst multiple projects.
MAVEN_HOME	$DEVON_IDE_HOME/software/maven	Path to Maven
MAVEN_OPTS	-Xmx512m -Duser.home=$DEVON_IDE_HOME/conf	Maven options
DEVON_SOFTWARE_REPOSITORY	-	Project specific or custom software-repository.
DEVON_SOFTWARE_PATH	-	Globaly shared user-specific local software installation location.
ECLIPSE_VMARGS	-Xms128M -Xmx768M -XX:MaxPermSize=256M	JVM options for Eclipse
ECLIPSE_PLUGINS	-	Array with "feature groups" and "update site URLs" to cusomize required eclipse plugins.
«TOOL»_VERSION	-	The version of the tool «TOOL» to install and use (e.g. ECLIPSE_VERSION or MAVEN_VERSION).
«TOOL»_BUILD_OPTS	e.g.clean install	The arguments provided to the build-tool «TOOL» in order to run a build.
«TOOL»_RELEASE_OPTS	e.g.clean deploy -Dchangelist= -Pdeploy	The arguments provided to the build-tool «TOOL» in order to perform a release build.