KDE on Rebel Zhangs Blog

Die Implementierung einer Funktionalität in einer QtWidgets-Anwendung mit GammaRay finden

rebel1725@tilde.club (Rebel Zhang) — Sun, 09 Aug 2026 20:49:33 +0800

Um Freiheit 1 und Freiheit 3 freier Software auszuüben und/oder zur freien-Software-Community beizutragen, müssen wir den mit einer Funktionalität verbundenen Quellcode ändern, damit die Software etwas anderes tut. Da wir mit einem Projekt jedoch nicht vertraut sind, wissen wir oft nicht, wo sich der Quellcode befindet, den wir ändern müssen. Vielleicht haben Sie Glück, wenn Sie grep -R <some-user-facing-string> . ausprobieren; manchmal funktioniert das jedoch nicht (siehe den vorherigen Beitrag). In diesem Fall benötigen wir fortgeschrittene Werkzeuge zur Software-Inspektion. Für mit Qt entwickelte Software ist ein leistungsstarkes Hilfswerkzeug GammaRay.

Um GammaRay zu verwenden, müssen Sie es zuerst installieren. Wenn Sie Software inspizieren möchten, die aus dem offiziellen Paketarchiv Ihrer Distribution installiert wurde, dann installieren Sie GammaRay ebenfalls von dort:

# apt install gammaray

Wenn Sie kde-builder zur Entwicklung von KDE-Anwendungen verwenden, fügen Sie diese Zeilen zu Ihrer ~/.config/kde-builder.yaml hinzu:

project gammaray:
  repository: https://github.com/KDAB/GammaRay.git

und bauen Sie es in Ihr Arbeitsverzeichnis:

$ kde-builder gammaray

Um GammaRay zu verwenden, muss die Anwendung, die Sie inspizieren möchten, ausgeführt werden. Starten Sie dann GammaRay und wählen Sie Ihre Anwendung aus der Liste aus.

Nehmen wir als Beispiel die Suche nach der Diashow-Logik in Gwenview. Öffnen Sie Gwenview und dann ein Bild; dort sehen Sie die Option Start Slideshow im Menü:

Wenn Sie die Liste der Widgets einzeln durchgehen, werden Sie sehen, dass 0x13bda470 das Menü ist, das wir inspizieren möchten und das die Option Start Slideshow enthält:

Und wir werden im Reiter Connections eine toggle_slideshow QAction sehen:

grep zeigt uns, wo eine solche QAction liegt:

~/kde/src/gwenview$ grep -R toggle_slideshow
app/fullscreencontent.cpp:    addAction(QStringLiteral("toggle_slideshow"));
app/gwenviewui.rc:        <Action name="toggle_slideshow" />
app/mainwindow.cpp:        mToggleSlideShowAction = view->addAction(QStringLiteral("toggle_slideshow"), q, &MainWindow::toggleSlideShow);

Öffnen Sie das Projekt in Ihrer bevorzugten IDE, z. B. Qt Creator, und suchen Sie in app/mainwindow.cpp nach der Zeichenkette. Wir werden toggle_slideshow hier finden:

        mToggleSlideShowAction = view->addAction(QStringLiteral("toggle_slideshow"), q, &MainWindow::toggleSlideShow);
        q->updateSlideShowAction();
        connect(mSlideShow, &SlideShow::stateChanged, q, &MainWindow::updateSlideShowAction);

Suchen wir nun hier nach toggleSlideShow, was uns zu dieser Funktion führt:

