Allez directement au contenu principal
Mises à jour directes

Show the latest version when users open your app

Par défaut, un live update exécute une session après le téléchargement. Les modes de mise à jour directe l'appliquent au lancement au lieu de cela, derrière votre écran de splash, de sorte que la première page que les utilisateurs voient est déjà la nouvelle version.

Un support humain de Martin

autoUpdate : à l'installation, au lancement ou toujours
L'écran de splash est maintenu jusqu'à ce que l'update soit prêt
Les téléchargements delta gardent l'attente courte

Le problème

Mises à jour de fond en retard d'une session

Ce qui se passe dans le mode par défaut

1

L’utilisateur ouvre l'application

L'application démarre sur le paquet qu'elle a déjà. L'actualiseur vérifie si un nouveau paquet est disponible et le 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 qui a été installé avant votre mise à jour.

3

La mise à jour s'applique à la prochaine reprise

Lorsque l'utilisateur quitte l'application, l'actualiseur installe le nouveau bundle. Il le voit la prochaine fois qu'il ouvre l'application.

Pour la plupart des mises à jour, c'est le bon compromis. Lorsque la session qui démarre après votre téléchargement doit exécuter le nouveau code, utilisez un mode de mise à jour direct.

Lorsque la première session compte

Un flux de paiement ou de connexion brisé

Les utilisateurs qui ouvrent l'application ne devraient pas passer par l'écran cassé une fois de plus avant que la correction ne soit appliquée.

A une sécurité de la couche web

Vous voulez que le JavaScript corrigé s'exécute dès le lancement, et non à la prochaine session.

A une mise à jour datée

Terms, notices, or event content that must be current on the first screen users see.

La Solution

Mise à jour directe : quels changements ?

Le correcteur vérifie au lancement tandis que votre écran de splash reste visible. Si une nouvelle version est disponible, il la télécharge et l'applique avant que l'écran de splash ne se cache.

Mode par défaut (en arrière-plan)

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

Pas d'attente à la mise en ligne. Les utilisateurs voient l'update la session suivante.

Mode direct (onLaunch)

1
L'utilisateur ouvre l'application et l'écran de démarrage reste affiché
2
L'actualiseur vérifie et télécharge les fichiers modifiés
3
L'actualisation s'applique, la splash cache, la nouvelle version s'affiche

Les utilisateurs voient la nouvelle version à l'écran d'accueil. Ils attendent à l'écran de démarrage pendant le téléchargement.

Documentation du comportement d'actualisation

Comment ça marche

Comment configurer les mises à jour directes

Un mode direct est une configuration native, il est donc inclus dans une build de magasin en premier. Ensuite, chaque live update le suit. Les commandes proviennent des Capgo docs.

  1. Ajoutez le plugin d'écran de démarrage et choisissez un mode

    Installez @capacitor/écran de démarrage, 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 },
    }
    Traitement de l'écran de démarrage
  2. Envoyez la configuration dans une build de magasin

    La configuration de capacitor est compilée dans l'application native, donc le nouveau mode atteint les utilisateurs avec votre prochaine mise à jour de magasin. Capgo Build peut la produire dans le cloud.

    npx @capgo/cli@latest build request --platform ios
    npx @capgo/cli@latest build request --platform android
    Documentation de Capgo Build
  3. Téléchargez les bundles en delta

    Les utilisateurs attendent le téléchargement au démarrage, donc envoyez uniquement les fichiers modifiés. Le CLI détecte les modes d'application instantanée et sollicite un téléchargement delta.

    npx @capgo/cli@latest bundle upload --channel production --delta
    Documentation des mises à jour delta
  4. Conservez le rôle-back automatique sur

    Appelez notifyAppReady() une fois que votre application a démarré. Si une nouvelle bundle échoue à démarrer, le dispositif revient à la dernière version fonctionnelle.

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

Choisissez le mode qui convient à votre application

Les mises à jour directes sont un échange : une courte attente au lancement en échange de la nouvelle version sur la première page.

Trois modes d'application instantanée

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

  • Seulement après une installation fraîche ou une mise à jour du magasin de l'application native
  • lorsque l'application démarre à partir d'un état tué (démarrage froid)
  • toujours : à chaque vérification de fond, même lorsque l'application est ouverte
Paramètres de mise à jour

3

Modes d'application instantanée dans autoUpdate

Gestion de l'écran de chargement

Pour les modes directs, @capacitor/splash-screen est requis avec launchAutoHide défini sur false, et autoSplashscreen défini sur true. L'actualiseur masque l'écran de chargement une fois l'actualisation appliquée, ou une fois qu'il sait qu'aucune mise à jour n'est nécessaire.

  • Aucune appelle manuelle SplashScreen.hide() n'est nécessaire
  • keepUrlPathAfterReload garde l'utilisateur sur la même route après le rechargement
  • Écoutez l'événement appReady si vous avez besoin d'autres tâches après que le splash se cache.
Gestion de l'écran de chargement

autoSplashscreen

Requis pour chaque mode direct

Compromis à prévoir

Les utilisateurs attendent le téléchargement au lancement, et avec toujours une mise à jour, ils peuvent recharger l'application tout en cours d'utilisation. Prévoyez les deux.

  • Télécharger avec --delta afin que seuls les fichiers modifiés téléchargent
  • Save and restore app state so a reload does not lose user progress
  • Conserver le mode par défaut lorsque une session de retard est suffisante
