matthias.lotz
dff2de1755
die Order nicht gefunden. -> behoben - IMP: "einfachere" Debug Möglichkeit mit odoo-18-dev container. README.md in .vscode hinzugefügt.
65 lines
2.7 KiB
Markdown
65 lines
2.7 KiB
Markdown
# Quickstart: Debugging für open_workshop
|
||
|
||
Diese Datei hilft dir, das `open_workshop` Addon schnell in VS Code zu öffnen und sowohl das Addon als auch (optional) den Odoo‑Core zu debuggen.
|
||
|
||
Kurzfassung
|
||
- Öffne in VS Code den Ordner `extra-addons/open_workshop`.
|
||
- Starte die Development-Container/Composer Umgebung mit `./dev.sh` (Option 1 oder 2).
|
||
- Verwende die DevContainer‑Funktion oder die Debug‑Konfigurationen unten.
|
||
|
||
1) Container starten
|
||
|
||
Empfohlen: im Projektstamm (`odoo`) ausführen:
|
||
|
||
```bash
|
||
./dev.sh
|
||
# Option 1: Normal starten (ODOO_DEV=1)
|
||
# Option 2: Debug-Modus (ODOO_DEBUG=1) — der Container wartet auf eine Debug-Verbindung
|
||
```
|
||
|
||
2) VS Code als DevContainer verbinden (empfohlen)
|
||
|
||
- Öffne VS Code im lokalen Ordner `extra-addons/open_workshop`.
|
||
- Command Palette → `Dev Containers: Attach to Running Container...` → wähle `odoo-dev`.
|
||
- VS Code öffnet den Container als Arbeitsumgebung (remoteUser ist `odoo`).
|
||
- Öffne dann das Workspace‑Verzeichnis `/mnt/extra-addons/open_workshop`.
|
||
|
||
Vorteil: Du arbeitest direkt im Container (kein lokales Kopieren der Core‑Sourcen nötig) und Breakpoints funktionieren zuverlässig.
|
||
|
||
3) Debugging (Attach)
|
||
|
||
- Wenn du als DevContainer verbunden bist, verwende die Debug‑Konfiguration "Odoo Attach (container)" (port 5678).
|
||
- Wenn du lokal arbeitest und den Host‑Port benutzt, verwende "Odoo Attach (host)" (port 4338).
|
||
|
||
4) Pfad‑Mapping
|
||
|
||
- Die `launch.json` enthält Pfadabbildungen:
|
||
- `${workspaceFolder}` ↔ `/mnt/extra-addons/open_workshop` (dein Addon)
|
||
- `${workspaceFolder}/../../odoo-source/odoo` ↔ `/usr/lib/python3/dist-packages/odoo` (falls du lokal eine Kopie des Odoo‑Cores hast)
|
||
|
||
Hinweis: Lokale `odoo-source` ist nicht erforderlich, wenn du per DevContainer arbeitest, weil VS Code die Dateien direkt im Container liest.
|
||
|
||
5) Troubleshooting
|
||
|
||
- Debug-Verbindung schlägt fehl: prüfe, ob der Container im Debug‑Modus läuft und der Port gemappt ist:
|
||
|
||
```bash
|
||
docker compose -f docker-compose.dev.yaml ps
|
||
docker compose -f docker-compose.dev.yaml logs -f odoo-dev
|
||
```
|
||
|
||
- VS Code meldet, dass Breakpoints nicht aufgelöst werden: vergewissere dich, dass die `pathMappings` korrekt sind und die lokalen Dateien existieren (oder nutze DevContainer).
|
||
|
||
6) Image/Compose aktualisieren
|
||
|
||
- Wenn du `Dockerfile.Dev` geändert hast: neu bauen (Option 3 in `./dev.sh`), dann Container neu starten (Option 5 oder down/up).
|
||
|
||
7) Kurze Checklist für Mitentwickler
|
||
|
||
- `./dev.sh` → Option 3 (einmalig) wenn du das Dev‑Image bauen musst.
|
||
- `./dev.sh` → Option 1 oder 2 zum Starten.
|
||
- In VS Code: Öffne `extra-addons/open_workshop`, dann `Dev Containers: Attach to Running Container...`.
|
||
- Starte Debug mit "Odoo Attach (container)" oder "Odoo Attach (host)".
|
||
|
||
|