GNOME Workbench 47: Ein Beispiel

Zitat von GNU Linux

GNOME Workbench lädt zum Experimentieren mit GTK 4 und Libadwaita, ein. Wir demonstrieren die in Version 47 eingebaute automatische Vervollständigungsfunktion anhand eines Beispiels.

Wer auf Linux unterwegs ist, benutzt in aller Regel eine GTK- oder Qt-basierte Desktop-Umgebung. GTK und Qt sind Widget-Toolkits. Sie bestimmen weitgehend darüber, wie Widgets wie Fenster, Knöpfe, Textfelder, Dateidialoge etc. aussehen und funktionieren und verleihen damit der Desktop-Umgebung ihren Charakter. Nebst GNOME setzen z.B. auch Cinammon, Xfce, Budgie, Mate und Pantheon auf GTK. Wer also eine Linux-App oder eine plattformübergreifende App schreiben will, tut gut daran, sich mit GTK auseinanderzusetzen. Doch wie findet man den Einstieg in GTK und GNOME Technologie?

Dazu ist GNOME Workbench sehr zu empfehlen. Dieses Tool wurde bereits in einem früheren Artikel von Ralf kurz vorgestellt. Es handelt sich dabei um einen Werkzeugkasten, der alles bietet, um sich mit GNOME Technologie vertraut zu machen. GNOME ergänzt GTK mit der Libadwaita Bibliothek, welche weitere Widgets anbietet, dabei die GNOME Richtlinien für Benutzeroberflächen umsetzt und GNOME Apps ihr charakteristisches Aussehen verleiht. In Workbench gibt es mehr als hundert Demos für die Verwendung der einzelnen Elemente von GTK 4 und Libadwaita, wobei UI-Design durch Code, CSS Stylesheets und einen Live-Preview begleitet werden. Der Code ist dabei in Javascript, Python, Rust und Vala verfügbar, sodass sich auch Vergleiche zwischen den verschiedenen Programmiersprachen anstellen lassen. Auch für Fortgeschrittene ist Workbench wohl die beste Quelle, um ihr Wissen über einzelne Elemente von GTK 4 und Libadwaita aufzufrischen.

