# Nativer macOS-Weg (createinstallmedia / asr)

Alternative zum Docker/Linux-Tool im Projekt-Root — **nur nutzbar, wenn
gerade ein echter Mac zur Verfuegung steht**. Zwei Quellen fuer den
Installer-Payload stehen zur Auswahl, direkt im Script:

1. **Von Apple herunterladen** (macOS 10.15 Catalina oder neuer als Host
   noetig) — der offiziell von Apple unterstuetzte Weg ueber
   `softwareupdate --fetch-full-installer`.
2. **Aus der lokalen Downloads-Bibliothek des Docker-Tools** — wenn das
   ganze Projekt inkl. `downloads/`-Ordner z.B. auf eine externe Platte
   kopiert wurde, braucht dieser Weg **kein Internet und keinen erneuten
   Download**.

## Warum ein eigenes Script, warum nicht einfach dd wie das Docker-Tool?

Kurz: **`createinstallmedia` (der offiziell unterstuetzte macOS-Weg)
braucht die vollstaendige, fertig gepackte "Install macOS X.app"** —
nicht die rohen Katalog-Dateien, die das Docker-Tool per `dd` schreibt.
Deshalb dieser separate, macOS-native Pfad.

## Wie die Bibliotheks-Wiederverwendung funktioniert

Die `downloads/library/`-Bibliothek des Docker-Tools enthaelt pro
macOS-Version genau eine von zwei Rohdateien (siehe `meta.json` im
jeweiligen Unterordner, Feld `mode`):

- **`InstallAssistant.pkg`** (Big Sur und neuer, `mode: "recovery"`):
  Apples eigenes `installer -pkg ... -target /` entpackt daraus die
  komplette Install-App (inkl. `createinstallmedia`-Binary) nach
  `/Applications` — bestaetigt per Apple-Community-Thread, dass ein
  `.pkg`-Installer aus dem Software-Update-Katalog 1:1 dasselbe Paket
  ist wie der App-Store-Download. Danach laeuft der normale
  `createinstallmedia`-Weg wie bei der Apple-Quelle.
- **`BaseSystem.dmg`/`InstallESD.dmg`** (bis Catalina, `mode:
  "legacy_dmg"`): das ist bereits ein fertiges, bootfaehiges Volume.
  `createinstallmedia` braucht es gar nicht erst — Apples eigenes
  Bordmittel `asr restore --source ... --target ... --erase --noprompt`
  schreibt es direkt und sauber auf den Stick (etablierte Technik, siehe
  Quellen unten). Kein App-Download, kein `createinstallmedia` noetig.

In beiden Faellen: **kein zweiter Download**, die Datei aus der Bibliothek
wird 1:1 weiterverwendet.

## Zukunftssicherheit

Bei der Apple-Quelle fragt `softwareupdate --list-full-installers`
Apples eigene Server live ab — genau wie der Katalog-Check im Docker-Tool,
nur eben Apples eigenes Tool statt eigenem Parser. Neue macOS-Versionen
tauchen automatisch in der Liste auf.

Bei der Bibliotheks-Quelle haengt die Auswahl logischerweise davon ab, was
das Docker-Tool zuletzt heruntergeladen hat — dafuer aber komplett ohne
Internetzugriff nutzbar.

## Nutzung

```bash
cd native-macos
chmod +x create-stick.sh   # falls das Ausfuehr-Bit beim Kopieren verloren ging
./create-stick.sh
```

Fuehrt durch vier Schritte (reines Terminal-Menue, keine externen
Abhaengigkeiten — nur `softwareupdate`, `diskutil`, `PlistBuddy`,
`installer`, `asr`, `createinstallmedia`, alles Bordmittel):

1. **Quelle + Version waehlen** — Apple-Server oder lokale Bibliothek
   (Pfad wird abgefragt, Default rät `../downloads/library` relativ zum
   Script — passt, wenn das komplette Projekt kopiert wurde).
2. **Installer-Payload besorgen** — je nach Quelle/Modus: Download via
   `softwareupdate`, Entpacken via `installer -pkg`, oder (legacy_dmg
   aus der Bibliothek) gar nichts, das Image liegt schon bereit.
3. **USB-Stick auswaehlen** — Liste nur externer, physischer Laufwerke
   (`diskutil list -plist external physical`), danach Sicherheitsabfrage:
   exakter Geraetepfad muss nochmal eingetippt werden, bevor irgendwas
   geloescht wird.
4. **Schreiben** — je nach Modus entweder `createinstallmedia
   --nointeraction` (Apple-Quelle und Bibliothek/Big-Sur+) oder
   `diskutil eraseDisk` + `asr restore --erase` (Bibliothek,
   bis Catalina). Beides mit `sudo`, live-Ausgabe im Terminal.

## Grenzen

- Nur macOS 10.15+ (Catalina oder neuer) als **Host**, auf dem das Script
  laeuft — das Zielsystem, auf das installiert wird, kann trotzdem
  jede von Apple unterstuetzte Version sein. Diese Einschraenkung gilt nur
  fuer die Apple-Download-Quelle (`softwareupdate --fetch-full-installer`);
  `installer`/`asr` funktionieren grundsaetzlich auch auf aelteren Hosts.
- Kein Multiboot-Support (anders als das Docker-Tool) —
  jeder Lauf erstellt immer einen kompletten Single-Version-Stick.
- **Ungetestet auf echtem Mac.** Die Auswahl-/Verzweigungslogik (Quelle,
  Modus-Erkennung ueber `meta.json`) wurde unter Linux mit einer
  simulierten Bibliothek end-to-end durchgespielt (`bash -n` sauber,
  beide Zweige laufen bis zum jeweils ersten macOS-only-Befehl korrekt
  durch). Der eigentliche `installer`/`asr`/`createinstallmedia`-Lauf
  selbst ist nur gegen offizielle Apple-Doku/Community-Quellen verifiziert,
  nicht live auf einem Mac getestet.

## Quellen (fuer den asr-Weg, live nachgeschlagen)

- Apple Developer/Community — `asr restore` ist das Bordmittel fuer
  Block-Level-Restores von Disk Images, seit jeher Teil von macOS.
- Cody Krieger — "Creating bootable macOS Sierra installation media on
  macOS Catalina": beschreibt exakt den `diskutil eraseDisk` +
  `asr restore --erase`-Ablauf fuer aeltere macOS-Installer.