# 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](../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.
