📦 bundle

Gérer les dossiers d'application pour le déploiement dans Capgo Cloud, y compris l'upload, les vérifications de compatibilité et l'encryption.

⬆️ Uploader

Alias : u

npx @capgo/cli@latest bundle upload

⬆️ Télécharger un nouvel ensemble d'applications dans le cloud Capgo pour la 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 : Stocker uniquement un lien URL (utile pour les applications >200MB ou les exigences de confidentialité). Capgo ne vérifie jamais le contenu externe. Ajouter l'encryption 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 du canal (ou la dernière version d'application distante) lorsque vous ne passez pas --bundleOutils de CI lorsque package.json est déjà égal à une version Capgo:

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

En utilisant --auto-bump ai, Capgo Cloudflare Workers AI compare les fichiers de bundle locaux avec le delta de manifeste précédent Capgo/canal, infère major | minor | patch | metadataet imprime une brève raison dans le CLI journal. Si aucune version Capgo précédente n'existe, l'IA est ignorée et la mise à jour par défaut est de patch.

Options :

Paramètre	Type	Description
-a	string	clé API pour se connecter à votre compte
-p	string	Chemin du dossier à télécharger, si non fourni, il utilisera le webDir défini dans capacitor.config
-c	string	Canal à lier. Utilisez des virgules pour plusieurs canaux, par exemple production,beta
—rollout	string	Fixer le bundle téléchargé comme cible de lancement de ce canal à un pourcentage de 0 à 100
—stable	boolean	Remplacez la version stable par défaut au lieu de définir la cible de déploiement.
—taux-de-lancement-bps	string	Définir le pourcentage de déploiement du bundle téléchargé en points de base de 0 à 10000
—taux-de-cache-ttl-secondes	string	Cloudflare durée de vie du cache de décision de déploiement en secondes
-e	string	Lier à une URL externe au lieu de télécharger sur Capgo Cloud
—clé-de-session-iv	string	Définissez l'IV et la clé de session pour l'URL de bundle externe
—région-s3	string	Région pour votre bucket S3
—clé-api-s3	string	API clé pour votre point de terminaison S3
—s3-apisecret	string	API secret pour votre point de terminaison S3
—s3-endpoint	string	URL de votre point de terminaison S3
—s3-bucket-name	string	Nom de votre bac S3 AWS
—s3-port	string	Port de votre point de terminaison S3
—no-s3-ssl	boolean	Désactiver SSL pour l'upload S3
—key-v2	string	Chemin personnalisé pour la clé de signature privée (système v2)
—clé-données-v2	string	Clé de signature privée (système v2)
—url-de-bundle	boolean	Affiche l'URL du bundle dans la sortie standard
—sans-clé	boolean	Ignorer la clé de signature et envoyer la mise à jour claire
—no-code-check	boolean	Ignore le contrôle si notifyAppReady() est appelé dans le source code et l'index est présent dans le dossier racine.
—afficher-séance-iv	boolean	Affiche dans la console la clé IV et la session utilisées pour chiffrer la mise à jour
-b	string	Numéro de version du bundle à télécharger
—bump-major-auto	string	Augmente automatiquement le niveau de la version du canal lié, sinon la dernière version d'application distante. Niveau : majeur, mineur (par défaut), patch (alias fix), métadonnées, ou ai (Workers AI infère le niveau à partir du delta local vs précédent manifeste ; tombe en patch si aucun Capgo précédent). Augmente jusqu'à trouver un nom libre (les noms supprimés restent occupés). Ne peut pas être combiné avec —bundle (-b)
—lier	string	Lier à une ressource externe (par exemple GitHub release)
—commentaire	string	Commentaire sur cette version, pourrait être une note de version, un hachage de commit, un message de commit, etc.
—min-version-mise-à-jour	string	Version minimum requise pour mettre à jour vers cette version. Utilisé uniquement si la mise à jour automatique est désactivée dans le canal.
—min-version-mise-à-jour-auto	boolean	Définir la version minimale d'actualisation 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 (sortie non nulle) au lieu de l'uploader lorsque le bundle est incompatible avec les packages natifs actuels du canal. Dans un terminal interactif, vous pouvez toujours choisir une construction native ; le refus échoue. Il ne peut pas être combiné avec —ignore-metadata-check.
---ignore-checksum-check	boolean	Ignore le contrôle de checksum lors de l'upload
---force-crc32-checksum	boolean	Forcer le checksum CRC32 pour l'upload (surplombe la détection automatique)
---timeout	string	Durée d'attente pour le processus d'upload en secondes
---multipart	boolean	Utilisez —tus à la place. Utilise le protocole multipart pour les téléchargements S3.
---zip	boolean	Upload le bundle en utilisant zip vers Capgo cloud (legacy)
—tus	boolean	Téléchargez le bundle en utilisant TUS vers Capgo cloud
—tus-chunk-size	string	Taille de bloc en octets pour les téléchargements TUS résumables (par défaut : automatique)
—partial	boolean	Utilisez maintenant —delta. Téléchargez les mises à jour incrémentales.
—partial-only	boolean	Utilisez maintenant —delta-only. Téléchargez uniquement les mises à jour incrémentales, ignorez le bundle complet.
—delta	boolean	Upload delta updates (only changed files) for instant, super-fast updates instead of big zip downloads
—delta-only	boolean	Téléchargez uniquement les mises à jour delta pour une vitesse maximale (utile pour les applications volumineuses)
---pas-de-delta	boolean	Désactiver les mises à jour delta même si les mises à jour instantanées sont activées
---checksum-chiffré	string	Un checksum chiffré (signature). Utilisé uniquement lors de l'upload d'un bundle externe.
—auto-set-bundle	boolean	Configurer le bundle dans capacitor.config.json
---upload-séché	boolean	Chargement sec du processus de bundle : ajouter la ligne dans la base de données sans télécharger de fichiers ou mettre à jour les canaux (Utilisé par Capgo pour les tests internes)
—package-json	string	Chemins vers les fichiers package.json pour les monorepos (séparés par des virgules)
—node-modules	string	Chemins vers les dossiers node_modules pour les monorepos (séparés par des virgules)
—chiffrer-partial	boolean	Chiffrer les fichiers de mise à jour delta (activé automatiquement pour le majeur > 6.14.4)
—supprimer-lien-bundle-sur-telechargement	boolean	Localise le bundle lié actuellement dans le canal dans lequel vous essayez de télécharger, et le supprime
—pas-de-modele-brotli	string	Fichiers à exclure de la compression Brotli (globs séparés par des virgules, par exemple, ".jpg,".png" )
—désactiver-brotli	boolean	Désactive complètement la compression Brotli même si la version de l'actualiseur le supporte
—version-existe-ok	boolean	Sortir avec succès si la version du bundle existe déjà, utile pour les workflows CI/CD avec des monorepos
—auto-assign	boolean	Permettre aux appareils de rejoindre automatiquement ce canal (paramètre de mise à jour du canal)
—affichage-qr	boolean	Afficher un QR code terminal pour cette prévisualisation de bundle après téléchargement
—envoi-de-notification-de-mise-à-jour	boolean	Envoyer une notification de mise à jour native aux appareils après mise à jour des lots de canaux liés.
—supa-host	string	URL de l'hôte Supabase personnalisée (pour l'hébergement autonome ou le Capgo développement)
—supa-anon	string	Clé anonyme Supabase personnalisée (pour l'hébergement autonome)
—verbose	boolean	Activer l'affichage détaillé avec des journaux de débogage

🧪 Compatibilité

npx @capgo/cli@latest bundle compatibility

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

Exemple :

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

Options :

Paramètre	Type	Description
-a	string	API clé pour se connecter à votre compte
-c	string	Chaîne de canal pour vérifier la compatibilité avec
—text	boolean	Afficher le texte au lieu d'émoticônes
—package-json	string	Chemins vers les fichiers package.json pour les monorepos (séparés par des virgules)
—node-modules	string	Chemins vers les répertoires node_modules pour les monorepos (séparés par des virgules)
—supa-host	string	URL de l'hôte Supabase personnalisée (pour l'hébergement auto-hôte ou le développement Capgo)
—supa-anon	string	Custom Supabase anon key (for self-hosting)

🔹 ReleaseType

npx @capgo/cli@latest bundle releaseType

Affichez “native” ou “OTA” en fonction de la compatibilité avec les dernières métadonnées d'un canal.

Example:

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

Exemple :

Options :	Type	Description
-a	string	clé API pour se connecter à votre compte
-c	string	Channel to compare against
—package-json	string	Chemins vers les fichiers package.json pour les monorepos (séparés par des virgules)
—node-modules	string	Chemins vers les répertoires node_modules pour les monorepos (séparés par des virgules)
—supa-host	string	URL de l'hôte Supabase personnalisé (pour l'hébergement auto-hébergé ou le développement Capgo)
—supa-anon	string	Clé anonyme Supabase personnalisée (pour auto-hébergement)

