Den vollständigen Index der Dokumentation findest du in llms.txt. Die Markdown-Version einer Dokumentationsseite erhältst du, indem du .md an die URL der Seite anhängst.
Hauptnavigation
Design
Codex

Anwendungsfall für Codex

Für macOS entwickeln

Erstelle mit Codex das Grundgerüst für native Mac-Apps mit SwiftUI. Codex hilft dir auch beim Entwickeln und Debuggen.

Schwierigkeitsgrad Advanced
Zeithorizont 1h

Entwickle mit Codex native Mac-Apps mit SwiftUI und richte ein Skript ein, mit dem du deine App über die Shell kompilieren und starten kannst. Wenn du die App erweiterst, kannst du Mac-typische Szenen und Fenster ergänzen, AppKit einbinden und die Codesignierung einrichten.

Besonders geeignet für

  • Neue SwiftUI-Apps für macOS, für die Codex ein natives App-Grundgerüst und ein Skript für wiederholbare Builds erstellen soll
  • Bestehende Mac-Apps, bei denen Codex Fenster, Menüs, Seitenleisten oder Einstellungen anpassen, an der AppKit-Anbindung arbeiten oder Probleme mit der Codesignierung beheben soll
  • Teams, die macOS-Apps vorwiegend in der Shell entwickeln und die Benutzeroberfläche nach den Konventionen von macOS gestalten möchten

