Aller au contenu principal

Publication sur Google Play

L'app Android existe en deux versions construites à chaque mise à jour de main (android-release.yml, release GitHub android-latest) :

FichierPourMises à jour
tandem.apkInstallation depuis le site (Réglages → Application Android)L'app se met à jour elle-même (docs/android.md §4)
tandem-play.aabGoogle Play (build play)Par le Play Store. Pas de mise à jour automatique ni de permission « installer des applications », que Google Play interdit

La version Play est la même que la release (même code, même API, mêmes notifications Firebase). Seule différence : UPDATE_MANIFEST_URL est vide et src/play/AndroidManifest.xml retire REQUEST_INSTALL_PACKAGES et le FileProvider des mises à jour.

1. Quelle piste choisir ?​

  • Test interne (recommandé) : jusqu'à 100 testeurs invités par e-mail, disponible en quelques minutes, sans exigence de test préalable. Idéal pour un foyer : Grace et Nicolas installent l'app depuis le Play Store et reçoivent les mises à jour comme n'importe quelle app.
  • Production (public) : un compte développeur personnel créé après novembre 2023 doit d'abord faire un test fermé avec au moins 12 testeurs pendant 14 jours. Ça n'a d'intérêt que pour ouvrir l'app à d'autres foyers.

2. Clé de signature : garder la compatibilité avec l'APK du site​

Android n'installe une mise à jour que si elle est signée par la même clé. Par défaut, Google Play re-signe l'app avec sa propre clé : la version Play et l'APK du site ne pourraient pas se remplacer (il faudrait désinstaller l'une pour installer l'autre, et perdre les données locales non synchronisées).

Pour passer de l'une à l'autre sans désinstaller, lors de la première publication, choisir dans Configuration → Intégrité de l'application → Signature d'application l'option « Utiliser une clé existante : exporter et importer depuis un keystore Java » et importer agenda.jks (celui du secret ANDROID_KEYSTORE_B64, cf. docs/android.md §4) avec l'outil PEPK fourni par la console. La clé d'importation peut être la même (agenda.jks, alias agenda) : c'est elle qui signe tandem-play.aab dans la CI.

Les numéros de version (versionCode = exécution du workflow + 10) sont communs aux deux versions et toujours croissants.

