📦 paquet

📦 Gérez les ensembles d'applications pour la mise en ligne dans le nuage Capgo, y compris l'upload, les vérifications de compatibilité et la cryptage.

⬆️ Télécharger

Alias : u

npx @capgo/cli@latest bundle upload

⬆️ Téléchargez un nouvel ensemble d'applications dans le nuage 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 : Stockez uniquement un lien URL (utile pour les applications >200MB ou les exigences de confidentialité). Capgo ne vérifie jamais le contenu externe. Ajoutez un cryptage pour une sécurité sans confiance.

Exemple :

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

Augmenter automatiquement la prochaine version semver disponible dans le canal (ou la dernière version distante de l'application) si vous n'avez pas fourni --bundleUtilisé en CI lorsque package.json Déjà correspond à une version Capgo 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 avec le delta de manifeste Capgo/canal précédent, 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'intelligence artificielle est ignorée et la mise à jour par défaut est de patch.

Options :

Paramètres	Type	Description
-a	string	API clé 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	Chaîne à lier. Utilisez des virgules pour plusieurs chaînes, par exemple production,beta
—rollout	string	Définir le bundle téléchargé comme cible de lancement de cette chaîne à un pourcentage de 0 à 100
—rollout-percentage-bps	string	Définissez le pourcentage de déploiement du bundle téléchargé en points de base de 0 à 10000
—rollout-cache-ttl-seconds	string	Cloudflare TTL de la cache de décision de déploiement en secondes
-e	string	Lien vers une URL externe au lieu de télécharger sur Capgo Cloud
—iv-session-key	string	Définissez la clé de session et IV pour l'URL du bundle externe
—s3-region	string	Région pour votre bucket S3
—s3-apikey	string	API clé pour votre point de terminaison S3
—s3-apisecret	string	API secret pour votre point de terminaison S3
—s3-endpoint	string	URL du point de terminaison S3
—s3-bucket-name	string	Nom de votre bac à sable AWS S3
—s3-port	string	Port pour 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)
—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	Ignorer la clé de signature et envoyer une mise à jour claire
—no-code-check	boolean	Ignorer la vérification si notifyAppReady() est appelé dans le source code et l'index est présent dans le dossier racine
—display-iv-session	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
—auto-bump	string	Auto-incrémentation à partir du bundle lié au canal, 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 de manifest local par rapport à la version précédente ; tombe en patch si aucune version précédente Capgo n'est disponible). Incrémente jusqu'à trouver un nom disponible (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, qui pourrait être une note de publication, un hachage de commit, un message de commit, etc.
—min-version-de-mise-à-jour	string	Version minimale requise pour mettre à jour vers cette version. Utilisé uniquement si la mise à jour automatique est désactivée pour les métadonnées dans le canal
—min-version-de-mise-à-jour-automatique	boolean	Définir la version de mise à jour minimale en fonction des packages natifs
—ignorer-vérification-des-métadonnées	boolean	Ignores la vérification des métadonnées (node_modules) lors de l'upload
—échec-en-cas-de-compatibilité-incompatible	boolean	Échouez l'upload (sortir avec un code non nul) au lieu d'uploader lorsque le bundle est incompatible avec les packages natifs actuels du canal. Dans un terminal interactif, vous pouvez toujours choisir une construction native ; refuser échoue. Ne peut pas être combiné avec —ignore-metadata-check.
—ignore-checksum-check	boolean	Igore le contrôle de checksum lors de l'upload
—force-crc32-checksum	boolean	Forcer le checksum CRC32 pour l'upload (dépasser la détection automatique)
—timeout	string	Durée de temps limite pour le processus d'upload en secondes
—multipart	boolean	[DEPRECATED] Utilisez —tus à la place. Utilise le protocole multipart pour les uploads S3
—zip	boolean	Upload le bundle en utilisant zip vers Capgo cloud (legacy)
—tus	boolean	Charger 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	[DEPRECATED] Utilisez —delta au lieu de cela. Téléchargez des mises à jour incrémentales
—partial-only	boolean	[DEPRECATED] Utilisez —delta-only au lieu de cela. Téléchargez uniquement des mises à jour incrémentales, ignorez le bundle complet
—delta	boolean	Téléchargez des mises à jour delta (seulement les fichiers modifiés) pour des mises à jour instantanées et très rapides au lieu de téléchargements de zip volumineux
—delta-only	boolean	Téléchargez uniquement des mises à jour delta sans bundle complet pour une vitesse maximale (utile pour les applications volumineuses)
—no-delta	boolean	Désactiver les mises à jour delta même si les mises à jour instantanées sont activées
—cochaine-encrypted	string	Une cochaine chiffrée (signature). Utilisé uniquement lors de l'upload d'un bundle externe.
—configurer-bundle-automatique	boolean	Définir le bundle dans capacitor.config.json
—upload-sec	boolean	Upload sec du processus de bundle : ajouter la ligne dans la base de données sans uploader les fichiers ou mettre à jour les canaux (Utilisé par Capgo pour les tests internes)
—fichier-json-package	string	Chemins vers les fichiers package.json pour les monorepos (séparés par des virgules)
—dossiers-modules-node	string	Chemins vers les dossiers node_modules pour les monorepos (séparés par des virgules)
—chiffrer-partial	boolean	Chiffrez les fichiers d'actualisation delta (activé automatiquement pour l'actualiseur > 6.14.4)
—supprime-le-panier-lié-sur-televersement	boolean	Localise le panier lié actuellement dans le canal dans lequel vous essayez de téléverser, et le supprime
—pas-de-modèles-de-brotli	string	Fichiers à exclure de la compression Brotli (globs séparés par des virgules, par exemple, “.jpg,.png”)
—désactive-brotli	boolean	Désactive complètement la compression Brotli même si la version de l'actualiseur le supporte
—existe-la-version—ok	boolean	Sortir avec succès si la version du panier existe déjà, utile pour les workflows CI/CD avec des monorepos
—s'assigne-soi-même	boolean	Autoriser les appareils à rejoindre automatiquement ce canal (mise à jour de la configuration du canal)
—qr-preview	boolean	Afficher un QR code terminal pour cette prévisualisation de bundle après téléchargement
—send-update-notification	boolean	Envoyer une notification de mise à jour native aux appareils après mise à jour des bundles 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 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 vous assurer que les mises à jour sont 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 pour vérifier la compatibilité avec
—texte	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ébergé ou le Capgo développement)
—supa-anon	string	Clé anonyme personnalisée Supabase (pour auto-hébergement)