void MainWindow::toggleSlideShow()
{
    if (d->mSlideShow->isRunning()) {
        d->mSlideShow->pause();
    } else {
        if (!d->mViewAction->isChecked()) {
            d->mViewAction->trigger();
        }
        if (!d->mFullScreenAction->isChecked()) {
            d->mFullScreenAction->trigger();
        }
        QList<QUrl> list;
        for (int pos = 0; pos < d->mDirModel->rowCount(); ++pos) {
            QModelIndex index = d->mDirModel->index(pos, 0);
            KFileItem item = d->mDirModel->itemForIndex(index);
            MimeTypeUtils::Kind kind = MimeTypeUtils::fileItemKind(item);
            switch (kind) {
            case MimeTypeUtils::KIND_SVG_IMAGE:
            case MimeTypeUtils::KIND_RASTER_IMAGE:
            case MimeTypeUtils::KIND_VIDEO:
                list << item.url();
                break;
            default:
                break;
            }
        }
        d->mSlideShow->start(list);
    }
    updateSlideShowAction();
}

Suchen Sie weiter nach mSlideShow, und Sie landen hier:

struct MainWindow::Private {
    ...
    SlideShow *mSlideShow = nullptr;
    ...
}

Wir sehen nun, dass d->mSlideShow vom Typ SlideShow * ist. Wenn Sie mit der Maus über den Namen SlideShow fahren, erfahren Sie, dass der Typ von lib/slideshow.h bereitgestellt wird.

Öffnen Sie nun lib/slideshow.cpp und lib/slideshow.h, und Sie sind startklar.

Meine allerersten Schritte beim Mitwirken an der Freie-Software-Gemeinschaft (bestehende Projekte)

rebel1725@tilde.club (Rebel Zhang) — Sun, 02 Aug 2026 23:18:30 +0800

In den vergangenen Tagen habe ich der Freie-Software-Gemeinschaft weitaus weniger beigetragen, als ich von ihr profitiert habe, und das, was ich beigetragen habe, beschränkte sich auf kleine, einfache persönliche Projekte sowie Beiträge ohne Code (etwa einige Übersetzungen, das Hochladen einiger Screenshots auf Debian Screenshots und das Verfassen von Beiträgen für die Free Software Chinese Site). Im vergangenen Jahr habe ich C/C++, Qt, Assemblersprache und etwas Rust gelernt, und ich denke, es ist an der Zeit, etwas Sinnvolles für die Freie-Software-Gemeinschaft und die Freie-Software-Bewegung zu tun.

HAFTUNGSAUSSCHLUSS: Das ist keine Anleitung! Ich schreibe diesen Beitrag nur, um meine eigenen Erfahrungen zu teilen. Bitte ziehe die einschlägige Dokumentation zu Rate und wende dich an Expertinnen und Experten, um mehr darüber zu erfahren, wie man zur Freie-Software-Gemeinschaft beitragen kann.

Warum ich KDE gewählt habe

Ursprünglich hatte ich darüber nachgedacht, zu postmarketOS beizutragen. Allerdings hatte ich das Gefühl, dass meine Fähigkeiten bei Weitem nicht ausreichten, und ich beschloss, mit etwas relativ Einfachem zu beginnen. Da ich mit C++ und Qt besser vertraut bin, habe ich KDE für meinen ersten Beitrag zur Gemeinschaft gewählt.

Gefühle

Meine Fähigkeit, Quellcode zu lesen, ist schwach. Etwa Anfang 2025 versuchte ich, den Quellcode von PDF Arranger zu lesen, und fühlte mich krank und überwältigt.

Dank der Erfahrung aus dem Erlernen von Reverse Engineering, das das Lesen von Assemblersprache erfordert, hat sich jedoch auch meine Fähigkeit verbessert, Quellcode in Hochsprachen zu lesen. Deshalb denke ich, dass ich einen echten Beitrag zu Freier Software versuchen sollte, um meine Fähigkeiten in einer realen Umgebung zu üben.

Bevor ich den Quellbaum öffnete, war ich etwas nervös, und ich hatte Angst, vom Quellcode überwältigt zu werden, so wie es mir beim Lesen des PDF-Arranger-Quellcodes ergangen war. Dank der Ermutigung meines Freundes Integral fand ich den Mut, diesen Schritt zu gehen.

Werkzeuge

Eine der von KDE empfohlenen Entwicklungsumgebungen ist die neueste Version von Fedora KDE. Da ich Qubes OS verwende, ist es für mich sehr einfach, schnell eine eigenständige HVM einzurichten und meine gesamte Arbeit darin zu erledigen.