3. Étapes dans la Play Console​

  1. Compte développeur : play.google.com/console, 25 $ une fois, vérification d'identité (quelques jours).

  2. Créer l'application : nom Tandem, langue par défaut Français – fr-FR, Application, Gratuite. Nom du paquet : app.tandem.foyer (fixé au premier envoi).

  3. Configurer l'application (tableau de bord → Configurer votre application) :

    • Règles de confidentialité : https://tandem-agenda.app/privacy
    • Accès à l'application : Tout ou partie des fonctionnalités sont restreintes → fournir un compte de démonstration (créer un compte demo… sur le site, un foyer et quelques tâches ; identifiants saisis uniquement dans la console, jamais dans le dépôt).
    • Annonces : Non, mon application ne contient pas d'annonces.
    • Classification du contenu : catégorie Tous les autres types d'applications, réponses « non » partout (pas de violence, de contenu généré public, de jeux d'argent…) → PEGI 3.
    • Public cible : 18 ans et plus (évite les exigences « Familles »). L'app n'attire pas les enfants.
    • Application d'actualités, gouvernementale, financière, santé : non.
    • Sécurité des données : voir §4.
    • Suppression de compte : URL https://tandem-agenda.app/privacy (section « Vos droits » : Réglages → Données & confidentialité → Supprimer mon compte). Suppression immédiate ; sauvegardes effacées sous 14 jours (serveur) et 30 jours (hors serveur).
  4. Fiche Play Store (Présence sur le Store → Fiche principale) : copier les textes et images de apps/android/fastlane/metadata/android (fr-FR, puis en-US et nl-NL en traduction, chacune avec ses images) :

    ChampFichierLimite
    Nomtitle.txt30
    Description courteshort_description.txt80
    Description complètefull_description.txt4000
    Icône 512 × 512images/icon.pngPNG 32 bits
    Image de présentation 1024 × 500images/featureGraphic.png
    Captures de téléphone (6)images/phoneScreenshots/*.png1080 × 2160
    Notes de versionchangelogs/default.txt500

    Catégorie : Productivité. Coordonnées : une adresse e-mail de contact (obligatoire, visible publiquement) et le site https://tandem-agenda.app.

  5. Premier envoi (manuel) : Tester → Test interne → Créer une release → importer tandem-play.aab depuis la release GitHub android-latest → notes de version → Enregistrer → Publier. Onglet Testeurs : créer une liste avec les adresses Google de Grace et Nicolas, puis leur envoyer le lien d'inscription : ils acceptent, puis installent depuis le Play Store.

4. Sécurité des données (réponses)​

Votre application collecte-t-elle ou partage-t-elle des données ? Oui. Chiffrées en transit : oui (HTTPS). Les utilisateurs peuvent demander la suppression : oui. Aucune donnée n'est partagée : Firebase et l'hébergeur sont des prestataires, et la publication dans Google Calendar est un transfert demandé par l'utilisateur. Ces deux cas sont exclus de la notion de partage.

Scanner de codes-barres (play-services-code-scanner, ML Kit de Google Play services) : l'image reste sur le téléphone et rien n'est transmis à Tandem, mais Google indique que ML Kit peut envoyer à Google des données de diagnostic (performances, utilisation de l'API). Avant d'envoyer la version, relire la page « Données collectées » de ML Kit dans la documentation de Google et reporter ses réponses dans le formulaire (en général : diagnostics, collectés, non partagés).

Type de donnéesCollectéeFinalitéFacultative
Informations personnelles → Nom (prénom)OuiFonctionnement de l'app, gestion du compteNon
Informations personnelles → Adresse e-mailOuiFonctionnement de l'app, gestion du compte ; communications du développeur (réponse à un signalement, seulement si l'utilisateur l'accepte)Non
Activité dans l'app → Autres contenus générés par l'utilisateur (tâches, notes, listes)OuiFonctionnement de l'appNon
Infos et performances de l'app → Journaux de plantage, DiagnosticsOuiAnalyse (correction des erreurs)Non
Infos et performances de l'app → Autres informations sur les performances (informations techniques d'un signalement : version, Android, modèle, langue, écran)OuiFonctionnement de l'app (assistance)Oui (case décochée par défaut, contenu affiché avant l'envoi)
Messages → Autres messages dans l'app (texte d'un signalement envoyé à l'administrateur)OuiFonctionnement de l'app (assistance)Oui
Identifiants de l'appareil → Autres identifiants (jeton de notification Firebase)OuiFonctionnement de l'app (notifications)Oui
Photos et vidéos → Photos (photo jointe à une tâche, photo de ticket lue ou jointe à une dépense, photo de code-barres lue (effacée aussitôt), capture jointe à un signalement, prise ou choisie par l'utilisateur ; une photo de ticket lue sans être jointe est effacée aussitôt)OuiFonctionnement de l'appOui
Fichiers et documents → Fichiers et documents (pièces jointes)OuiFonctionnement de l'appOui

La capture d'un signalement passe par le sélecteur de photos du système : l'app ne demande aucune permission de stockage ou de galerie.

Non collectés : position, contacts, agenda de l'appareil (l'app ne lit pas le calendrier du téléphone), données financières, santé, historique de navigation, publicité. Les photos et fichiers ne sont jamais lus en arrière-plan : seulement ceux que l'utilisateur joint lui-même.

5. Automatiser les envois suivants (facultatif)​

Avec le secret PLAY_SERVICE_ACCOUNT_JSON, chaque mise à jour de main envoie aussi l'AAB en test interne (android-release.yml, action r0adkll/upload-google-play, notes de version changelogs/default.txt, fichier de désobfuscation R8 inclus) :

  1. Google Cloud Console (projet de votre choix) → IAM → Comptes de service → Créer → onglet Clés → Ajouter une clé → JSON (fichier téléchargé : secret, ne jamais le committer).
  2. Activer l'API Google Play Android Developer API dans ce projet.
  3. Play Console → Utilisateurs et autorisations → Inviter l'adresse du compte de service → application Tandem → droits Publier dans les canaux de test (et Afficher les informations sur l'application).
  4. GitHub → Settings → Secrets and variables → Actions → PLAY_SERVICE_ACCOUNT_JSON = contenu du fichier JSON.

Le premier envoi doit rester manuel (§3.5) : l'API refuse une app qui n'a encore aucune release.

Choisir la piste : par défaut, les envois vont en test interne. Pour envoyer directement chaque nouvelle version à la piste de votre test fermé, créez la variable GitHub Settings → Secrets and variables → Actions → Variables → PLAY_TRACK = alpha. C'est l'identifiant de la piste « Test fermé – Alpha » créée par défaut ; pour une piste fermée personnalisée, mettez son nom exact tel qu'affiché dans la Play Console. Autres valeurs : internal, beta (test ouvert), production. Un lancement manuel du workflow (Actions → Android — APK à installer → Run workflow) permet aussi de choisir la piste pour cet envoi-là.

Une version déjà envoyée en test interne se passe au test fermé sans nouvel envoi : Play Console → Tester → Test interne → la release → Promouvoir la release → Test fermé → Enregistrer → Envoyer pour examen. Les pistes de test fermé passent par l'examen de Google (quelques heures à quelques jours), contrairement au test interne.

6. Mettre à jour la fiche et les captures​

  • Textes : modifier les fichiers fastlane/metadata/android/<langue>/…, puis lancer Actions → « Google Play — mettre à jour la fiche » → Run workflow (case « Envoyer aussi icône, image de présentation et captures » pour les images ; « Vérifier seulement » pour un essai à blanc). Le workflow envoie fr-FR et en-US, et nl-NL quand PLAY_LISTING_NL=true. Sans le secret PLAY_SERVICE_ACCOUNT_JSON, recopier les textes à la main dans la console (format fastlane supply).

  • Notes de version (« Nouveautés », 500 caractères max par langue) : fastlane/metadata/android/<langue>/changelogs/default.txt. À mettre à jour avant chaque envoi : la CI les joint à l'envoi automatique et les recopie sur la page de la release android-latest, au format <fr-FR>…</fr-FR> à coller tel quel dans la Play Console.

  • Néerlandais : une fois la traduction Néerlandais – nl-NL ajoutée à la fiche (Fiche principale → Gérer les traductions), créer la variable de dépôt PLAY_LISTING_NL=true (GitHub → Settings → Secrets and variables → Actions → Variables) : la CI joindra alors aussi les notes nl-NL. Avant, Google Play refuserait l'envoi (langue absente de la fiche).

  • Captures (six : Aujourd'hui, répétition, calendrier, tâches, courses, mode sombre) : rendues depuis les vrais écrans (StoreScreenshotsTest), foyer fictif d'Emma et Tom, données traduites dans chaque langue. Le workflow de la fiche les refait lui-même quand la case des images est cochée (les fichiers du dépôt peuvent donc dater) et les garde dans l'artefact play-captures. Pour les voir avant : étiquette captures sur une PR (artefact android-captures), ou en local :

    cd apps/android
    ./gradlew testDebugUnitTest --tests '*StoreScreenshots*' -Pscreenshots
  • Icône 512 × 512 et image de présentation 1024 × 500 (images/icon.png, images/featureGraphic.png, les trois langues) : générées depuis le symbole (docs/brand/tandem-symbol.svg), identité « Deux fils » (nuit, Instrument Serif). Les textes de la bannière sont dans FEATURE_TEXT du script. Sans marque tierce (pas de « Google » dans les visuels, règle de Google Play).

    node scripts/generate-icons.mjs --play # fiche Play seulement
    node scripts/generate-icons.mjs # toutes les icônes (Android, web, site, doc)

7. Vérifications avant envoi​

  • targetSdk 36, AAB signé avec la clé d'importation (fait par la CI)
  • Pas de REQUEST_INSTALL_PACKAGES dans la version Play (vérifié par le build play)
  • Permission de notification demandée à l'exécution (Android 13+) : oui, dans l'app
  • Politique de confidentialité en ligne et à jour
  • Compte de démonstration valide (connexion possible sans Google)
  • Recette rapide sur téléphone de la version installée depuis le Play Store (docs/android.md §7)

Avertissement attendu, sans conséquence : « Cet App Bundle contient du code natif, et vous n'avez pas importé de symboles de débogage ». Le seul code natif vient de deux bibliothèques AndroidX (libandroidx.graphics.path.so, libdatastore_shared_counter.so), livrées par Google déjà dépouillées de leurs symboles : il n'existe rien à importer (debugSymbolLevel n'y change rien). L'app n'a pas de code natif propre ; ses plantages Kotlin restent lisibles grâce au fichier de correspondance R8, inclus dans chaque AAB (BUNDLE-METADATA).