Zum Hauptinhalt springen

Lokale Umgebung vorbereiten

Bevor Sie mit der Erkundung der Welt von Jutro beginnen, sollten Sie sicherstellen, dass Sie die notwendigen Tools installiert haben.

Note: Wissenswertes (nur für Windows-Benutzer)

Für die Einrichtung von Tools, die über Shell-Befehle installiert werden müssen, ist es am besten, Powershell als „Administrator“ zu verwenden, um Rechteprobleme zu vermeiden.

Visual Studio Code installieren​

  1. Gehen Sie auf https://code.visualstudio.com/ und laden Sie das Installationsprogramm für Ihr System herunter.
  2. Befolgen Sie die Installationsanweisungen.

Git installieren​

Sobald Sie Git installiert haben, können Sie es direkt in VS Code verwenden, um Änderungen auszuführen und zu übertragen, Zweige zu erstellen und so weiter.

  1. Gehen Sie auf https://git-scm.com/downloads und laden Sie die Installation für Ihr System herunter.

Node.js installieren​

Sie müssen eine Version von Node installieren, die mit der aktuellen Version der Starter-App kompatibel ist:

  • Node-Version: >=22.6.0 < 23
  • npm: >=10.8.2
  1. Öffnen Sie https://nodejs.org/download/release/ und suchen Sie nach der Version von Node, die Sie installieren möchten. Wenn Sie beispielsweise Version 18.14.2 herunterladen möchten, suchen Sie nach „v18.14.2“. Sie erhalten auch die zugehörige NPM-Version.
Note: Wissenswertes

Stellen Sie bitte sicher, dass Sie das Installationsprogramm von Node.js verwenden, das für die Architektur geeignet ist, auf der Ihr Rechner läuft. Mit anderen Worten, wenn Sie ein 64-Bit-System verwenden (der übliche Fall), stellen Sie sicher, dass Sie den Installer mit der 64-Bit-Version von Node.js herunterladen (auch bekannt als x64). Wenn Sie ein 32-Bit-System verwenden, laden Sie auch die 32-Bit-Variante des Node.js-Installationsprogramms herunter (auch bekannt als x86).

Haftungsausschluss: Wenn Sie eine 32-Bit-Version von Node verwenden, müssen Sie möglicherweise einige zusätzliche Bibliotheken/DLLs/C (C++)-Compiler für einige indirekte Abhängigkeiten von Jutro (z. B. canvas) auf Ihrem Computer einrichten. Das liegt daran, dass die Versionen ihrer Pre-Builds möglicherweise nicht für die 32-Bit-Architektur verfügbar sind. In diesem Fall müssen diese möglicherweise lokal aus den Quellen von node-gyp erstellt werden (daher sind zusätzlichen Tools auf Ihrem Rechner erforderlich).

HINWEIS: Alternativ können Sie auch Node Version Manager (nvm) (oder die Variante für Windows-Betriebssysteme) installieren und dann zur Installation der kompatiblen Node-Version verwenden. Mit nvm ist auch ein einfacher Wechsel zur richtigen Node-Version möglich, die zum Ausführen der Startanwendung erforderlich ist. Dies ist nützlich, wenn bereits andere Versionen installiert wurden.

  1. Um zu überprüfen, ob Sie über die richtige Version von Node verfügen, öffnen Sie ein neues Befehlszeilenfenster und führen Sie folgendes aus:
node -v

Abhängigkeiten von node-gyp installieren​

node-gyp wird von vielen Abhängigkeiten von Jutro benötigt, benötigt aber selbst auch mehrere globale Bibliotheken/Tools, die auf Ihrem System installiert sein müssen, um eine korrekte Funktion zu ermöglichen.

  1. Vergewissern Sie sich, dass alle erforderlichen Tools/Bibliotheken entsprechend Ihrem Betriebssystem installiert sind:

    1. Unix
    2. Mac
    3. Windows

  2. Konfigurieren Sie den Verweis von node-gyp auf eine geeignete Python-Version auf Ihrem Rechner, entsprechend der Empfehlung für node-gyp

HINWEIS: Wenn Sie nicht über die von node-gyp benötigte Version von Python verfügen, empfehlen wir Ihnen, diese mit dem Versionsverwaltungsprogramm pyenv (oder dessen Variante für Windows-Betriebssysteme) zu installieren.