Passer au contenu principal

Capacitor Guide d'initialisation étape par étape de l'application

Découvrez comment configurer et déployer efficacement des applications mobiles à l'aide de Capacitor, couvrant tout, de l'installation aux configurations spécifiques aux plateformes.

Martin Donadieu

Martin Donadieu

Spécialiste du contenu marketing

Capacitor Guide d'initialisation étape par étape de l'application

Voulez-vous créer des applications mobiles avec un code unique? Capacitor facilite la création d'applications iOS, Android et web à l'aide de frameworks comme React, Langue cible : françaisTokens protégés : ["Cloudflare", "Capacitor", "GitHub", "Capgo", "code", "API", "SDK", "CLI", "npm", "bun"] Textes à traduire : ["Angular", ", ou", "Vue", ". Cette guide explique comment configurer", "__CAPGO_KEEP_0__", ", configurer les plateformes, et déployer les mises à jour de manière efficace.", "Étapes clés pour se lancer :", "Installer les outils", "Node.js", ", __CAPGO_KEEP_0__, Git, et un éditeur de texte comme", "VS __CAPGO_KEEP_0__", "Configurer __CAPGO_KEEP_0__"]Angular CapacitorVue

. Cette guide explique comment configurer

  • __CAPGO_KEEP_0__: , configurer les plateformes, et déployer les mises à jour de manière efficace., npm, Git, and a code editor like VS Code.
  • Set Up Capacitor: Installez le Capacitor CLI et initialisez votre projet.
  • Configurer les plateformes: Ajoutez la prise en charge d'iOS et d'Android, ajustez les paramètres et synchronisez votre code.
  • Testez et Déployez: Créez, exécutez sur les appareils et utilisez les outils de mise à jour en direct comme Capgo pour des mises à jour sans heurt.

Capacitor relie les applications web aux fonctionnalités de dispositif natif, garantissant une performance fluide sur plusieurs plateformes. Suivez ce guide pour simplifier votre processus de développement d'applications !

5 étapes pour une APP NATIVE avec CAPACITOR | Guide de mise à jour d'Ionic

CAPACITOR

Outils et configuration protégés

Voici comment configurer votre environnement de développement avec les outils essentiels.

Installation des outils de développement

Pour travailler avec Capacitor, vous aurez besoin des outils suivants :

OutilButVersion minimale
Node.jsEnvironnement de temps d'exécution JavaScript14.0.0 ou une version supérieure
npmGestionnaire de packages6.0.0 ou version ultérieure
IDE/Code ÉditeurEnvironnement de développementDernière version stable
GitContrôle de version2.0.0 ou version ultérieure

Suivez ces étapes pour les installer :

  • Node.js et npm: Téléchargez et installez les deux depuis le site officiel le site web de Node.js.
  • Code Éditeur: Choisissez un éditeur comme VS Code, WebStorm, ou Sublime Text et installez la dernière version stable.
  • Git: Obtenez-le sur git-scm.com.
  • Outils spécifiques à la plateforme: Installez les outils spécifiques à votre plateforme, comme Xcode pour macOS ou Android Studio pour le développement Android.

Une fois ces installations effectuées, vous êtes prêt à passer à la configuration de l'Capacitor CLI.

Capacitor CLI Configuration

Obtenez l'Capacitor CLI en cours de fonctionnement avec ces étapes :

  1. Installez Capacitor CLI de manière globale

    Ouvrez votre terminal et exécutez la commande suivante :

    npm install -g @capacitor/cli
  2. Initialisez le plugin Capgo

    Si vous n'avez pas encore effectué cela, exécutez :

    npx @capgo/cli init

    Cela configurera les paramètres nécessaires pour gérer les mises à jour de manière efficace. [1]Il simplifie le processus de création, de test et de déploiement de votre application.

Lancer un Nouveau Projet Capacitor

Une fois les outils nécessaires installés, vous êtes prêt à configurer votre premier projet Capacitor. Voici comment commencer.

Créer votre Projet

Pour créer un nouveau projet Capacitor, ouvrez votre terminal et utilisez cette commande :

npx @capacitor/cli create [projectDirectory] [appId] [appDisplayName]

Par exemple :

npx @capacitor/cli create my-cap-app com.example.app "My Capacitor App"

Voici ce que chaque paramètre signifie :

  • projectDirectory: Le nom de votre dossier de projet (par exemple, my-cap-app).
  • appId: Un identifiant inversé-domaine pour votre application (par exemple, com.example.app).
  • appDisplayName : Le nom affiché pour votre application (par exemple, My Capacitor App).

