waffensachkunde

Waffensachkunde – Lernsoftware für die Sachkundeprüfung nach § 7 WaffG. Barrierefrei, offline, EUPL-1.2.

/ docs installation.md

3,9 KB Rohdatei

Installation und Weitergabe

Die Anwendung läuft auf Windows 10/11. Sie braucht keine Internetverbindung, kein Konto und keine Installation von Zusatzsoftware.

Eine Fassung für macOS gibt es noch nicht. Der Bau ist vorbereitet, aber kein Paket ist je entstanden und nichts an dieser Software lief je auf einem Mac. Die Anleitung dafür steht weiter unten — sie beschreibt, wie es gehen wird, nicht, was heute geht.

Windows

  1. Die Datei Waffensachkunde Lernsoftware-<version>-Setup-x64.exe starten.
  2. Windows zeigt eine Warnung — dazu unten mehr. Über „Weitere Informationen" → „Trotzdem ausführen" geht es weiter.
  3. Der Installationsassistent führt auf Deutsch durch den Rest. Die Anwendung wird für den angemeldeten Benutzer installiert, Administratorrechte sind nicht nötig.

macOS — vorgesehen, noch nicht verfügbar

Diese Schritte sind noch von niemandem gegangen worden. Sie stehen hier, damit die Anleitung fertig ist, wenn das Paket es ist — nicht, weil es heute eines gäbe.

  1. Die Datei Waffensachkunde Lernsoftware-<version>-<arch>.dmg öffnen und die Anwendung in den Programme-Ordner ziehen. arm64 ist für Apple-Silicon-Macs, x64 für ältere Intel-Macs.
  2. Beim ersten Start blockiert macOS die Anwendung. Statt sie doppelt zu klicken: Rechtsklick auf das Programmsymbol → „Öffnen" → im Dialog erneut „Öffnen". Alternativ unter Systemeinstellungen → Datenschutz & Sicherheit auf „Dennoch öffnen".
  3. Ab dem zweiten Start entfällt das.

Warum warnt das Betriebssystem?

Weil die Anwendung nicht signiert ist. Eine Signatur ist eine Art digitaler Ausweis, den Microsoft und Apple gegen Gebühr ausstellen — bei Microsoft mehrere hundert Euro im Jahr, dazu ein Hardware-Sicherheitsmodul. Für ein Programm, das verschenkt wird, steht das in keinem Verhältnis.

Ohne Signatur kann das Betriebssystem nicht bestätigen, wer die Anwendung gebaut hat. Es sagt damit nichts darüber aus, ob sie schädlich ist — nur, dass es den Herausgeber nicht kennt.

Wer das nicht einfach glauben möchte, muss es auch nicht: Der vollständige Quelltext liegt offen, und die Anwendung lässt sich selbst bauen (siehe README). Ein Prüfsummenabgleich der weitergegebenen Datei ist ebenfalls möglich.

Was die Anwendung tut — und was nicht

  • Keine Internetverbindung. Die Anwendung öffnet von sich aus keine Verbindung. Es gibt keine Aktualisierungsprüfung, keine Nutzungsstatistik, keine Fehlerberichte an Dritte.
  • Kein Konto, keine Anmeldung.
  • Alle Daten bleiben auf dem Gerät. Der Lernstand liegt in einer Datei im Benutzerprofil und verlässt den Rechner nicht.

Weitergabe

Die Software steht unter der European Union Public Licence 1.2. Sie darf frei weitergegeben werden — auch die Installationsdatei, unverändert oder verändert. Bei einer veränderten Fassung muss deren Quelltext unter derselben Lizenz verfügbar sein.

Der amtliche Fragenkatalog ist davon nicht erfasst: Er ist ein Werk des Bundesverwaltungsamtes und wird unverändert mit Quellenangabe wiedergegeben. Einzelheiten stehen in der Anwendung unter „Über diese Software".

Deinstallation

Windows: Einstellungen → Apps → „Waffensachkunde Lernsoftware" → Deinstallieren.

macOS: Die Anwendung aus dem Programme-Ordner in den Papierkorb ziehen.

Der Lernstand bleibt dabei erhalten, damit eine spätere Neuinstallation ihn weiterverwenden kann. Wer ihn ebenfalls entfernen möchte, löscht das Verzeichnis Waffensachkunde Lernsoftware unter:

  • Windows: %APPDATA%
  • macOS: ~/Library/Application Support

Selbst bauen

cd app
npm install
npm run build
npm run dist:win     # bzw. dist:mac auf einem Mac

Das Ergebnis liegt danach in app/release/. Der Fragenkatalog wird dabei aus content/katalog/ mitgepackt; er lässt sich mit python data-pipeline/parse_catalog.py aus dem amtlichen PDF neu erzeugen.