Project

General

Profile

Setup und Starten » History » Version 1

Daniel Noah Hildebrandt, 10/30/2026 01:21 PM
Seite angelegt

1 1 Daniel Noah Hildebrandt
h1. Setup & Starten
2
3
{{toc}}
4
5
h2. Voraussetzungen
6
7
* "Node.js":https://nodejs.org (LTS-Version) – Phaser und alle anderen Pakete installiert npm automatisch, *kein* separater Download nötig
8
* "Git":https://git-scm.com
9
* Editor: "Visual Studio Code":https://code.visualstudio.com (empfohlen, optional mit der Erweiterung _ESLint_)
10
11
Nach der Installation von Node.js in einem *neuen* Terminal prüfen:
12
13
<pre>
14
node -v
15
npm -v
16
</pre>
17
18
h2. Projekt einrichten
19
20
<pre>
21
git clone https://gitlab.hof-university.de/Vi/gamedesign_ws2627.git
22
cd gamedesign_ws2627
23
npm install
24
</pre>
25
26
@npm install@ ist nur einmal nötig – und erneut, wenn jemand neue Pakete hinzufügt. Der Ordner @node_modules@ wird *nie* committet (steht in der @.gitignore@).
27
28
h2. Spiel starten
29
30
<pre>
31
npm run dev-nolog
32
</pre>
33
34
Danach im Browser *http://localhost:8080* öffnen. Änderungen am Code werden beim Speichern automatisch neu geladen. Server beenden mit @Strg + C@.
35
36
@npm run dev@ funktioniert auch, sendet aber bei jedem Start anonyme Nutzungsdaten an Phaser – daher @dev-nolog@ verwenden.
37
38
h2. Fertigen Build erstellen
39
40
<pre>
41
npm run build-nolog
42
</pre>
43
44
Das fertige Spiel liegt anschließend im Ordner @dist/@.
45
46
h2. Häufige Probleme
47
48
|_. Problem |_. Lösung |
49
|PowerShell: _„Die Ausführung von Skripts ist auf diesem System deaktiviert“_ |Einmalig @Set-ExecutionPolicy -Scope CurrentUser RemoteSigned@ ausführen und mit @J@ bestätigen. Alternativ @npm.cmd@ statt @npm@ verwenden oder in VS Code das Terminal auf „Command Prompt“ umstellen. |
50
|_„npm wird nicht erkannt“_ |Terminal bzw. VS Code nach der Node.js-Installation neu öffnen. |
51
|Warnung @install-scripts … esbuild@ |Meist harmlos. Falls ein esbuild-Fehler auftritt: @npm install-scripts approve esbuild@ und danach @npm install@. |
52
|Warnung @1 moderate severity vulnerability@ |Ignorieren. *Nicht* @npm audit fix --force@ ausführen – das kann das Projekt kaputt machen. |
53
|Port 8080 belegt |Vite weicht automatisch auf einen anderen Port aus – welcher, steht im Terminal. |
54
55
h2. Git-Grundlagen
56
57
* Vor jeder Arbeit den aktuellen Stand holen: @git pull@
58
* Neue Features in einem eigenen Branch entwickeln: @git switch -c feature/name@
59
* @git fetch@ ist ungefährlich – es lädt nur Infos vom Server und ändert keine Dateien.