Aller au contenu principal
Mises à jour directes

Affichez la dernière version dès l’ouverture de votre app

Par défaut, un live update s’exécute une session après son téléchargement. Les modes de mise à jour directe l’appliquent plutôt au lancement, derrière votre écran de démarrage, pour que le premier écran affiché soit déjà la nouvelle version.

autoUpdate : atInstall, onLaunch ou always
Splash screen maintenu jusqu’à la mise à jour prête
Les téléchargements delta réduisent l’attente

Le problème

Les mises à jour en arrière-plan arrivent une session plus tard

Ce qui se passe en mode par défaut

1

L'utilisateur ouvre l'application

L’app démarre avec le bundle qu’elle possède déjà. Le module de mise à jour vérifie s’il existe une nouvelle version et la télécharge en arrière-plan.

2

La session exécute la version actuelle

Pour le reste de cette session, l’utilisateur exécute le code installé avant votre correctif.

3

La mise à jour s'applique à la reprise suivante

Lorsque l’utilisateur quitte l’app, le système de mise à jour installe le nouveau bundle. Il le verra à la prochaine ouverture de l’app.

Pour la plupart des releases, c’est le bon compromis. Lorsque la session qui démarre après votre upload doit exécuter le nouveau code, utilisez un mode de mise à jour directe.

Lorsque la première session compte

Un flux de paiement ou de connexion cassé

Les utilisateurs qui ouvrent l’app ne devraient pas repasser par l’écran cassé avant que le correctif ne s’applique.

Un correctif de sécurité côté web

Vous voulez que le JavaScript patché s'exécute dès le lancement, et non lors de la session suivante.

Un changement lié à une date

Des conditions, des mentions ou du contenu d'événement qui doivent être à jour dès le premier écran affiché.

La solution

Ce qui change avec le mode direct update

L'updater vérifie au lancement pendant que votre splash screen reste affiché. Si un nouveau bundle est disponible, il le télécharge et l'applique avant que le splash screen ne disparaisse.

Mode par défaut (atBackground)

1
L'utilisateur ouvre l'application
2
L'application affiche la version actuelle
3
La mise à jour se télécharge en arrière-plan
4
La mise à jour s'applique à la reprise suivante

No wait at launch. Users see the update one session later.

Mode direct (onLaunch)

1
L'utilisateur ouvre l'app et le splash screen reste affiché
2
L'updater vérifie et télécharge les fichiers modifiés
3
La mise à jour s'applique, le splash screen disparaît, la nouvelle version s'affiche

Les utilisateurs voient la nouvelle version dès le premier écran. Ils patientent sur le splash screen pendant le téléchargement.

Docs : comportement des mises à jour

Comment ça marche

Comment configurer les mises à jour directes

Le mode direct est une configuration native, il est donc livré d'abord dans un build pour les stores. Ensuite, chaque live update le suit. Les commandes viennent de la doc Capgo.

  1. Ajoutez le plugin splash screen et choisissez un mode

    Installez @capacitor/splash-screen, puis configurez autoUpdate, autoSplashscreen et launchAutoHide dans capacitor.config.ts.

    npm install @capacitor/splash-screen
    npx cap sync
    
    // capacitor.config.ts
    plugins: {
      CapacitorUpdater: {
        autoUpdate: 'onLaunch', // or 'atInstall' / 'always'
        autoSplashscreen: true,
        keepUrlPathAfterReload: true,
      },
      SplashScreen: { launchAutoHide: false },
    }
    Gestion du splash screen
  2. Incluez la config dans un build pour les stores

    Le fichier capacitor.config est compilé dans l'app native, donc le nouveau mode arrivera chez les utilisateurs avec votre prochaine release sur les stores. Capgo Build peut le générer dans le cloud.

    npx @capgo/cli@latest build request --platform ios
    npx @capgo/cli@latest build request --platform android
    Capgo Docs de build
  3. Envoyez les bundles en deltas

    Les utilisateurs attendent le téléchargement au lancement, donc n'envoyez que les fichiers modifiés. CLI détecte les modes d'application instantanée et propose un upload de delta.

    npx @capgo/cli@latest bundle upload --channel production --delta
    Docs des delta updates
  4. Gardez le rollback automatique activé

    Appelez notifyAppReady() une fois votre app démarrée. Si un nouveau bundle échoue au démarrage, l'appareil revient au dernier bundle fonctionnel.

    import { CapacitorUpdater } from '@capgo/capacitor-updater'
    
    await CapacitorUpdater.notifyAppReady()
    Docs de notifyAppReady()

