Logo

Ein Projekt anlegen

Ihr erstes Origin-Repository aufbauen

Ein Projekt anlegen

In dieser Lektion entsteht das lokale Projekt, das in der nächsten Lektion zum Divekit-Origin-Repository wird.

Das Starter-Projekt aufbauen

Schritt 1: Projektordner anlegen oder betreten

Wenn Sie noch keinen Projektordner haben, legen Sie einen an:

mkdir vehicle-workshop
cd vehicle-workshop

Wenn Sie das Verzeichnis schon früher angelegt haben, betreten Sie es einfach.

Schritt 2: eine winzige Vorlagendatei ergänzen

Ergänzen Sie jetzt eine winzige Vorlagendatei, damit Ihr Projekt bereits Inhalt enthält, der später individualisiert werden kann.

Legen Sie den Quellordner an:

mkdir -p src

Erstellen Sie src/$Vehicle$.java mit folgendem Inhalt — am einfachsten in Ihrem Editor, denn der Dateiname selbst enthält den Platzhalter:

public class $Vehicle$ {
    public String kind() {
        return "$Vehicle$";
    }
}

Wenn Sie die Datei lieber im Terminal anlegen, setzen Sie den Namen in einfache Anführungszeichen, damit Ihre Shell $Vehicle$ nicht als Variable interpretiert:

touch 'src/$Vehicle$.java'

Erstellen Sie außerdem eine README.md:

# Vehicle Workshop

This assignment contains one placeholder: `$Vehicle$`.

An diesem Punkt ist das noch ein ganz normaler Projektordner mit Starter-Dateien.

Typische Fehler

Was Sie versuchen können

Ihre Shell hat den Platzhalter expandiert. In bash und zsh wird ein unquotiertes $Vehicle als (vermutlich leere) Shell-Variable gelesen, sodass touch src/$Vehicle$.java tatsächlich src/$.java erzeugt.

Löschen Sie die falsche Datei und legen Sie sie mit dem Namen in einfachen Anführungszeichen neu an:

rm 'src/$.java'
touch 'src/$Vehicle$.java'

Dasselbe gilt für den Dateiinhalt: Wenn Sie die Datei mit einem Heredoc schreiben, quoten Sie den Delimiter (<<'EOF'), sonst werden auch die Platzhalter im Dateiinhalt zerlegt. Im Zweifel nehmen Sie Ihren Editor.

Was Sie versuchen können
Müssen Sie nicht. Es ist völlig in Ordnung, die ersten Vorlagendateien vor der Initialisierung vorzubereiten.
Was Sie versuchen können
Noch nicht. Im Moment sind sie nur Textmarkierungen in einem normalen Projektordner.
Was Sie versuchen können
In dieser Phase reichen eine winzige Quelldatei und eine kurze README.

Check

Diese Fragen sollten Sie jetzt beantworten können:

Vorschlag zur Antwort
An drei Stellen: im Dateinamen src/$Vehicle$.java, in dieser Datei als Klassenname und Rückgabewert sowie in der README.md.
Vorschlag zur Antwort
Noch nichts. Sie sind reine Textmarkierungen. Bedeutung bekommen sie erst, wenn Sie Divekit initialisieren und definieren, wie Vehicle ersetzt werden darf.
Vorschlag zur Antwort
Nein — es ist noch ein normaler Projektordner. Er wird zum Origin-Repository, wenn Sie in der nächsten Lektion divekit init ausführen.