📦 archive

Gérer les ensembles d'applications pour le déploiement dans le nuage Capgo, 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 nouveau bundle d'applications vers 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 : Stocker uniquement un lien URL (utile pour les applications >200MB ou les exigences de confidentialité). Capgo ne vérifie jamais le contenu externe. Ajouter une encryption pour une sécurité sans confiance.

Exemple :

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

Options :

Paramètre	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 à se connecter
-e,	string	Lier à une URL externe au lieu de télécharger sur Capgo Cloud
—iv-session-key	string	Définir la clé IV et la clé de session pour l'URL de bundle externe
—s3-region	string	Région pour votre bacquet 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 pour votre bacquet S3 AWS
__CAPGO_KEEP_0__	string	Port pour votre point de terminaison S3
—ne pas utiliser SSL pour l'upload S3	boolean	—clé personnalisée pour signature privée (système v2)
—clé de signature privée (système v2)	string	Affiche l'URL du bundle dans la sortie standard
—ne pas utiliser la clé	string	__CAPGO_KEEP_0__
__CAPGO_KEEP_0__	boolean	__CAPGO_KEEP_0__
__CAPGO_KEEP_0__	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 code source code et l'index est présent dans le dossier racine
—display-iv-session	boolean	Afficher dans la console la clé IV et la clé de session utilisées pour chiffrer la mise à jour
-b,	string	Numéro de version du bundle à télécharger
—lien	string	Lien vers 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-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 de métadonnées
—auto-min-update-version	boolean	Définir la version minimale de mise à jour basée sur les packages natifs
—ignore-metadata-check	boolean	Igore la vérification des métadonnées (node_modules) lors de l'upload
—ignore-checksum-check	boolean	Igore la vérification du 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 téléchargements S3
—zip	boolean	Téléchargez 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	[DEPRECATED] Utilisez —delta à la place. Téléchargez les mises à jour incrémentales
—partial-only	boolean	[DEPRECATED] Utilisez —delta-only à la place. Téléchargez uniquement les mises à jour incrémentales, ignorez le bundle complet
—delta	boolean	Télécharger les 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écharger uniquement les mises à jour delta sans le bundle complet pour une vitesse maximale (utile pour les applications volumineuses)
—no-delta	boolean	Désactiver les mises à jour delta même si Direct Update est activé
—encrypted-checksum	string	Un hachage chiffré (signature). Utilisé uniquement lors du téléchargement d'un bundle externe.
—auto-set-bundle	boolean	Définir le bundle dans capacitor.config.json
—dry-upload	boolean	Télécharger le processus de bundle en mode sec, ce qui signifie qu'il ne téléchargera pas les fichiers mais ajoutera la ligne dans la base de données (Utilisé par Capgo pour les tests internes)
—package-json	string	Chemins vers les fichiers package.json pour les monoproduits (séparés par des virgules)
—node-modules	string	Chemins vers les répertoires node_modules pour les monoproduits (séparés par des virgules)
—encrypt-partial	boolean	Chiffrer les fichiers de mise à jour delta (activé automatiquement pour le mises à jour > 6.14.4)
—delete-linked-bundle-on-upload	boolean	Localise le bundle lié actuellement dans le canal que vous essayez d'uploader, et le supprime
—no-brotli-patterns	string	Fichiers à exclure de la compression Brotli (globs séparés par des virgules, par exemple, “.jpg,.png”)
—disable-brotli	boolean	Désactiver complètement la compression Brotli même si la version de l'actualiseur la supporte
—version-existe-ok	boolean	Quitter 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 (paramètre d'actualisation du canal)
—supa-host	string	URL de l'hôte Supabase personnalisée (pour l'hébergement auto ou le développement Capgo)
—supa-anon	string	Clé anonyme Supabase personnalisée (pour l'hébergement auto)
—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 ensemble 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	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 Capgo développement)
—supa-anon	string	Clé anonyme personnalisée de 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 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	API clé 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 Capgo développement)
—supa-anon	string	Clé anonyme personnalisée de Supabase (pour auto-hébergement)

🗑️ Supprimer

Alias : d

npx @capgo/cli@latest bundle delete

Supprimer un ensemble spécifique 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	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 le Capgo développement)
—supa-anon	string	Clé anonyme Supabase personnalisée (pour l'hébergement auto-hébergé)

📋 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ée (pour l'hébergement auto ou Capgo développement)
—supa-anon	string	Clé anonyme Supabase personnalisée (pour l'hébergement auto)

🧹 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	Clé API à lier à votre compte
-k,	string	Nombre de versions à conserver
-f,	string	Suppression forcée
—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 auto-hôte ou le développement Capgo)
—supa-anon	string	Clé anonyme Supabase personnalisée (pour l'hébergement auto-hôte)

🔒 Chiffrer

npx @capgo/cli@latest bundle encrypt

Chiffre 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,	string	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é de données	string	Clé de signature privée
—coche	string	Coche de la somme de contrôle 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éez un fichier zip de votre ensemble d'application. Renvoie 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 paquet à inclure dans le nom du fichier zip
-n,	string	Nom du fichier zip
-j,	string	Afficher les résultats en JSON
—no-code-check	boolean	Ignorer la vérification si notifyAppReady() est appelé dans le fichier source code et si 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)

Continuez à partir de l'ensemble de fichiers

Si vous utilisez l'ensemble de fichiers pour planifier la sécurité et la conformité, connectez-le à Chiffrement pour les détails d'implémentation dans Chiffrement, Conformité pour les détails d'implémentation dans Conformité, Capgo Scanner de sécurité pour le flux de travail du produit dans Capgo Scanner de sécurité, Capgo Sécurité pour le flux de travail du produit dans le centre de sécurité Capgo Capgo Centre de confiance pour le flux de travail du produit dans le centre de confiance Capgo