Capacitor CI/CD Pipeline Setup Guide

Want faster app updates avec un minimum d'effort ? Configuration d'un pipeline CI/CD pour votre Capacitor automate la construction, les tests et la mise en ligne, ce qui vous permet de gagner du temps et de réduire les erreurs. Voici ce que vous obtiendrez :

Mises à jour en temps réel: Push updates instantly without app store delays. 95% of users receive updates in 24 hours.
Pipelines de base: Automatisez les builds déclenchés par l'activité de branchage (main, staging, feature/*) et définissez des environnements séparés pour le stade et la production.
Capgo IntégrationUtilisez Capgo pour déployer des mises à jour sécurisées et chiffrées, gérer canaux de mise à jour, et surveiller les performances.
Plans abordables: Les plans commencent à 12 $/mois avec des mises à jour en direct, des analyses et environ 15 builds natifs/mois.

Capacitor CI/CD pipelines simplify workflows, improve efficiency, and ensure your app stays up-to-date seamlessly. Let’s dive into the details.

Exigences de configuration

Prerequisites

Veuillez vous assurer d'avoir les éléments suivants installés et configurés :

Node.js LTS, Capacitor CLI, et Git
Un compte sur votre plateforme CI préférée (comme GitHub Actions, GitLab CI, ou Jenkins)
A un compte Capgo pour gérer les mises à jour en direct

Une fois ces éléments prêts, procédez à définir vos déclencheurs et étapes de construction dans votre plateforme CI.

Intégrer Appflow avec votre pipeline CICD

Étapes de configuration du pipeline

Maintenant que vous avez géré les prérequis, il est temps de configurer les déclencheurs et les paramètres d'environnement de votre pipeline.

Déclencheurs et étapes de construction

Configurez votre pipeline CI/CD pour déclencher automatiquement les constructions en fonction de l'activité spécifique d'une branche. Voici comment le configurer :

