- C++ 52%
- Kotlin 28.7%
- QML 16.4%
- CMake 2.9%
| android | ||
| debian | ||
| widget | ||
| .gitignore | ||
| CMakeLists.txt | ||
| main.cpp | ||
| README.md | ||
Plasma-6-Terminliste und Akonadi-Diagnose
Dieses Projekt enthält eine nur lesende Akonadi-Diagnose und ein natives Plasma-6-QML-Applet für einen in den Widget-Einstellungen ausgewählten Akonadi-Kalender. Das Widget kann auf ausdrückliche Benutzeraktion Termine ausschließlich in der ausgewählten Collection anlegen oder löschen; andere Kalender werden nicht verändert.
Bauen und ausführen
cmake -S . -B build
cmake --build build
./build/akonadi-calendar-diagnose
Der Build erzeugt zusätzlich ein lokales Applet-Paket unter build/widget/package. Es wird dabei weder installiert noch in eine laufende Plasma-Sitzung geladen.
Für den Aufruf außerhalb einer KDE-Sitzung kann QT_QPA_PLATFORM=offscreen nötig sein. Die Diagnose gibt Verbindungs- und Ladezustand, Collections samt IDs/Eltern-IDs, Item-Zahlen, MIME-Typen und gefundene Events auf stdout/stderr aus.
Exit-Codes:
0: Event-Payload in „Privat (Saturn)“ oder einem Unterordner gefunden und Baum vollständig geladen.2: Baum vollständig geladen, Zielcollection vorhanden, aber kein Event gefunden.3: Timeout, Collection-Baum oder Item-Laden unvollständig.4: Session-DBus nicht erreichbar.5: Akonadi-Server nicht verfügbar.6: Baum vollständig geladen, Zielcollection nicht gefunden.
Widget-Architektur und Test-Build
Das Widget ist ein Plasma-6-KPackage-QML-Applet. Ein natives Qt/QML-Plugin stellt das Terminmodell und ein separates Auswahlmodell für Kalenderquellen bereit. Die Einstellungen zeigen geeignete Akonadi-Collections mit ihrem Pfad an. Gespeichert wird die Ressource zusammen mit der Remote-ID der Collection; falls keine Remote-ID existiert, wird der Ressourcenpfad verwendet. Bei jedem Lese- und Schreibvorgang wird diese Zuordnung erneut im aktuellen Akonadi-Baum aufgelöst. Nicht mehr vorhandene oder mehrdeutige Ziele werden abgewiesen. Lokale Akonadi-Collection- und Item-IDs werden nicht dauerhaft gespeichert.
Der Backend-Filter zeigt Termine, deren lokale Zeitspanne den heutigen Tag bis einschließlich heute + 7 Tage schneidet. Wiederholungen werden anhand der KCalendarCore-Occurrence-API aufgelöst; Ganztagstermine verwenden inklusive Enddaten, bei zeitgebundenen Terminen gilt ein halb offenes Tagesintervall. Zeitangaben werden in der lokalen Zeitzone formatiert. Akonadi-Modelländerungen lösen eine zusammengefasste Neuberechnung aus; alle 15 Minuten wird die lesende Modellverbindung neu aufgebaut. Ein 30-Sekunden-Lade-Timeout und Statusmeldung verhindern einen unbegrenzt stillen Ladezustand.
Klicks übergeben die vom EntityTreeModel gelieferte Entity-URL unverändert als korganizer --view <URL> an QProcess. Das erhält die Item-ID dynamisch und nutzt den KOrganizer-Öffnungspfad. Neue Termine werden als KCalendarCore::Event-Payload über Akonadi::ItemCreateJob gespeichert und durch Akonadi/CalDAV synchronisiert; es gibt keine direkte HTTP-Schreiboperation. Titel, Datum, Zeitbereich, Ganztag und exakte Duplikate werden vor dem Schreibjob geprüft. KOrganizer bleibt der vollwertige Editor.
./build/widget/eventcreation-validation testet Eingabevalidierung, lokale Zeit-/Ganztag-Payloads, Akonadi-MIME-Typ und Duplikatschlüssel ohne Akonadi-Schreibjob oder Änderung von Kalenderdaten.
Der Build auf dem Host kompiliert das vorhandene Diagnoseprogramm, das QML-Backend und das QML-Plugin. Das Applet-Paket samt Backend-Bibliothek wird in build/widget/package gestaged. qmlformat bestätigt die QML-Syntax. Der Qt-QML-Plugin-Introspektionslauf konnte das Backend-Modul laden. Eine vollständige QML-Typprüfung in der Plasma-Engine wurde nicht ausgeführt, weil das Widget gemäß Vorgabe nicht gestartet wurde. Der Nur-Lese-Backend-Smoke-Test kann aus dieser Tool-Ausführungsumgebung den Session-DBus nicht erreichen; er meldet das explizit und verändert keine Daten.
Build und headless Backend-Test in einer echten KDE-Konsole:
cmake -S . -B build
cmake --build build -j2
QT_QPA_PLATFORM=offscreen ./build/widget/eventlist-readonly-smoke
Der Smoke-Test gibt Status sowie Termine, Item-IDs und Entity-URLs aus; Exit-Code 0 bedeutet, dass die Zielhierarchie gefunden und eingelesen wurde, 2/5 meldet fehlende Collections bzw. Ladefehler, 3 einen 45-Sekunden-Timeout und 4 einen nicht erreichbaren Session-DBus.
Spätere lokale Installation des Pakets (nicht Bestandteil des Build-Schritts):
cmake --install build --prefix "$HOME/.local"
kpackagetool6 --type Plasma/Applet --upgrade build/widget/package
Das QML-Plugin wird benutzerspezifisch unter ~/.local/lib/qt6/qml installiert. Der Plasma-Prozess benötigt diesen Pfad in QML_IMPORT_PATH; für dauerhafte lokale Installationen kann er über ein Sitzungsstartskript unter ~/.config/plasma-workspace/env/ eingebunden werden.
Danach im Plasma-Desktop das Kontextmenü öffnen, Widgets hinzufügen… wählen, Private Termine suchen und auf den Desktop ziehen. Für den Test wieder entfernen und bei Bedarf lokal deinstallieren:
kpackagetool6 --type Plasma/Applet --remove org.example.plasma-event-list
Diagnoseergebnis am 2026-11-04
Der Zugriff auf die echte Plasma-Sitzung war nach Freigabe möglich: Session-DBus erreichbar, Akonadi-Server Running, Monitor bereit, rekursiver Collection-Baum vollständig.
Privat (Saturn): Collection-ID32, interner Nameakonadi_davgroupware_resource_0, Root-Collection.- Untercollection
privat: Collection-ID33, Parent-ID32, 37 Items. - Alle 37 Items der Untercollection sind Kalender-Events mit MIME-Typ
application/x-vnd.akonadi.calendar.event; für alle 37 wurden Event-Payloads gelesen. - Im gesamten Modell: 1.057 Items, davon 732 Kalender-Events und 325
text/directory. - Ergebnis: Exit-Code
0.
Die Entity-URLs werden pro Event ausgegeben. Sie verwenden das von Akonadi gelieferte Format akonadi:?item=<ID>&type=application/x-vnd.akonadi.calendar.event.
KOrganizer-Aufruf für Item 995 am 2026-11-04
Die installierte Version ist 4:24.12.3-1. Ihr Quellcode zeigt, dass korganizer --view <URL> den Wert als QUrl an Akonadi::Item::fromUrl() übergibt, daraus einen ItemFetchJob mit vollständigem Payload erstellt und bei genau einem Treffer CalendarView::showIncidence(item) aufruft. Diese Überladung übergibt das Item an den Event Viewer. Bei einer bereits laufenden Instanz leitet PimUniqueApplication die Kommandozeilenargumente per newInstance() an dieselbe activate()-Methode weiter.
Der Nur-Lese-Funktionstest verwendete exakt akonadi:?item=995&type=application/x-vnd.akonadi.calendar.event. Akonadi lieferte genau ein Item mit ID 995, Event-MIME-Typ und Event-Payload. Der Inzidenz-UID wurde ebenfalls aus dem Payload gelesen; in Collection 33 ist dieser UID genau einmal vorhanden. Damit sind URL-Auflösung und der von --view vorgesehene Öffnungspfad bis zum Event Viewer im Quellcode nachgewiesen.
Die sichtbare Ende-zu-Ende-Öffnung wurde anschließend in der echten Plasma-Sitzung mit erneut gestarteter KOrganizer-Instanz bestätigt. Ein Screenshot zeigt den Dialog „Terminanzeige — KOrganizer“ für „Ulli Pagenberg Geburtstag“, aus der Collection privat in Privat (Saturn), am Mittwoch, 14. Oktober 2020, mit Dauer „1 Tag“ und jährlicher Wiederholung am 14. Oktober. Damit sind Fetch, Aufruf des Event-Viewers und sichtbare Anzeige für Item 995 jeweils bestätigt.
Beim Start erschien kf.calendarcore: Invalid date encountered. Der Quellpfad erklärt die Warnung: CalendarView::showIncidence(item) setzt den Viewer-Kontext absichtlich mit einer leeren QDate(); Incidence::startDateTimesForDate() warnt für dieses ungültige Kontextdatum. Der Formatter verwendet bei der dadurch leeren Ergebnisliste anschließend event->dtStart() als Rückfall. Die sichtbare Anzeige enthält korrekt den Termin am 14.10.2020, daher ist das Termin-Datum bzw. der Event-Payload nicht ursächlich für ein Ausbleiben der Anzeige. Die zuvor notierten IncidenceAttendee-Warnungen stammen aus dem separaten IncidenceEditor-/Konfliktauflösungs-Codepfad; sie traten beim abschließenden --view-Test nicht auf und sind für diesen Viewer-Aufruf nicht erforderlich.
Die Meldung Invalid uid stammte nicht aus dem --view-Pfad, sondern aus einem separaten Test der DBus-Methode /Korganizer, showIncidence(QString): Die Implementierung versucht den Parameter direkt in eine Zahl umzuwandeln. Die übergebene URL kann daher nicht funktionieren. Obwohl der Header diese Methode als URL-basiert beschreibt, erwartet die Implementierung eine numerische Item-ID. Der numerische Aufruf showIncidence("995") lieferte in der laufenden Instanz trotzdem false, weil CalendarView das Item in seinem internen Kalender nicht mit einer Inzidenz auflösen konnte.
Daneben existiert /Calendar, Interface org.kde.calendar.Calendar, Methode showIncidenceByUid(uid, occurrence, activationToken). Sie sucht per Inzidenz-UID im internen Kalender, hat aber keinen Rückgabewert. Der DBus-Aufruf selbst gelang; ob der interne UID-Lookup dieses Item auflöste, lässt sich aus dem Rückgabestatus nicht feststellen. Dieser UID-Endpunkt wird für den --view-Aufruf nicht benötigt.
Der Zweitaufruf bei laufender Instanz wurde ebenfalls ausgeführt; er endete mit Exit-Code 0, während nur ein KOrganizer-Prozess lief. Es wurden keine Kalenderdaten geändert.