Aller au contenu

Checklist de configuration initiale

Vous avez terminé onboarding. Configurez maintenant Capgo une fois. Ensuite, le quotidien se résume à upload → test → déployer.

Règle : les canaux sont des voies de release (development, production), not tickets, features, or developer names.


Checklist de configuration initiale

Section titled “One time setup checklist”
  1. Créer des canaux: choisissez le plus petit ensemble adapté (voir ci-dessous).

  2. Définir le canal d’upload par défaut dans paramètres de l’app:

    • App solo → production
    • Équipe → development
  3. Canal de production : public on, device self-set off, block updates under native on, auto-update guard on major.

  4. Canal de test (development / staging): public off, device self-set on for QA.

  5. Envoyez depuis votre CI par --delta (le checksum et les dépendances natives sont automatiques) :

    Fenêtre de terminal
    npx @capgo/cli@latest bundle upload \
    --channel development \
    --bundle "1.8.0-${BUILD_NUMBER}" \
    --comment "commit ${GIT_SHA:0:7} run ${CI_RUN_ID}" \
    --delta

    Le --bundle valeur devez soit valide versionnage sémantique. Validez-le dans le testeur SemVer avant l’upload.

  6. Déployer en production uniquement après les tests, depuis le dashboard ou CLI.

  7. Équipe et sécurité : invitez une seule fois, permissions minimales, 2FA pour l’organisation, une clé API en CI.

Laissez le chiffrement, min_update_version, les métadonnées et l’aperçu désactivés sauf si vous avez une raison valable.


Simple: 1 app, 1 canal : production

Équipe: development + production. Upload vers dev, déploiement vers prod.

Versions natives: ajoutez des canaux uniquement si nécessaire, par ex. production-9.0 + test-9.0. Gardez les utilisateurs du store sur le canal de production principal.

Beaucoup d'apps: même modèle simple par app (généralement un production par app). Ne créez pas de canaux supplémentaires juste parce que l’organisation est grande.

Train de release (facultatif) : staging → rc → production. Même template sur chaque app qui en a besoin.


Les noms de bundle sont requis à suivre versionnage sémantique. Capgo utilise semver pour les vérifications de compatibilité, les règles de mise à jour automatique des canaux et les rollbacks. Validez chaque nom dans testeur SemVer avant l'upload.

  • Nom = semver depuis la CI, par ex. 1.8.0, 1.8.0-beta.1, ou 1.8.0-20260629.42
  • Commentaire = texte libre pour les humains → commit abc1234 run 28059070270

Utiliser semver pré-release labels (la partie qui suit -) lorsque vous déployez de nombreux builds sous le même MAJOR.MINOR.PATCH. Par exemple, conservez 1.8.0 et ajoutez la date ou le compteur de build dans la pré-release : 1.8.0-20260629.1, 1.8.0-beta.2. N’inventez pas de formats personnalisés comme fix-login-bug ou 2.5.2026062306. Ils ne sont pas des semver valides et les uploads échoueront ou se comporteront de manière imprévisible.

Placez les notes de version dans --comment, et non dans le nom du bundle.

Voir aussi ciblage de version et versioning des bundles.


--delta uploads fichiers delta afin que les appareils téléchargent uniquement les fichiers modifiés au lieu du bundle complet à chaque fois. Le checksum est toujours calculé automatiquement. Vous n'avez pas à passer de flag checksum.

Par défaut : --delta (fichiers delta + sauvegarde zip)

Section intitulée « Par défaut : --delta (fichiers delta + sauvegarde zip) »
Fenêtre de terminal
npx @capgo/cli@latest bundle upload \
--channel development \
--bundle "1.8.0-${BUILD_NUMBER}" \
--delta

C'est le choix par défaut recommandé pour la plupart des apps. Capgo stocke les fichiers delta et conserve le zip complet en sauvegarde. Les appareils avec une ancienne version du plugin sans support Delta utilisent le zip. Idéal si le coût de stockage n’est pas votre priorité.

Fenêtre de terminal
npx @capgo/cli@latest bundle upload \
--channel development \
--bundle "1.8.0-${BUILD_NUMBER}" \
--comment "commit ${GIT_SHA:0:7} run ${CI_RUN_ID}" \
--delta-only

Utiliser --delta-only lorsque vous souhaitez réduire le stockage Capgo. Seuls les fichiers delta sont stockés, pas le zip complet. À privilégier pour les grandes applications ou les volumes d’upload élevés où le stockage devient significatif.

Compromis : sans sauvegarde zip sur le serveur, vous dépendez entièrement des fichiers delta, et les appareils avec une ancienne version du plugin sans support Delta ne peuvent pas se mettre à jour. Évitez --delta-only sauf si vous avez réellement besoin des gains de stockage.

Aucune configuration de plugin supplémentaire n’est requise sur l’appareil. Le lecteur de l’updater lit la liste des fichiers delta et ne récupère que les fichiers modifiés.


Upload to development (--delta)
→ test
→ deploy to production
→ don't touch channel settings again

ErreurCorriger
Attendre une OTA avant une nouvelle release sur les storesRecompiler et déployer l'app native après l'ajout du plugin
Envoyer un bundle sans le déployer sur un canalAssocier le bundle à un canal (p. ex. production)
Un canal par fonctionnalité, ticket ou développeurUtiliser uniquement des canaux de release permanents
Noms de canaux CI dynamiquesNoms fixes : development, production
Trop de canaux pour une app simpleCommencer avec 1-2 canaux
Auto-défini sur l’appareil en productionDésactivé en production, activé sur les canaux de test
Passé --deltaAjoutez --delta aux uploads ; utilisez --delta-only uniquement si vous devez économiser de l’espace
Noms de bundle non semverRespectez le versionnage sémantique et validez dans le testeur SemVer
Changer le schéma de versionnage au fil du tempsKeep semver; use pre-release labels for extra builds (1.8.0-20260629.1)
Métadonnées / aperçu activés sans raisonDésactivé par défaut
Message « Nouvelle version disponible » lors d’une installation fraîcheÀ ignorer lorsque current() renvoie bundle.id === "builtin" (voir ci-dessous)

Revue App Store : aucun message de mise à jour lors d’une installation neuve

Section intitulée « Révision App Store : aucun message de mise à jour lors d’une installation neuve »

Apple accepte les applications utilisant Capgo. Les reviewers rejettent l’interface associée : un message « nouvelle version disponible » ou « mise à jour en cours » affiché au premier lancement.

Cela concerne surtout les configurations auto-hébergées et manuelles, où votre application effectue sa propre vérification de version et affiche son propre prompt.

Le reviewer installe votre binaire store. Il est plus ancien que votre dernier bundle, donc la première vérification détecte immédiatement un bundle : votre appel serveur le renvoie, ou l’updater le trouve et émet updateAvailable. Si votre application affiche un message, le relecteur le verra.

Juste après une installation fraîche ou une mise à jour native du store, l’application exécute le bundle livré et current() renvoie bundle.id === "builtin". Ignorez votre message dans ce cas :

import { CapacitorUpdater } from '@capgo/capacitor-updater'
const { bundle } = await CapacitorUpdater.current()
if (bundle.id !== 'builtin') {
showNewVersionMessage()
}

Dans toute interface visible, évitez les mots « mise à jour », « live update », « OTA », « téléchargement » et « installation ». Voir conformité.