Déclencheurs de branche:
- Utilisez main pour les builds de production.
- Utilisez staging pour des fins de test.
- Utilisez feature/* pour le travail de développement.
Build steps:
- Installez toutes les dépendances nécessaires.
- Run unit tests to ensure code quality.
- Construirez les actifs web pour l'application.
- Générez des binaires natifs pour les plateformes mobiles ou de bureau.
- Déployez la construction dans votre environnement de test pour une validation supplémentaire.

Paramètres d'environnement

Définissez des fichiers de configuration d'environnement séparés pour le stade et la production pour garder les choses organisées et sécurisées. Voici un exemple de configuration.

# staging.env
ENVIRONMENT=staging
API_ENDPOINT=https://api-staging.example.com
LIVE_UPDATES_ENABLED=true

# production.env
ENVIRONMENT=production
API_ENDPOINT=https://api.example.com
LIVE_UPDATES_ENABLED=true

Pour les données sensibles comme les clés API et les certificats, assurez-vous de les stocker de manière sécurisée dans le système de gestion des secrets de votre plateforme CI. Cela garantit que votre pipeline reste à la fois fonctionnel et sécurisé.

Capgo Guide d'intégration

Capgo Live Update Interface de tableau de bord

Une fois que vous avez configuré vos étapes de build et de déploiement, il est temps d'intégrer Capgo. Cela vous permet de publier des mises à jour directement dans votre application, en ignorant les retards d'approbation des magasins d'applications.

Étapes de configuration de Capgo

Après avoir préparé votre pipeline CI/CD, suivez ces étapes pour ajouter Capgo à votre projet :

Premièrement, installez le Capgo CLI:

npx @capgo/cli init

Ensuite, procédez avec ces commandes :

Construirez votre application: npm install && npm run build
Déployez les mises à jour: npx @capgo/cli deploy
Annuler les mises à jour: npx @capgo/cli rollback

Voici un exemple d'une tâche GitHub Actions pour déployer les mises à jour :

- name: Deploy to Capgo
  run: |
    npm install @capgo/cli
    npx @capgo/cli deploy
  env:
    CAPGO_TOKEN: ${{ secrets.CAPGO_TOKEN }}

Caractéristiques clés de Capgo

Capgo offre plusieurs avantages aux applications Capacitor, notamment :

Mises à jour sécurisées et efficaces: Mises à jour chiffrées et différentielles réduisent les tailles des payloads tout en garantissant une livraison sécurisée.
Gestion de canauxCréez des canaux de préproduction et de production pour contrôler la mise à jour des mises à jour.
Tableau de bord d'analyseSuivez les taux de mise à jour réussies et surveillez l'adoption des utilisateurs avec des informations détaillées.

Capgo Plans et Tarifs

Capgo propose des plans flexibles pour répondre à différents besoins :

SOLO: 12 €/mois (1 000 MAU, 2 Go de stockage, 50 Go de bande passante)
MAKER: 33 €/mois (10 000 MAU, 5 Go de stockage, 500 Go de bande passante)
TEAM: 83 €/mois (100 000 MAU, 10 Go de stockage, 2 000 Go de bande passante)
PAYGDémarrez à 249 $/mois, avec des options de mise à l'échelle personnalisée, d'accès API et de domaines personnalisés.

Actuellement, Capgo prend en charge plus de 1 900 applications en production, ce qui en fait un choix fiable pour le déploiement continu [1].

Gestion de la Chaîne d'Intégration

Suivi de l'état

Pour maintenir la qualité de votre application et garder vos utilisateurs heureux, il est essentiel de garder un œil sur votre pipeline. Utilisez votre plateforme CI/CD pour configurer des alertes automatiques pour :

État de construction et progression de déploiement
Taux de réussite des mises à jour
Métriques d'adoption des utilisateurs
Rapports d'erreurs et journaux de crash

Associez ces alertes à une documentation claire pour garantir un suivi fluide et une résolution rapide des problèmes.

Guide de la documentation

Une bonne documentation maintient votre équipe sur la même page et permet une opération fluide. Assurez-vous que votre documentation couvre :

Configuration du pipeline: Détails comme les déclencheurs de build, les variables d'environnement et les paramètres de sécurité.
Procédures de mise à jourÉtapes pour les déploiements, instructions de retrait et Gestion des canaux d'actualisation.
Configuration de la surveillanceComment configurer les alertes, suivre les métriques et répondre aux problèmes.
Lignes directrices de conformitéRègles spécifiques au plateforme, restrictions de mise à jour et autres exigences.

Considérez stocker toutes les documents dans un contrôle de version et les mettre à jour chaque fois que votre pipeline change. Incluez les étapes de dépannage pour les erreurs courantes pour économiser du temps lorsque des problèmes se produisent.

Lignes directrices de la plateforme

Suivez les politiques d'Apple et d'Android en utilisant le système de canaux de Capgo pour assurer des déploiements lisses et conformes :

Test de version bêta: Release updates to small user groups valider les modifications.
Sorties étalées: Roll out updates gradually to catch issues early.
Réparations d'urgence: Annulez rapidement les mises à jour avec un simple clic si quelque chose se passe mal.

Résumé

: Vue d'ensemble des étapes de configuration.

Pour commencer, vous aurez besoin d'installer le CLI, de configurer les builds et les variables d'environnement, de sécuriser vos secrets, d'activer la surveillance et de déployer les mises à jour. Ce processus s'intègre de manière fluide avec les outils de surveillance et d'annulation, garantissant que votre application reste en ligne avec un temps d'arrêt minimal.

Avantages CI/CD

: La connexion entre la configuration et les résultats démontre comment Capgo améliore l'efficacité : les mises à jour atteignent 95 % des utilisateurs en seulement 24 heures. De plus, les tarifs de Capgo commencent à $12 par moisoffrant un avantage coûtant considérable par rapport aux services de legacy qui peuvent facturer jusqu'à 500 $ par mois.Actuellement, Capgo prend en charge plus de 1 900 applications de production [1].

Keep going from Capacitor CI/CD Pipeline Setup Guide

Si vous utilisez Capacitor CI/CD Pipeline Setup Guide planifier l'automatisation de CI/CD, la connecter avec 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 Native Builds, Capgo Intégrations pour le flux de travail du produit dans Capgo Intégrations Intégration CI/CD pour les détails d'implémentation dans Intégration CI/CD, et GitHub Intégration d'actions pour les détails d'implémentation dans GitHub Intégration d'actions.