Google Play Console Deployment Patterns

Tout ce qu'il faut savoir pour publier une app Android via Google Play Console.

1. Prérequis

• Google Play Console account — $25 one-time — https://play.google.com/console
• Android app avec applicationId unique (ex. com.atum.myapp)
• AAB (Android App Bundle) — obligatoire depuis août 2021 pour nouvelles apps
• Signing keystore (upload key + app signing key)
• Icon, feature graphic, screenshots pour les tailles requises

2. App creation

Play Console → All apps → Create app

• App name (50 chars max)
• Default language
• App or Game
• Free or Paid
• Declarations (policies, terms)

3. Store listing

Graphics (requis)

• Icon : 512x512 PNG (32-bit avec alpha)
• Feature graphic : 1024x500 JPG/PNG (affiché en haut de la fiche)
• Phone screenshots : min 2, max 8 — tailles 16:9 minimum 320 px de côté court
• Tablet screenshots : si l'app supporte tablet — min 1, max 8
• TV screenshots : si Android TV
• Wear OS screenshots : si Wear OS

Textes

• Short description (80 chars)
• Full description (4000 chars)
• Title (30 chars)

Video (optionnel)

• URL YouTube d'un trailer

4. Signing — Play App Signing (OBLIGATOIRE pour nouvelles apps)

Concepts

• Upload key — clé que tu utilises pour signer les AAB avant upload
• App signing key — clé que Google utilise pour signer les APK livrés aux users

Google gère l'app signing key pour toi via Play App Signing. Tu n'as qu'à gérer l'upload key.

Setup

1. Générer une upload key :

keytool -genkey -v -keystore upload-keystore.jks -keyalg RSA \
  -keysize 2048 -validity 10000 -alias upload

2. Configurer android/app/build.gradle :

android {
    signingConfigs {
        release {
            storeFile file(System.getenv("UPLOAD_KEYSTORE_PATH"))
            storePassword System.getenv("UPLOAD_KEYSTORE_PASSWORD")
            keyAlias System.getenv("UPLOAD_KEY_ALIAS")
            keyPassword System.getenv("UPLOAD_KEY_PASSWORD")
        }
    }
    buildTypes {
        release {
            signingConfig signingConfigs.release
        }
    }
}

3. Uploader le premier AAB → Play Console demande d'opt-in à Play App Signing → accepter

Backup critique : l'upload key doit être sauvegardé. Si perdu, Google peut aider à la régénérer (contrairement au signing key pré-Play App Signing qui était irréversible).

5. Release tracks

Play Console propose 4 tracks :

Track	Audience	Review
Internal testing	100 testers internes max	Pas de review
Closed testing (alpha / beta)	Groupes fermés ou liste d'emails	Review ~1-2 jours
Open testing	Public ouvert (opt-in via Play Store)	Review ~2-4 jours
Production	Tous les users	Review 1-7 jours

Workflow recommandé

1. Internal testing → QA interne
2. Closed alpha → beta fermée avec 10-50 users
3. Open testing → beta ouverte
4. Production → lancement

Chaque track a son propre historique de releases, mais l'upload de version s'incrémente globalement.

6. Create a new release

Play Console → App → Release → (select track) → Create new release

• App bundles — upload le .aab (EAS Submit ou manual)
• Release name — auto ou custom (ex. 1.0.0 (42))
• Release notes par langue (max 500 chars par langue)
• Review release → Start rollout

7. Staged rollout (production)

Pour une release production :

• % of users : commencer à 10 % pendant 24-48h
• Monitorer les crashes via Play Console → Statistics → Android Vitals
• Si OK → 50 % puis 100 %
• Si crashes → halt rollout et publier un hotfix

8. Content Rating

Play Console → App → Policy → App content

Répondre au questionnaire IARC :

• Violence
• Fear / Horror
• Sex
• Nudity
• Language
• Controlled substance
• Gambling
• User-generated content

L'age rating est généré automatiquement selon les réponses. Répondre honnêtement — contenu sensible non déclaré = suspension de l'app.

9. Data Safety section (OBLIGATOIRE depuis 2022)

Déclarer toutes les données collectées/partagées. Similaire au App Privacy Details d'Apple.

Sections :

