Kurze Antwort
Anders als bei iOS kann Codex Android-Apps in seiner Cloud-Umgebung bauen und testen, sofern Android SDK und Gradle dort eingerichtet sind. Für eine bestehende Web-App ist ein nativer Wrapper wie WebViewGold der schnellste Weg in den Play Store; bei paralleler Agentenarbeit sollten versionCode, Signierung und Uploads zentral in der CI liegen.
Inhalt
Android ist für Codex das einfachere Ziel
Die Android-Toolchain läuft auf Linux. Gradle, das Android SDK, Lint und Unit-Tests brauchen weder einen Mac noch eine grafische Oberfläche. Damit kann Codex nicht nur Code schreiben, sondern die App in seiner eigenen Arbeitsumgebung auch bauen und testen. Das ist der entscheidende Unterschied zum iOS-Weg, bei dem Xcode auf macOS den Kreislauf unterbricht.
Damit das funktioniert, muss die Codex-Umgebung vorbereitet sein. Und weil Codex gern mehrere Aufgaben parallel bearbeitet, entstehen bei Android-Releases eigene Fallstricke, die man bei klassischer Entwicklung kaum kennt.
Ausgangslage klären
| Ihre App | Empfohlener Weg | Rolle von Codex |
|---|---|---|
| Web-App, gehostet, mobil gut nutzbar | Nativer Wrapper | Web-App für den Wrapper optimieren, Push-Backend bauen |
| Web-App mit Bedarf an Gerätefunktionen | Wrapper mit nativen Erweiterungen | Web-App und Konfiguration des Wrappers |
| Neue App, nativ gewünscht | Kotlin mit Jetpack Compose oder React Native | Gesamte Entwicklung inklusive Build und Tests |
Weg 1: Web-App im Wrapper
Für die meisten Unternehmens-Apps, die mit Codex als Web-App entstanden sind, ist ein Wrapper der wirtschaftlichste Weg. WebViewGold stellt ein Android-Template bereit: URL eintragen, Icon, Farben und Startbildschirm setzen, Push über Firebase aktivieren, bauen. Offline-Erkennung, Datei-Upload, Kamera, AdMob und mehr als 40 native Schnittstellen sind bereits enthalten.
Codex übernimmt dabei die Web-Seite. Gute Aufgaben zum Delegieren:
- Alle Formulare auf Smartphone-Breite prüfen und korrigieren.
- Die Zurück-Navigation so gestalten, dass sie innerhalb der App sinnvoll funktioniert.
- Einen Endpunkt zur Registrierung von Push-Tokens und eine Funktion zum Versand von Benachrichtigungen bauen.
- Eine Kontolöschung in der App und eine öffentliche Löschseite ergänzen, die Google Play verlangt.
- Login-Flows prüfen, die Google in eingebetteten WebViews nicht erlaubt, und auf System-Browser-Flows umstellen.
Weil diese Aufgaben unabhängig voneinander sind, können Sie sie parallel an Codex geben. Das ist genau der Arbeitsmodus, in dem Codex seine Stärken ausspielt.
Weg 2: Native App, von Codex gebaut und getestet
Die Umgebung einrichten
Damit Codex Android-Builds ausführen kann, braucht die Umgebung ein JDK, das Android SDK mit den passenden Build-Tools und Zugriff auf die Maven-Repositories, aus denen Gradle Abhängigkeiten lädt. Richten Sie das über das Setup der Codex-Umgebung ein und prüfen Sie die Netzwerkfreigaben. Ein Build, der beim ersten Abhängigkeitsdownload scheitert, ist der häufigste Grund, warum Codex-Aufgaben unter Android ohne Ergebnis enden.
AGENTS.md für Android
## Android-Build
- JDK 17, Android SDK unter $ANDROID_HOME
- Build: ./gradlew assembleDebug
- Unit-Tests: ./gradlew testDebugUnitTest
- Lint: ./gradlew lintDebug, keine neuen Fehler
## Release-Regeln
- versionCode und versionName NICHT ändern (setzt die CI)
- signingConfigs nicht anfassen, keine Keystores ins Repo
- Neue Berechtigungen im Manifest nur mit Begründung im PR
Was Codex nicht testen kann
Instrumentierte UI-Tests auf Emulatoren sind in Container-Umgebungen oft schwierig, weil Hardware-Beschleunigung fehlt. Rechnen Sie damit, dass Codex Unit-Tests und Lint zuverlässig ausführt, UI-Tests aber in Ihrer CI oder manuell auf Geräten laufen.
Das Parallelitäts-Problem bei Releases
Wenn fünf Codex-Aufgaben gleichzeitig laufen und jede den versionCode erhöht, entstehen Merge-Konflikte oder, schlimmer, zwei Builds mit derselben Versionsnummer. Google Play akzeptiert jeden versionCode nur einmal. Die Lösung ist einfach, muss aber bewusst eingeführt werden:
- versionCode zentral: Die CI setzt ihn aus der Build-Nummer oder dem Git-Tag, nicht der Agent.
- Signierung zentral: Der Upload-Schlüssel liegt im Secret-Speicher der CI. Codex sieht ihn nie.
- Upload zentral: Nur die CI lädt Bundles über die Google Play Developer API in den internen Track, etwa mit fastlane.
- Freigabe manuell: Der Schritt von internem Test zu Produktion bleibt eine menschliche Entscheidung.
So können Agenten frei und parallel arbeiten, während der Release-Prozess deterministisch bleibt.
Play Console: was vor der ersten Freigabe fertig sein muss
- Organisationskonto mit verifizierten Unternehmensdaten (private Neukonten unterliegen einer Testpflicht vor der Produktionsfreigabe)
- Play App Signing aktiviert
- Store-Eintrag mit Beschreibung, Icon, Feature-Grafik und Screenshots
- Data-Safety-Angaben, die alle von Codex eingebundenen Bibliotheken berücksichtigen, etwa Analyse- oder Crash-Dienste
- Datenschutzerklärung und Link zur Kontolöschung
- Inhaltsbewertung und Zielgruppe
- Prüfzugang, falls die App einen Login hat
Ein nützlicher Trick: Lassen Sie Codex vor dem Release eine Aufgabe ausführen, die alle Abhängigkeiten und Manifest-Berechtigungen auflistet und kurz beschreibt, welche Daten sie erheben. Die Liste ist eine gute Grundlage für Data Safety, ersetzt aber nicht die Prüfung durch einen Menschen.
Unterstützung beim Weg in den Store
appsubmitter.io übernimmt Einreichung, Store-Einträge, CI/CD und die Kommunikation bei Ablehnungen, in Ihrem eigenen Play-Console-Konto. Wer den Wrapper nicht selbst einrichten möchte, bekommt bei WeSetupYourWebViewApp eine fertig konfigurierte App auf Basis von WebViewGold mit vollem Quellcode in etwa 72 Stunden.
Den iOS-Weg mit seiner Mac-Abhängigkeit behandeln wir in ChatGPT Codex App in den App Store bringen. Wie Teams Codex strukturiert einführen, beschreibt die OpenAI Codex Schulung. Und wer zwischen Claude Code und Codex abwägt, findet die Android-Sicht mit Claude Code unter Claude Code App in den Play Store bringen.
FAQ
Kann Codex ein Android App Bundle selbst erzeugen?
Ja, wenn JDK, Android SDK und Gradle-Abhängigkeiten in der Umgebung verfügbar sind. Signiert und hochgeladen werden sollte das Release-Bundle aber in der CI, nicht vom Agenten.
Warum sollte Codex den versionCode nicht ändern?
Bei parallelen Aufgaben entstehen sonst Konflikte oder doppelte Versionsnummern, die Google Play ablehnt. Eine zentrale Vergabe in der CI vermeidet das zuverlässig.
Wrapper oder native App?
Wenn die Web-App bereits gut funktioniert, bringt der Wrapper sie am schnellsten in den Store und hält den Pflegeaufwand gering. Native Apps lohnen sich bei Offline-Daten, intensiver Hardware-Nutzung oder sehr hohen Performance-Anforderungen.
Wie lange dauert die erste Veröffentlichung?
Die technische Umsetzung dauert beim Wrapper wenige Tage. Kontoverifizierung, Store-Eintrag und gegebenenfalls eine Testphase bestimmen die Gesamtdauer stärker als der Build.