Android-App-Veröffentlichung Skill
Release-Paket erstellen und an die fünf großen App-Stores (Tencent/Xiaomi/Huawei/OPPO/vivo) zur Prüfung einreichen – End-to-End automatisiert.
Ausführungsanweisungen
Wenn ein Benutzer „Paket zur Prüfung einreichen“ (oder „build“, „veröffentlichen“, „App ausliefern“, „Multi-Channel-Einreichung“ usw.) sagt:
- Änderungsmitteilung bestätigen: Falls nicht angegeben, verwenden Sie den Standardtext „Fehler behoben, Benutzererfahrung optimiert“ oder fragen Sie den Benutzer.
- All-in-One-Befehl ausführen:
PUBLISH_CONFIRM_SUBMIT=YES python3 ~/.codex/skills/android-publish/scripts/build_and_submit.py \ --i-know-this-submits-to-production \ --update-desc "<Änderungsmitteilung>" \ <Projektstammverzeichnis> - Ausgabe überwachen: Das Skript erledigt alle Schritte automatisch (Vorkontrolle → Build → Bugly → Multi-Channel-Einreichung → Git-Tag), kein menschlicher Eingriff erforderlich.
- Ergebnisse melden: Zusammenfassung des Erfolgs-/Fehlerstatus aller Kanäle an den Benutzer.
- Fehlerbehandlung: Bei Fehlschlag der Vorkontrolle (Signatur/Versionsnummer) abbrechen und den genauen Grund mitteilen; ein Fehlschlag auf einem Kanal beeinträchtigt die anderen nicht.
Nur Build ohne Einreichung (Dry-Run)
Nur Tencent App Store unterstützt Dry-Run (Hochladen ohne Einreichung). Xiaomi/Huawei/OPPO/vivo reichen nach dem Hochladen sofort ein; bei Dry-Run werden diese Kanäle automatisch übersprungen:
python3 ~/.codex/skills/android-publish/scripts/build_and_submit.py \
--dry-run --store yyb \
<Projektstammverzeichnis>
Einzelkanal angeben
PUBLISH_CONFIRM_SUBMIT=YES python3 ~/.codex/skills/android-publish/scripts/build_and_submit.py \
--store yyb|xiaomi|huawei|oppo|vivo \
--i-know-this-submits-to-production \
--update-desc "<Änderungsmitteilung>" \
<Projektstammverzeichnis>
Schritte überspringen
--skip-build: Build überspringen, vorhandene APK verwenden--skip-bugly: Bugly-Symbolupload überspringen--skip-git: Git-Tag überspringen--skip-check: Vorkontrolle überspringen
Automatisierter Workflow
| Schritt | Skript | Beschreibung |
|---|---|---|
| Schritt 0 Vorkontrolle | pre_check.py | Prüft Release-Signatur auf signingConfigs.release + lokalen versionCode > online versionCode |
| Schritt 1 Build | ./gradlew clean assembleRelease | Findet app-arm64-v8a-release.apk (nur 64-Bit-Paket hochladen) |
| Schritt 1.5 Bugly | upload_bugly_symbol.py | Lädt mapping.txt hoch (nicht blockierend, Fehler stoppt Einreichung nicht) |
| Schritt 2 Multi-Channel-Einreichung | je Kanal *_submit.py | Lädt nacheinander in konfigurierte Kanäle hoch, unabhängige Sicherheitssperren |
| Schritt 3 Git-Tag | git_tag.py | Nach Erfolg: Merge in master + Versions-Tag erstellen + pushen |
Unterstützte Kanäle
| Kanal | Kennung | Signaturmethode | Dry-Run | API-Limit |
|---|---|---|---|---|
| Tencent App Store | yyb | HmacSHA256 | Unterstützt | 100 Uploads/Tag, 50 Updates/Tag |
| Xiaomi App Store | xiaomi | RSA (X.509-Zertifikat) | Nicht unterstützt (Upload = Einreichung) | Keine |
| Huawei App Gallery | huawei | OAuth2 (API-Client) | Nicht unterstützt | Keine |
| OPPO App Store | oppo | HmacSHA256 | Nicht unterstützt | 50/Tag/Schnittstelle |
| vivo App Store | vivo | HmacSHA256 | Nicht unterstützt | 50/Tag/Schnittstelle |
Alle Kanäle unterstützen chinesische Änderungsmitteilungen; --update-desc wird einheitlich übergeben. Huawei setzt zusätzlich das sichtbare Feld newFeatures.
Sicherheitssperre
Die Einreichung ist ein schreibender Online-Vorgang und erfordert beides:
- Befehlszeilenoption
--i-know-this-submits-to-production - Umgebungsvariable
PUBLISH_CONFIRM_SUBMIT=YES(Multi-Channel) oder kanalspezifische Variable
build_and_submit.py setzt bei --confirm automatisch die entsprechenden Umgebungsvariablen für alle Unterprozesse, daher reicht es, PUBLISH_CONFIRM_SUBMIT=YES zu setzen.
Besonderheiten der Kanäle
- Tencent App Store: Upload und Einreichung getrennt, Dry-Run unterstützt. Limit: 100 Uploads/Tag, 50 Updates/Tag.
- Xiaomi: Upload = Einreichung; Update benötigt nur APK + updateDesc. Kein API-Limit.
- Huawei: Token → Upload zu OBS → Dateiinformationen aktualisieren → Sprachinformationen (Änderungsmitteilung) aktualisieren → 2 Minuten warten → Einreichen. Team-Anmeldeinformationen gelten kanalübergreifend.
- OPPO: Release-API mit vielen Feldern, aber Werte werden automatisch aus vorherigen Abfragen übernommen. Limit: 50/Tag/Schnittstelle.
- vivo: APK-Upload gibt Transaktions-ID + versionCode zurück; Update-API hat nur wenige Pflichtfelder. Limit: 50/Tag/Schnittstelle.
Voraussetzungen
- Die App ist in jedem App Store registriert und bereits live
- Projektstammverzeichnis enthält
.publish_env(in.gitignore), mit Anmeldeinformationen für alle Kanäle - Xiaomi-Public-Key-Zertifikatsdatei liegt im Projektstammverzeichnis und ist in
.gitignoreaufgenommen - Lokal installiert: Python 3.8+,
requests,pycryptodome,cryptography - Projektstammverzeichnis enthält
gradlew, Java / Android SDK sind konfiguriert
Einzelkanal-Operationen
Jeder Kanal unterstützt unabhängige Abfragen und Einreichungen; Details siehe README.md.
Bugly-Symbolupload
Nach dem Build wird mapping.txt automatisch (nicht blockierend) an Bugly hochgeladen, damit Absturzstacktraces rückverfolgbar bleiben. Das Jar-Tool befindet sich im tools/-Verzeichnis des Skills; Anmeldeinformationen werden aus .publish_env gelesen (BUGLY_APP_ID / BUGLY_APP_KEY).