Liste de vérification une fois

Vous avez terminé Onboarding. Maintenant, configurez Capgo une fois. Après cela, le travail quotidien est uniquement télécharger → tester → déployer.

Lancer une nouvelle mise en production d'un magasin

Installer le plugin Capgo dans votre projet n'est pas suffisant. Mises à jour OTA ne fonctionnent que sur les appareils exécutant une application native qui inclut déjà le plugin.

Après avoir ajouté Capgo et appelé CapacitorUpdater.notifyAppReady():

1. Exécuter npx cap sync
2. Créez un nouveau binaire iOS / Android
3. Soumettre à l'App Store, Play Store, TestFlight ou votre distribution interne

Utilisateurs d'une version de magasin plus ancienne sans le plugin ne recevra jamais les mises à jour en direct. L'envoi de bundles à Capgo n'affecte que les appareils sur un Capgo-activé.

Voir aussi troubleshooting.

Règle : canaux sont des voies de mise à jour ("development, productionpas de billets, de fonctionnalités ou de noms de développeurs.

---

Checklist de configuration unique

1. Créer des canaux: choisissez l'ensemble le plus petit qui convient (voir ci-dessous).

2. Définir le canal de téléchargement par défaut en paramètres de l'application:

   • Application solo → production
   • Équipe → development

3. Canal de production : public, activé, appareil désactivé, bloc des mises à jour natives activé, garde de mise à jour automatique activée major.

4. Canal de test :) (development / staging) public off, appareil allumé par lui-même pour les tests QA.

5. Télécharger à partir de CI avec --delta (checksum et dépendances natives sont automatiques)

   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 doit être valide la versionnement semantique. Validez-le dans le testeur SemVer avant de l'uploader.

6. Déployer en production seulement après avoir testé, à partir de la tableau de bord ou CLI.

7. Équipe et sécurité : inviter une fois, les moins de droits, 2FA pour l'org, une seule clé API dans CI.

Désactiver l'encryption, min_update_version, les métadonnées, et la prévisualisation désactivé sauf si vous avez une raison claire.

---

Choisissez votre taille

Simple: 1 application, 1 canal : production

Équipe: development + productionEnvoyer vers le dev, déployer vers la prod.

Versions natives: add channels only when needed, e.g. production-9.0 + test-9.0. Keep store users on the main production channel.

Many apps: même modèle simple par application (généralement un) production Chaque). N'ajoutez pas de canaux supplémentaires uniquement parce que l'organisation est grande.

Train de lancement (facultatif) : staging → rc → production. Même modèle sur chaque application qui en a besoin.

Attention

N'utilisez pas de canaux nommés d'après des tickets, des personnes ou des variables CI comme ${inputs_capgo_channel}.

---

Nom de bundle vs commentaire

Les noms de bundle sont obligatoires pour suivre la versionnement semantique. Capgo utilise semver pour les vérifications de compatibilité, les règles d'actualisation automatique des canaux et les retours en arrière. Vérifiez chaque nom dans le SemVer tester avant l'envoi.

• Nom = semver à partir de CI, par exemple. 1.8.0, 1.8.0-beta.1, ou 1.8.0-20260629.42
• Commentaire = texte libre pour les humains → commit abc1234 run 28059070270

Utilisez semver pre-release étiquettes (la partie après) -) lorsqu'il y a plusieurs builds sous le même MAJOR.MINOR.PATCHprotectedTokens 1.8.0 et ajoutez la date ou le compteur de build dans la pré-version : 1.8.0-20260629.1, 1.8.0-beta.2Ne créez pas de formats personnalisés comme fix-login-bug ou 2.5.2026062306Ils ne sont pas valides semver et les téléchargements échoueront ou se comporteront de manière imprévisible.

Ajoutez les notes de version --commentla ciblage de version

et la versionnement du bundle and Section intitulée « Upload delta ».

---

Téléversement Delta

--delta téléchargements fichiers delta Ainsi, 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 besoin de passer un flag de checksum.

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

npx @capgo/cli@latest bundle upload \
  --channel development \
  --bundle "1.8.0-${BUILD_NUMBER}" \
  --delta

C'est la recommandation par défaut pour la plupart des applications. Capgo stocke les fichiers delta et keeps the full zip as a backup. Devices on an old plugin version without Delta support use the zip. Good when storage cost is not your main concern.

É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-only

Utiliser --delta-only lorsque vous souhaitez réduire le stockage __CAPGO_KEEP_0__ réduire l'espace de stockage CapgoSeuls les fichiers delta sont stockés, pas le zip complet. Choisissez cette option pour les grandes applications ou un volume d'upload élevé où le stockage s'accumule.

Trade-off: without the zip backup on the server, you rely fully on delta files, and devices on an old plugin version without Delta support cannot update. Skip --delta-only sauf que vous avez besoin effectivement des économies de stockage.

Aucun paramétrage supplémentaire de plugin n'est requis sur le dispositif. L'actualiseur lit la liste des fichiers delta et récupère uniquement les fichiers modifiés.

Note :

Mettez Mises à jour Delta pour le dépannage et directUpdate Mise à jour

---

pour le dépannage et

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

---

Sous-titre « Flux quotidien »

Mistake	Fix
Expecting OTA before a new store release	Reconstruire et envoyer l'application native après avoir ajouté le plugin
Télécharger un bundle mais ne pas déployer sur un canal	Affecter le bundle à un canal (par exemple production)
Un canal par fonctionnalité, ticket ou développeur	Utiliser uniquement les voies de publication permanentes
Noms de canaux CI dynamiques	Noms fixes : development, production
Trop de canaux pour une application simple	Commencer avec 1-2 canaux
Configuration auto-définie du dispositif sur production	Désactivé pour la production, activé pour les canaux de test
Ignorer --delta	Ajoutez --delta à des téléchargements ; utilisez --delta-only only when you need to save storage
Des noms de paquets non-semver	Suisz la versionnement semantique et validez dans le Testeur SemVer
Changer de schéma de versionnement au fil du temps	Keep semver; use pre-release labels for extra builds (1.8.0-20260629.1)
Metadata / prévisualisation activée sans raison	Laissez par défaut

---

En savoir plus

Canaux Défauts, priorité et routage.

Mises à jour delta Pourquoi et comment utiliser --delta.

CD/CI Automatiser l'upload et la mise en ligne.

Fournitures Checksum, dépendances et métadonnées.