Checklist de configuration initiale
Copiez un prompt de configuration incluant les étapes d'installation et le guide markdown complet pour ce plugin.
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”-
Créer des canaux: choisissez le plus petit ensemble adapté (voir ci-dessous).
-
Définir le canal d’upload par défaut dans paramètres de l’app:
- App solo →
production - Équipe →
development
- App solo →
-
Canal de production : public on, device self-set off, block updates under native on, auto-update guard on
major. -
Canal de test (
development/staging): public off, device self-set on for QA. -
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}" \--deltaLe
--bundlevaleur devez soit valide versionnage sémantique. Validez-le dans le testeur SemVer avant l’upload. -
Déployer en production uniquement après les tests, depuis le dashboard ou CLI.
-
É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.
Choisissez votre taille
Section intitulée « Choisissez votre taille »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.
Nom du bundle vs commentaire
Section intitulée « Nom du bundle vs commentaire »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, ou1.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.
Upload delta
Section intitulée « Upload delta »--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) »npx @capgo/cli@latest bundle upload \ --channel development \ --bundle "1.8.0-${BUILD_NUMBER}" \ --deltaC'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é.
Économie de stockage : --delta-only
Section intitulée « Économie de stockage : --delta-only »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-onlyUtiliser --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.
Flux de travail quotidien
Section intitulée « Flux de travail quotidien »Upload to development (--delta) → test → deploy to production → don't touch channel settings againErreurs courantes
Section intitulée « Erreurs courantes »| Erreur | Corriger |
|---|---|
| Attendre une OTA avant une nouvelle release sur les stores | Recompiler et déployer l'app native après l'ajout du plugin |
| Envoyer un bundle sans le déployer sur un canal | Associer le bundle à un canal (p. ex. production) |
| Un canal par fonctionnalité, ticket ou développeur | Utiliser uniquement des canaux de release permanents |
| Noms de canaux CI dynamiques | Noms fixes : development, production |
| Trop de canaux pour une app simple | Commencer avec 1-2 canaux |
| Auto-défini sur l’appareil en production | Désactivé en production, activé sur les canaux de test |
Passé --delta | Ajoutez --delta aux uploads ; utilisez --delta-only uniquement si vous devez économiser de l’espace |
| Noms de bundle non semver | Respectez le versionnage sémantique et validez dans le testeur SemVer |
| Changer le schéma de versionnage au fil du temps | Keep semver; use pre-release labels for extra builds (1.8.0-20260629.1) |
| Métadonnées / aperçu activés sans raison | Dé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é.