Was du brauchst
UI-Framework
Standardoptionen
Warum du es brauchst
SwiftUI ist eine gute Wahl, um Mac-Apps in Szenen zu gliedern und Fenster, Seitenleisten, Symbolleisten und Einstellungen zu gestalten.
.md an die URL der Seite anhängst.
Anwendungsfall für Codex
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.
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.
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.
Weiterführende Links
| 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. |
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.
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.
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.
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.
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.
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.
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.
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.
Was du brauchst
Standardoptionen
Warum du es brauchst
Was du brauchst
UI-Framework
Standardoptionen
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
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. |
Setze deine App-Idee mit Codex und dem Plugin „Build macOS Apps“ als native Mac-App mit...
Erfasse mit Codex und dem Plugin „Build macOS Apps“ einige aussagekräftige...
Finde mit Codex und dem Plugin „Build iOS Apps“ heraus, welche Aktionen und Entitäten deine...