[Blockierte Grafik: https://gnulinux.ch/bl-content/uploads/pages/ce3da79fd02497a6181863cec9b31302/Workbench.png]

In der kürzlich veröffentlichten Version 47 gibt es in Workbench eine Funktion für automatische Vervollständigungs-Vorschläge und Anzeige dazu passender Dokumentation beim Tippen. In diesem Artikel soll diese Funktion an einem kleinen Beispiel illustriert werden. In einem Folgeartikel wird dann eine komplette App mit Hilfe von Python entwickelt. Wer Workbench noch nicht installiert hat, möge dies über Flathub nachholen.

Wir beginnen mit einem neuen (leeren) Projekt. Dies erhält man über das Hamburger-Menü oder mittels der Tastenkombination Ctrl+N. Was im UI-Panel geschrieben wird, ist in der Auszeichnungssprache Blueprint geschrieben. Im Vergleich zum herkömmlichen sperrigen XML-Format (siehe dazu ein Beispiel in Ralfs Artikel zum Ende von Glade) ist es viel kompakter und lesbarer. Während das Schreiben von XML nur besonders versierten Anwender:innen zu empfehlen war, ist das Blueprint-Format auch Anfänger:innen zugänglich.

Jede Blueprint UI-Definition beginnt mit der Zeile:

Code

using Gtk 4.0;

Beginnt man nur schon das erste Wort zu tippen, erhält man prompt die ganze Zeile vorgeschlagen.

[Blockierte Grafik: https://gnulinux.ch/bl-content/uploads/pages/ce3da79fd02497a6181863cec9b31302/using.png]

Sollen zudem Libadwaita Widgets eingesetzt werden, folgt noch die Zeile

Code

using Adw 1;

Danach definieren wir die Widget-Hierarchie. Als Haupt-Behälter können wir etwa ein Fenster, einen Dialog oder eine Status-Seite verwenden. Letzteres ist besonders geeignet für das Experimentieren, da damit eine Live-Vorschau möglich ist, wo jede Änderung an der UI-Definition direkt ersichtlich wird. Eine Status-Seite wird auch in den meisten Demos aus der Bibliothek verwendet. So schreiben wir also

Code

Adw.StatusPage {@@@WCF_PRE_LINEBREAK@@@@@@WCF_PRE_LINEBREAK@@@}

wobei der Inhalt noch zu füllen ist. Wenn wir den Vervollständigungs-Vorschlag nach dem Tippen der ersten Buchstaben dafür mittels Enter quittieren, sehen wir auch gleich welche Eigenschaften so eine Seite hat.

[Blockierte Grafik: https://gnulinux.ch/bl-content/uploads/pages/ce3da79fd02497a6181863cec9b31302/properties.png]

Diese Vorschläge lassen sich auch später noch mit Hilfe der Tastenkombination Ctrl+Space anzeigen. Wir setzen also mal einen Titel und eine Beschreibung:

Code

Adw.StatusPage {@@@WCF_PRE_LINEBREAK@@@    title: "Experiment";@@@WCF_PRE_LINEBREAK@@@    description: "Wir experimentieren mit Gnome-Technologie";@@@WCF_PRE_LINEBREAK@@@}

Auch hier hilft die Autovervollständigung, da etwa bei Quittierung der Eigenschaft "title" bereits der Doppelpunkt, die Gänsefüsschen und das Semikolon geschrieben werden, so dass nur noch der eigentliche Titel eingefügt werden muss. Hier die aktuelle Übersicht mit dem UI-Panel links und der Vorschau rechts.

[Blockierte Grafik: https://gnulinux.ch/bl-content/uploads/pages/ce3da79fd02497a6181863cec9b31302/AdwStatusPage.png]

Jetzt wollen wir die Status-Seite natürlich noch mit etwas Inhalt befüllen. Wie wäre es mit einer Auswahl der Lieblings-Desktopumgebung und einer Bewertung derer auf einer Skala von 0-10, sowie einem Knopf zum Absenden der Antwort? Wer die GTK-Widgets noch nicht kennt, kann die Demo-Bibliothek aufrufen und schauen, welche Elemente wir hier brauchen und wie sie in Blueprint definiert werden können. Dabei ist auch an das Layout zu denken, denn die Elemente liessen sich auf verschiedene Art auf der Seite anbringen.

Für die Auswahl verwenden wir ein DropDown, für die Skala einen SpinButton, für die Beschriftungen Labels, für den Knopf einen Button und das Ganze arrangieren wir mit Hilfe einer Box und eines Grid, so dass die Beschriftungen und Auswahlmöglichkeiten in einem Gitter angeordnet sind und diese Tabelle oberhalb des Knopfs erscheint.

Wir definieren zuerst mal die einzelnen Elemente und kümmern uns danach um die Anordnung. Zuerst die Labels:

Code

      Label {@@@WCF_PRE_LINEBREAK@@@        label: "Welches ist deine Lieblings-Desktopumgebung?";@@@WCF_PRE_LINEBREAK@@@      }@@@WCF_PRE_LINEBREAK@@@@@@WCF_PRE_LINEBREAK@@@      Label {@@@WCF_PRE_LINEBREAK@@@        label: "Wie bewertest du deine Lieblings-Desktopumgebung?";@@@WCF_PRE_LINEBREAK@@@      }

Dann das DropDown (vergleiche DropDown Demo):

Code

      DropDown {@@@WCF_PRE_LINEBREAK@@@        model: StringList {@@@WCF_PRE_LINEBREAK@@@          strings [@@@WCF_PRE_LINEBREAK@@@            "GNOME",@@@WCF_PRE_LINEBREAK@@@            "KDE",@@@WCF_PRE_LINEBREAK@@@            "Cinnamon",@@@WCF_PRE_LINEBREAK@@@            "Xfce",@@@WCF_PRE_LINEBREAK@@@            "Mate",@@@WCF_PRE_LINEBREAK@@@            "Budgie",@@@WCF_PRE_LINEBREAK@@@            "Pantheon",@@@WCF_PRE_LINEBREAK@@@            "Deepin"@@@WCF_PRE_LINEBREAK@@@          ]@@@WCF_PRE_LINEBREAK@@@        };@@@WCF_PRE_LINEBREAK@@@      }@@@WCF_PRE_LINEBREAK@@@

und der SpinButton (vergleiche SpinButton Demo):

Code

      SpinButton {@@@WCF_PRE_LINEBREAK@@@        numeric: true;@@@WCF_PRE_LINEBREAK@@@@@@WCF_PRE_LINEBREAK@@@        adjustment: Adjustment {@@@WCF_PRE_LINEBREAK@@@          lower: 0;@@@WCF_PRE_LINEBREAK@@@          upper: 10;@@@WCF_PRE_LINEBREAK@@@          step-increment: 1;@@@WCF_PRE_LINEBREAK@@@          value: 5;@@@WCF_PRE_LINEBREAK@@@        };@@@WCF_PRE_LINEBREAK@@@      }@@@WCF_PRE_LINEBREAK@@@

und zuletzt der Button:

Code

    Button {@@@WCF_PRE_LINEBREAK@@@      halign: center;@@@WCF_PRE_LINEBREAK@@@      label: "Senden!";@@@WCF_PRE_LINEBREAK@@@    }@@@WCF_PRE_LINEBREAK@@@

Damit wir diese Elemente überhaupt in der Vorschau sehen, packen wir das Ganze mal in eine vertikale Box, und zentrieren diese horizontal. Dazu fügen wir oberhalb des ersten Elements die Zeilen

Code

  Box {@@@WCF_PRE_LINEBREAK@@@    orientation: vertical;@@@WCF_PRE_LINEBREAK@@@    halign: center;@@@WCF_PRE_LINEBREAK@@@

hinzu und schliessen die geschweifte Klammer nach dem letzten der Elemente. Nun sieht es so aus:

[Blockierte Grafik: https://gnulinux.ch/bl-content/uploads/pages/ce3da79fd02497a6181863cec9b31302/verticallyplaced.png]

Jetzt packen wir die beiden Labels, das DropDown und den SpinButton noch in ein Gitter (Grid), in welchem links übereinander die Labels stehen und rechts die entsprechenden Auswahlmöglichkeiten. Dafür fügen wir oberhalb des ersten der vier Elemente eine Zeile

Code

    Grid {

ein und schliessen die geschweifte Klammer nach dem letzten der vier Elemente. Um die Positionen der vier Elemente zu definieren, fügen wir zu jedem der Elemente die layout-Eigenschaft mit passenden Werten für Zeile und Spalte ein, also z.B.

Code

        layout {@@@WCF_PRE_LINEBREAK@@@          column: 0;@@@WCF_PRE_LINEBREAK@@@          row: 1;@@@WCF_PRE_LINEBREAK@@@        }

für das zweite Label.

Da die einzelnen Elemente noch etwas sehr aufeinanderhocken, fügen wir noch etwas Abstände ein. Bei der Box:

Code

    spacing: 12;@@@WCF_PRE_LINEBREAK@@@

beim Grid:

Code

      row-spacing: 12;@@@WCF_PRE_LINEBREAK@@@      column-spacing: 12;@@@WCF_PRE_LINEBREAK@@@

Schon sieht das Ganze recht ordentlich aus:

[Blockierte Grafik: https://gnulinux.ch/bl-content/uploads/pages/ce3da79fd02497a6181863cec9b31302/2024-06-2717-21-19.png]

Hier noch die ganze UI-Definition:

Code

using Gtk 4.0;@@@WCF_PRE_LINEBREAK@@@using Adw 1;@@@WCF_PRE_LINEBREAK@@@@@@WCF_PRE_LINEBREAK@@@Adw.StatusPage {@@@WCF_PRE_LINEBREAK@@@  title: "Experiment";@@@WCF_PRE_LINEBREAK@@@  description: "Wir experimentieren mit Gnome Techonologie";@@@WCF_PRE_LINEBREAK@@@@@@WCF_PRE_LINEBREAK@@@  Box {@@@WCF_PRE_LINEBREAK@@@    orientation: vertical;@@@WCF_PRE_LINEBREAK@@@    halign: center;@@@WCF_PRE_LINEBREAK@@@    spacing: 12;@@@WCF_PRE_LINEBREAK@@@@@@WCF_PRE_LINEBREAK@@@    Grid {@@@WCF_PRE_LINEBREAK@@@      row-spacing: 12;@@@WCF_PRE_LINEBREAK@@@      column-spacing: 12;@@@WCF_PRE_LINEBREAK@@@@@@WCF_PRE_LINEBREAK@@@      Label {@@@WCF_PRE_LINEBREAK@@@        label: "Welches ist deine Lieblings-Desktopumgebung?";@@@WCF_PRE_LINEBREAK@@@        layout {@@@WCF_PRE_LINEBREAK@@@          column: 0;@@@WCF_PRE_LINEBREAK@@@          row: 0;@@@WCF_PRE_LINEBREAK@@@        }@@@WCF_PRE_LINEBREAK@@@      }@@@WCF_PRE_LINEBREAK@@@@@@WCF_PRE_LINEBREAK@@@      Label {@@@WCF_PRE_LINEBREAK@@@        label: "Wie bewertest du deine Lieblings-Desktopumgebung?";@@@WCF_PRE_LINEBREAK@@@        layout {@@@WCF_PRE_LINEBREAK@@@          column: 0;@@@WCF_PRE_LINEBREAK@@@          row: 1;@@@WCF_PRE_LINEBREAK@@@        }@@@WCF_PRE_LINEBREAK@@@      }@@@WCF_PRE_LINEBREAK@@@@@@WCF_PRE_LINEBREAK@@@      DropDown {@@@WCF_PRE_LINEBREAK@@@        layout {@@@WCF_PRE_LINEBREAK@@@          column: 1;@@@WCF_PRE_LINEBREAK@@@          row: 0;@@@WCF_PRE_LINEBREAK@@@        }@@@WCF_PRE_LINEBREAK@@@@@@WCF_PRE_LINEBREAK@@@        model: StringList {@@@WCF_PRE_LINEBREAK@@@          strings [@@@WCF_PRE_LINEBREAK@@@            "GNOME",@@@WCF_PRE_LINEBREAK@@@            "KDE",@@@WCF_PRE_LINEBREAK@@@            "Cinnamon",@@@WCF_PRE_LINEBREAK@@@            "Xfce",@@@WCF_PRE_LINEBREAK@@@            "Mate",@@@WCF_PRE_LINEBREAK@@@            "Budgie",@@@WCF_PRE_LINEBREAK@@@            "Pantheon",@@@WCF_PRE_LINEBREAK@@@            "Deepin"@@@WCF_PRE_LINEBREAK@@@          ]@@@WCF_PRE_LINEBREAK@@@        };@@@WCF_PRE_LINEBREAK@@@      }@@@WCF_PRE_LINEBREAK@@@@@@WCF_PRE_LINEBREAK@@@      SpinButton {@@@WCF_PRE_LINEBREAK@@@        numeric: true;@@@WCF_PRE_LINEBREAK@@@@@@WCF_PRE_LINEBREAK@@@        layout {@@@WCF_PRE_LINEBREAK@@@          column: 1;@@@WCF_PRE_LINEBREAK@@@          row: 1;@@@WCF_PRE_LINEBREAK@@@        }@@@WCF_PRE_LINEBREAK@@@@@@WCF_PRE_LINEBREAK@@@        adjustment: Adjustment {@@@WCF_PRE_LINEBREAK@@@          lower: 0;@@@WCF_PRE_LINEBREAK@@@          upper: 10;@@@WCF_PRE_LINEBREAK@@@          step-increment: 1;@@@WCF_PRE_LINEBREAK@@@          value: 5;@@@WCF_PRE_LINEBREAK@@@        };@@@WCF_PRE_LINEBREAK@@@      }@@@WCF_PRE_LINEBREAK@@@    }@@@WCF_PRE_LINEBREAK@@@@@@WCF_PRE_LINEBREAK@@@    Button {@@@WCF_PRE_LINEBREAK@@@      halign: center;@@@WCF_PRE_LINEBREAK@@@      label: "Senden!";@@@WCF_PRE_LINEBREAK@@@    }@@@WCF_PRE_LINEBREAK@@@  }@@@WCF_PRE_LINEBREAK@@@}@@@WCF_PRE_LINEBREAK@@@

Wir könnten das Ganze noch mit etwas Code bereichern, der ausgeführt wird, wenn der Button gedrückt wird. Aber das lasse ich aus Platzgründen mal weg. In einem Folgeartikel werde ich zeigen, wie sich eine ganze App in Workbench schreiben lässt. Dort steht dann der Code im Zentrum.

Fazit:

Workbench und Blueprint sind eine Power-Kombination, mit der sich neuerdings ziemlich einfach GTK 4 / Libadwaita Benutzeroberflächen erstellen lassen. Vorbei sind die Zeiten, in welchen GTK 4 und Libadwaita nur einem Kreise von Eingeweihten zugänglich waren. Die Vervollständigungs-Vorschläge und dazu passend angezeigte Dokumention helfen sowohl Anfängern als auch Fortgeschrittenen und ersparen vielfach den Gebrauch der Suchmaschine.

Quellen:

• https://flathub.org/apps/re.sonny.Workbench
• https://blog.sonny.re/workbench-47
• https://jwestman.pages.gitlab.gnome.org/blueprint-compiler/

---

GNU/Linux.ch ist ein Community-Projekt. Bei uns kannst du nicht nur mitlesen, sondern auch selbst aktiv werden. Wir freuen uns, wenn du mit uns über die Artikel in unseren Chat-Gruppen oder im Fediverse diskutierst. Auch du selbst kannst Autor werden. Reiche uns deinen Artikelvorschlag über das Formular auf unserer Webseite ein.

Alles anzeigen

Quelle: https://gnulinux.ch/gnome-workbench-47-ein-beispiel