Capacitor CLI vous aide à transformer vos web apps en apps natives iOS et Android avec une base de code unique. Voici comment le configurer rapidement :
- Prerequisites: Installer Node.js (v16+), npm, et un framework web (React, Vue, Angular, etc.).
- Installer Capacitor CLI: Exécuter
npm install @capacitor/cli @capacitor/coreet initialiser votre projet avecnpx cap init. - Préparer les plateformes: Ajouter le support pour iOS (
npx cap add ios) et Android (npx cap add android) plateformes. - Build et Sync : Utilisez
npm run buildetnpx cap syncpour transférer les assets web vers les projets natifs. - Live Updates en option: Utilisez des outils comme Capgo pour envoyer des mises à jour instantanément sans les délais des stores.
Capacitor CLI simplifie le développement et la maintenance de vos apps. Suivez ce guide pour une installation et un dépannage sans accroc.
Créez une app mobile rapidement ! React + Capacitor + Tailwind + DaisyUI

Avant de commencer
Préparez votre environnement en suivant ces étapes :
Configuration Node.js et npm

Vous aurez besoin de Node.js version 16 ou supérieure. La dernière version LTS est recommandée. Pour vérifier votre configuration, exécutez :
node --version
npm --version
Si vous devez mettre à jour, téléchargez Node.js (qui inclut npm) depuis le site officiel.
Après avoir confirmé que Node.js est prêt, assurez-vous que votre projet web répond aux exigences Capacitor nécessaires.
Vérifier votre projet web
Votre projet web doit inclure les éléments suivants :
- Un package.json valide: Assurez-vous qu’il est correctement configuré.
- Un dossier de build: c'est ici que se trouvent vos assets web (généralement
distouwww). - Un point d'entrée: votre dossier de build doit inclure un
index.htmlfichier.
Voici un aperçu des package.json champs clés :
| Champ obligatoire | Valeur d'exemple | Objectif |
|---|---|---|
| nom | « my-app » | Identifie le projet |
| installée | “1.0.0” | Spécifie la version de l'app |
| répertoire de build | « dist » ou « www » | Indique les assets web |
Une fois votre projet Node.js et web prêt, passez à l’installation des outils spécifiques à chaque plateforme.
Installer les logiciels requis
Pour le développement Android :
- Téléchargez et installez la dernière version de Android Studio.
- Configurez l'SDK Android avec au moins le niveau API 22.
- Configurez la
ANDROID_HOMEvariable d'environnement.
Pour le développement iOS (Mac uniquement) :
-
Installer Xcode 14 ou une version plus récente.
-
Installer les Command Line Tools.
-
Utiliser Homebrew pour installer CocoaPods:
brew install cocoapods -
Accepter la licence Xcode :
sudo xcodebuild -license accept
Lorsque vous intégrerez Capgo plus tard, assurez-vous d’avoir une connexion Internet stable et des certificats SSL valides.
Une fois ces étapes terminées, vous êtes prêt pour un développement Capacitor sans accroc. Ensuite, vous installerez le Capacitor CLI.
Installer Capacitor CLI
Votre environnement étant prêt, il est temps d’installer et de configurer Capacitor CLI.
Ajouter les packages Capacitor
Commencez par installer les packages Capacitor CLI et Core à l’aide de npm :
npm install @capacitor/cli @capacitor/core
Une fois installés, vérifiez la configuration en consultant la version de Capacitor CLI:
npx cap --version
Configurer votre projet
Initialisez Capacitor dans votre projet avec la commande suivante :
npx cap init
Pendant l’initialisation, on vous demandera de fournir ces informations :
| Paramètre | Description | Exemple |
|---|---|---|
| App Name | Le nom affiché dans les stores | « My Awesome App » |
| ID de l'app | Un identifiant unique pour votre application | « com.mycompany.myapp » |
| Répertoire Web | Chemin vers vos ressources web | « dist » ou « www » |
Ensuite, mettez à jour votre fichier de configuration (capacitor.config.ts ou capacitor.config.json) avec les paramètres suivants :
import { CapacitorConfig } from '@capacitor/cli';
const config: CapacitorConfig = {
appId: 'com.mycompany.myapp',
appName: 'My Awesome App',
webDir: 'dist',
bundledWebRuntime: false
};
export default config;
Configurer iOS et Android
Ajoutez le support des plateformes iOS et Android avec ces commandes :
npx cap add ios
npx cap add android
Cela va générer les projets natifs :
- iOS : crée un
iosdossier contenant le projet Xcode. - Android : crée un
androiddossier pour le projet Android Studio.
Après avoir modifié vos assets web, exécutez les commandes suivantes pour compiler et synchroniser :
npm run build
npx cap sync
Ce processus compile vos assets web et les transfère vers les projets natifs, y compris les plugins installés Plugins Capacitor.
Pour ouvrir les projets natifs et les personnaliser davantage :
npx cap open ios # Opens Xcode
npx cap open android # Opens Android Studio
Vous êtes maintenant prêt à tester votre configuration et à résoudre les éventuels problèmes.
Résoudre les problèmes courants
Lors de la configuration de Capacitor CLI, vous pourriez rencontrer quelques problèmes courants. Voici comment les résoudre :
Problèmes Gradle sur Android
Si vous rencontrez des problèmes liés à Gradle, essayez ces étapes :
-
Accédez au répertoire Android et videz le cache de build :
cd android ./gradlew cleanBuildCache -
Mettez à jour la version de Gradle dans
android/build.gradle:buildscript { ext { gradleVersion = '8.1.0' } } -
Ajoutez les lignes suivantes à
android/gradle.propertiespour de meilleures performances :org.gradle.jvmargs=-Xmx4608m org.gradle.parallel=true
Si les problèmes persistent, revoyez votre configuration ou consultez d'autres ressources de dépannage.
L'application affiche un écran blanc
Un écran blanc indique généralement un problème de configuration. Voici comment le résoudre :
-
Vérifiez le chemin du répertoire web : Assurez-vous que le
webDircorrespond à la sortie de votre build.const config: CapacitorConfig = { webDir: 'dist', // Adjust if necessary }; -
Vérifiez la configuration du serveur : Confirmez que les paramètres du serveur sont corrects.
server: { url: 'http://localhost:3000', cleartext: true } -
Mettez à jour la Content Security Policy : Ajoutez cette balise meta à votre HTML pour un chargement correct des ressources.
<meta http-equiv="Content-Security-Policy" content="default-src 'self' 'unsafe-inline' 'unsafe-eval' data: *">
Le plugin ne fonctionne pas
Si un plugin ne se comporte pas comme prévu, suivez ces étapes :
-
Effectuez une installation propre des dépendances :
rm -rf node_modules npm cache clean --force npm install -
Vérifiez les paramètres du plugin dans
capacitor.config.tspour vous assurer qu’ils sont correctement configurés :plugins: { PluginName: { option: 'value' } }
Pour ceux qui utilisent le plugin natif de Capgo, il synchronise automatiquement les plugins et maintient la compatibilité lors des mises à jour.
Après avoir appliqué ces correctifs, recompilez votre projet pour vérifier les modifications :
npm run build && npx cap copy && npx cap sync
Une fois que tout fonctionne correctement, vous pouvez passer à l’exploration des options live update avec Capgo.
Live updates avec Capgo

Simplifiez mises à jour d'app avec Capgo. Il vous permet d'envoyer des mises à jour directement aux utilisateurs, sans passer par la revue des stores.
Démarrer est simple. Tout d'abord, installez les packages nécessaires :
npm install @capgo/cli @capgo/capacitor-updater
npx cap sync
Ensuite, initialisez Capgo dans votre projet :
npx @capgo/cli init
Plans tarifaires
Capgo propose plusieurs plans pour répondre à différents besoins :
| Plan | Utilisateurs actifs mensuels (MAU) | Bande passante | Stockage | Prix (annuel) |
|---|---|---|---|---|
| SOLO | 1,000 | 50 Go | 2 Go | 12 $/mois |
| MAKER | 10,000 | 500 Go | 5 Go | 33 $/mois |
| TEAM | 100,000 | 2 000 Go | 10 Go | 83 $/mois |
Pour les entreprises, le plan PAYG démarre à 249 $/mois et inclut des avantages comme l'accès à API, des domaines personnalisés et un support dédié.
Configuration pour Live Updates
Pour activer les live updates, ajoutez ceci à votre capacitor.config.ts fichier :
{
plugins: {
CapacitorUpdater: {
autoUpdate: true,
updateUrl: 'https://api.capgo.app/updates'
}
}
}
Fonctionnalités clés
Capgo propose plusieurs fonctionnalités phares :
- Mises à jour sécurisées avec un chiffrement de bout en bout
- Déploiements automatisés via une CI/CD intégrée
- Mises à jour ciblées via l’attribution à un utilisateur
- Rollback instantané avec contrôle de version
- Analyses en temps réel pour suivre les mises à jour
Commandes de déploiement
Testez les mises à jour en développement avant de les déployer en production. Utilisez les commandes suivantes :
-
Déployer en staging :
npx @capgo/cli deploy --channel staging -
Déployer en production :
npx @capgo/cli deploy --channel production
Capgo garantit la conformité aux règles d’Apple et d’Android : vos live updates ne risquent pas d’enfreindre les règles des stores. C’est un moyen efficace de gérer les applications Capacitor après installation.
Conclusion
Configurer Capacitor CLI est simple quand les prérequis sont réunis. Cette configuration assure des mises à jour d’app plus fluides et des workflows de développement efficaces.
Les outils modernes simplifient comme jamais la maintenance des applications. Par exemple, Capgo propose désormais des live updates, qui remplacent les anciennes méthodes. Son intégration à l’installation de CLI en fait un excellent choix pour les développeurs qui travaillent sur des applications Capacitor.
Le l'écosystème Capacitor s’améliore constamment avec de nouveaux outils et fonctionnalités. L’installation de CLI n’est que le point de départ pour compiler des applications mobiles, et vous bénéficiez d’une documentation détaillée et d’une communauté de développeurs active.
Assurez-vous de maintenir à jour Capacitor CLI et ses packages pour éviter les problèmes de compatibilité.
Continuer avec l'installation de Capacitor CLI : guide étape par étape
Si vous utilisez Installer Capacitor CLI : guide étape par étape pour planifier les opérations du dashboard et de API, connectez-l’avec Aperçu de API pour les détails d'implémentation dans « Vue d'ensemble de API », Introduction pour les détails d'implémentation dans l'introduction, Clés API pour les détails d'implémentation dans API Keys, Appareils pour les détails d'implémentation dans Devices, et Les bundles pour les détails d'implémentation dans Bundles.