• Data collection (Yes/No)
• Data encryption in transit
• Data can be requested for deletion
• Data types collected — location, personal info, financial, health, messages, photos/videos, audio, files, calendar, contacts, device identifiers, etc.
• For each type : collected or shared, required or optional, purpose

Tolérance zéro : Google scanne les SDKs et compare aux déclarations. Incohérence = suspension immédiate.

10. Target Audience and Content

• Target age group (required pour 2024+) — 5 and under / 6-8 / 9-12 / 13-15 / 16-17 / 18+
• Families Program opt-in si ciblage enfants
• Ads — l'app contient-elle des pubs ?

11. App access

• App is not accessible without login → fournir credentials de test à Google pour la review
• Inclure username + password dans "Testing instructions"

12. Play Console API + GitHub Actions

# Créer un Service Account dans Google Cloud Console
# Assigner "Release Manager" dans Play Console → Users and permissions
# Télécharger le JSON key

# Avec EAS
eas submit --profile production --platform android --latest

Fastlane supply

# fastlane/Fastfile
lane :play_production do
  upload_to_play_store(
    json_key: "fastlane/play-console-key.json",
    package_name: "com.atum.myapp",
    aab: "android/app/build/outputs/bundle/release/app-release.aab",
    track: "production",
    release_status: "draft", # ou completed pour auto-release
    rollout: "0.1" # 10 % staged
  )
end

GitHub Actions

# .github/workflows/play-store.yml
name: Play Store Release

on:
  push:
    tags: ['v*']

jobs:
  release:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Setup
        uses: actions/setup-node@v4
        with: { node-version: '20' }
      - run: npm install -g eas-cli
      - run: pnpm install
      - name: Build AAB
        run: eas build --profile production --platform android --non-interactive
        env:
          EXPO_TOKEN: ${{ secrets.EXPO_TOKEN }}
      - name: Submit to Play Store
        run: eas submit --profile production --platform android --latest --non-interactive
        env:
          EXPO_TOKEN: ${{ secrets.EXPO_TOKEN }}

13. Google Play Billing (IAP)

Pour les apps avec IAP :

1. Play Console → Monetize → Products → In-app products ou Subscriptions
2. Types :
   • Managed products (one-time purchases, consumables, non-consumables)
   • Subscriptions (auto-renewing avec base plans + offers)
3. Implémenter com.android.billingclient:billing (Java/Kotlin) ou un wrapper React Native
4. Test avec License testers (Play Console → Setup → License testing)

Commission : 15 % sur les subscriptions après 12 mois ou < $1M/an, 30 % standard.

Anti-patterns

1. Upload APK au lieu de AAB — refusé pour nouvelles apps depuis 2021
2. Perte du upload key → contact support, délai de récupération
3. Signing manuel sans Play App Signing → inflexibilité si key compromise
4. Data Safety non alignée avec les SDKs → suspension auto
5. Version code non incrémenté → upload refusé
6. Rollout 100 % direct sans staged → risque de crash massif
7. Soumission open testing trop tôt → bad ratings avant le launch prod
8. IAP pour digital content non déclaré → viol des terms, suspension
9. APIs dépréciées (target SDK trop bas) → refus de publication

Checklist pré-submission

• applicationId unique et final
• versionCode + versionName incrémentés
• AAB signé avec upload key
• Play App Signing activé
• Icon 512x512 + feature graphic 1024x500
• Screenshots phone + tablet + TV + Wear OS si applicable
• Short + Full description par langue
• Privacy Policy URL publique
• Content rating IARC complété
• Data safety section complétée
• Target audience défini
• App access credentials de test si login requis
• Internal testing validé
• Closed or open testing selon le workflow
• Crash-free rate Android Vitals > 99.5 %
• Target SDK à jour (API 34 ou supérieur en 2025)

Quand déléguer

• Build Android → skill deploy-eas (dans ce plugin)
• App Store iOS → skill deploy-app-store (dans ce plugin)
• Kotlin spécifique → kotlin-expert d'atum-stack-mobile
• Flutter → flutter-dart-expert d'atum-stack-mobile

Ressources

• https://play.google.com/console
• https://developer.android.com/distribute/best-practices/launch/launch-checklist
• https://support.google.com/googleplay/android-developer/answer/9859152 (Data Safety)
• https://docs.fastlane.tools/actions/supply/