📦 bundle

📦 Gérez les bundles d'application pour le déploiement dans Capgo Cloud, y compris l'upload, les contrôles de compatibilité et le chiffrement.

⬆️ Envoyer

Alias : u

npx @capgo/cli@latest bundle upload

⬆️ Envoie un nouveau bundle d’application vers Capgo Cloud pour distribution. La version doit être > 0.0.0 et unique. Les versions supprimées ne peuvent pas être réutilisées pour des raisons de sécurité. Option externe : stocke uniquement un lien URL (utile pour les apps > 200 Mo ou les exigences de confidentialité). Capgo n’inspecte jamais le contenu externe. Ajoutez un chiffrement pour une sécurité sans confiance.

Exemple :

npx @capgo/cli@latest bundle upload com.example.app --path ./dist --channel production,beta

Augmente automatiquement la prochaine version semver disponible du canal (ou de la dernière version d’application distante) si vous ne passez pas --bundle. Utile en CI lorsque package.json correspond déjà à une version que Capgo possède :

npx @capgo/cli@latest bundle upload --channel=production --auto-bump
npx @capgo/cli@latest bundle upload --auto-bump major
npx @capgo/cli@latest bundle upload --auto-bump minor   # default when the flag has no value
npx @capgo/cli@latest bundle upload --auto-bump patch   # alias: fix
npx @capgo/cli@latest bundle upload --auto-bump metadata
npx @capgo/cli@latest bundle upload --channel=production --auto-bump ai

Avec --auto-bump ai, Capgo Cloudflare Workers AI compare les fichiers de bundle locaux au manifeste de delta de la version précédente Capgo/canal et déduit major | minor | patch | metadata, et affiche une brève raison dans le journal CLI. Si aucune version précédente de Capgo n'existe, l'IA est ignorée et l'incrément passe par défaut à patch.

Options :

