Für Freiburger Entwicklerinnen und Entwickler, die mit OpenAI Codex arbeiten, ist Android der einfachste Weg zum ersten Store-Release, denn der gesamte Build läuft auf Linux und damit auch in der Cloud-Umgebung des Agenten. Dieser Leitfaden zeigt, wie Sie die Codex-Umgebung für Android vorbereiten, welche Aufgaben sich parallel abarbeiten lassen und wie Sie die Release-Spuren der Play Console vom internen Test bis zum gestaffelten Rollout sinnvoll einsetzen.
Android ist das natürliche Terrain des Codex-Cloud-Agenten
Anders als bei iOS lässt sich eine Android-App vollständig auf Linux bauen. Damit kann der Cloud-Agent von OpenAI Codex nicht nur Code schreiben, sondern auch Gradle-Builds und Unit-Tests ausführen, sofern die Umgebung vorbereitet ist. Dafür konfigurieren Sie in Codex eine Umgebung mit Setup-Skript, das JDK und Android SDK installiert und Abhängigkeiten vorab lädt. Beachten Sie, dass der Internetzugang während der eigentlichen Agentenarbeit standardmäßig eingeschränkt ist; alles, was der Build braucht, sollte deshalb im Setup-Schritt geladen werden.
Lokal arbeitet die Codex CLI direkt mit Ihrem Android-Projekt, ruft Gradle auf und liest Fehlermeldungen. In beiden Fällen gilt: Die AGENTS.md ist die verbindliche Anleitung. Halten Sie dort fest, wie Debug- und Release-Builds gestartet werden, welche Tests vor einem Pull Request grün sein müssen und dass Signing-Dateien tabu sind.
Parallele Aufgaben für einen sauberen Release
Die Stärke des Cloud-Agenten liegt in parallelen Aufgaben. Für einen Android-Release können Sie gleichzeitig eine Aufgabe zum Anheben von targetSdk auf das aktuell geforderte Target API Level, eine zur Prüfung aller Berechtigungen im AndroidManifest und eine zur Erstellung von fastlane-Lanes mit supply anstoßen. Jede Aufgabe liefert einen eigenen Pull Request, den Ihr Team einzeln prüft.
Besonders hilfreich ist eine Lane, die den versionCode automatisch aus der Build-Nummer der CI ableitet, denn Google akzeptiert kein Bundle mit einer bereits verwendeten Nummer. Ebenso sinnvoll ist eine Aufgabe, die Store-Texte und Release Notes im Repository pflegt, damit Metadaten versioniert und mehrsprachig vorliegen. Upload-Schlüssel und Service-Konto für die Play-API gehören dagegen ausschließlich in die Secrets Ihrer CI.
Release-Spuren der Play Console richtig nutzen
Google Play bietet mehrere Spuren, die Sie für einen kontrollierten Ablauf nutzen sollten:
- Erstellen Sie den App-Eintrag in der Play Console, aktivieren Sie Play App Signing und laden Sie das erste AAB in den internen Test.
- Lassen Sie Codex einen CI-Workflow schreiben, der jeden Merge auf den Hauptzweig automatisch in den internen Test hochlädt.
- Starten Sie bei neuen privaten Entwicklerkonten den geschlossenen Test mit mindestens 12 Testern, die 14 Tage aktiv bleiben.
- Füllen Sie Data safety, Inhaltsbewertung und Zielgruppe aus und gleichen Sie die Angaben mit den tatsächlich genutzten SDKs ab.
- Beantragen Sie den Produktionszugang und veröffentlichen Sie per gestaffeltem Rollout, zunächst für einen kleinen Prozentsatz der Nutzer.
- Beobachten Sie Abstürze in Android Vitals und erhöhen Sie den Rollout erst, wenn die Werte stabil sind.
Qualitätssicherung und Unterstützung
Agenten neigen dazu, bei Problemen schnell eine neue Bibliothek einzubinden. Jede davon kann Berechtigungen oder Datenflüsse mitbringen, die im Data-safety-Formular fehlen. Ein Abgleich vor jedem Release ist deshalb Pflicht. appsubmitter.io übernimmt diese Prüfung, richtet Play App Signing, fastlane und CI in Ihrem eigenen Konto ein und begleitet Einreichung und Rückfragen von Google. Mit neooutput lernt Ihr Team in Workshops, Codex mit AGENTS.md, parallelen Aufgaben und klaren Review-Regeln produktiv einzusetzen.
Planen Sie zudem die jährliche Pflege ein: Wenn Google das geforderte Target API Level anhebt, ist das eine ideale Aufgabe für den Cloud-Agenten. Er liest die Verhaltensänderungen der neuen Android-Version, passt Code und Konfiguration an und liefert einen Pull Request mit grünen Tests. Ein Testlauf auf echten Geräten über den internen Test bleibt trotzdem unverzichtbar, bevor das Update in die Produktion geht.
Codex-Projekte aus Freiburg sicher in Google Play
Viele Freiburger Projekte, etwa aus der Green-City-Szene, aus Forschungsgruppen oder aus kleinen Agenturen im Breisgau, haben begrenzte Ressourcen für den Betrieb. Eine Release-Strecke, in der Codex die Routinearbeit erledigt und die CI automatisch in den internen Test liefert, spart dort spürbar Zeit. Wir helfen, Umgebung, Setup-Skript und AGENTS.md so aufzusetzen, dass der Agent reproduzierbar baut und testet. Ein typischer Fehler ist ein Setup-Skript, das Abhängigkeiten nicht vollständig vorab lädt, sodass Builds später am eingeschränkten Netzzugang scheitern.
jocapps sitzt in Freiburg und bietet mit neooutput Workshops zu Codex an, in denen Ihr Team an der eigenen Android-App übt. appsubmitter.io richtet Play App Signing, Service-Konto und fastlane in Ihrer Play Console ein und begleitet die Testphase mit 12 Testern. Nutzer in der Schweiz und in Frankreich berücksichtigen wir bei Länderauswahl und Sprachversionen.
Häufige Fragen
Kann der Codex-Cloud-Agent Android-Builds ausführen?
Ja, wenn die Umgebung per Setup-Skript mit JDK und Android SDK vorbereitet ist. Da der Internetzugang während der Agentenarbeit standardmäßig eingeschränkt ist, sollten Abhängigkeiten im Setup geladen werden. Signierte Release-Builds erzeugen Sie trotzdem besser in der CI.
Warum lehnt Google mein neues Bundle ab?
Häufige Ursachen sind ein nicht erhöhter versionCode, ein zu niedriges Target API Level oder eine falsche Signatur. Lassen Sie den versionCode automatisch aus der CI-Build-Nummer berechnen. Fehlermeldungen der Play Console können Sie Codex direkt als Aufgabe übergeben.
Was bringt ein gestaffelter Rollout?
Sie veröffentlichen ein Update zunächst nur für einen Teil der Nutzer und beobachten Abstürze und Bewertungen. Treten Probleme auf, stoppen Sie den Rollout, bevor alle betroffen sind. Gerade bei KI-generiertem Code ist das eine sinnvolle Absicherung.
Kann ich in Freiburg Hilfe bei der Codex-Umgebung für Android bekommen?
Ja, wir helfen beim Setup-Skript, bei der Installation von JDK und Android SDK und bei der passenden AGENTS.md. Das geht in Freiburg vor Ort oder per Video. Ziel ist, dass der Agent Ihre App eigenständig bauen und testen kann.