🔹 Type de version

npx @capgo/cli@latest bundle releaseType

🧭 Afficher “native” ou “OTA” en fonction de la compatibilité avec les métadonnées d'un canal les plus récentes.

Exemple :

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

Options :

Paramètre	Type	Description
-a	string	API clé pour se connecter à votre compte
-c	string	Canal à comparer
—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ébergé ou le développement Capgo)
—supa-anon	string	Clé d'anonyme personnalisée Supabase (pour auto-hébergement)

🗑️ Supprimer

Alias : d

npx @capgo/cli@latest bundle delete

Supprimer une version spécifique d'un bundle du cloud Capgo, optionnellement ciblant une seule version.

Exemple :

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

Options :

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

📋 Liste

Alias : l

npx @capgo/cli@latest bundle list

📋 Liste de tous les bundles téléchargé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 clé pour se connecter à votre compte
—supa-host	string	URL de l'hôte Supabase personnalisé (pour l'hébergement auto-hébergé ou Capgo développement)
—supa-anon	string	Clé anonyme Supabase personnalisée (pour l'hébergement auto-hébergé)

🧹 Nettoyage

Alias : c

npx @capgo/cli@latest bundle cleanup

Supprimer les anciens ensembles dans Capgo Cloud, en conservant le nombre spécifié de versions récentes. Les ensembles liés aux 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	Suppression forcée
—ignore-champ	boolean	Supprimer les bundles même si ils sont liés à des canaux (AVERTISSEMENT : supprime également les canaux)
—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)

🔒 Chiffrer

npx @capgo/cli@latest bundle encrypt

Chiffrez un zip bundle pour un stockage externe sécurisé. Renvoie ivSessionKey pour l'upload/décryptage. Obtenir le checksum en utilisant ‘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
—clé de données	string	Clé de signature privée
-j	boolean	Sortie en JSON
—fichier-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échiffrer un bundle chiffré (principalement pour les tests). Affiche la clé de session base64 pour la 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
—clé de données	string	Clé de signature privée
—coche	string	Coche de la liste des éléments du bundle, pour vérifier l'intégrité du bundle
—fichier json du package	string	Chemins vers les fichiers json du package pour les monorepos (séparés par des virgules)

🔹 Zip

npx @capgo/cli@latest bundle zip

Créer un fichier zip de votre bundle d'application. Retourne un checksum pour l'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 paquet 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 fichier source code et l'index est présent dans le dossier racine
—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)