open_workshop/.vscode

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:

./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:

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)".