Choisissez le mode adapté à votre app

Les mises à jour directes sont un compromis : une courte attente au lancement en échange de la nouvelle version dès le premier écran.

Trois modes d'application instantanée

Configurez autoUpdate dans capacitor.config.ts. Chaque mode définit quand une mise à jour peut s'appliquer pendant que l'utilisateur attend.

  • atInstall : uniquement juste après une première installation ou une mise à jour de l'app native via les stores
  • onLaunch : quand l'app démarre après avoir été tuée (cold start)
  • toujours : à chaque vérification au premier plan, même quand l'app est ouverte
Paramètres de l'updater

3

Modes d'application immédiate dans autoUpdate

Gestion du splash screen

Les modes directs nécessitent @capacitor/splash-screen avec launchAutoHide défini sur false et autoSplashscreen sur true. L'updater masque le splash screen une fois la mise à jour appliquée, ou une fois qu'il sait qu'aucune mise à jour n'est nécessaire.

  • Aucun appel manuel à SplashScreen.hide() nécessaire
  • keepUrlPathAfterReload maintient l'utilisateur sur la même route après le rechargement
  • Écoutez appReady si vous avez besoin d’actions supplémentaires après la disparition du splash
Gestion du splash screen

autoSplashscreen

Requis pour chaque mode direct

Compromis à prévoir

Les utilisateurs attendent le téléchargement au lancement, et avec une mise à jour, ils peuvent recharger l'app à tout moment pendant son utilisation. Prévoyez les deux cas.

  • Faites un upload avec --delta pour ne télécharger que les fichiers modifiés
  • Sauvegardez et restaurez l'état de l'app pour conserver la progression au rechargement
  • Gardez le mode par défaut quand un délai d'une session convient
Docs des delta updates

--delta

Recommandé pour chaque upload de mise à jour directe

Quand utiliser les mises à jour directes

Utilisez le mode direct quand la session actuelle doit exécuter le nouveau code. Gardez le mode par défaut pour le reste.

Corrections de bugs critiques

Bugs de paiement, de connexion ou de données où utiliser l'ancien code une session de plus est inacceptable.

Onboarding au premier lancement

atInstall applique le dernier bundle juste après une nouvelle installation ou une mise à jour depuis les stores, pour que les nouveaux utilisateurs démarrent sur votre onboarding actuel.

Contenu daté

Pages d'événements, annonces ou conditions qui doivent être à jour dès que l'utilisateur ouvre l'app.

Correctifs de sécurité

Corrections de sécurité de la couche web exécutables dès le lancement. Les correctifs du code natif nécessitent toujours une release sur les stores.

Releases de routine

Les ajustements de style et les petites fonctionnalités justifient rarement l'attente au lancement. Le mode par défaut les applique une session plus tard.

Apps restant ouvertes des heures

Avec l'option always, des vérifications périodiques (toutes les 10 minutes par défaut) peuvent appliquer une mise à jour pendant que l'app est ouverte. Sauvegardez l'état avant de compter dessus.

Réduire l'attente au lancement

L'attente au lancement correspond à la vérification de la mise à jour plus le téléchargement. Les delta updates limitent le téléchargement aux seuls fichiers modifiés.

~50 ms

Latence API typique

Delta

Seuls les fichiers modifiés sont téléchargés

1 Md+

Mises à jour livrées par mois

Apps développées avec Capacitor

Correctifs de contenu urgents pour les apps d'information publique

