<commit_before>---
layout: documentation
---

{% include base.html %}

# Setting Up a Development Environment

Please ensure that you have the following prerequisites installed on your machine:

1. [Git](https://git-scm.com/downloads)
1. [Maven 3.x](https://maven.apache.org/download.cgi)
1. [Oracle JDK 8](http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html)
1. [Python >=2.5](https://www.python.org/downloads/) (to build UIs with npm)

The Eclipse IDE is used for Eclipse SmartHome developments.
The Eclipse Installer automatically prepares the IDE so that it comes with all required plug-ins, the correct workspace encoding settings, pre-configured code formatters and more.
Simply follow these steps:

1. Download the [Eclipse Installer](https://wiki.eclipse.org/Eclipse_Installer)

2. Launch the Eclipse Installer and switch to „Advanced Mode“ in the top right menu:
![Step 0](images/ide0.png)

3. Choose the "Eclipse IDE for Java Developers" and select "Next":
![Step 1](images/ide1.png)

4. Expand the "SmartHome" entry, double click "Runtime" and select "Next":
![Step 2](images/ide2.png)

5. Now provide an installation folder and your Github id (used to push your changesets to) and select "Next":
![Step 3](images/ide3.png)

6. The installation will now begin when pressing "Finish".
![Step 4](images/ide4.png)

7. Once it is done, you will see the Eclipse Welcome Screen, which you can close by clicking "Workbench" on the top right.
You will see that the installer not only set up an Eclipse IDE instance for you, but also checked out the Eclipse SmartHome git repository and imported all projects into the workspace.
Don't worry that you still see error markers at that point, this will be addressed in the next steps.
![Step 5](images/ide5.png)<commit_msg>Added information to not use spaces in installpath (#6525)<commit_after>---
layout: documentation
---

{% include base.html %}

# Setting Up a Development Environment

Please ensure that you have the following prerequisites installed on your machine:

1. [Git](https://git-scm.com/downloads)
1. [Maven 3.x](https://maven.apache.org/download.cgi)
1. [Oracle JDK 8](http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html)
1. [Python >=2.5](https://www.python.org/downloads/) (to build UIs with npm)

The Eclipse IDE is used for Eclipse SmartHome developments.
The Eclipse Installer automatically prepares the IDE so that it comes with all required plug-ins, the correct workspace encoding settings, pre-configured code formatters and more.
Simply follow these steps:

1. Download the [Eclipse Installer](https://wiki.eclipse.org/Eclipse_Installer)

2. Launch the Eclipse Installer and switch to „Advanced Mode“ in the top right menu:
![Step 0](images/ide0.png)

3. Choose the "Eclipse IDE for Java Developers" and select "Next":
![Step 1](images/ide1.png)

4. Expand the "SmartHome" entry, double click "Runtime" and select "Next":
![Step 2](images/ide2.png)

5. Now provide an installation folder (don't use spaces in the path on Windows!) and your Github id (used to push your changesets to) and select "Next":
![Step 3](images/ide3.png)

6. The installation will now begin when pressing "Finish".
![Step 4](images/ide4.png)

7. Once it is done, you will see the Eclipse Welcome Screen, which you can close by clicking "Workbench" on the top right.
You will see that the installer not only set up an Eclipse IDE instance for you, but also checked out the Eclipse SmartHome git repository and imported all projects into the workspace.
Don't worry that you still see error markers at that point, this will be addressed in the next steps.
![Step 5](images/ide5.png)
{'fraction_non_alphanumeric': 0.09718462371413103, 'fraction_numerical': 0.020032485110990796, 'mean_word_length': 4.590015128593041, 'pattern_counts': {'":': 6, '<': 3, '<?xml version=': 0, '>': 5, 'https://': 8, 'lorem ipsum': 0, 'www.': 4, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 16, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '1065801', 'n_tokens_mistral': 1136, 'n_tokens_neox': 1043, 'n_words': 481}