AngChow/android-publish

Automatisation complète du cycle de publication Android : pré-vérification → build → upload des tables de symboles Bugly → soumission multi-canaux (Tencent MyApp / Xiaomi / Huawei / OPPO / vivo) → tag Git

Qu'est-ce que android-publish ?

Ce skill Codex automatise l'ensemble du processus de publication d'une application Android, de la pré-vérification à la soumission sur cinq marchés majeurs chinois (Tencent MyApp, Xiaomi, Huawei, OPPO, vivo) en un seul clic. Il effectue une pré-vérification de la configuration de signature release et du numéro de version, compile l'APK (version 64 bits), télécharge les tables de symboles Bugly (non bloquant), soumet l'application sur chaque marché configuré avec des mécanismes de verrouillage de sécurité, puis crée un tag Git sur le dépôt. Le skill supporte les exécutions à sec (dry-run) pour Tencent MyApp, la sélection de canaux individuels, et le saut d'étapes (build, Bugly, Git, pré-vérification). Il est conçu pour fonctionner avec des projets Android standards utilisant Gradle sur macOS/Linux, et nécessite un fichier `.publish_env` contenant les identifiants de chaque marché ainsi que Python 3.8+ avec les dépendances requises.

Compatible avec~Claude Code✓Codex CLI~Cursor
npx skills add AngChow/android-publish

Installed? Explore more Productivité et collaboration skills: steipete/gemini, steipete/gh-issues, steipete/skill-creator · View all 6 →

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Skill de publication d'application Android

Build de l'APK Release et soumission sur les cinq principaux marchés d'applications (Tencent MyApp / Xiaomi / Huawei / OPPO / vivo), automatisation de bout en bout.

Instructions d'exécution

Lorsque l'utilisateur demande "packager et soumettre" (ou "sortir le package" / "mettre en ligne" / "publier l'application" / "soumission multi-canaux", etc.) :

  1. Confirmer le texte de mise à jour : si l'utilisateur ne précise rien, utiliser la valeur par défaut "Correction de bugs connus, optimisation de l'expérience utilisateur", ou demander à l'utilisateur
  2. Exécuter la commande tout-en-un :
    PUBLISH_CONFIRM_SUBMIT=YES python3 ~/.codex/skills/android-publish/scripts/build_and_submit.py \
        --i-know-this-submits-to-production \
        --update-desc "<texte de mise à jour>" \
        <racine du projet>
    
  3. Surveiller la sortie : le script effectue automatiquement toutes les étapes (pré-vérification → build → Bugly → soumission multi-canaux → tag Git), sans intervention humaine
  4. Rapporter les résultats : résumer l'état de succès/échec de chaque canal à l'utilisateur
  5. Gestion des exceptions : si la pré-vérification échoue (signature / numéro de version), arrêter et informer l'utilisateur de la raison précise ; l'échec d'un canal n'affecte pas les autres canaux

Build sans soumission (dry-run)

Seul Tencent MyApp supporte le dry-run (upload sans soumission). Xiaomi / Huawei / OPPO / vivo soumettent dès l'upload, donc le dry-run les ignore automatiquement :

python3 ~/.codex/skills/android-publish/scripts/build_and_submit.py \
    --dry-run --store yyb \
    <racine du projet>

Canal unique

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 "<texte de mise à jour>" \
    <racine du projet>

Sauter des étapes

  • --skip-build : sauter le build, utiliser directement un APK existant
  • --skip-bugly : sauter l'upload des tables de symboles Bugly
  • --skip-git : sauter la création du tag Git
  • --skip-check : sauter la pré-vérification

Processus automatisé

ÉtapeScriptDescription
Étape 0 Pré-vérificationpre_check.pyVérifier que la configuration de signature release est signingConfigs.release + que le versionCode local est > versionCode en ligne
Étape 1 Build./gradlew clean assembleReleaseLocaliser app-arm64-v8a-release.apk (upload uniquement du package 64 bits)
Étape 1.5 Buglyupload_bugly_symbol.pyUploader mapping.txt (non bloquant, l'échec n'affecte pas la soumission)
Étape 2 Soumission multi-canaux*_submit.py par canalUploader séquentiellement vers les canaux configurés, avec verrou de sécurité indépendant
Étape 3 Tag Gitgit_tag.pyUne fois tout réussi, fusionner dans master + créer le tag de version + pousser

Canaux supportés

CanalIdentifiantMéthode de signaturedry-runLimite API
Tencent MyAppyybHmacSHA256Supporté100 uploads/jour, 50 mises à jour/jour
Xiaomi App StorexiaomiRSA (certificat X.509)Non supporté (upload = soumission)Aucune
Huawei AppGalleryhuaweiOAuth2 (API Client)Non supportéAucune
OPPO App MarketoppoHmacSHA256Non supporté50 requêtes/jour/API
vivo App StorevivoHmacSHA256Non supporté50 requêtes/jour/API

Tous les canaux supportent le texte de mise à jour en chinois, passé via --update-desc. Huawei définit en plus le champ newFeatures visible par l'utilisateur.

Verrou de sécurité

La soumission est une opération en production, elle doit satisfaire simultanément :

  • L'option --i-know-this-submits-to-production dans la ligne de commande
  • La variable d'environnement PUBLISH_CONFIRM_SUBMIT=YES (multi-canaux) ou la variable correspondante par canal

build_and_submit.py définit automatiquement les variables d'environnement pour chaque sous-processus lors de --confirm, il suffit donc de définir PUBLISH_CONFIRM_SUBMIT=YES.

Particularités de chaque canal

  • Tencent MyApp : upload et soumission séparés, supporte le dry-run. Limite de 100 uploads/jour, 50 mises à jour/jour.
  • Xiaomi : upload = soumission, mise à jour avec APK + updateDesc uniquement. Pas de limite API.
  • Huawei : Token → upload OBS → mise à jour des informations de fichier → mise à jour des informations linguistiques (texte de mise à jour) → attendre 2 minutes → soumettre. Les identifiants sont valides au niveau de l'équipe pour toutes les applications.
  • OPPO : l'API de publication a de nombreux champs, mais ils sont automatiquement réutilisés à partir des valeurs existantes lors de la requête. Limite de 50 requêtes/jour/API.
  • vivo : l'upload APK renvoie un numéro de flux + versionCode, l'API de mise à jour a peu de champs obligatoires. Limite de 50 requêtes/jour/API.

Prérequis

  1. Chaque marché d'applications doit avoir l'application inscrite et publiée avec succès
  2. Le répertoire racine du projet doit contenir .publish_env (dans .gitignore), avec les identifiants de chaque canal
  3. Le fichier de clé publique Xiaomi (certificat) doit se trouver à la racine du projet et avoir été ajouté à .gitignore
  4. La machine locale doit avoir Python 3.8+, requests, pycryptodome, cryptography
  5. Le répertoire racine du projet doit contenir gradlew avec Java / Android SDK configurés

Opération par canal

Chaque canal supporte les requêtes indépendantes et la soumission. Voir README.md pour plus de détails.

Tables de symboles Bugly

Après le build, mapping.txt est automatiquement uploadé vers Bugly (non bloquant), garantissant que les traces de crash en production peuvent être désobfusquées. L'outil jar est intégré dans le répertoire tools/ du skill, les identifiants sont lus depuis .publish_env (BUGLY_APP_ID / BUGLY_APP_KEY).

Skills associés