Mises à jour delta

--delta

Recommandé pour chaque téléchargement direct

Quand utiliser les mises à jour directes

Utilisez un mode direct lorsque la session actuelle doit exécuter le nouveau code. Conservez le mode par défaut pour tout le reste.

Correctifs de bogues critiques

Bogues de paiement, de connexion ou de données où l'exécution de l'ancien code pendant une autre session est trop longue.

Première utilisation : onboarding

atInstall applies the latest bundle right after a fresh install or store update, so new users start on your current onboarding.

Contenu obsolète

Event pages, notices, or terms that must be current when users open the app.

Correctifs de sécurité

Mises à jour web sécurisées qui s'exécutent dès le lancement. Les correctifs natifs code nécessitent toujours une mise à jour de magasin.

Sorties régulières

Les ajustements de style et les petites fonctionnalités ne justifient généralement pas une attente à la sortie. Le mode par défaut les applique une session plus tard.

Applications qui restent ouvertes pendant des heures

Avec des vérifications périodiques (toutes les 10 minutes par défaut), des mises à jour peuvent être appliquées même si l'application est ouverte. Sauvegardez l'état avant de vous y fier.

Rendre l'attente à la mise en route courte

La vitesse de mise à jour directe réduit considérablement le temps d'attente à la mise en ligne.

~50ms

Latence typique API

Delta

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

1B+

Mises à jour délivrées par mois

Applications créées avec Capacitor

Public information apps need urgent content fixes

Les applications d'urgence, de santé et civiques ne peuvent pas attendre des jours pour corriger une liste de vérification brisée, un lien de ressource ou un avis spécifique à l'emplacement. Les mises à jour directes permettent au niveau web de bouger dès que la correction est approuvée.

icône de l'application FEMA MÉTÉO

FEMA

Des erreurs mineures dans le contenu peuvent devenir urgentes.

Google Play installe
1,6M
Notation de magasin
4.0
Icône de l'application Conecte SUS MEDICAL

Conecte SUS

Enregistrements de santé et surfaces de conseils où les modifications d'une copie approuvée nécessitent une livraison rapide.

Google Play installe
27,7M
Note de notation du magasin
4.6
icône de l'application e-Título SOCIAL

e-Título

Flux d'identité civique où des conseils sûrs de version sont essentiels sur plusieurs appareils.

Installs sur Google Play
54,9M
Note de notation du magasin
4.8

Preuves de clients

Ce que les équipes qui utilisent Capgo disent

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

Kapil

Fondateur, NuTriQ

« Pouvoir envoyer des mises à jour OTA en production instantanément sans attendre les cycles de revue complets de l'App Store a été un immense avantage opérationnel. »

Portrait de Sergiu S

Sergiu S

Développeur en chef, drivolino GmbH

“Le Capgo Capacitor Updater plugin a complètement transformé la façon dont nous expédions les mises à jour. Ce qui prenait des jours maintenant prend juste des minutes.”

Portrait de Luis Dominguez

Luis Dominguez

Qui paie, Anirol

“Depuis que j'ai commencé à utiliser Capgo tout est plus rapide, et je peux donner à mes utilisateurs le temps qu'ils méritent sans négliger ma vie quotidienne.”

FAQ

Questions sur les mises à jour directes

Quand les utiliser, comment les configurer et ce qu'elles coûtent au lancement.

Utilisons-nous des mises à jour directes ou le mode de fond par défaut ?

Utilisez le mode par défaut pour la plupart des mises à jour : il n'y a pas d'attente au lancement, et les utilisateurs reçoivent la mise à jour la session suivante. Utilisez un mode direct lorsque la session qui commence après votre téléchargement doit exécuter le nouveau code, par exemple une vérification de paiement brisée ou une mise à jour de sécurité de la couche web.

Mise à jour de comportement

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

atInstall applique une mise à jour immédiatement uniquement après une installation fraîche ou une mise à jour de l'application native, puis se comporte comme la valeur par défaut. onLaunch s'applique immédiatement lorsque l'application démarre à partir d'un état tué. toujours vérifie à chaque fois que l'application est en avant-plan et s'applique dès que la téléchargement est terminé, même si l'utilisateur est en train d'utiliser l'application.

Paramètres de mise à jour

Pourquoi le plugin de 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 éclat ou l'ancien UI avant le rechargement. Avec eux, le splash reste en place jusqu'à ce que la mise à jour soit appliquée ou que l'application mette en place que celle-ci n'est pas nécessaire.

Gestion de l'écran de splash

Pouvez-vous activer les mises à jour directes avec un live update ?

Non. autoUpdate vit dans capacitor.config, qui est lu dans l'application native au moment de la construction. Envoyez la nouvelle configuration dans une mise à jour de magasin. Après cela, chaque live update suit le nouveau mode.

Documents de compatibilité native

Notre configuration 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 toujours. Déplacez la configuration vers autoUpdate dans votre prochaine mise à jour native.

Paramètres de mise à jour

Placez votre prochaine correction sur la première page

Try a direct update mode on a test build during the trial and measure the launch wait on your own app.

Un soutien humain de Martin

14 jours d'essai gratuit. Pas de carte de crédit requise.