Paramètre	Type	Description
-a	string	Clé API pour lier votre compte
-p	string	Chemin du dossier à envoyer ; s'il n'est pas fourni, le webDir défini dans capacitor.config sera utilisé
-c	string	Canal à lier. Utilisez des virgules pour plusieurs canaux, par exemple production,beta
—rollout	string	Définir le bundle uploadé comme cible de rollout pour ce canal, avec un pourcentage de 0 à 100
—stable	boolean	Sur un canal avec déploiement progressif, remplacez le fallback stable au lieu de définir la cible du déploiement
—rollout-percentage-bps	string	Définir le pourcentage de rollout du bundle uploadé en points de base, de 0 à 10000
—rollout-cache-ttl-seconds	string	TTL en secondes du cache de décision de rollout Cloudflare
-e	string	Lien vers une URL externe au lieu d'un upload vers Capgo Cloud
—iv-session-key	string	Définir la clé IV et la clé de session pour l'URL externe du bundle
—s3-region	string	Région de votre bucket S3
—s3-apikey	string	Clé API pour votre endpoint S3
—s3-apisecret	string	Secret API pour votre endpoint S3
—s3-endpoint	string	URL de l'endpoint S3
—s3-bucket-name	string	Nom de votre bucket AWS S3
—s3-port	string	Port de votre endpoint S3
—no-s3-ssl	boolean	Désactiver le SSL pour l'upload S3
—key-v2	string	Chemin personnalisé pour la clé de signature privée (système v2)
—key-data-v2	string	Clé de signature privée (système v2)
—bundle-url	boolean	Affiche l'URL du bundle dans la sortie standard
—no-key	boolean	Ignore signing key and send clear update
—no-code-check	boolean	Ignore la vérification de l'appel à notifyAppReady() dans la source code et l'index présent dans le dossier racine
—display-iv-session	boolean	Afficher dans la console l’IV et la clé de session utilisés pour chiffrer la mise à jour
-b	string	Numéro de version du bundle à envoyer
—auto-bump	string	Incrémenter automatiquement à partir du bundle lié au canal, sinon de la dernière version d’application distante. Niveau : major, minor (par défaut), patch (alias fix), metadata ou ai (Workers IA déduit le niveau à partir du delta entre le manifeste local et le précédent ; repli sur patch si aucune version Capgo précédente). Incrémente jusqu’à trouver un nom libre (les noms supprimés restent occupés). Ne peut pas être combiné avec —bundle (-b)
—link	string	Lien vers une ressource externe (p. ex. release GitHub)
—comment	string	Commentaire sur cette version, peut être une note de release, un hash de commit, un message de commit, etc.
—min-update-version	string	Version minimale requise pour passer à cette version. Utilisé uniquement si disable auto update est défini sur metadata dans le canal
—auto-min-update-version	boolean	Définir la version minimale de mise à jour en fonction des packages natifs
—ignore-metadata-check	boolean	Ignore la vérification des métadonnées (node_modules) lors de l’upload
—fail-on-incompatible	boolean	Échoue l’upload (code de sortie non nul) au lieu de l’envoyer si le bundle est incompatible avec les packages natifs actuels du canal. Dans un terminal interactif, vous pouvez toujours choisir un build natif ; refuser entraîne l’échec. Ne peut pas être combiné avec —ignore-metadata-check.
—ignore-checksum-check	boolean	Ignore la vérification du checksum lors de l’upload
—force-crc32-checksum	boolean	Forcer le checksum CRC32 pour l’upload (remplace la détection automatique)
—timeout	string	Délai d’attente pour le processus d’upload, en secondes
—multipart	boolean	[OBSOLÈTE] Utilisez —tus à la place. Utilise le protocole multipart pour les uploads S3
—zip	boolean	Envoyer le bundle en utilisant zip vers le cloud Capgo (légacy)
—tus	boolean	Envoyer le bundle en utilisant TUS vers le cloud Capgo
—tus-chunk-size	string	Taille des chunks en octets pour les uploads TUS reprenables (défaut : auto)
—partial	boolean	[OBSOLÈTE] Utilisez —delta à la place. Envoie des mises à jour incrémentielles
—partial-only	boolean	[OBSOLÈTE] Utilisez —delta-only à la place. Envoie uniquement des mises à jour incrémentielles, sans bundle complet
—delta	boolean	Envoyer des mises à jour delta (fichiers modifiés uniquement) pour des mises à jour instantanées et ultra-rapides, plutôt que de gros téléchargements zip
—delta-only	boolean	Envoyer uniquement les mises à jour delta sans bundle complet pour une vitesse maximale (utile pour les grandes apps)
—no-delta	boolean	Désactive les mises à jour delta, même si les mises à jour instantanées sont activées
—encrypted-checksum	string	Un checksum chiffré (signature). Utilisé uniquement lors de l'upload d'un bundle externe.
—auto-set-bundle	boolean	Définir le bundle dans capacitor.config.json
—dry-upload	boolean	Simuler l’upload du bundle : ajouter la ligne en base de données sans envoyer les fichiers ni mettre à jour les canaux (utilisé par Capgo pour les tests internes)
—package-json	string	Chemins des fichiers package.json pour les monorepos (séparés par des virgules)
—node-modules	string	Chemins des répertoires node_modules pour les monorepos (séparés par des virgules)
—encrypt-partial	boolean	Chiffre les fichiers de mise à jour delta (activé automatiquement pour updater > 6.14.4)
—delete-linked-bundle-on-upload	boolean	Localiser le bundle actuellement lié au canal vers lequel vous essayez d’uploader, puis le supprimer
—no-brotli-patterns	string	Fichiers à exclure de la compression Brotli (globs séparés par des virgules, ex. «.jpg,.png »)
—disable-brotli	boolean	Désactiver complètement la compression Brotli, même si la version de l’updater le prend en charge
—version-exists-ok	boolean	Quitte avec succès si la version du bundle existe déjà, utile pour les workflows CI/CD avec des monorepos
—self-assign	boolean	Autoriser les appareils à rejoindre automatiquement ce canal (met à jour le paramètre du canal)
—qr-preview	boolean	Afficher un QR code dans le terminal pour l’aperçu de ce bundle après l’upload
—send-update-notification	boolean	Envoyer une notification native de vérification de mise à jour aux appareils après la mise à jour des bundles du canal lié
—supa-host	string	URL d'hôte Supabase personnalisée (pour l'auto-hébergement ou le développement Capgo)
—supa-anon	string	Clé anon Supabase personnalisée (pour l'auto-hébergement)
—verbose	boolean	Activer la sortie verbose avec des logs détaillés

🧪 Compatibilité

npx @capgo/cli@latest bundle compatibility

🧪 Vérifiez la compatibilité d'un bundle avec un canal spécifique dans Capgo Cloud pour garantir des mises à jour sûres.

Exemple :

npx @capgo/cli@latest bundle compatibility com.example.app --channel production

Options :

Paramètre	Type	Description
-a	string	Clé API pour lier votre compte
-c	string	Canal pour vérifier la compatibilité
—text	boolean	Afficher du texte au lieu d’emojis
—package-json	string	Chemins des fichiers package.json pour les monorepos (séparés par des virgules)
—node-modules	string	Chemins des répertoires node_modules pour les monorepos (séparés par des virgules)
—supa-host	string	URL d'hôte Supabase personnalisée (pour l'auto-hébergement ou le développement Capgo)
—supa-anon	string	Clé anon Supabase personnalisée (pour l'auto-hébergement)

🔹 ReleaseType

npx @capgo/cli@latest bundle releaseType

🧭 Affiche « native » ou « OTA » selon la compatibilité avec les métadonnées les plus récentes d’un canal.

Exemple :

npx @capgo/cli@latest bundle releaseType com.example.app --channel production

Options :

Paramètre	Type	Description
-a	string	Clé API pour lier votre compte
-c	string	Canal de comparaison
—package-json	string	Chemins des fichiers package.json pour les monorepos (séparés par des virgules)
—node-modules	string	Chemins des répertoires node_modules pour les monorepos (séparés par des virgules)
—supa-host	string	URL d'hôte Supabase personnalisée (pour l'auto-hébergement ou le développement Capgo)
—supa-anon	string	Clé anon Supabase personnalisée (pour l'auto-hébergement)

🗑️ Supprimer

Alias : d

npx @capgo/cli@latest bundle delete

🗑️ Supprimez un bundle spécifique du cloud Capgo, en ciblant éventuellement une seule version.

Exemple :

npx @capgo/cli@latest bundle delete BUNDLE_ID com.example.app

Options :

Paramètre	Type	Description
-a	string	Clé API pour lier votre compte
—supa-host	string	URL d'hôte Supabase personnalisée (pour l'auto-hébergement ou le développement Capgo)
—supa-anon	string	Clé anon Supabase personnalisée (pour l'auto-hébergement)

📋 Liste

Alias : l

npx @capgo/cli@latest bundle list

📋 Liste tous les bundles uploadés pour une application dans Capgo Cloud.

Exemple :

npx @capgo/cli@latest bundle list com.example.app

Options :

Paramètre	Type	Description
-a	string	Clé API pour lier votre compte
—supa-host	string	URL d'hôte Supabase personnalisée (pour l'auto-hébergement ou le développement Capgo)
—supa-anon	string	Clé anon Supabase personnalisée (pour l'auto-hébergement)

🧹 Nettoyage

Alias : c

npx @capgo/cli@latest bundle cleanup

🧹 Supprime les anciens bundles dans Capgo Cloud, en conservant le nombre de versions récentes spécifié. Les bundles liés à des canaux sont conservés, sauf si l’option —ignore-channel est utilisée.

Exemple :

npx @capgo/cli@latest bundle cleanup com.example.app --bundle=1.0 --keep=3

Options :

Paramètre	Type	Description
-b	string	Numéro de version du bundle de l’application à supprimer
-a	string	Clé API pour lier votre compte
-k	string	Nombre de versions à conserver
-f	boolean	Forcer la suppression
—ignore-channel	boolean	Supprimer les bundles même s’ils sont liés à des canaux (ATTENTION : supprime aussi les canaux)
—supa-host	string	URL d'hôte Supabase personnalisée (pour l'auto-hébergement ou le développement Capgo)
—supa-anon	string	Clé anon Supabase personnalisée (pour l'auto-hébergement)

🔒 Chiffrer

npx @capgo/cli@latest bundle encrypt

🔒 Chiffrez un bundle zip pour un stockage externe sécurisé.\nRetourne l’ivSessionKey pour l'upload/déchiffrement. Obtenez le checksum via ‘bundle zip —json’.

Exemple :

npx @capgo/cli@latest bundle encrypt ./myapp.zip CHECKSUM

Options :

Paramètre	Type	Description
—clé	string	Chemin personnalisé pour la clé de signature privée
—key-data	string	Clé de signature privée
-j	boolean	Sortie au format JSON
—package-json	string	Chemins des fichiers package.json pour les monorepos (séparés par des virgules)

🔓 Déchiffrer

npx @capgo/cli@latest bundle decrypt

🔓 Décrypter un bundle chiffré (principalement pour les tests). Affiche la clé de session en base64 pour vérification.

Exemple :

npx @capgo/cli@latest bundle decrypt ./myapp_encrypted.zip CHECKSUM

Options :

Paramètre	Type	Description
—clé	string	Chemin personnalisé pour la clé de signature privée
—key-data	string	Clé de signature privée
—checksum	string	Checksum du bundle, pour vérifier l’intégrité du bundle
—package-json	string	Chemins des fichiers package.json pour les monorepos (séparés par des virgules)

🔹 Zipper

npx @capgo/cli@latest bundle zip

🗜️ Crée un fichier zip de votre bundle. Retourne le checksum pour l’usage avec le chiffrement. Utilisez —json pour une sortie lisible par machine.

Exemple :

npx @capgo/cli@latest bundle zip com.example.app --path ./dist

Options :

Paramètre	Type	Description
-p	string	Chemin du dossier à envoyer ; s'il n'est pas fourni, le webDir défini dans capacitor.config sera utilisé
-b	string	Numéro de version du bundle pour nommer le fichier zip
-n	string	Nom du fichier zip
-j	boolean	Sortie au format JSON
—no-code-check	boolean	Ignore la vérification de l'appel à notifyAppReady() dans la source code et l'index présent dans le dossier racine
—key-v2	boolean	Utiliser le chiffrement v2
—package-json	string	Chemins des fichiers package.json pour les monorepos (séparés par des virgules)