Démarrage rapide

Ce guide mène une app de zéro à une build en production. Dans les exemples, https://<domaine-de-l-app> est l’adresse de votre instance Releo et <app-id> l’identifiant d’une app.

1. Créer votre compte

Sur Releo Cloud, ouvrez https://<domaine-de-l-app>/signup, saisissez votre nom, votre email et un mot de passe, puis confirmez votre email avec le lien reçu. Votre compte arrive avec sa propre organisation, sur l’offre Free.

Note

Auto-hébergement ? Le premier compte créé sur une nouvelle instance en devient l’administrateur.

2. Connecter les stores

Releo dialogue avec les stores grâce à des identifiants que vous créez dans vos comptes Apple et Google. Vous les enregistrez une fois dans Administration → Accès stores ; ils sont chiffrés et ne sont plus jamais affichés. Les mêmes étapes sont intégrées aux fenêtres d’ajout de l’application web.

Clé API App Store Connect

1. Ouvrez App Store Connect → Utilisateurs et accès → Intégrations → API App Store Connect, onglet Clés d’équipe. La première fois, le détenteur du compte doit cliquer sur Demander l’accès.

2. Cliquez sur + (Générer une clé API), nommez-la Releo et choisissez l’accès Gestionnaire d’apps (nécessaire pour envoyer des builds, gérer TestFlight et soumettre à la review).

3. Téléchargez le fichier AuthKey_XXXXXXXXXX.p8. Apple ne permet de le télécharger qu’une seule fois.

4. Dans Releo, ajoutez une clé API App Store Connect : reportez le Key ID (ligne de la clé) et l’Issuer ID (affiché au-dessus du tableau des clés), puis choisissez le fichier .p8.

Les clés individuelles (Utilisateurs et accès → votre profil) fonctionnent aussi : choisissez « Individuelle », il n’y a pas d’Issuer ID.

Compte de service Google Play

1. Dans la console Google Cloud, choisissez ou créez un projet, puis activez l’API Google Play Android Developer.

2. Allez dans IAM et administration → Comptes de service → Créer un compte de service (nom : releo). Aucun rôle Google Cloud n’est nécessaire.

3. Ouvrez le compte → Clés → Ajouter une clé → Créer une clé → JSON. Gardez le fichier téléchargé.

4. Dans Play Console → Utilisateurs et autorisations, Invitez un utilisateur avec l’email du compte de service (…@….iam.gserviceaccount.com). Dans Autorisations des applications, ajoutez vos apps avec :

   • Publier en production, exclure des appareils et utiliser la signature d’application Play
   • Publier des applications sur des canaux de test
   • Gérer les canaux de test et modifier les listes de testeurs

   Envoyez l’invitation.

5. Dans Releo, ajoutez un compte de service Google Play et collez le contenu de la clé JSON (ou choisissez le fichier).

Cliquez sur Tester pour chaque identifiant : pour Apple, Releo liste les apps visibles par la clé ; pour Google, il vérifie la clé, puis son accès à chaque app associée. Les changements d’autorisations dans Play Console peuvent mettre quelques minutes à s’appliquer.

3. Ajouter l’app

Dans Apps → Nouvelle application, activez iOS, Android ou les deux :

• iOS : le Bundle identifier, l’ID App Store Connect (l’identifiant Apple numérique visible dans App Store Connect → votre app → Informations sur l’app) et la clé API App Store Connect.
• Android : le Package name (applicationId) et le compte de service.

Les autres réglages sont facultatifs et peuvent attendre : groupes TestFlight, langues des notes de version, fournisseurs LLM et Git pour les notes générées, membres.

Attention

La toute première build d’une app Android doit être envoyée à la main dans Play Console : l’API Google Play ne peut pas publier une app qui n’a jamais eu de release.

4. Envoyer une première build

Releo retrouve l’app à partir du bundle ID ou du package contenu dans le binaire. Choisissez la méthode qui vous convient :

Web

Ouvrez l’app et déposez le .ipa ou le .aab dans la zone d’envoi (ou cliquez dessus pour parcourir). La build apparaît aussitôt dans la liste.

CLI

La CLI releo s’installe depuis une copie du dépôt Releo (Node 22.12+ et pnpm) :

git clone https://<git-host>/<owner>/<repository>.git && cd <repository>
pnpm install && pnpm --filter @releo/cli build
npm install -g ./apps/cli

Connectez-vous une fois : la commande ouvre le navigateur, où vous vérifiez le code et autorisez la CLI.

releo login --url https://<domaine-de-l-app>

Puis envoyez, par exemple après un build Flutter :

flutter build ipa
releo builds create --file build/ios/ipa/*.ipa --commit "$(git rev-parse HEAD)"

flutter build appbundle
releo builds create --file build/app/outputs/bundle/release/app-release.aab --commit "$(git rev-parse HEAD)"

CI

Créez une clé d’API dans Mes paramètres → Clés API avec la portée Envoyer des builds (ajoutez Promouvoir des builds pour promouvoir aussi depuis la CI). Placez l’adresse de l’instance dans une variable RELEO_URL et la clé dans un secret RELEO_TOKEN. Avec GitHub Actions :

- name: Ship to TestFlight
  run: |
    curl --fail-with-body -X POST "${{ vars.RELEO_URL }}/api/v1/builds" \
      -H "Authorization: Bearer ${{ secrets.RELEO_TOKEN }}" \
      -F commit="${{ github.sha }}" \
      -F file=@build/ios/ipa/App.ipa

La CLI lit aussi RELEO_URL et RELEO_TOKEN : en CI, aucune connexion n’est nécessaire.

Envoyez le commit exact que vous avez buildé (--commit ou -F commit=) : Releo s’en sert pour lister les commits des notes de version.

5. Suivre et promouvoir la build

Une build passe par uploaded → pushing → processing (iOS, pendant le traitement d’Apple) → testing. Elle est alors sur TestFlight ou sur le canal interne de Google Play, avec ses notes pour les testeurs. En cas d’échec, la build affiche l’erreur et peut être relancée.

Une fois en testing, promouvez-la avec Promouvoir en production sur la page de la build, ou depuis la CLI :

id=$(releo builds create --file build/ios/ipa/*.ipa --commit "$(git rev-parse HEAD)" | jq -r .id)
releo builds get "$id" | jq -r .status                         # testing

releo builds promote "$id" --release-mode manual              # iOS : soumission à la review (ou after_approval)
releo builds release "$id"                                    # iOS en mode manuel, une fois validée par Apple
releo builds promote "$id" --track production --rollout 0.2   # Android : déploiement progressif à 20 %

• iOS : Releo crée la version App Store, y associe la build, renseigne « Nouveautés » dans chaque langue et la soumet à la review. En mode manual, publiez-la avec Publier maintenant une fois validée par Apple ; avec after_approval, Apple la publie automatiquement.
• Android : la build passe du canal interne à la production avec le déploiement choisi. Google l’examine ensuite ; suivez sa publication dans Play Console.

Pour les apps sur les deux plateformes, Publier iOS + Android sur la page de l’app promeut une build de chaque avec des notes de version rédigées une seule fois.

Pour aller plus loin

• Notes de version générées : ajoutez un fournisseur LLM et un fournisseur Git dans Administration, puis choisissez-les dans les paramètres de l’app.
• Pages publiques, rôles, authentification unique et la référence complète de l’API et de la CLI : voir la documentation interactive de l’API sur https://<domaine-de-l-app>/docs.