# 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--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--.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](../README.md)). 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 ```bash 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.