Translated using Weblate (German)

## /e/OS easy-installer Build documentation

## /e/OS Easy-Installer-Build-Dokumentation

### Tools required to build

- Java JDK 11+

### How to clone the project

### Das Projekt klonen

Run this command in a terminal

Führen Sie diesen Befehl im Terminal aus

```shell

git clone https://gitlab.e.foundation/e/tools/easy-installer.git

```

### How to build

### Wie man Builds erstellt

Open a terminal at the root of the project

prompt: `./gradlew dist`

Öffnen Sie ein Terminal an der Wurzel des Projektes.

Prompt: `./gradlew dist`

Note: "dist" for "distribution"

Hinweis: „dist“ steht für „Distribution“

#### Result

It will create 3 zipped artifacts, zipped together in a single archive :

#### Ergebnis

Es wird 3 gezippte Artefakte erstellen, die in ein gemeinsames Archiv gepackt sind:

- linux-x64

- windows-x64

- mac

Location of the artifacts :

Ort der Artefakte :

Zipped build : "/build/distributions/"

Archiviertes Build : "/build/distributions/"

Unzipped build : "/build/image/"

#### What does this command do?

Compiled java version is provided from "buildSrc" folder. There is one version for each platform (windows, osx, linux). That will allow to have an installation free application. thanks to java 9+, it only includes required modules.

Die kompilierte Java-Version wird im Ordner „buildSrc“ bereitgestellt. Es gibt eine Version für jede Plattform (Windows, OSX, Linux). Dies ermöglicht eine installationsfreie Anwendung. Dank Java 9+ enthält sie nur die erforderlichen Module.

99% of the job is done by the "badass jlink plugin" (see section below).

The remaining 1% consist of:

- copying ADB

- copying heimdall

- copying fastboot

- flash's scripts

99% erledigt "badass jlink plugin" (siehe obere Sektion).

Die verbleibenden 1% werden erledigt von:

- ADB kopieren

- heimdall kopieren

- fastboot kopieren

- Flash-Skripte

from "buildSrc" and "flash-scripts" folders into the build.

von den "buildSrc"- und "flash-scripts"-Ordnern in das Build.

#### What is used to make the build ?

It uses the ["badass jlink plugin"](https://badass-jlink-plugin.beryx.org/releases/latest/#_properties)

#### Was wird benutzt, um das Build zu erstellen ?

Es benutzt das ["badass jlink plugin"](https://badass-jlink-plugin.beryx.org/releases/latest/#_properties)

## Feature idea

## Funktions-Idee

- make `./gradlew dist` to create a build for one platform at a time depending on a param.

i.e: `./gradlew dist windows` or `./gradlew dist linux`

1. I want to help **porting /e/OS on Windows**

    - you can help us to translate scripts to Windows

    - if you have some knowledge to package Windows application (as we did on Linux with Snap)

    - once the 2 previous points will be done, you can test and try that everything runs on Windows as it runs on Linux

1. Ich möchte helfen **/e/ auf Windows zu portieren**

    - Sie können uns helfen, Skripte für Windows zu übersetzen.

    - wenn Sie etwas Wissen mitbringen, um Windows-Anwendungen zu paketieren (wie wir mit Snap auf Linux gemacht haben)

    - Sobald die 2 vorherigen Punkte erledigt sind, können Sie testen, ob alles unter Windows genauso läuft wie unter Linux

1. I want to help **porting /e/OS on MacOS**

    - you can check that our scripts are compatible with MacOS

    - if you have some knowledge to package MacOS X applications (as we did on Linux with Snap)

    - once the 2 previous points will be done, you can test and try that everything runs on MacOS as it runs on Linux

1. Ich möchte helfen, **/e/ auf MacOS zu portieren**

    - Sie können überprüfen, ob unsere Skripte mit MacOS kompatibel sind

    - wenn Sie Wissen mitbringen, MacOS-Anwendungen zu paketieren (wie wir mit Snap auf Linux gemacht haben)

    - Sobald die 2 vorherigen Punkte erledigt sind, können Sie testen, ob alles unter MacOS genauso läuft wie unter Linux

1. I want to **add support for a new device**

    - You need to own the device

    - First step is to create configuration files for the Easy Installer

    - If necessary, create the missing scripts to be able to achieve the installation

1. Ich möchte **Unterstützung für ein neues Gerät hinzufügen**

    - Sie müssen das Gerät besitzen

    - Erstellen Sie als erstes Konfigurationsdateien für den Easy-Installer

    - Erstellen Sie, wenn nötig, die fehlenden Skripten, um die Installation durchführen zu können

## How to support or add a new device ?