📦 assembler

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

⬆️ Télécharger

Alias : u

npx @capgo/cli@latest bundle upload

⬆️ Téléchargez un nouveau bundle 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 une encryption pour une sécurité sans confiance.

Exemple :

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

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é en tant que cible de lancement de ce canal à un pourcentage de 0 à 100
—pourcentage-de-lancement-bps	string	Fixez le pourcentage de déploiement du bundle téléchargé en points de base de 0 à 10000
—durée-de-cache-de-la-décision-de-lancement-seconds	string	Cloudflare durée de cache de la décision de lancement en secondes
-e	string	Lien vers une URL externe au lieu de télécharger sur Capgo Cloud
—clé-de-session-IV	string	Fixez la clé de session et IV pour l'URL du bundle externe
—région-S3	string	Région pour votre bucket S3
—clé-API-S3	string	API clé API 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-emballage	boolean	Affiche l'URL de l'emballage dans la sortie standard
—sans-clé	boolean	Ignorez la clé de signature et envoyez une mise à jour claire
—sans-code-vérification	boolean	Ignorez la vérification si notifyAppReady() est appelé dans la source code et l'index est présent dans le dossier racine
—afficher-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 de l'emballage à télécharger
—lien	string	Lien vers une ressource externe (par exemple GitHub release)
—commentaire	string	Commentaire sur cette version, pourrait être un note de version, un hash 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 dans le canal
—min-version-de-mise-à-jour-automatique	boolean	Définir la version minimale de mise à jour basée sur les packages natifs
—ignorer-vérification-des-méta-données	boolean	Igner les vérifications des méta-données (node_modules) lors de l'upload
—échec-en-cas-d'incompatibilité	boolean	Faire échouer l'upload (sortir avec un code non nul) au lieu d'uploader lorsque le bundle est incompatibl avec les packages natifs du canal. Dans un terminal interactif, vous pouvez toujours choisir une construction native ; refuser fait échouer.
—ignore-checksum-check	boolean	Ignores le contrôle de checksum lors de l'upload
—force-crc32-checksum	boolean	Force le contrôle de checksum CRC32 pour l'upload (dépasser la détection automatique)
—timeout	string	Durée d'attente pour le processus d'upload en secondes
—multipart	boolean	[DEPRECATED] Utilisez —tus à la place. Utilise le protocole multipart pour les uploads S3
—zip	boolean	Effectue l'upload du bundle en utilisant zip vers le nuage Capgo (legacy)
—tus	boolean	Effectue l'upload du bundle en utilisant TUS vers le nuage Capgo
—taille-de-chunk	string	Taille de chunk en octets pour les téléchargements TUS résumables (par défaut : automatique)
—partiel	boolean	[DEPRECATED] Utilisez —delta à la place. Téléchargez des mises à jour incrémentales
—partiel-seul	boolean	[DEPRECATED] Utilisez —delta-seul à la place. 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-seul	boolean	Téléchargez uniquement des mises à jour delta sans bundle complet pour une vitesse maximale (utile pour les applications volumineuses)
—pas-de-delta	boolean	Désactivez les mises à jour delta même si les mises à jour instantanées sont activées
—somme-chiffre-encrée	string	Une somme-chiffre chiffrée (signature). Utilisé uniquement lors de l'envoi d'un bundle externe.
—définir-bundle-auto	boolean	Définir le bundle dans capacitor.config.json
—téléchargement-séché	boolean	Téléchargement sec du processus de bundle : ajouter la ligne dans la base de données sans télécharger les fichiers ou mettre à jour les canaux (Utilisé par Capgo pour les tests internes)
—fichier-json-paqueter	string	Chemins vers les fichiers package.json pour les monorepos (séparés par des virgules)
—dossiers-modules-nœud	string	Chemins vers les dossiers node_modules pour les monorepos (séparés par des virgules)
—chiffrement-partial	boolean	Chiffrer les fichiers de mise à jour delta (activé automatiquement pour l'updater > 6.14.4)
Supprimer le bundle lié lors de l'upload	boolean	Localise le bundle actuellement lié dans le canal que vous essayez d'uploader, et le supprime
Exclure les fichiers de la compression Brotli (globs séparés par des virgules, par exemple, "	string	.jpg,.png")Désactiver complètement la compression Brotli même si la version de l'updater le supporte
Sortir avec succès si la version du bundle existe déjà, utile pour les workflows CI/CD avec des monorepos	boolean	Permettre aux appareils de se joindre automatiquement à ce canal (met à jour la configuration du canal)
—version-exists-ok	boolean	—self-assign
—disable-brotli	boolean	—no-brotli-patterns
—prévisualisation QR	boolean	Imprimez un QR code terminal pour cette prévisualisation de bundle après téléchargement
—envoyer une mise à jour de notification	boolean	Envoyer une mise à jour de notification native aux appareils après mise à jour des liens de bundle de canal
—hôte Supabase personnalisé	string	URL de l'hôte Supabase personnalisé (pour l'hébergement auto-hôte ou Capgo le développement)
—clé Supabase anonyme	string	Clé Supabase anonyme personnalisée (pour l'hébergement auto-hôte)
—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 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	Clé API pour se connecter à votre compte
-c	string	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 autonome ou le développement Capgo)
—supa-anon	string	Clé anonyme Supabase personnalisée (pour l'hébergement autonome)

🔹 Type de version

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.

Exemple :

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

Options :

Paramètre	Type	Description
-a	string	clé API pour se connecter à votre compte
-c	string	Canal à comparer contre
—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é anonyme Supabase personnalisée (pour l'hébergement auto-hébergé)

🗑️ 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ètre	Type	Description
-a	string	Clé API pour se connecter à votre compte
—supa-host	string	URL de l'hôte Supabase personnalisé (pour l'hébergement autonome ou le développement Capgo )
—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 dans 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ôte ou le développement Capgo)
—supa-anon	string	Clé anonyme personnalisée Supabase (pour l'hébergement auto-hôte)

🧹 Nettoyage

Alias : c

npx @capgo/cli@latest bundle cleanup

🧹 Supprimer les anciens bundles dans Capgo Cloud, en conservant un nombre spécifié de versions récentes. Les bundles liés aux canaux sont préservés à moins que —ignore-channel soit utilisé.

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	Forcer la suppression
—ignore-channel	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 Capgo développement)
—supa-anon	string	Clé anonyme Supabase personnalisée (pour l'hébergement autonome)

🔒 Chiffrer

npx @capgo/cli@latest bundle encrypt

Chiffrer un zip bundle pour un stockage externe sécurisé. Renvoie ivSessionKey pour l'upload/décryptage. Obtenez 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é-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é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é-données	string	Clé de signature privée
—coche	string	Coche du bundle, pour vérifier l'intégrité du bundle
—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. 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 ce n'est pas 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 en JSON
—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
—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)