Après avoir exécuté cette commande, vous devrez ajuster vos paramètres de projet dans le capacitor.config.json __CAPGO_KEEP_0__.config.json

Configuring capacitor.config.json

fichier est où vous définissez les paramètres clés de votre projet. Voici un exemple de configuration de base : capacitor.config.json Voici une explication des options clés :

{
  "appId": "com.example.app",
  "appName": "My Capacitor App",
  "webDir": "dist",
  "bundledWebRuntime": false,
  "server": {
    "hostname": "app.example.com",
    "androidScheme": "https",
    "iosScheme": "https"
  }
}

Paramètre

ButValeur d'exempleappId
appIdIdentifiant unique pour votre applicationcom.example.app
__CAPGO_KEEP_0__Nom d'affichage de l'applicationMy Capacitor App
__CAPGO_KEEP_0__Répertoire pour les fichiers de builddist
__CAPGO_KEEP_0__Inclure le runtime Capacitorfalse
__CAPGO_KEEP_0__Hôte pour le serveur de développementapp.example.com
__CAPGO_KEEP_0__Schéma de URL pour Androidhttps
__CAPGO_KEEP_0__Schéma de protocole pour iOShttps

Installation des Dépendances

Pour finaliser la configuration, installez les dépendances requises et initialisez votre projet avec ces commandes :

npm install @capacitor/core
npm install @capacitor/cli --save-dev
npx cap init

Une fois ces étapes complétées, votre projet est prêt pour la configuration et le développement spécifiques aux plateformes.

Configuration des Plates-formes Mobiles

Une fois votre projet Capacitor initialisé, le prochain pas consiste à ajouter et à configurer les plateformes iOS et Android afin que votre application puisse s'exécuter nativement sur les appareils mobiles.

Configuration iOS et Android

Commencez par ajouter le support de plateforme en utilisant les commandes suivantes :

npx cap add ios
npx cap add android

Après avoir ajouté les plateformes, synchronisez votre application web code avec :

npx cap sync

Avant d'exécuter ces commandes, assurez-vous que votre application web est construite et que le webDir est correctement configuré. Une fois cela fait, personnalisez les paramètres de chaque plateforme pour les adapter aux besoins de votre application. capacitor.config.json dans la plateforme mobile est correctement configuré. Une fois cela fait, personnalisez les paramètres de chaque plateforme pour les adapter aux besoins de votre application.

Paramètres Spécifiques à la Plateforme

iOS

Ouvrez le projet iOS avec :

npx cap open ios

Ensuite, configurez les paramètres suivants :

  • Identifiant de l'Application : Assurez-vous qu'il correspond à votre appId.
  • Équipe de Développement : Attribuez l'équipe appropriée pour la signature code.
  • Cible de Déploiement : Définissez la version iOS minimale.
  • Orientation de l'Appareil : Ajustez selon vos besoins.
  • Descriptions de confidentialité: Ajoutez les descriptions requises dans Info.plist.

Android

Ouvrez le projet Android avec :

npx cap open android

Mettez ensuite à jour ces paramètres :

  • Nom de package: Assurez-vous qu'il correspond à votre appId.
  • Permissions: Définissez les permissions nécessaires dans AndroidManifest.xml.
  • Orientation de l'écran: Configurez cela dans AndroidManifest.xml.
  • Cible SDK: Définissez la version appropriée dans android/app/build.gradle.

Emplacements des Actifs et de la Configuration

Ici, vous trouverez les fichiers clés pour les icônes d'applications, les écrans de splash, les liens profonds et les autorisations :

ConfigurationEmplacement iOSEmplacement Android
Icônes d'Applicationios/App/App/Assets.xcassetsandroid/app/src/main/res
Écrans de Splashios/App/App/Assets.xcassetsandroid/app/src/main/res
Liens Profondsios/App/App/Info.plistAndroidManifest.xml
AutorisationsInfo.plistAndroidManifest.xml

Avec ces configurations en place, vous êtes prêt à construire et à tester votre application sur les appareils mobiles.

Construire et Tester

En utilisant la configuration décrite précédemment, vous pouvez maintenant construire et tester votre Capacitor application pour vous assurer qu'elle fonctionne correctement sur divers appareils.

Commandes de Construction et de Lancement

Une fois votre application configurée pour les plateformes mobiles, il est temps de lancer les tests. Commencez par mettre à jour vos actifs web :

npm run build
npx cap sync

