AngChow/android-publish

End-to-End-Automatisierung des Android-App-Packaging und des Einreichungsprozesses für mehrere App-Stores: Vorkontrolle → Build → Bugly-Symbolupload → Multi-Channel-Einreichung (Tencent/Xiaomi/Huawei/OPPO/vivo) → Git-Tag.

Was ist android-publish?

Dieses Skill automatisiert den gesamten Workflow vom Android-App-Build bis zur Einreichung in fünf großen chinesischen App-Stores (Tencent App Store, Xiaomi, Huawei, OPPO, vivo). Es führt eine Vorkontrolle durch (Signaturkonfiguration, Versionsnummer), erstellt eine Release-Version, lädt Symboltabellen zu Bugly hoch, reicht bei jedem Store nach dessen APIs ein und setzt bei Erfolg einen Git-Tag. Der Skill ist für Entwickler konzipiert, die diesen wiederkehrenden Prozess aus der Kommandozeile oder einem KI-Agenten ausführen möchten. Er unterstützt Trockentests nur für den Tencent Store, überspringbare Schritte (Build, Bugly, Git, Check) und die Einreichung über einzelne Kanäle. Die Integration mit Claude Code, Codex oder Cursor ermöglicht eine sofortige Ausführung durch einen einfachen Sprachbefehl wie „App packen und einreichen“.

Funktioniert mit~Claude Code✓Codex CLI~Cursor
npx skills add AngChow/android-publish

Installed? Explore more Produktivität & Zusammenarbeit skills: steipete/gemini, steipete/gh-issues, steipete/skill-creator · View all 6 →

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

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:

  1. Änderungsmitteilung bestätigen: Falls nicht angegeben, verwenden Sie den Standardtext „Fehler behoben, Benutzererfahrung optimiert“ oder fragen Sie den Benutzer.
  2. 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>
    
  3. Ausgabe überwachen: Das Skript erledigt alle Schritte automatisch (Vorkontrolle → Build → Bugly → Multi-Channel-Einreichung → Git-Tag), kein menschlicher Eingriff erforderlich.
  4. Ergebnisse melden: Zusammenfassung des Erfolgs-/Fehlerstatus aller Kanäle an den Benutzer.
  5. 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

SchrittSkriptBeschreibung
Schritt 0 Vorkontrollepre_check.pyPrüft Release-Signatur auf signingConfigs.release + lokalen versionCode > online versionCode
Schritt 1 Build./gradlew clean assembleReleaseFindet app-arm64-v8a-release.apk (nur 64-Bit-Paket hochladen)
Schritt 1.5 Buglyupload_bugly_symbol.pyLädt mapping.txt hoch (nicht blockierend, Fehler stoppt Einreichung nicht)
Schritt 2 Multi-Channel-Einreichungje Kanal *_submit.pyLädt nacheinander in konfigurierte Kanäle hoch, unabhängige Sicherheitssperren
Schritt 3 Git-Taggit_tag.pyNach Erfolg: Merge in master + Versions-Tag erstellen + pushen

Unterstützte Kanäle

KanalKennungSignaturmethodeDry-RunAPI-Limit
Tencent App StoreyybHmacSHA256Unterstützt100 Uploads/Tag, 50 Updates/Tag
Xiaomi App StorexiaomiRSA (X.509-Zertifikat)Nicht unterstützt (Upload = Einreichung)Keine
Huawei App GalleryhuaweiOAuth2 (API-Client)Nicht unterstütztKeine
OPPO App StoreoppoHmacSHA256Nicht unterstützt50/Tag/Schnittstelle
vivo App StorevivoHmacSHA256Nicht unterstützt50/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

  1. Die App ist in jedem App Store registriert und bereits live
  2. Projektstammverzeichnis enthält .publish_env (in .gitignore), mit Anmeldeinformationen für alle Kanäle
  3. Xiaomi-Public-Key-Zertifikatsdatei liegt im Projektstammverzeichnis und ist in .gitignore aufgenommen
  4. Lokal installiert: Python 3.8+, requests, pycryptodome, cryptography
  5. 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).

Verwandte Skills