fortunecookie/LEKTIONEN_2026-06-06.md

Lektionen gelehrt am 06.06.2026

🎯 Dynamische Cookie-Bilder Implementierung

Problem

Cookie-Bilder sollten sich je nach ausgewählter Spruchliste ändern (z.B. famous quotes_open.png für berühmte Zitate).

Lösung

1. Funktion updateCookieImage() erstellt, die den Bildpfad basierend auf currentFortuneListName und fortuneOpened bestimmt
2. Explizite Aufrufe an allen Stellen, wo sich der Zustand ändert:
   • Initialisierung (mit Qt.callLater für UI-Bereitschaft)
   • Beim Listenwechsel in den Einstellungen
   • Beim Öffnen/Schließen des Cookies (MouseArea Handler)
   • Beim Neuladen des Fortunes

Wichtige Erkenntnis

Qt.binding() funktioniert NICHT zuverlässig für automatische Updates, wenn sich Properties in JavaScript-Funktionen ändern. → Immer explizite Aufrufe von Update-Funktionen verwenden, statt auf automatische Bindings zu vertrauen.

Code-Beispiel

function updateCookieImage() {
    var listName = currentFortuneListName || "fortune";
    var availableLists = ["farmer wisdom", "UNfortune", ...];
    if (availableLists.indexOf(listName) !== -1) {
        var encodedName = listName.replace(/ /g, "%20");
        cookieImage.source = Qt.resolvedUrl("../assets/" + encodedName + (fortuneOpened ? "_open.png" : "_close.png"));
    } else {
        cookieImage.source = fortuneOpened ? Qt.resolvedUrl("../assets/cookie_open2.png") : Qt.resolvedUrl("../assets/cookie_closed2.png");
    }
}

---

📝 Listenbeschreibungen

Problem

Spruchanzahl wurde in Klammern angezeigt (z.B. "Redensarten aus aller Welt (15)").

Lösung

cleanDescription()-Funktion entfernt alle Klammern mit Zahlen am Ende:

function cleanDescription(text) {
    return text.replace(/\s*\(\d+\)$/, "");
}

---

🔊 Cookie-Knacksgeräusch Toggle

Implementierung

• Property cookieCrackEnabled (default: true)
• Switch in Einstellungen mit Binding an die Property
• Sound wird nur abgespielt, wenn cookieCrackEnabled === true

Code

Switch {
    checked: cookieCrackEnabled
    onCheckedChanged: {
        cookieCrackEnabled = checked;
        py.call("fortunecookie.set_cookie_crack_enabled", [checked]);
    }
}

// In Event-Handlern:
if (cookieCrackEnabled) crackMediaPlayer.play();

---

📏 Cookie-Icon-Größen

Anpassung

• Geschlossen: 30x26 GU
• Geöffnet: 34x30 GU

Alle Cookie-Bilder haben jetzt ähnliche Dimensionen für ein einheitliches Aussehen.

---

🔧 Debugging-Tipps

1. console.log() ist essenziell - Ohne Debug-Ausgaben ist es schwer, den Code-Fluss zu verfolgen
2. Clean Build - clickable clean vor clickable build durchführen, wenn Änderungen nicht sichtbar sind
3. Git Status prüfen - git status zeigt, welche Dateien geändert sind
4. Build-Directory prüfen - Manchmal wird die alte Main.qml verwendet, weil der Build nicht neu gestartet wurde

---

📌 Best Practices

1. Explizit > Implizit - Bei QML besser explizite Funktionsaufrufe als automatische Bindings verwenden
2. Fehlerbehandlung - try-catch in komplexen Funktionen hilft bei der Fehlersuche
3. Konsistente Größen - UI-Elemente sollten ähnliche Dimensionen haben für ein professionelles Aussehen
4. Benutzerfreundlichkeit - Toggle-Switches für Sound sind intuitiver als Checkboxen