Ensuite, utilisez les commandes appropriées pour votre plateforme cible :

Pour iOS :

npx cap run ios

Pour Android :

npx cap run android

Ces commandes construiront et lanceront votre application sur un simulateur ou un appareil connecté. Tester sur les appareils réels et les simulateurs est crucial pour identifier les problèmes spécifiques à la plateforme.

Ajout de Plugins Capacitor

Les plugins Capacitor vous permettent d'ajouter des fonctionnalités natives à votre application. Par exemple, pour inclure les capacités de la caméra, de la géolocalisation et de stockage, exécutez :

npm install @capacitor/camera @capacitor/geolocation @capacitor/storage
npx cap sync

After l'installation, configurez les plugins dans vos projets natifs. Voici un aperçu rapide des exigences de configuration :

PluginConfiguration iOSConfiguration Android
CaméraAjouter Description de confidentialitéAjouter des autorisations au manifeste
LocalisationAjouter une description d'utilisation de la localisationAjouter des autorisations de localisation
StockagePas de configuration supplémentaire nécessairePas de configuration supplémentaire nécessaire

Mises à jour en temps réel avec Capgo

Capgo Interface de tableau de bord de mise à jour en temps réel

Pour simplifier la mise en production et les tests, vous pouvez intégrer des outils de mise à jour en temps réel comme Capgo. Cette service a déjà délivré plus de 23,5 millions de mises à jour, avec 95 % des utilisateurs recevant des mises à jour dans les 24 heures et un taux de réussite global de 82 % [1].

Pour ajouter Capgo à votre application :

npm install @capgo/capacitor-updater
npx cap sync

Capgo offre plusieurs avantages pendant les tests :

  • Créez des canaux séparés pour les environnements de développement, de test et de production.
  • Appliquez des correctifs de bogues immédiats pendant les tests.
  • Suivez les taux de réussite des mises à jour avec des analyses intégrées.
  • Annulez rapidement les mises à jour si des problèmes surgissent.

Capgo garantit également la livraison sécurisée des mises à jour avec une encryption de bout en bout. Son système de canal vous permet de tester les mises à jour avec des groupes d'utilisateurs sélectionnés avant de les déployer pour tous.

Résumé

Cette guide a parcouru toutes les phases de mise en place et de déploiement d'une application Capacitor , couvrant toutes les étapes essentielles nécessaires pour se lancer et assurer une opération fluide.

Points principaux

La création d'une application Capacitor nécessite une attention soigneuse à la mise en place, à la configuration et aux ajustements spécifiques au plateau. La configuration de votre environnement de développement - y compris les outils comme Node.js et le Capacitor CLI - est un point de départ crucial. La configuration des plateformes comme iOS et Android assure que l'application fonctionne de manière fluide sur les systèmes natifs.

L'utilisation d'un système de mise à jour tel que Capgo peut simplifier la gestion des versions et aider à maintenir la stabilité de l'application [1].

Voici un aperçu des principales étapes :

PhaseÉtapesConseils
Configuration initialeInstallez les outils, CLI configurationUtilisez les dernières versions stables
ConfigurationRéglage des paramètres de plateforme, ajout de pluginsSuivez les lignes directrices spécifiques à la plateforme
TestConstruisez et testez sur les appareilsPriorisez les tests sur des appareils réels
DéploiementGérez les mises à jour, le contrôle de versionUtilisez des pipelines automatisés pour l'efficacité

Continuez de Capacitor Guide étape par étape de l'initialisation de l'application

Si vous utilisez Capacitor Guide étape par étape de l'initialisation de l'application pour planifier l'automatisation CI/CD, connectez-le à Capgo CI/CD pour le flux de travail du produit dans Capgo CI/CD, Capgo Builds natifs pour le flux de travail du produit dans Capgo Builds natifs, Intégrations Capgo pour le flux de travail du produit dans Intégrations Capgo, Intégration CI/CD pour le détail d'implémentation dans Intégration CI/CD, et GitHub Actions Integration pour le détail d'implémentation dans GitHub Actions Integration.

Mises à jour en direct pour les applications Capacitor

Lors d'un bug dans la couche web, expédiez la correction par le biais de Capgo au lieu d'attendre des jours pour l'approbation de la boutique d'applications. Les utilisateurs reçoivent l'actualisation en arrière-plan tandis que les modifications natives restent dans le chemin de revue normal.

Démarrer maintenant

Dernières actualités de notre Blog

Capgo vous offre les meilleures informations nécessaires pour créer une application mobile véritablement professionnelle.