Referenz-Muster: Offline-Installer¶

Zielgruppe: Rezept-Autoren. Beispiel-Rezepte: photoshop, photoshop-m0nkrus, premiere, master-pdf-editor · Vorlage: recipes/_template-installer/

Wann dieses Muster?¶

Windows liefert einen Offline-Installer (Ordner mit Set-up.exe / Setup.exe + Pakete, oder eine einzelne Setup-.exe). Rezeptor legt Prefix an, startet den Installer unter Proton-GE, speichert App-Daten unter dem Ziel (Datenordner).

GUI	Bedeutung
Quelle	Installer-Ordner oder `.exe` (BYOS — nicht im Repo)
Ziel	Freier Installationsort (`RECIPE_DATA_ROOT`) — hier liegen danach Programm/Spiel inkl. Prefix (`{Ziel}/prefix/…`). Kein Zwangspfad; nur ein früher selbst gewählter Ort wird wieder vorgeschlagen.

Typische `recipe.yml`-Ecken¶

install_type / source_kind: Installer oder Ordner mit Setup
install_steps: oft module: recipe_<id>::install statt langer Schrittliste
version_detect: z. B. json_key / pe_field gegen die Offline-Quelle
source_hints: Pack-Titel / Keywords zum Suchen (keine URLs); abweichende Packs → eigenes Rezept
uninstall → purge_recipe_data (Prefix + Shortcuts; kein Mitbringen des Installers löschen)

Pack-Ordner (m0nkrus-Stil)¶

Zwei Photoshop-Rezepte (ein Pack = ein Rezept):

ID	Pack	Garantie
`photoshop`	Standard Offline (Set-up + packages)	22.0.0.35
`photoshop-m0nkrus`	Pack 22.1.1.138 + Neural / missing_libs / GenP	22.1.1.138

Bei photoshop-m0nkrus: Quelle = kompletter Pack-Ordner (ISO + Sibling-Extras). Rezeptor:

nimmt die passende .iso als Offline-Installer
setzt RECIPE_PACK_ROOT und wendet nach dem Adobe-Setup Extras an (core/recipe-photoshop-pack.sh): ps2021_missing_libs.7z, Neural-Filters-SFX → Wine-PluginData
startet kein GenP (ISO laut Pack vorgepatcht; Cure nur manuell bei Aktivierungsverlust)

Varianten teilen die Core-API mit photoshop über dünne Wrapper:

core/recipe-photoshop-m0nkrus-install.sh / -launch.sh

(module: recipe_photoshop::install in recipe.yml; ohne Wrapper findet load_app_module die Funktionen nicht.)

MSI (Master PDF Editor)¶

master-pdf-editor: BYOS Pack-Ordner mit MasterPDFEditor-setup-*.msi (+ optional fix/MasterPDFEditor.exe). Core: recipe_master_pdf_editor::run_msi (Timeout, Erfolg wenn EXE da) + ::finalize (WORK_ROOT / Fix). Rezeptor liefert weder MSI noch Fix.

Bekannte Fallen¶

Falle	Hinweis
GPU/OpenGL in Adobe-Apps	Rezept setzt Prefs über Proton-Grafik-DLLs
MSXML/IE8 scheitert mit `no valid cabinets`	Oft kaputter Win7-SP1-Download unter `~/.cache/winetricks/win7sp1/`. Aktuelle Builds: Cache prüfen, löschen, einmal Retry. Manuell: Ordner löschen, Install/Repair erneut.
Quelle ≠ Repo-Pfad	Nutzer bringt Offline-Medium; Heuristik: Pack-Ordner / `Downloads/`
Nur-ISO statt Pack	Install ok, Neural Filters / missing_libs fehlen
Leeres Ziel	Pflichtwahl — kein stiller Default aus `target_default` / Home
Ziel verschieben	Mehr → Ziel verschieben… (`scripts/recipe-relocate.sh`)

Schnellstart & Typ-Übersicht: ENTWICKLER.md · Spec: RECIPE-AUTHORING.md