Danach richtete ich kde-builder gemäß der offiziellen Dokumentation für KDE-Entwicklerinnen und -Entwickler ein.

Arbeit

Ich ging die Fehlerliste durch, die auf KDEs offiziellem Bugzilla gehostet wird. Mir fiel ein Fehler auf, der sehr leicht zu beheben schien, aber nachdem ich den Quellcode geholt und das Binärprogramm gebaut hatte, stellte ich fest, dass der Fehler in meiner Umgebung mit der neuesten Version von Ark nicht reproduzierbar war.

Dann ging ich zurück zur Fehlerliste und entdeckte einen weiteren Fehler, der trivial wirkte. Die Systemumgebung und die Softwareversion im Fehlerbericht waren dieselben wie bei mir (Fedora KDE, 26.04), und der Fehler war in der Anwendung aus Fedora’s offiziellem Repository reproduzierbar. Nachdem ich das bestätigt hatte, holte ich den Quellcode und baute ihn.

Ich startete GDB auf dem Binärprogramm ~/kde/build/konsole/bin/konsole. Nachdem ich die im Fehlerbericht genannte Zeichenkette (calt,liga,ss03, ss07,ss09) in das Feld eingefügt hatte, sah ich diese Ausgabe in der Konsole:

The tag name must be exactly 4 characters long!

Nach mehreren Gesprächen mit einem LLM fand ich mithilfe eines GDB-Python-Skripts einen Weg, die Zeile im Quellcode zu lokalisieren, die diese Meldung ausgibt:

python
import gdb

TARGET = b"The tag name must be exactly 4 characters long!"

class FilteredWrite(gdb.Breakpoint):
    def stop(self):
        fd = int(gdb.parse_and_eval("$rdi"))
        if fd not in (1, 2):
            return False

        buf = int(gdb.parse_and_eval("$rsi"))
        count = int(gdb.parse_and_eval("$rdx"))

        try:
            data = gdb.selected_inferior().read_memory(buf, count).tobytes()
        except gdb.MemoryError:
            return False

        if TARGET in data:
            gdb.write("\n=== matched output ===\n")
            gdb.write(data.decode("utf-8", "replace") + "\n")
            gdb.execute("bt full")
            return True

        return False

FilteredWrite("write")

Nach einer GDB-Sitzung bestätigte ich, dass die Warnung aus der Datei kfontchooser.cpp in kwidgetsaddons ausgelöst wurde. Ich fand auch die Funktion, die die Warnung auslöst:

void KFontChooserPrivate::slotFeaturesChanged(const QString &features)
{
    m_selectedFont.clearFeatures();

    if (features.isEmpty()) {
        return;
    }

    const QStringList rawFeaturesList = features.split(QLatin1Char(','), Qt::SkipEmptyParts);
    for (const QString &feature : rawFeaturesList) {
        auto f = QStringView(feature).trimmed();
        if (f.isEmpty()) {
            continue;
        }
        QList<QStringView> parts = f.split(QStringLiteral("="), Qt::SkipEmptyParts);
        if (parts.length() == 2) {
            const auto tag = QFont::Tag::fromString(parts[0]);
            bool ok = false;
            const int number = parts[1].toInt(&ok);
            if (tag.has_value() && ok) {
                m_selectedFont.setFeature(tag.value(), number);
            }
        } else if (f.size() <= 4) {
            const auto tag = QFont::Tag::fromString(feature);
            if (tag.has_value()) {
                m_selectedFont.setFeature(tag.value(), 1);
            }
        }
    }

    Q_EMIT q->fontSelected(m_selectedFont);
}

Mir fiel auf, dass das Ergebnis des Teilens getrimmt wurde:

auto f = QStringView(feature).trimmed();

aber die ursprüngliche, nicht getrimmte Zeichenkette weiterhin als Tag verwendet wurde:

const auto tag = QFont::Tag::fromString(feature);

