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.) :
- 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
- 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> - Surveiller la sortie : le script effectue automatiquement toutes les étapes (pré-vérification → build → Bugly → soumission multi-canaux → tag Git), sans intervention humaine
- Rapporter les résultats : résumer l'état de succès/échec de chaque canal à l'utilisateur
- 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é
| Étape | Script | Description |
|---|---|---|
| Étape 0 Pré-vérification | pre_check.py | Vérifier que la configuration de signature release est signingConfigs.release + que le versionCode local est > versionCode en ligne |
| Étape 1 Build | ./gradlew clean assembleRelease | Localiser app-arm64-v8a-release.apk (upload uniquement du package 64 bits) |
| Étape 1.5 Bugly | upload_bugly_symbol.py | Uploader mapping.txt (non bloquant, l'échec n'affecte pas la soumission) |
| Étape 2 Soumission multi-canaux | *_submit.py par canal | Uploader séquentiellement vers les canaux configurés, avec verrou de sécurité indépendant |
| Étape 3 Tag Git | git_tag.py | Une fois tout réussi, fusionner dans master + créer le tag de version + pousser |
Canaux supportés
| Canal | Identifiant | Méthode de signature | dry-run | Limite API |
|---|---|---|---|---|
| Tencent MyApp | yyb | HmacSHA256 | Supporté | 100 uploads/jour, 50 mises à jour/jour |
| Xiaomi App Store | xiaomi | RSA (certificat X.509) | Non supporté (upload = soumission) | Aucune |
| Huawei AppGallery | huawei | OAuth2 (API Client) | Non supporté | Aucune |
| OPPO App Market | oppo | HmacSHA256 | Non supporté | 50 requêtes/jour/API |
| vivo App Store | vivo | HmacSHA256 | Non 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-productiondans 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
- Chaque marché d'applications doit avoir l'application inscrite et publiée avec succès
- Le répertoire racine du projet doit contenir
.publish_env(dans.gitignore), avec les identifiants de chaque canal - Le fichier de clé publique Xiaomi (certificat) doit se trouver à la racine du projet et avoir été ajouté à
.gitignore - La machine locale doit avoir Python 3.8+,
requests,pycryptodome,cryptography - Le répertoire racine du projet doit contenir
gradlewavec 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).