Les apps d'urgence, de santé ou civiques ne peuvent pas attendre des jours pour corriger une checklist défectueuse, un lien de ressource ou un avis propre à un lieu. Les mises à jour directes permettent à la couche web d'évoluer dès que le correctif est approuvé.

Icône de l'app FEMA MÉTÉO

FEMA

Des consignes d'urgence où une petite erreur de contenu peut devenir critique.

Installations Google Play
1,6 M
Note du store
4.0
Icône de l'application Conecte SUS MÉDICAL

Connectez SUS

Dossiers médicaux et interfaces de conseils où les contenus approuvés doivent être diffusés rapidement.

Installations Google Play
27,7 M
Note du store
4.6
Icône de l'application e-Título Social

e-Título

Parcours d’identité civique où des consignes fiables selon la version sont essentielles sur tous les appareils.

Installations Google Play
54,9 M
Note du store
4.8

Témoignages clients

Ce que disent les équipes qui déploient avec Capgo

5.0/5 noté par les équipes de développeurs 9,400+ équipes Lire les avis

Kapil

Fondateur, NuTriQ

“Pouvoir pousser instantanément des mises à jour OTA en production sans attendre les cycles complets de validation de l’App Store est un avantage opérationnel énorme.”

Portrait de Sergiu S

Sergiu S

Développeur principal, drivolino GmbH

« Le plugin Capgo Capacitor Updater a totalement transformé notre façon de déployer les mises à jour. Ce qui prenait des jours ne prend plus que quelques minutes. »

Portrait de Luis Dominguez

Luis Dominguez

Celui qui paie, Anirol

« Depuis que j'utilise Capgo, tout est plus rapide, et je peux offrir à mes utilisateurs le temps qu'ils méritent sans négliger ma vie quotidienne. »

FAQ

Questions sur les direct updates

Quand les utiliser, comment les configurer et quel est leur coût au lancement.

Devons-nous utiliser les direct updates ou le mode background par défaut ?

Utilisez le mode par défaut pour la plupart des releases : il n'y a pas d'attente au lancement et les utilisateurs reçoivent la mise à jour lors de la session suivante. Utilisez un mode direct lorsque la session qui démarre après votre upload doit exécuter le nouveau code, par exemple un checkout défectueux ou un correctif de sécurité de la couche web.

Docs : comportement des mises à jour

Quelle est la différence entre atInstall, onLaunch et always ?

atInstall applique une mise à jour immédiatement, uniquement après une nouvelle installation ou une mise à jour de l'app native sur le store, puis se comporte comme le mode par défaut. onLaunch s'applique immédiatement au démarrage de l'app après une fermeture complète. always vérifie à chaque passage au premier plan et s'applique dès que le téléchargement est terminé, même si l'utilisateur est déjà dans l'app.

Paramètres de l'updater

Pourquoi le plugin splash screen est-il requis ?

Les modes directs appliquent la mise à jour pendant que l'utilisateur attend. Sans @capacitor/splash-screen, autoSplashscreen: true et launchAutoHide: false, les utilisateurs peuvent voir un scintillement ou l'ancienne UI avant le rechargement. Avec ces options, l'écran de splash reste affiché jusqu'à ce que la mise à jour soit appliquée ou que l'updater confirme qu'aucune n'est nécessaire.

Gestion du splash screen

Pouvons-nous activer les direct updates avec un live update ?

Non. autoUpdate se trouve dans capacitor.config, qui est lu par l'app native au moment du build. Livrez ce nouveau paramètre dans une release sur les stores. Ensuite, chaque live update suit le nouveau mode.

Docs de compatibilité native

Notre config utilise directUpdate. Est-ce toujours pris en charge ?

directUpdate est obsolète mais toujours détecté. Ses valeurs correspondent aux modes autoUpdate atInstall, onLaunch et always. Migrez le paramètre vers autoUpdate lors de votre prochaine release native.

Paramètres de l'updater

Déployez votre prochain correctif sur le premier écran

Essayez un mode direct update sur un build de test pendant l'essai et mesurez l'attente au lancement sur votre propre app.

Essai gratuit de 14 jours. Aucune carte bancaire requise.