Das scheint ein Fehler des Entwicklers zu sein. Um das Problem zu beheben, müssen wir nur die nicht getrimmte Zeichenkette durch die getrimmte ersetzen:

const auto tag = QFont::Tag::fromString(f);

Danach war es an der Zeit, einen Branch zu erstellen, die Änderung in diesen Branch zu committen und einen Merge Request einzureichen. Aufgrund meiner begrenzten Erfahrung mit Git stieß ich jedoch auf ein Problem:

warning: redirecting to https://invent.kde.org/rebellfs/kwidgetsaddons.git/
Enumerating objects: 21973, done.
Counting objects: 100% (21973/21973), done.
Delta compression using up to 4 threads
Compressing objects: 100% (2790/2790), done.
Writing objects: 100% (21973/21973), 41.17 MiB | ... KiB/s, done.
Total 21973 (delta 13428), reused 21374 (delta 12884), pack-reused 0 (from 0)
remote: Resolving deltas: 100% (13428/13428), done.
remote: Audit failure - Commit 046e4bb16e60b66070ee4a00c368ca6924db3a08 - Email address has an invalid domain : [kde@randomguy3.me.uk](mailto:kde@randomguy3.me.uk)
remote: Audit failure - Commit 046e4bb16e60b66070ee4a00c368ca6924db3a08 - Email address has an invalid domain : [kde@randomguy3.me.uk](mailto:kde@randomguy3.me.uk)
remote: Audit failure - Commit c8c7ab3d0e7ca825bbb01d58de005d4d589b12cc - Email address has an invalid domain : [kde@randomguy3.me.uk](mailto:kde@randomguy3.me.uk)
remote: Audit failure - Commit c8c7ab3d0e7ca825bbb01d58de005d4d589b12cc - Email address has an invalid domain : [kde@randomguy3.me.uk](mailto:kde@randomguy3.me.uk)
remote: Audit failure - Commit 62e5736a1f4afc2d24ef2c4d643a98bc60e6d6cd - Email address has an invalid domain : [kde@randomguy3.me.uk](mailto:kde@randomguy3.me.uk)
remote: Audit failure - Commit 62e5736a1f4afc2d24ef2c4d643a98bc60e6d6cd - Email address has an invalid domain : [kde@randomguy3.me.uk](mailto:kde@randomguy3.me.uk)
remote: Audit failure - Commit f317243c63620acec15a46c412502e73b9a04e2a - Email address has an invalid domain : [kde@randomguy3.me.uk](mailto:kde@randomguy3.me.uk)
remote: Audit failure - Commit f317243c63620acec15a46c412502e73b9a04e2a - Email address has an invalid domain : [kde@randomguy3.me.uk](mailto:kde@randomguy3.me.uk)
remote: Push declined - commits failed audit
remote: Should the audit failures above mention issues regarding your name, please ensure that your Git username has been set to your full name.
remote: Please see https://git-scm.com/book/en/v2/Getting-Started-First-Time-Git-Setup for more details on ensuring Git has been fully configured.
remote: In the event that your full name has been set and is shown above as being rejected, please file a Sysadmin ticket at https://go.kde.org/systickets
To https://invent.kde.org/rebellfs/kwidgetsaddons
! [remote rejected]     work/rebel1725/fix523757 -> work/rebel1725/fix523757 (pre-receive hook declined)
error: failed to push some refs to 'https://invent.kde.org/rebellfs/kwidgetsaddons'

Schließlich reichte ich die Änderung über den Browser ein, da es sich nur um eine triviale Änderung an einer einzigen Datei handelte.

Fazit

Heute habe ich meinen allerersten Beitrag zur Freie-Software-Gemeinschaft geleistet und bin zugleich ein brandneuer Freie-Software-Mitwirkender geworden. In Zukunft hoffe ich, immer mehr beizutragen, meine Fähigkeiten zu schärfen und der Gemeinschaft sowie der Freie-Software-Bewegung noch nützlicher zu sein.