🗑️ Supprimer

Alias: d

npx @capgo/cli@latest bundle delete

Supprimer un ensemble spécifique à partir de Capgo Cloud, optionnellement ciblant une seule version.

Exemple :

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

Options :

Paramètres	Type	Description
-a	string	API clé pour se connecter à votre compte
—supa-host	string	URL de l'hôte Supabase personnalisée (pour l'hébergement autonome ou le développement Capgo)
—supa-anon	string	Clé anonyme Supabase personnalisée (pour l'hébergement autonome)

📋 Liste

Liste l

npx @capgo/cli@latest bundle list

Liste de tous les ensembles déposés pour une application sur Capgo Cloud.

Exemple :

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

Options :

Paramètre	Type	Description
-a	string	API pour se connecter à votre compte
—hôte-supra	string	URL de l'hôte Supabase personnalisé (pour l'hébergement autonome ou le développement Capgo)
—clé-anon-supra	string	Clé anonyme Supabase personnalisée (pour l'hébergement autonome)

🧹 Nettoyage

Alias : c

npx @capgo/cli@latest bundle cleanup

Supprimez les anciens bundles dans Capgo Cloud, en conservant un nombre spécifié de versions récentes. Bundles liés à des canaux sont préservés à moins d'utiliser —ignore-channel.

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	API clé pour se connecter à votre compte
-k	string	Nombre de versions à conserver
-f	boolean	Force suppression
—ignore-channel	boolean	Supprimer les ensembles même si liés à des canaux (ATTENTION : supprime également les canaux)
—supa-host	string	URL de l'hôte Supabase personnalisée (pour l'hébergement auto-hôte ou le développement Capgo)
—supa-anon	string	Custom Supabase anon key (for self-hosting)