Inhalt

    ← Alle Anwendungsfälle

    Für macOS entwickeln

    Erstelle mit Codex das Grundgerüst für native Mac-Apps mit SwiftUI. Codex hilft dir auch beim Entwickeln und Debuggen.

    Entwickle mit Codex native Mac-Apps mit SwiftUI und richte ein Skript ein, mit dem du deine App über die Shell kompilieren und starten kannst. Wenn du die App erweiterst, kannst du Mac-typische Szenen und Fenster ergänzen, AppKit einbinden und die Codesignierung einrichten.

    Advanced
    1h

    Entwickle mit Codex native Mac-Apps mit SwiftUI und richte ein Skript ein, mit dem du deine App über die Shell kompilieren und starten kannst. Wenn du die App erweiterst, kannst du Mac-typische Szenen und Fenster ergänzen, AppKit einbinden und die Codesignierung einrichten.

    Advanced
    1h

    Besonders geeignet für

    • Neue SwiftUI-Apps für macOS, für die Codex ein natives App-Grundgerüst und ein Skript für wiederholbare Builds erstellen soll
    • Bestehende Mac-Apps, bei denen Codex Fenster, Menüs, Seitenleisten oder Einstellungen anpassen, an der AppKit-Anbindung arbeiten oder Probleme mit der Codesignierung beheben soll
    • Teams, die macOS-Apps vorwiegend in der Shell entwickeln und die Benutzeroberfläche nach den Konventionen von macOS gestalten möchten

    Skills und Plug-ins

    • Entwickle und debugge macOS-Apps vorwiegend in der Shell. Gestalte SwiftUI-Szenen und -Fenster nach macOS-Konventionen, binde bei Bedarf AppKit ein und bereite die Codesignierung und Notarisierung vor.
    Skill Nutzen
    Build macOS Apps Entwickle und debugge macOS-Apps vorwiegend in der Shell. Gestalte SwiftUI-Szenen und -Fenster nach macOS-Konventionen, binde bei Bedarf AppKit ein und bereite die Codesignierung und Notarisierung vor.

    Prompt für den Einstieg

    Use the Build macOS Apps plugin to scaffold a starter macOS SwiftUI app and add a project-local `script/build_and_run.sh` entrypoint I can wire to a `Run` action. Constraints: - Stay shell-first. Prefer `xcodebuild` for Xcode projects and `swift build` for package-first apps. - Model Mac scenes explicitly with a main window plus `Settings`, `MenuBarExtra`, or utility windows only when they fit the product. - Prefer desktop-native sidebars, toolbars, menus, keyboard shortcuts, and system materials over iOS-style push navigation. - Use a narrow AppKit bridge only when SwiftUI cannot express the desktop behavior cleanly. - Keep one small validation loop for each change and tell me exactly which build, launch, or log commands you ran. Deliver: - the app scaffold or requested Mac feature slice - a reusable build-and-run script - the smallest validation steps you ran - any desktop-specific follow-up work you recommend
    Use the Build macOS Apps plugin to scaffold a starter macOS SwiftUI app and add a project-local `script/build_and_run.sh` entrypoint I can wire to a `Run` action. Constraints: - Stay shell-first. Prefer `xcodebuild` for Xcode projects and `swift build` for package-first apps. - Model Mac scenes explicitly with a main window plus `Settings`, `MenuBarExtra`, or utility windows only when they fit the product. - Prefer desktop-native sidebars, toolbars, menus, keyboard shortcuts, and system materials over iOS-style push navigation. - Use a narrow AppKit bridge only when SwiftUI cannot express the desktop behavior cleanly. - Keep one small validation loop for each change and tell me exactly which build, launch, or log commands you ran. Deliver: - the app scaffold or requested Mac feature slice - a reusable build-and-run script - the smallest validation steps you ran - any desktop-specific follow-up work you recommend

    App-Grundgerüst anlegen und Build-Ablauf einrichten

    Bitte Codex bei einer neuen Mac-App zuerst, das passende Szenenmodell auszuwählen: WindowGroup, Window, Settings, MenuBarExtra oder DocumentGroup. So ist die App von Anfang an auf den Mac zugeschnitten, statt aus einer ContentView nach iOS-Vorbild zu entstehen.

    Steuere Build und Start über die Shell. Verwende für Xcode-Projekte xcodebuild. Ist die App als Swift-Paket angelegt, verwende swift build und ein Wrapper-Skript im Projekt unter script/build_and_run.sh. Das Skript beendet den alten Prozess, erstellt die App und startet die neue Version. Bei Bedarf kann es auch Logs oder Telemetriedaten bereitstellen.

    Hat eine reine SwiftPM-App eine grafische Oberfläche, verpacke und starte sie als .app, statt die ausführbare Datei direkt aufzurufen. So vermeidest du bei lokalen Prüfungen Probleme mit einem fehlenden Dock-Symbol, der Aktivierung der App oder der Bundle-Identität.

    Skills nutzen

    Füge das Plugin „Build macOS Apps“ hinzu, sobald du an Desktop-spezifischen Funktionen arbeitest. Es unterstützt dich beim Erstellen und Debuggen über die Shell, beim Paketieren von SwiftPM-Apps, bei nativen Szenen- und Fenstermustern in SwiftUI und bei der Anbindung an AppKit. Es deckt auch Unified Logging, die Analyse fehlgeschlagener Tests sowie das Signieren und Notarisieren ab.

    Wie du Skills und Plugins installierst und verwendest, erfährst du in der Dokumentation zu Plugins und der Dokumentation zu Skills.

    Eine native Mac-Oberfläche entwickeln

    Bevorzuge Mac-Konventionen gegenüber Navigationsmustern aus iOS. Verwende NavigationSplitView für Layouts mit Seitenleiste und Detailansicht und eigene Settings-Szenen für die Einstellungen. Mache Aktionen über Symbolleisten und Menübefehle leicht auffindbar. Für kleine Hilfsfunktionen, die jederzeit erreichbar sein sollen, eignen sich Extras in der Menüleiste.

    Nutze zunächst Systemmaterialien, semantische Farben und Standardbedienelemente. Ergänze eine eigene Fenstergestaltung, Bereiche zum Verschieben von Fenstern oder Oberflächen mit Liquid Glass nur, wenn das Produkt auf dem Desktop eine eigenständige Gestaltung braucht.

    Wenn SwiftUI das gewünschte Verhalten nur teilweise abdeckt, halte die Anbindung an AppKit so klein wie möglich. Geeignete Beispiele sind Dialoge zum Öffnen und Sichern, die Steuerung des First Responders, die Prüfung, ob Menübefehle verfügbar sind, Sonderfälle bei Drag-and-drop oder eine eingebettete NSView für ein einzelnes spezialisiertes Bedienelement.

    Debuggen, testen und die Veröffentlichung vorbereiten

    Um das Verhalten zur Laufzeit zu prüfen, bitte Codex, mit Logger einige Ereignisse zu protokollieren, etwa beim Öffnen eines Fensters, bei der Auswahl in der Seitenleiste, beim Ausführen von Menübefehlen oder bei der Synchronisierung im Hintergrund. Prüfe diese Ereignisse nach dem Start der App mit log stream.

    Wenn Tests fehlschlagen, lass Codex mit xcodebuild test oder swift test zunächst nur die Tests ausführen, die zur Eingrenzung nötig sind. Lass Codex dann feststellen, ob die Ursache ein Kompilierungsfehler, eine fehlgeschlagene Assertion, ein Absturz, ein sporadisch fehlschlagender Test oder ein Problem mit der Umgebung oder dem Setup ist.

    Wenn du von der lokalen Entwicklung zur Auslieferung übergehst, bitte Codex, zwei Abläufe vorzubereiten: die manuelle Archivierung in Xcode und ein Skript zum Archivieren und Notarisieren für wiederholte Veröffentlichungen. Lass Codex das App-Bundle, die Entitlements und die Hardened Runtime mit codesign und plutil prüfen. Verwende die App Store Connect CLI, wenn du auch Uploads über das Terminal erledigen möchtest.

    Beispiel-Prompt

    Verwende das Plugin „Build macOS Apps“, um diese App-Funktion mit SwiftUI nativ für macOS umzusetzen. Vorgaben: - Gliedere die App in Mac-typische Szenen mit Hauptfenster und Einstellungen. Biete Aktionen dort über die Symbolleiste oder Menübefehle an, wo es sinnvoll ist. - Bevorzuge ein Layout mit Seitenleiste und Detailansicht gegenüber einer Push-Navigation wie unter iOS, wenn es für die Funktion hilfreich ist, dass die Navigationsstruktur sichtbar bleibt. - Ergänze eine kleine Anbindung an AppKit nur, wenn sich ein bestimmtes Desktop-Verhalten mit SwiftUI allein nicht sauber umsetzen lässt. - Erstelle oder aktualisiere `script/build_and_run.sh`, damit sich die App weiterhin über die Shell erstellen und starten lässt. - Nenne mir die Befehle, mit denen du die App erstellt, gestartet und getestet sowie die Logs geprüft hast. Stelle den beschriebenen Funktionsumfang fertig und überprüfe ihn mit dem kleinsten aussagekräftigen Build- oder Testlauf. Fasse zusammen, welche Schritte zum Signieren oder Paketieren vor der Auslieferung noch nötig sind.

    Praxistipps

    Szenen explizit definieren

    Definiere für das Hauptfenster, das Einstellungsfenster, Hilfsfenster und Extras in der Menüleiste jeweils eigene Szenen auf oberster Ebene, statt die gesamte App in einer einzigen großen View unterzubringen.

    Die Standardoberfläche von macOS nutzen

    Bevor du eigene Seitenleisten, Symbolleisten oder Materialien erstellst, prüfe, ob die Standard-APIs von SwiftUI für Szenen und Fenster bereits das gewünschte Mac-Verhalten bieten.

    AppKit gezielt einsetzen

    Nutze NSViewRepresentable, NSViewControllerRepresentable oder einen kleinen Helfer für NSWindow, um eine einzelne fehlende Desktop-Funktion zu ergänzen. Verwalte die Auswahl und den App-Zustand weiterhin zentral in SwiftUI.

    Signierung und Notarisierung unabhängig vom lokalen Build prüfen

    Auch wenn die App lokal startet, ist damit noch nicht geklärt, ob sie signiert ist oder alle Voraussetzungen für die Notarisierung erfüllt. Behalte für einzelne Release-Prüfungen einen manuellen Archivierungsablauf in Xcode bei. Ergänze für wiederholte Auslieferungen ein Skript zum Archivieren und Notarisieren. Sobald es um die Auslieferung geht, führe zusätzlich zur lokalen Erprobung Prüfungen mit codesign und plutil durch.

    Tech-Stack

    Was du brauchst

    UI-Framework

    Standardoptionen

    SwiftUI

    Warum du es brauchst

    SwiftUI ist eine gute Wahl, um Mac-Apps in Szenen zu gliedern und Fenster, Seitenleisten, Symbolleisten und Einstellungen zu gestalten.

    Was du brauchst

    AppKit-Anbindung

    Standardoptionen

    AppKit

    Warum du es brauchst

    Wenn sich das gewünschte Verhalten auf dem Mac mit SwiftUI allein nicht umsetzen lässt, binde AppKit gezielt über NSViewRepresentable, NSViewControllerRepresentable oder NSWindow ein.

    Was du brauchst

    Build und Paketierung

    Standardoptionen

    xcodebuild, swift build und App Store Connect CLI

    Warum du es brauchst

    Nutze einen wiederholbaren Ablauf im Terminal, um Apps lokal zu kompilieren, Archive manuell zu erstellen, die Notarisierung per Skript auszuführen und Apps in den App Store hochzuladen.

    Was du brauchst Standardoptionen Warum du es brauchst
    UI-Framework SwiftUI SwiftUI ist eine gute Wahl, um Mac-Apps in Szenen zu gliedern und Fenster, Seitenleisten, Symbolleisten und Einstellungen zu gestalten.
    AppKit-Anbindung AppKit Wenn sich das gewünschte Verhalten auf dem Mac mit SwiftUI allein nicht umsetzen lässt, binde AppKit gezielt über NSViewRepresentable , NSViewControllerRepresentable oder NSWindow ein.
    Build und Paketierung xcodebuild , swift build und App Store Connect CLI Nutze einen wiederholbaren Ablauf im Terminal, um Apps lokal zu kompilieren, Archive manuell zu erstellen, die Notarisierung per Skript auszuführen und Apps in den App Store hochzuladen.

    Verwandte Anwendungsfälle