Avant de Commencer

Préparez votre environnement en suivant ces étapes :

Configurer Nodejs et npm

Vous aurez besoin de Nodejs 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 Nodejs (qui inclut npm) depuis le site officiel.

Après avoir confirmé que Nodejs est prêt, assurez-vous que votre projet web répond aux exigences nécessaires de Capacitor.

Vérifier Votre Projet Web

Votre projet web doit avoir les éléments suivants :

• Un packagejson valide : Assurez-vous qu’il est correctement configuré
• Un répertoire de build : C’est là que résident vos assets web (généralement dist ou www)
• Un point d’entrée : Votre répertoire de build doit inclure un fichier indexhtml

Voici un aperçu des champs clés du packagejson :

Une fois que votre Nodejs et votre projet web sont prêts, passez à l’installation des outils spécifiques à la plateforme.

Installer les Logiciels Requis

Pour le Développement Android :

• Téléchargez et installez la dernière version d’Android Studio
• Configurez le SDK Android avec au moins l’API niveau 22
• Configurez la variable d’environnement ANDROID_HOME

Pour le Développement iOS (Mac uniquement) :

• Installez Xcode 14 ou une version plus récente

• Installez les Command Line Tools

• Utilisez Homebrew pour installer CocoaPods :

  brew install cocoapods

• Acceptez la licence Xcode :

  sudo xcodebuild -license accept

Lors de l’intégration de 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 processus de développement Capacitor fluide. Ensuite, vous installerez le CLI Capacitor.

Installer Capacitor CLI

Une fois votre environnement 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 en utilisant npm :

npm install @capacitor/cli @capacitor/core

Une fois installé, confirmez la configuration en vérifiant la version de Capacitor :

npx cap --version

Configurer Votre Projet

Initialisez Capacitor dans votre projet avec la commande suivante :

npx cap init

Pendant l’initialisation, vous serez invité à fournir ces détails :

Ensuite, mettez à jour votre fichier de configuration (capacitorconfig.ts ou capacitorconfig.json) avec les paramètres appropriés :

[[CODE_BLOCK]]

Configurer iOS et Android

Ajoutez le support pour les plateformes iOS et Android avec ces commandes :

[[CODE_BLOCK]]

Cela générera des projets natifs :

• iOS : Crée un dossier ios contenant le projet Xcode
• Android : Crée un dossier android pour le projet Android Studio

Après avoir modifié vos ressources web, exécutez les commandes suivantes pour compiler et synchroniser :

[[CODE_BLOCK]]

Ce processus compile vos ressources web et les transfère vers les projets natifs, y compris les plugins Capacitor installés

Pour ouvrir les projets natifs pour personnalisation :

[[CODE_BLOCK]]

Vous êtes maintenant prêt à tester votre configuration et résoudre les problèmes éventuels

Résoudre les Problèmes Courants

Lors de la configuration du CLI Capacitor, vous pourriez rencontrer quelques difficultés courantes. Voici comment les résoudre :

Problèmes de Gradle Android

Si vous rencontrez des problèmes liés à Gradle, essayez ces étapes :

1. Naviguez vers le répertoire Android et effacez le cache de build :

   [[CODE_BLOCK]]

2. Mettez à jour la version de Gradle dans android/build.gradle :

   [[CODE_BLOCK]]

3. Ajoutez les lignes suivantes à android/gradle.properties pour de meilleures performances :

   [[CODE_BLOCK]]

Si les problèmes persistent, révisez votre configuration ou consultez des ressources de dépannage supplémentaires

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 webDir correspond à votre dossier de build

  [[CODE_BLOCK]]

• Vérifiez la Configuration du Serveur : Confirmez que les paramètres du serveur sont corrects

  [[CODE_BLOCK]]

• Mettez à Jour la Politique de Sécurité du Contenu : Ajoutez cette balise meta à votre HTML pour le chargement correct des ressources

  [[CODE_BLOCK]]

Plugin Ne Fonctionne Pas

Si un plugin ne fonctionne pas comme prévu, suivez ces étapes :

1. Effectuez une installation propre des dépendances :

   [[CODE_BLOCK]]

2. Vérifiez les paramètres du plugin dans capacitorconfig.ts pour vous assurer qu’ils sont correctement configurés :

   [[CODE_BLOCK]]

Pour ceux qui utilisent le plugin natif de Capgo, il synchronise automatiquement les plugins et maintient la compatibilité pendant les mises à jour

Après avoir appliqué ces corrections, recompilez votre projet pour vérifier les changements :

[[CODE_BLOCK]]

Une fois que tout fonctionne correctement, vous pouvez passer à l’exploration des options de mise à jour en direct avec Capgo

Mises à Jour en Direct avec Capgo

Simplifiez les mises à jour d’applications avec Capgo. Il vous permet de pousser des mises à jour directement aux utilisateurs, en évitant la nécessité de révisions sur l’app store

Commencer est simple. D’abord, installez les packages nécessaires :

[[CODE_BLOCK]]

Ensuite, initialisez Capgo dans votre projet :

[[CODE_BLOCK]]

Plans Tarifaires

Capgo propose plusieurs niveaux de prix pour répondre à différents besoins :

Pour les utilisateurs entreprise, le plan PAYG commence à 249€/mois et inclut des avantages comme l’accès API, les domaines personnalisés et le support dédié

Configuration pour les Mises à Jour en Direct

Pour activer les mises à jour en direct, ajoutez ce qui suit à votre fichier capacitorconfig.ts :

[[CODE_BLOCK]]

Fonctionnalités Clés

Capgo fournit plusieurs fonctionnalités remarquables :

• **[Mises à jour sécurisées](https://capgo