🔒 Chiffrer

npx @capgo/cli@latest bundle encrypt

🔒 Chiffrer un ensemble zip pour un stockage externe sécurisé. Renvoie ivSessionKey pour l'upload/décryptage. Obtenir le checksum en utilisant ‘ensemble 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
—clé-données	string	Clé de signature privée
-j	boolean	Sortie en JSON
—package-json	string	Chemins vers les fichiers package.json pour les monorepos (séparés par des virgules)

🔓 Déchiffrer

npx @capgo/cli@latest bundle decrypt

Déchiffrez un bundle chiffré (principalement pour les tests). Prints la clé de session base64 pour la vérification.

Example:

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

Exemple :

Param	Type	Type de contenu
Description	string	Chemin personnalisé pour la clé de signature privée
—key-data	string	Clé de signature privée
—checksum	string	Vérifiez l'intégrité du bundle en utilisant le checksum.
—package-json	string	Chemins vers les fichiers package.json pour les monorepos (séparés par des virgules)

🔹 Zip

npx @capgo/cli@latest bundle zip

Créez un fichier zip de votre bundle d'application. Renvoie le checksum pour utilisation avec l'encryption. Utilisez `—json` pour un résultat 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 à télécharger, si non fourni, il utilisera le webDir défini dans capacitor.config
-b	string	Numéro de version du bundle pour nommer le fichier zip
-n	string	Nom du fichier zip
-j	boolean	Afficher les résultats en JSON
—no-code-check	boolean	Ignorer la vérification si notifyAppReady() est appelé dans le source code et l'index présent dans le dossier root
—key-v2	boolean	Utiliser l'encryption v2
—package-json	string	Chemins vers les fichiers package.json pour les monorepos (séparés par des virgules)