Liest das Log
Gib ihm die komplette Ausgabe von xcodebuild, keinen Screenshot. Codex findet den ersten echten Fehler unter Hunderten von Warnungen und erklärt ihn in einfachen Worten, und das ist schon die halbe Lösung.
Fünf Fakten zum Xcode-Projekt von WebViewGold
Die meisten Endlosschleifen in Xcode entstehen, weil das Projekt wie eine frische Xcode-Vorlage behandelt wird. Das ist es nicht, und fünf Fakten aus den iOS-Setup-Docs und aus unserem Support erklären die meisten Fehler:
- Öffne den Workspace. Das Projekt nutzt CocoaPods. Öffne immer
WebViewGold.xcworkspace, nie das.xcodeprojallein, sonst fehlen die Pods (OneSignal, AdMob und andere). - Es gibt mehr als ein Target. Neben dem App-Target
WebViewGoldliegen Extension-Targets wieOneSignalNotificationServiceExtension(und App Clip oder andere, falls vorhanden). Jedes braucht ein Team, und jede Bundle-ID muss mit der der App beginnen:com.yourbrand.app.OneSignalNotificationServiceExtension. - Die Versionen müssen übereinstimmen. Alle Targets tragen dieselbe Version und dieselbe Build-Nummer.
- Der Name steht an zwei Stellen. Der Product Name in den Build Settings darf keine Buchstaben mit Akzenten oder Umlauten enthalten; der Name auf dem Home-Bildschirm mit Umlauten kommt in Bundle Display Name in der Info.plist. Benenne das Projekt selbst ("WebViewGold") nicht um; die Docs zur Veröffentlichung warnen, dass das Probleme verursacht.
- Ein Info.plist-Key muss bleiben. Entferne Berechtigungstexte, die du nicht brauchst, aber behalte Privacy - Tracking Usage Description; laut Docs stürzt die App ohne ihn ab.
Und ein Fakt von Apple: Seit dem 28. April 2026 akzeptiert App Store Connect nur noch Builds, die mit Xcode 26 oder neuer erstellt wurden. Nutze das aktuelle Xcode ohne Beta aus dem Mac App Store und eine aktuelle WebViewGold-Version.
Die häufigsten Fehler und ihre Lösungen
| Meldung oder Symptom | Ursache | Lösung | Wer |
|---|---|---|---|
| "No such module …" oder "framework not found Pods_WebViewGold" | Statt des Workspace wurde das .xcodeproj geöffnet, oder das Entpack-Tool hat die Pods beschädigt | Öffne WebViewGold.xcworkspace. Klappt es immer noch nicht: Lade das Zip neu herunter, entpacke es mit einem anderen Tool und behalte die Ordnernamen bei; führe bei Bedarf pod install im Projektordner aus | Codex kann es ausführen |
| "Pods-WebViewGold-frameworks.sh: Permission denied" mit "Command PhaseScriptExecution failed with a nonzero exit code" | Das Skript hat beim Entpacken sein Ausführungsrecht verloren | chmod +x auf das im Log genannte Skript, dann Product → Clean Build Folder | Codex |
| "… cannot be opened because the developer cannot be verified" | macOS Gatekeeper blockiert das heruntergeladene Skript | Schließe Xcode, klicke die Datei im Finder mit gedrückter Ctrl-Taste an (Pods/Target Support Files), wähle Öffnen und öffne den Workspace erneut | Du |
| "Signing for OneSignalNotificationServiceExtension requires a development team" | Team nur beim App-Target gesetzt | Wähle unter Signing & Capabilities für jedes Target dasselbe Team | Du oder Codex mit deiner Team ID |
| "Failed to register bundle identifier" / "… is not available" | Die Bundle-ID der Vorlage oder eine, die ein anderer Entwickler registriert hat | Wähle deine eigene ID im Reverse-DNS-Format und ändere sie in jedem Target | Codex |
| "The embedded binary's bundle identifier is not prefixed with the parent app's bundle identifier" | Die Extension-ID hat noch das alte Präfix | Deine App-ID plus .OneSignalNotificationServiceExtension | Codex |
| ITMS-90685 "CFBundleIdentifier Collision" | Eine Extension nutzt dieselbe ID wie die App | Gib jeder Extension ein eigenes Suffix | Codex |
| ITMS-90473 "CFBundleVersion Mismatch" | Die Build-Nummer der Extension weicht von der der App ab | Dieselbe Version und Build-Nummer in allen Targets | Codex |
| "Provisioning profile doesn't support the Push Notifications capability" | Der App ID fehlt die Capability | Aktiviere Push Notifications und App Groups für die App ID im Apple Developer Portal, entferne die Capability in Xcode und füge sie neu hinzu, starte Xcode neu | Du |
| "Failed to create provisioning profile" / "No profiles for … were found" | Falsche Apple-ID oder falsches Team in Xcode, oder ein Simulator als Ziel ausgewählt | Prüfe Xcode Settings → Accounts; archiviere mit "Any iOS Device (arm64)" | Du |
| "errSecInternalComponent" / "Command CodeSign failed with a nonzero exit code" | Gesperrter Schlüsselbund oder fehlendes Zertifikat | Entsperre den Anmelde-Schlüsselbund; ist kein Apple-Distribution-Zertifikat aufgeführt, erstelle eines unter Settings → Accounts → Manage Certificates | Du |
| ITMS-90717 "Invalid App Store Icon" (Transparenz oder Alphakanal) | Das 1024-px-Icon hat einen Alphakanal | Exportiere es flach ohne Alphakanal und ersetze es im AppIcon-Set | Codex kann es prüfen |
| ITMS-90725 "SDK version issue" | Mit einem älteren Xcode und SDK gebaut | Aktualisiere Xcode und baue neu | Du |
| Die App stürzt nach Änderungen an der Info.plist direkt beim Start ab | Privacy - Tracking Usage Description wurde entfernt | Stelle den Key mit einem kurzen, zutreffenden Zwecktext wieder her | Codex |
Wo Codex hilft und wo es an dich übergibt
Bearbeitet Projekt-Textdateien konsistent
Bundle-IDs und Versionsnummern stehen in project.pbxproj, Berechtigungstexte in der Info.plist, deine Einstellungen in Config.swift. Codex ändert jedes Target in einem einzigen Diff statt nur das eine, an das du gedacht hast.
Führt Befehle aus, mit deiner Freigabe
Mit der Codex CLI oder der IDE-Erweiterung auf deinem Mac kann es xcodebuild, pod install, plutil und sips ausführen. Befehle, die seine Sandbox verlassen (ein Xcode-Build schreibt in DerivedData und kontaktiert womöglich Apple), brauchen deine Freigabe, oder du führst sie selbst aus und gibst das Log weiter.
Niemals dein Apple-Account
Zertifikate, App IDs, Capabilities und Profile liegen in deinem Apple-Developer-Konto, und der Schlüsselbund braucht dein Mac-Passwort. Füge beides nie in einen Agenten ein. Codex schreibt den Klickpfad; du klickst.
Cloud-Aufgaben haben kein Xcode
Eine Codex-Cloud-Aufgabe kann die Projektdateien in einem Repository bearbeiten und einen Pull Request öffnen, aber sie kann keine iOS-App bauen, signieren oder archivieren. Builds entstehen auf einem Mac oder im Cloud Builder.
WebViewGold hat uns die kürzeste und effizienteste Time-to-Market ermöglicht, die jemals möglich war, verglichen mit allen anderen App-Plattformen, die wir in den letzten 5 Jahren ausprobiert haben. Ich weiß nicht, warum ich euch nicht schon früher entdeckt habe, aber ich bin wirklich, wirklich froh, dass ich es getan habe. Wir nähern uns derzeit fast 6000 App-Downloads im iOS App Store & Google Play Store ohne Probleme!
Gib Codex ein vollständiges Log
Führe diese Befehle im Terminal in dem Ordner aus, der WebViewGold.xcworkspace enthält, oder lass Codex sie ausführen. Der Archiv-Befehl macht dasselbe wie Product → Archive und speichert alles in build.log.
bash
# 1. Schemes and targets (use the scheme name it prints below)
xcodebuild -list -workspace WebViewGold.xcworkspace
# 2. Archive from the command line and keep the complete log
xcodebuild -workspace WebViewGold.xcworkspace -scheme WebViewGold \
-configuration Release -destination "generic/platform=iOS" \
-archivePath build/WebViewGold.xcarchive archive 2>&1 | tee build.log
# 3. The errors only, with line numbers
grep -n "error:" build.log | head -40
# 4. Bundle IDs and versions of every target (one prefix, one version)
grep -n "PRODUCT_BUNDLE_IDENTIFIER\|MARKETING_VERSION\|CURRENT_PROJECT_VERSION" *.xcodeproj/project.pbxproj
# 5. Signing identities in your keychain
security find-identity -v -p codesigning
# 6. Does the icon have an alpha channel? (path from your AppIcon set)
sips -g pixelWidth -g pixelHeight -g hasAlpha path/to/AppIcon-1024.pngDer Xcode-Triage-Prompt
Fülle die eckigen Klammern aus. Der Regelblock ist der wichtige Teil: Er listet auf, was ein Agent in diesem Projekt niemals anfassen sollte.
In die Codex CLI oder IDE-Erweiterung einfügen, geöffnet im Ordner des Xcode-Projekts
Ich baue die iOS-App aus dem WebViewGold-Xcode-Projekt in diesem Ordner, und das Archivieren schlägt fehl. Lies build.log (die komplette Ausgabe von xcodebuild) und hilf mir, den Fehler zu beheben. Fakten zum Projekt: - Baue immer WebViewGold.xcworkspace (CocoaPods), nie das .xcodeproj allein. - Targets: WebViewGold plus Extension-Targets wie OneSignalNotificationServiceExtension (und andere, falls vorhanden). Jede Bundle-ID einer Extension ist die Haupt-Bundle-ID plus ein Suffix, z. B. com.yourbrand.app.OneSignalNotificationServiceExtension. - Alle Targets nutzen dieselbe Version, dieselbe Build-Nummer und dasselbe Development Team. - Meine Bundle-ID: [com.yourbrand.app]. Meine Team ID: [ABCDE12345]. Version [1.0], Build [1]. Regeln: - Benenne das Xcode-Projekt nicht um, führe kein pod update aus, aktualisiere oder entferne keine SDKs (AdMob, OneSignal, andere), lösche den Key NSUserTrackingUsageDescription nicht und ändere das Deployment Target nicht. - Bevor du project.pbxproj bearbeitest, zeig mir die genauen Zeilen, die du ändern wirst. Ändere nur Bundle Identifier, Versionsnummern und Team-Einstellungen. - Ich gebe keine Passwörter weiter. Für alles, was meinen Apple-Account, das Apple Developer Portal oder den Schlüsselbund braucht, gib mir stattdessen Schritt-für-Schritt-Anweisungen zum Klicken. Antworte mit: 1. Dem ersten echten Fehler im Log, wörtlich zitiert (ignoriere Warnungen und Folgefehler). 2. Seiner Ursache in diesem Projekt, in ein oder zwei Sätzen. 3. Der Lösung: den Änderungen, die du vorgenommen hast, oder den Schritten für mich. 4. Dem Befehl, der die Lösung überprüft.
Behebe in dieser Reihenfolge
Jeder Schritt beseitigt eine ganze Fehlerklasse; wer vorspringt, bekommt später irreführende Meldungen.
Sauberer Start
Ein frisch entpacktes Paket der aktuellen WebViewGold-Version mit intakten Ordnernamen, das aktuelle Xcode, der Workspace geöffnet. Übertrage deine Werte aus Config.swift, statt ein altes, halb repariertes Projekt weiter aufzupäppeln.
Bundle-IDs
Deine ID am App-Target, dasselbe Präfix plus ein Suffix an jeder Extension. Leg sie endgültig fest: die Bundle-ID nur einmal wählen.
Team und Signierung
Dasselbe Team an allen Targets, "Automatically manage signing" eingeschaltet, angemeldet mit der Apple-ID, die zu deiner Mitgliedschaft im Developer Program gehört.
Capabilities der App ID
Aktiviere im Apple Developer Portal Push Notifications und App Groups für deine App ID (die Docs zur Veröffentlichung verlangen beides) und starte Xcode dann neu, damit es die neuen Profile holt.
Versionen
Version und Build-Nummer in allen Targets identisch, und die Build-Nummer höher als bei jedem Build, den du vorher hochgeladen hast.
Archivieren
Ziel "Any iOS Device (arm64)", dann Product → Archive. Ist Archive ausgegraut, ist ein Simulator ausgewählt.
Hochladen und die E-Mail lesen
Verteile aus dem Organizer. Verarbeitungsfehler von App Store Connect kommen per E-Mail mit einer ITMS-Nummer; füge diese E-Mail genau wie ein Build-Log in Codex ein.
Den echten Build testen
Installiere aus TestFlight, nicht nur aus Xcode: Release-Builds nutzen die Distributions-Signierung und Push im Produktionsmodus. Siehe TestFlight für Vibe-Coding-Apps.
Was Codex in diesem Projekt nicht tun darf
pod updateausführen oder SDKs aktualisieren. Das tauscht die getesteten Versionen von OneSignal, AdMob und anderen gegen ungetestete aus;pod installreicht.- Das AdMob-SDK entfernen, weil du keine Werbung zeigst. Die Docs warnen, dass das viele Abhängigkeitsfehler erzeugt; beantworte stattdessen die Frage zur Werbe-ID (Ad ID) in App Store Connect so, wie es die Docs zur Veröffentlichung beschreiben.
- Das Xcode-Projekt umbenennen, Ordner verschieben oder das Deployment Target anheben, um eine Warnung zum Schweigen zu bringen.
- Die Tracking Usage Description aus der Info.plist löschen.
project.pbxprojbearbeiten, ohne vorher zu committen oder ein Backup anzulegen. Lass dir vor der Änderung die genauen Zeilen zeigen.- Dein Apple-ID-Passwort, ein app-spezifisches Passwort oder dein Mac-Passwort bekommen. Kein Build-Schritt erfordert, dass der Agent sie kennt.
Häufig gestellte Fragen
Kann Codex in der Cloud meine iOS-App bauen?
Nein. Cloud-Aufgaben können die Xcode-Projektdateien in einem Repository bearbeiten, aber zum Kompilieren und Signieren einer iOS-App braucht es Xcode unter macOS. Nutze die Codex CLI oder die IDE-Erweiterung auf einem Mac, einen gemieteten Mac oder den Cloud Builder.
Soll ich Codex meine Apple-ID geben, damit es die Signierung reparieren kann?
Nein, und Codex braucht sie auch nicht. Deine Team ID (die zehnstellige Kennung, die im Apple Developer Portal angezeigt wird) reicht für die Projekteinstellungen; alles, was den Account selbst braucht, sind ein paar Klicks, die du in Xcode oder im Portal machst.
Apple hat mir wegen eines fehlenden Push-Notification-Entitlements gemailt. Ist das eine Ablehnung?
Nein, das ist eine Warnung, dass Push nicht konfiguriert ist. Wenn du kein Push nutzt, mach mit der Einreichung weiter. Wenn doch, füge die Capability Push Notifications in Xcode und an der App ID im Apple Developer Portal hinzu.
Warum ist Product → Archive ausgegraut?
Als Ausführungsziel ist ein Simulator ausgewählt. Wähle in der Toolbar Any iOS Device (arm64) und versuch es noch einmal.
Muss ich alle gelben Warnungen beheben?
Nein. Warnungen aus Pods von Drittanbietern sind in WebViewGold-Projekten normal. Behebe die Fehler und die Warnungen, die App Store Connect in seiner Verarbeitungs-E-Mail erwähnt.
Drei Wege, deine App in die Stores zu bringen
Gleiches Ergebnis, unterschiedlich viel Arbeit auf deiner Seite. Alle drei kommen mit Genehmigungsgarantie und 24/7 Support von echten Menschen.
Selbst machen
$109 pro Plattform, einmalig
Die WebViewGold-Lizenz: ein fertiges Xcode- oder Android-Studio-Projekt. URL einfügen, Name und Icon setzen, Features einschalten, bauen und einreichen. Kostenlose Updates für immer.
Pakete auf der Hauptseite ansehenCloud Builder
$349 pro Lizenz, einmaliges Add-on
Kein Mac, kein Xcode, kein Android Studio: Du konfigurierst im Browser, wir bauen beide Apps in der Cloud und übergeben sie an App Store Connect und die Play Console.
So funktioniert der Cloud Builder Kostenlose Demo ausprobierenFull Service
$698 pro Plattform $798
Schick uns deine URL und dein Icon. Unser Team konfiguriert, baut und liefert deine App innerhalb von 72 Stunden, White-Label, inklusive Quellprojekten. Beide Plattformen für $1,158.
Full-Service-Details Powered by
Winter-Sale-Preise gültig bis 31. Dezember 2026.