Packager 📦

Gérer les ensembles d'applications pour la mise en ligne dans le 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échargez un nouveau bundle d'application vers Capgo Cloud 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

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
-e,	string	Lier à une URL externe au lieu de télécharger sur Capgo Cloud
—iv-session-key	string	Définir 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 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'envoi vers S3
—clé-v2	string	Chemin personnalisé pour la clé de signature privée (système v2)
—clé-de-données-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 la mise à jour claire
—no-code-check	boolean	Ignorer la vérification si notifyAppReady() est appelé dans la 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
—lien	string	Lien vers une ressource externe (par exemple GitHub release)
—commentaire	string	Commentaire sur cette version, qui pourrait être un 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
—auto-min-version-de-mise-à-jour	boolean	Définir la version de mise à jour minimale basée sur les packages natifs
—ignorer-la-vérification-des-méta-données	boolean	Igner la vérification des méta-données (node_modules) lors de la téléchargement
—ignore-checksum-check	boolean	Igore le contrôle de checksum lors de l'upload
—force-crc32-checksum	boolean	Force le checksum CRC32 pour l'upload (dépasser la détection automatique)
—timeout	string	Temps d'attente pour le processus d'upload en secondes
—multipart	boolean	[DEPRECATED] Utiliser —tus au lieu de cela. Utilise le protocole multipart pour les uploads S3
—zip	boolean	Upload le bundle en utilisant zip vers le cloud Capgo (legacy)
—tus	boolean	Upload le bundle en utilisant TUS vers le cloud 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 la mise à jour directe est activée
—somme de contrôle chiffrée	string	Une somme de contrôle chiffrée (signature). Utilisé uniquement lors de l'upload d'un bundle externe.
—définir automatiquement le bundle	boolean	Définir le bundle dans capacitor.config.json
—upload sec	boolean	Upload sec du processus de bundle, cela 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)
—fichier json de package	string	Chemins vers les fichiers json de package pour les monorepos (séparés par des virgules)
—dossiers modules node	string	Chemins vers les dossiers modules node pour les monorepos (séparés par des virgules)
—chiffrer partiellement	boolean	Chiffrer les fichiers de mise à jour delta (activé automatiquement pour l'updater > 6.14.4)
—supprimer-le-lien-de-bundle-en-cours-de-téléchargement	boolean	Localise le bundle lié actuellement dans le canal dans lequel vous essayez de télécharger, et le supprime
—pas-de-patterns-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
—attribuer-soi-même	boolean	Autoriser les appareils à rejoindre automatiquement ce canal (met à jour la configuration du canal)
—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)
—verbose	boolean	Activer l'affichage détaillé avec des journaux de log détaillés

🧪 Compatibilité

npx @capgo/cli@latest bundle compatibility

Vérifier la compatibilité d'un bundle avec un canal spécifique dans Capgo Cloud pour s'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
—fichier-package-json	string	Chemins vers les fichiers package.json pour les monorepos (séparés par des virgules)
—dossiers-node-modules	string	Chemins vers les dossiers node_modules pour les monorepos (séparés par des virgules)
—hôte-supabase	string	URL de l'hôte Supabase personnalisée (pour l'hébergement auto-hôte ou le développement Capgo)
—clé-anon-supabase	string	Clé anonyme Supabase personnalisée (pour l'hébergement auto-hôte)

🔹 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
—fichier-json	string	Chemins vers les fichiers json de package pour les monorepos (séparés par des virgules)
—modules-node	string	Chemins vers les répertoires node_modules pour les monorepos (séparés par des virgules)
—hôte-supabase	string	URL de l'hôte Supabase personnalisée (pour l'hébergement auto ou le développement Capgo)
—clé-anon-supabase	string	Clé anonyme Supabase personnalisée (pour l'hébergement auto)

🗑️ Supprimer

Alias : d

npx @capgo/cli@latest bundle delete

Supprimer un bundle 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	Clé API pour se connecter à votre compte
—hôte supérieur	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)

📋 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-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 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 ne 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	Clé API pour se connecter à votre compte
-k,	string	Nombre de versions à conserver
-f,	string	Suppression forcée
—ignore-channel	boolean	Supprimer les bundles 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	Clé anonyme personnalisée Supabase (pour auto-hébergement)

🔒 Chiffrer

npx @capgo/cli@latest bundle encrypt

Chiffre un bundle zip 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é-de-données	string	Clé de signature privée
-j,	string	Afficher les résultats sous forme de 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
—checksum	string	Checksum 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

Exemple :

Fenêtre de terminal

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,	string	Sortie en JSON
—no-code-vérification	boolean	Ignorer la vérification si notifyAppReady() est appelé dans le source code et l'index est présent dans le dossier racine
—clé-v2	boolean	Utiliser l'encryption v2
—fichier-package-json	string	Chemins vers les fichiers package.json pour les monorepos (séparés par des virgules)