Skip to content

About

Basic Software Installer – Patch-My-PC-artiges Silent-Install-Tool fuer AS Computertechnik (.NET 4.8 WinForms)

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

Basic Software Installer

Ein Windows-Desktop-Tool (.NET Framework 4.8, WinForms) für AS Computertechnik, das nach einer Windows-Neuinstallation die gängige Grundausstattung an Software (Browser, PDF-Reader, Archiv-Tool, Virenschutz, ...) per Klick silent installiert – ähnlich dem Grundprinzip von „Patch My PC", aber als eigenes, schlankes Tool mit frei editierbarem Katalog statt eines gepflegten Fremd-Produkts.

Features

  • Ein Katalog, viele Programme – catalog/apps.json beschreibt deklarativ, was installierbar ist: Download-URL, Silent-Switches, optionaler Pfad-Override, optionale Sprachvarianten, optionale Installationsoptionen (Checkboxen) und optionale Lizenzierung. Neue Programme ergänzen heißt: JSON bearbeiten, kein Code ändern (siehe „Katalog erweitern" unten).
  • Versionserkennung – was laut Windows-Uninstall-Registry bereits installiert ist, wird beim Start automatisch geprüft, ebenso die online verfügbare Version (bei Firefox/Thunderbird/Zoom – nur dort lässt sie sich aus dem Download-Link ermitteln, sonst „–"), zusätzlich jederzeit per „Status aktualisieren". Erkennt die Prüfung ein Update, wählt sich die betroffene App automatisch an – „Installieren" reicht dann direkt. Schon aktuelle oder noch nicht geprüfte Programme werden beim Installieren übersprungen, ein bekanntes Update dagegen immer ausgeführt (die Hersteller-Silent-Installer sind dafür ausgelegt, über eine bestehende Installation zu laufen).
  • Profile – die aktuelle Auswahl (welche Apps, welcher Pfad, welche Optionen, welche Sprache) lässt sich unter einem Namen speichern und später mit einem Klick wieder laden (z. B. „Kundenstandard" vs. „Technikerstandard"). Liegt unter %APPDATA%\BasicInstaller\profiles.json. Ein Profil namens „Standard" (Groß-/Kleinschreibung egal) lädt sich beim Programmstart automatisch.
  • Sprache ist global, nicht pro Programm – eine Auswahl (Deutsch/Englisch) oben im Fenster gilt für alle Apps, die im Katalog überhaupt eine Sprachvariante anbieten.
  • Nur herunterladen – lädt die gewählten Installer in den lokalen Cache, ohne zu installieren. Für Technikereinsätze mit unsicherem Internet beim Kunden: vorher auf schnellem Netz vorladen, Installation läuft dann auch offline.
  • Auto-Update der App selbst – prüft gegen die GitHub-Releases-API dieses Repos auf eine neuere Version und installiert sie bei Bestätigung selbst (Details unten).
  • Persistentes Protokoll – jeder Lauf schreibt zusätzlich zur Textbox im Fenster eine Datei unter %APPDATA%\BasicInstaller\logs\ (Audit-Spur: was wurde wann auf diesem Rechner installiert).
  • Admin-Pflicht – die exe fordert per Manifest automatisch Administratorrechte an (UAC-Prompt beim Start), weil Installationen in %ProgramFiles% das ohnehin erfordern.

Build

Voraussetzungen: .NET SDK mit installiertem .NET Framework 4.8 Developer/Targeting Pack (auf GitHub-Actions-Runnern windows-latest bereits vorhanden). Optional für einen klassischen Setup.exe: Inno Setup 6.

build.bat

Baut die Release-exe (src\BasicInstaller\bin\Release\net48\BasicInstaller.exe) und, falls Inno Setup gefunden wird, zusätzlich installer\Output\BasicInstaller-Setup.exe. Ohne Inno Setup wird dieser zweite Schritt übersprungen (Hinweis statt Fehler) – für reine Entwicklung nicht nötig.

Reine Entwicklung/Debuggen direkt über Visual Studio (BasicInstaller.sln) oder:

dotnet build src\BasicInstaller\BasicInstaller.csproj -c Debug

Keine NuGet-Pakete. Alles verwendete (WinForms, JavaScriptSerializer, HttpClient, System.IO.Compression, Windows-Registry-Zugriff) ist Teil von .NET Framework 4.8 selbst – ein dotnet build braucht deshalb nie einen Package-Restore-Schritt oder Netzzugriff.

Release & Auto-Update

Ein Push eines Tags vX.Y.Z löst .github/workflows/release.yml aus: baut die Release-exe, baut (falls Inno Setup auf dem Runner vorhanden ist – bei windows-latest der Fall) das Setup, und veröffentlicht beides als GitHub Release.

Services/AutoUpdateService.cs prüft beim Programmstart und per Button gegen api.github.com/repos/<owner>/<repo>/releases/latest, vergleicht die Version und bietet bei einer neueren Version an, das ZIP-Asset herunterzuladen und selbst einzuspielen (Batch-Skript ersetzt die Dateien, nachdem sich die laufende exe beendet hat – eine exe kann sich nicht selbst überschreiben, solange sie läuft).

Das setzt ein öffentliches Repo voraus – die unauthentifizierte Releases-API liefert bei privaten Repos 404. Es wird bewusst kein Zugriffstoken im Client eingebettet; ein privates Repo heißt also schlicht: kein Auto-Update, keine halbe Lösung mit eingebettetem Secret.

Code-Signing

Unsigniert zeigt Windows SmartScreen bei anderen Nutzern „Unbekannter Herausgeber". Der Workflow hat dafür bereits einen optionalen Signing-Schritt (sowohl für die exe als auch für Setup.exe) über Azure Artifact Signing (früher „Azure Trusted Signing") – ohne eingerichtete Secrets überspringt er sich einfach, nichts bricht.

Wichtig, falls du nach einem klassischen .pfx-Zertifikat suchst: Seit Juni 2023 verlangt das CA/Browser Forum für jedes neu ausgestellte Code-Signing-Zertifikat (auch die günstigeren OV-Zertifikate, nicht nur EV) einen Hardware-Token oder eine Cloud-HSM – ein exportierbares .pfx mit Passwort gibt es bei seriösen CAs faktisch nicht mehr. Deshalb ist Azure Artifact Signing (kein physischer Token nötig, direkt aus GitHub Actions ansprechbar, ca. 10 $/Monat für 5.000 Signaturen, verfügbar in DE/EU) hier die praktikabelste Variante für eine kleine Firma – nicht nur eine Ausweich- lösung.

Einrichtung bei Microsoft (einmalig):

  1. Azure-Account + Pay-as-you-go-Subscription.
  2. „Artifact Signing Account" anlegen (Region wählen, z. B. weu für Westeuropa).
  3. Identität verifizieren lassen: „Public"-Identität mit Steuernummer/Handelsregister einreichen, Dokumenten-Check durch Microsofts Validierungsdienst (au10tix) durchlaufen – das dauert.
  4. „Certificate Profile" vom Typ Public Trust im Account anlegen.
  5. App-Registrierung in Azure AD anlegen (liefert Client-ID + Tenant-ID), Client-Secret generieren.
  6. Im Access Control (IAM) des Artifact Signing Accounts: der eigenen Nutzer-Identität die Rolle „Artifact Signing Identity Verifier" zuweisen, der App-Registrierung die Rolle „Artifact Signing Certificate Profile Signer".

Danach im GitHub-Repo (Settings → Secrets and variables → Actions) sechs Secrets anlegen:

Secret Wert
AZURE_TENANT_ID Tenant-ID der App-Registrierung
AZURE_CLIENT_ID Client-ID der App-Registrierung
AZURE_CLIENT_SECRET generiertes Client-Secret
AZURE_ENDPOINT Regions-Endpunkt, z. B. https://weu.codesigning.azure.net/
AZURE_CODE_SIGNING_NAME Name des Artifact Signing Accounts
AZURE_CERT_PROFILE_NAME Name des Certificate Profile

Sobald diese sechs Secrets existieren, signiert der nächste Release-Lauf automatisch – kein weiterer Code-/Workflow-Eingriff nötig.

Katalog erweitern

catalog/apps.json ist eine Liste von Objekten mit diesen Feldern:

Feld Bedeutung
id eindeutiger Schlüssel, u. a. für Cache-Dateinamen und Registry-Erkennung
name, category, homepage Anzeige in der Tabelle
installer_url Download-Link; null wenn keine stabile URL existiert (siehe notes)
version_url, version_regex, fallback_version optionale automatische Versionsermittlung, damit versionierte Download-Links nicht veralten: installer_url (und languages[].installer_url) darf {version} (z. B. 26.04) und {version_nodots} (z. B. 2604) enthalten. Beim Start liest die App version_url (Seite, Verzeichnisliste oder Redirect-Ziel – die Regex wird zuerst gegen die finale URL geprüft, z. B. github.com/<owner>/<repo>/releases/latest → …/tag/26.04, ohne API-Rate-Limit) und nimmt Gruppe 1 von version_regex; bei mehreren Treffern gewinnt die höchste Version. fallback_version gilt nur für den Download, falls die Ermittlung scheitert. Die ermittelte Version erscheint auch in der Spalte „Verfügbar“. Beispiele: vlc, 7zip, notepadpp, libreoffice, winrar
installer_type "exe" (Standard) | "msi" (läuft über einen msiexec-Wrapper) | "portable" (kein Install – die Datei wird unverändert kopiert, Ziel = default_install_path/Installationspfad-Spalte, ohne beides Downloads; optional shortcut_name legt danach eine Desktop-Verknüpfung an – z. B. O&O ShutUp10++, TeamViewer QuickSupport)
silent_args Array von Kommandozeilen-Switches für den Silent-Install (bei "portable" ungenutzt)
shortcut_name Nur bei "portable": Name (ohne .lnk) einer Desktop-Verknüpfung, die nach dem Kopieren automatisch angelegt wird. null = keine Verknüpfung
default_install_path, path_arg_template Pfad-Override; {path} wird ersetzt. null = vom Installer nicht unterstützt
license_type "cli_arg" (Schlüssel als zusätzlicher Switch) | "key_file" (Lizenzdatei wird nach der Installation ins Zielverzeichnis geschrieben) | null
license_key_arg_template nur bei cli_arg, z. B. "--license-key={key}"
license_file_name nur bei key_file, z. B. "rarreg.key"
options Array von Installationsoptionen, optional. type fehlt/"bool": Checkbox {key, label, default_value}. type: "choice": Auswahl {key, label, type:"choice", choice_values, choice_labels, default_choice} (z. B. Architektur x86/x64 bei Office 365). Jede Option kann zusätzlich cli_arg_template tragen – hängt den Wert direkt als Silent-Switch an (z. B. ESETs --enable-pua={pua}), unabhängig vom options_ini_template-Datei-Mechanismus, auch kombinierbar
options_ini_template, options_ini_filename wenn gesetzt: INI-Inhalt (mit {key}-Platzhaltern, werden durch 1/0 ersetzt) wird vor dem Install neben den Installer gelegt
detect_product_codes, blocked_name_contains Sicherheitsnetz gegen Verwechslung von Produkten mit gleichem Anzeigenamen. detect_product_codes erkennt ein Produkt exakt über den Schlüsselnamen (Produktcode) des Uninstall-Eintrags statt über den Anzeigenamen (ein Eintrag darf mit * enden = Präfix). blocked_name_contains: findet sich ein anderer Eintrag (anderer Produktcode) mit diesem Text im Namen, gilt die App als blockiert – sie wird nicht installiert/überinstalliert, die Zeile ist orange („anderes Produkt“) und nicht anhakbar. Beispiel: Adobe Acrobat Reader und Pro heißen beide „Adobe Acrobat (64-bit)“ und unterscheiden sich nur im Produktcode (…-FF00-… Reader, …-FFFF-… Pro).
process_names Prozessnamen (ohne .exe) der laufenden Anwendung. Läuft sie beim Update, fragt Basic Installer vor dem Installieren: schließen und aktualisieren / überspringen / Lauf abbrechen. Schließen erst freundlich (CloseMainWindow), nach 10 s hart.
installed_version_regex Regex (Gruppe 1) auf die installierte DisplayVersion, um den mit der „Verfügbar“-Version vergleichbaren Teil zu isolieren (Brave: 155.1.97.56 → 1.97.56).
detect_display_name_contains Teilstring, der gegen DisplayName in der Windows-Uninstall-Registry gematcht wird, um die installierte Version zu finden
default_language, languages optionale Sprachvarianten: languages ist ein Dictionary {sprachcode: {installer_url, extra_args}}, das installer_url/silent_args der App überschreibt bzw. ergänzt
notes Pflichtfeld für Unsicherheiten. Wenn eine URL/ein Switch/ein INI-Format nicht zu 100 % sicher ist: hier ehrlich vermerken, was vor Produktiveinsatz zu prüfen ist, statt einen selbstbewusst klingenden, aber möglicherweise falschen Wert einzutragen. Siehe bestehende Einträge (z. B. IrfanView, Acrobat Reader, WinRAR) als Vorbild.

Ein optionaler Benutzerkatalog unter %APPDATA%\BasicInstaller\user_apps.json (gleiches Format) wird beim Start zusätzlich geladen und über id mit dem mitgelieferten Katalog gemischt (gleiche id überschreibt, neue id wird ergänzt) – eigene Einträge überleben so ein Update der App.

Sicherheit / Secrets

Lizenzschlüssel und Lizenzdateiinhalte werden nie in config.json, profiles.json oder sonst einer Datei gespeichert, die versehentlich geteilt/committet werden könnte. Optional lassen sie sich über den Windows Credential Manager merken (Services/WindowsCredentialStore.cs, reines P/Invoke ohne NuGet) – pro Rechner, nie im Repo. Das Repo ist öffentlich (für Auto-Update nötig) – es landen dort ausschließlich Code und Katalog-Metadaten, niemals Zugangsdaten.

UX-Prinzip

Die Haupttabelle zeigt nur, was zur Auswahl nötig ist (Checkbox, erkannte Version, Pfad). Alles Zusätzliche – Installationsoptionen, Lizenzschlüssel/-datei, Kontaktdaten/Impressum – sitzt hinter kleinen Buttons/Popups (⚙-Spalte öffnet die Optionen/Lizenz eines einzelnen Programms, „ℹ Über / Kontakt"-Link), damit das Hauptfenster aufgeräumt bleibt. Sprache ist bewusst ein globaler Dropdown oben im Fenster statt einer Spalte pro Zeile.

Lizenz

Quellcode öffentlich einsehbar auf GitHub (für Auto-Update erforderlich), aber nicht unter einer Open-Source-Lizenz freigegeben – alle Rechte bei AS Computertechnik, siehe LICENSE.

About

Basic Software Installer – Patch-My-PC-artiges Silent-Install-Tool fuer AS Computertechnik (.NET 4.8 WinForms)

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages