Packer für Widget- und Tool-Pakete

Pakete und Zusatztools werden zentral auf visualstudio.ugso-software.de angeboten. Diese Open-Source-Seite enthält Beschreibung und Anleitung; der Download erfolgt über den Paketkatalog.

Der Packer erstellt aus einem Quellordner ein Widget-Paket (.wg) oder Tool-Paket (.tp) für HA Grafik Visual Studio. Beide Dateien sind ZIP-Archive mit eigener Endung. Vor dem Export prüft der Packer das Manifest, die Paketstruktur, referenzierte SVG-/PNG-Bilder und die Grenzen der Widget-Paket-Schnittstelle beziehungsweise Tool-Paket-Schnittstelle. Paketdateien enthalten in der aktuellen Schnittstelle 0.1 keinen ausführbaren Code.

Paket erstellen

1. Lege manifest.json im Wurzelverzeichnis eines Quellordners ab. Referenzierte Bilder gehören unter icons/. Die beiden Schnittstellenseiten zeigen die Felder und Beispiele.
2. Wähle im Packer Widget-Paket oder Tool-Paket, dann den Quellordner und einen vorhandenen Exportordner.
3. Prüfe die Ergebnisliste sowie Paket-ID, Version, Lizenz und Zielname. Exportieren wird erst bei gültigem Paket und freiem Zielnamen aktiv. Der Packer überschreibt keine vorhandene Datei.
4. Installiere die erzeugte .wg- oder .tp-Datei im Studio unter Einstellungen → Widget-Pakete oder Einstellungen → Tools. Die bisherigen Endungen .wg.zip und .tp.zip bleiben verwendbar.

Der Packer prüft mit denselben Regeln wie der gebündelte Studio-Importer. Packer 0.3.0 unterstützt bis zu 64 Widgets pro Paket; ein Tool-Paket enthält in Schnittstelle 0.1 genau ein Tool. Das Studio prüft jedes importierte Paket zusätzlich selbst.

GitHub und direkte Registrierung

Ab Testversion 0.3.1 zeigt der Packer ein bereits gespeichertes Paket mit identischem Dateiinhalt grün als Datei gespeichert an, auch nach einem Neustart. Ein erneuter Export bleibt deaktiviert. Bei abweichendem Inhalt schützt die Prüfung weiterhin vor dem Überschreiben. Der breite Button GitHub & Katalog … befindet sich direkt unter der Prüfliste.

Seit Packer 0.3.0 öffnet GitHub & Katalog … ein exportiertes .wg- oder .tp-Paket zur Prüfung und Veröffentlichung. Die unten angebotene Testversion 0.3.1 enthält diese Erweiterung und die korrigierte Anzeige gespeicherter Dateien.

1. Installiere die GitHub CLI und melde dich im Terminal mit gh auth login an. Trage dein öffentliches Repository ein und wähle Releases laden.
2. Wähle den Release-Tag und bestätige Paket auf GitHub veröffentlichen. Für einen neuen Release aktiviere Release für vorhandenen Git-Tag erstellen; der Tag muss bereits auf GitHub vorhanden sein. Vorhandene Dateien werden nicht überschrieben.
3. Der Download-Link wird übernommen. Alternativ kannst du einen bereits veröffentlichten HTTPS-Link zur festen .wg- oder .tp-Version direkt eingeben und den GitHub-Schritt überspringen.
4. Ergänze Lizenzlink, Beschreibung, interne Kontaktadresse und benötigte Studio-Mindestversion. Neue Funktionen werden mit Nein / Ja / Unsicher angegeben. Bei Ja oder Unsicher ist eine Beschreibung erforderlich; die Mindestversion darf noch unbekannt sein.
5. Lies die Registrierungshinweise, bestätige Verarbeitung und Verteilungsrechte und wähle Im Katalog registrieren. Vor dem Senden zeigt der Packer Empfänger und Angaben an. Das Originalpaket wird zur automatischen Analyse mitgeschickt.
6. Kopiere den privaten Verwaltungslink nach erfolgreicher Einreichung. Das Paket erscheint nach manueller Prüfung und Freigabe im Katalog. Bei unklarer Netzwerkantwort zuerst prüfen, ob die Version gespeichert wurde; der Packer wiederholt die Einreichung nicht automatisch.

Die Kontaktadresse geht intern an den Katalog und gegebenenfalls sein Prüfpostfach. Name, E-Mail und Webseite werden nicht öffentlich angezeigt. Der Packer speichert nur Repository und Lizenzlink als Komforteinstellung, keine Kontaktadresse, GitHub-Tokens, Einwilligungen oder Verwaltungslinks. Netzwerkaktionen laufen im Hintergrund. Widget-Quellordner können zusätzlich LICENSE.txt und README.md enthalten.

Programm und Dateiendungen

Die Qt-Oberfläche läuft unter Windows und Linux. Der Button Endungen registrieren zeigt zuerst eine Vorschau und richtet nach Bestätigung eigene Icons und „Öffnen mit“-Einträge für .wg und .tp beim aktuellen Benutzer ein. Eine bestehende Standard-App wird nicht geändert. Der Packer kann ein vorhandenes Paket zur Prüfung öffnen, ohne es zu installieren. Nach dem Verschieben des Programms muss die Dateityp-Registrierung erneut ausgeführt werden.

Version 0.3.1 ist als signierter Test-Release für Windows und Linux im Paketkatalog erhältlich:

System	Download	SHA-256
Windows x86_64	ZIP herunterladen	7047e6ee5bb2327cf80432d2c37e0f82516284c22c0d4910ff3d4d64950efd8a
Linux x86_64	TAR.GZ herunterladen	e094331c7281957764dee38a8a117d932a2589581117daf68f1e146b71fd9a19

Entpacke das Archiv vollständig und starte HA-Grafik-Packer.exe beziehungsweise HA-Grafik-Packer. Der Ordner _internal muss daneben bleiben; er enthält auch die separat austauschbaren Qt-Bibliotheken. Beide Plattform-Builds wurden mit Tests und einem Selbsttest nach dem Entpacken geprüft. Linux benötigt Qt-Systembibliotheken für EGL/OpenGL. Lizenztexte und Hinweise liegen im Archiv.

Download prüfen

Lade für Version 0.3.1 SHA256SUMS-0.3.1 und SHA256SUMS-0.3.1.sig herunter. Die Vertrauensdatei für OpenSSH und der öffentliche Release-Schlüssel werden getrennt vom Release bereitgestellt. Der Ed25519-Fingerabdruck ist SHA256:W3iUvKedcI4FWS1kMoBrLlrAF2GbsB4sELphG0uITLE. Die früheren Prüfsummendateien ohne Versionsnummer gehören zu 0.2.0.

Prüfe zuerst die Signatur. Unter Linux im Downloadordner:

ssh-keygen -Y verify -f packer-allowed-signers -I packer-release -n ha-grafik-visual-studio-packer-release -s SHA256SUMS-0.3.1.sig < SHA256SUMS-0.3.1
sha256sum -c SHA256SUMS-0.3.1

Unter Windows funktionieren dieselben Signaturparameter in cmd.exe mit der gezeigten Eingabeumleitung. Vergleiche danach certutil -hashfile DATEINAME SHA256 mit dem Wert in SHA256SUMS-0.3.1. Lade Schlüssel und Vertrauensdatei vor dem Prüfen von den oben verlinkten Quellen. Der Packer-Quellcode bleibt im privaten Entwicklungs-Repository.