Comportement de mise à jour

Copiez un prompt de configuration avec les étapes d'installation et le guide Markdown complet pour ce plug-in.

Lorsque vous publiez une mise à jour pour votre application Capgo, vous souhaitez probablement que vos utilisateurs reçoivent cette mise à jour le plus rapidement possible. Mais vous ne voulez pas non plus perturber leur expérience en leur forçant à attendre une mise à jour ou à redémarrer l'application au milieu d'une session.

Le comportement de mise à jour de Capgo est conçu pour trouver un équilibre entre la livraison des mises à jour rapidement et la minimisation de la perturbation pour vos utilisateurs.

Flux de mise à jour par défaut

Par défaut, voici comment Capgo gère les mises à jour d'applications :

Lorsque l'application passe en avant-plan, le plugin Capgo vérifie si une nouvelle mise à jour est disponible. Alors que l'application reste ouverte, il vérifie à nouveau à intervalles réguliers contrôlés par periodCheckDelay (10 minutes par défaut).
Si une mise à jour est trouvée, elle est téléchargée en arrière-plan tandis que l'utilisateur continue à utiliser la version actuelle de l'application.
Une fois le téléchargement terminé, Capgo attend que l'utilisateur mette l'application en arrière-plan.
Lorsque l'utilisateur ramène l'application à l'avant-plan, ils seront en train de lancer la version mise à jour.

Cette progression garantit que les utilisateurs sont toujours en train de lancer la dernière version de votre application, sans jamais être interrompus par des invitations à mettre à jour ou contraints d'attendre des téléchargements.

Pourquoi Cette Approche ?

La mise à jour d'une application lors d'un événement de fond ou de suppression présente quelques avantages clés pour l'expérience utilisateur :

Les utilisateurs ne sont pas interrompus par des invitations à mettre à jour ou contraints d'attendre des téléchargements au milieu d'une session.
Les mises à jour sont appliquées de manière fluide entre les sessions, de sorte que l'expérience de lancement de l'application est toujours fraîche.
Vous pouvez livrer des mises à jour fréquentes sans vous soucier de perturber les utilisateurs actifs.

Le principal inconvénient est que si un utilisateur met votre application en arrière-plan et la reprend rapidement, il peut perdre tout l'état non enregistré depuis que la mise à jour a été appliquée entre ces actions.

Pour atténuer cela, nous recommandons :

Enregistrer l'état fréquemment et le restaurer de manière gracieuse lorsque l'application reprend.
Éviter des mises à jour très fréquentes qui modifient de grandes parties de l'état de l'application.
Considérer la personnalisation du comportement de mise à jour pour les flux sensibles (voir ci-dessous).

Personnaliser Lorsque les Mises à Jour Sont Appliquées

Dans certains cas, vous pouvez vouloir plus de contrôle sur l'exact moment où une mise à jour est appliquée. Par exemple, vous pourriez vouloir vous assurer que l'utilisateur a terminé un flux en cours avant de mettre à jour, ou coordonner une mise à jour d'application avec une modification côté serveur.

Capgo fournit une setDelay fonction qui vous permet de spécifier des conditions qui doivent être remplies avant que la mise à jour soit installée :

import { CapacitorUpdater } from '@capgo/capacitor-updater';

await CapacitorUpdater.setMultiDelay({
  delayConditions: [
    {
      kind: 'date',
      value: '2023-06-01T00:00:00.000Z',
    },
    {
      kind: 'background',
      value: '60000',
    },
  ],
});

Cet exemple retarderait l'installation d'une mise à jour jusqu'après le 1er juin 2023 ET l'application aurait été mis en arrière-plan pendant au moins 60 secondes.

Les conditions de retard disponibles sont :

date : Attendre après une date et heure spécifique pour appliquer la mise à jour.
background : Attendre une durée minimale après que l'application est mise en arrière-plan pour appliquer la mise à jour.
nativeVersion : Attendre l'installation d'un fichier binaire natif avec une version minimale avant d'appliquer la mise à jour.
kill : Attendre l'événement de mort de l'application suivant pour appliquer la mise à jour.

Vous pouvez combiner ces conditions pour contrôler précisément quand une mise à jour est installée.

Application des Mises à Jour Immédiatement

Pour les mises à jour critiques ou les applications avec un état très simple, vous pouvez souhaitez appliquer une mise à jour dès qu'elle est téléchargée, sans attendre un événement de fond ou de mort. Capgo prend en charge cela via la autoUpdate politique dans votre Capacitor config.

Lorsque vous utilisez un mode d'application instantanée, nous fortement recommandons d'activer Mises à jour Delta (manifeste) pour minimiser les temps de téléchargement et améliorer l'expérience utilisateur. Les mises à jour Delta (manifeste) téléchargent uniquement les fichiers modifiés au lieu du bundle entier, ce qui est particulièrement important lorsque les mises à jour sont appliquées immédiatement tandis que les utilisateurs utilisent votre application.

Pourquoi cela compte pour les modes d'application instantanée :

Actualisations rapides: Les téléchargements plus petits signifient que les mises à jour se terminent rapidement, réduisant le temps pendant lequel les utilisateurs voient des écrans de chargement.
Une meilleure expérience mobile: Les utilisateurs sur les réseaux cellulaires ou les connexions plus lentes ne seront pas confrontés à des temps d'attente longs.
Utilisation de bande passante réduite: Seuls les fichiers modifiés sont téléchargés, ce qui économise des données pour vous et vos utilisateurs.

Lorsque autoUpdate est défini sur "atInstall", "onLaunch", ou "always" dans votre capacitor.config, le CLI le détecte. Dans les environnements non interactifs, il envoie des mises à jour Delta (manifeste) automatiquement, et dans les environnements interactifs, il vous invite à confirmer avant de télécharger. directUpdate La configuration legacy est toujours détectée. Utilisez --no-delta pour forcer un téléchargement de bundle complet.

Activer les mises à jour Delta (manifest) est aussi simple que de --delta drapeau lors de l'upload des bundles :

npx @capgo/cli@latest bundle upload --delta

En savoir plus dans la documentation sur les mises à jour Delta (manifest) est défini dans votre.

autoUpdate fichier, et non en JavaScript __CAPGO_KEEP_0__. Il prend en charge ces valeurs : capacitor.config.ts file, not in JavaScript code. It supports these values:

false Contexte : Fragment de texte HTML d'une chaîne de dialogue Capgo plus longue (clé parente `alternatives_cta_questions`). Page/zone : Comparaison de alternatives de mise à jour en direct de Capacitor. Rôle : Paragraphe de marketing ou juridique long. Vu dans : page alternatives.astro. Conservez les termes de produit et de marque Capgo ainsi que les termes de développeur exactement. Clé de message `alternatives_cta_questions` (Questions de CTA pour les alternatives). | Fragment de texte HTML d'une chaîne de dialogue Capgo plus longue (clé parente `appflow_cta_questions`). Page/zone : Comparaison et migration de Appflow. Rôle : Paragraphe de marketing ou juridique long. Vu dans : page ionic-appflow.astro. Conservez les termes de produit et de marque Capgo ainsi que les termes de développeur exactement. Clé de message `appflow_cta_questions` (Questions de CTA pour Appflow). | Fragment de texte HTML d'une chaîne de dialogue Capgo plus longue (clé parente `capwesome_cta_questions`). Page/zone : Page de comparaison de Capawesome. Rôle : Paragraphe de marketing ou juridique long. Vu dans : page capwesome.astro. Conservez les termes de produit et de marque Capgo ainsi que les termes de développeur exactement. Clé de message `capwesome_cta_questions` (Questions de CTA pour Capawesome). | Fragment de texte HTML d'une chaîne de dialogue Capgo plus longue (clé parente `consulting_faq_subtitle`). Page/zone : Page de services de conseil. Rôle : Sous-titre ou tagline de section. Vu dans : page consulting.astro. Conservez les termes de produit et de marque Capgo ainsi que les termes de développeur exactement. Clé de message `consulting_faq_subtitle` (Sous-titre FAQ pour les services de conseil). | Page/zone : Comparaison et migration de Appflow. Rôle : Étiquette de navigation ou élément de navigation court. Vu dans : page ionic-appflow.astro, page ionic-enterprise-plugins.astro, page solutions/ionic-enterprise-plugins.astro. Clé de message `appflow_plugins_or` (Appflow Plugins ou). 'off' : Désactiver les vérifications automatiques de mise à jour
true ou 'atBackground' Contexte : Fragment de texte HTML d'une chaîne de dialogue Capgo plus longue (clé parente `alternatives_cta_questions`). Page/zone : Comparaison de alternatives de mise à jour en direct de Capacitor. Rôle : Paragraphe de marketing ou juridique long. Vu dans : page alternatives.astro. Conservez les termes de produit et de marque Capgo ainsi que les termes de développeur exactement. Clé de message `alternatives_cta_questions` (Questions de CTA pour les alternatives). | Fragment de texte HTML d'une chaîne de dialogue Capgo plus longue (clé parente `appflow_cta_questions`). Page/zone : Comparaison et migration de Appflow. Rôle : Paragraphe de marketing ou juridique long. Vu dans : page ionic-appflow.astro. Conservez les termes de produit et de marque Capgo ainsi que les termes de développeur exactement. Clé de message `appflow_cta_questions` (Questions de CTA pour Appflow). | Fragment de texte HTML d'une chaîne de dialogue Capgo plus longue (clé parente `capwesome_cta_questions`). Page/zone : Page de comparaison de Capawesome. Rôle : Paragraphe de marketing ou juridique long. Vu dans : page capwesome.astro. Conservez les termes de produit et de marque Capgo ainsi que les termes de développeur exactement. Clé de message `capwesome_cta_questions` (Questions de CTA pour Capawesome). | Fragment de texte HTML d'une chaîne de dialogue Capgo plus longue (clé parente `consulting_faq_subtitle`). Page/zone : Page de services de conseil. Rôle : Sous-titre ou tagline de section. Vu dans : page consulting.astro. Conservez les termes de produit et de marque Capgo ainsi que les termes de développeur exactement. Clé de message `consulting_faq_subtitle` (Sous-titre FAQ pour les services de conseil). | Page/zone : Comparaison et migration de Appflow. Rôle : Étiquette de navigation ou élément de navigation court. Vu dans : page ionic-appflow.astro, page ionic-enterprise-plugins.astro, page solutions/ionic-enterprise-plugins.astro. Clé de message `appflow_plugins_or` (Appflow Plugins ou).
'atInstall': Appliquer immédiatement uniquement après une installation fraîche ou une mise à jour de l'application native ; sinon utilisez "atBackground" comportement
'onLaunch': Appliquer immédiatement uniquement lorsque l'application est ramenée à l'avant-plan à partir d'un état tué (démarrage froid). Après cette première vérification, reculez vers "atBackground" comportement
'always': Vérifiez à chaque transition en avant-plan et appliquez immédiatement dès que des mises à jour sont disponibles
'onlyDownload': Vérifiez et téléchargez automatiquement, émettez updateAvailable, et n'installez jamais le prochain bundle ou appliquez une mise à jour automatiquement

Tester une Build Native Sans Mises à Jour en Ligne

Voir Tester les Builds Native Sans Mises à Jour pour les garanties de configuration de version native, de politique de canal et de CI.

import { CapacitorConfig } from '@capacitor/cli';

const config: CapacitorConfig = {
  plugins: {
    CapacitorUpdater: {
      autoUpdate: 'always', // or 'atInstall' for updates only on app install/update
      autoSplashscreen: true,
      keepUrlPathAfterReload: true,
    },
    SplashScreen: {
      launchAutoHide: false, // Required when using instant apply with autoSplashscreen
    },
  },
};

export default config;

Avec autoUpdate: 'always', Capgo effectue des vérifications à chaque transition en avant-plan et applique une mise à jour immédiate dès que le téléchargement est terminé pendant cette vérification, même si l'utilisateur utilise actuellement l'application. Les vérifications périodiques contrôlées par periodCheckDelay peuvent déclencher le même comportement d'application immédiate pendant que l'application reste ouverte.

Notez que puisque autoUpdate est une configuration native, les modes d'application instantanée nécessitent une gestion supplémentaire dans votre code JavaScript.

Téléchargement Automatique Sans Application

Si vous souhaitez que Capgo vérifie et télécharge les mises à jour automatiquement mais ne les applique jamais automatiquement, utilisez autoUpdate: 'onlyDownload':

const config: CapacitorConfig = {
  plugins: {
    CapacitorUpdater: {
      autoUpdate: 'onlyDownload',
    },
  },
};

Dans ce mode, le plugin émet updateAvailable après téléchargement d'un bundle. Votre application peut ensuite décider de lancer CapacitorUpdater.set() ou afficher son propre prompt de mise à jour.

Gestion Automatique de l'Ecran de Splash

Pour rendre les modes d'application instantanée plus faciles à utiliser, Capgo fournit une autoSplashscreen option qui gère automatiquement la suppression de l'écran de démarrage pour vous (disponible depuis la version 7.6.0) :

const config: CapacitorConfig = {
  plugins: {
    CapacitorUpdater: {
      autoUpdate: 'always', // or 'atInstall'
      autoSplashscreen: true, // Automatically hide splashscreen
      keepUrlPathAfterReload: true,
    },
    SplashScreen: {
      launchAutoHide: false,
    },
  },
};

Lorsque autoSplashscreen est activé :

Le plugin cache automatiquement l'écran de démarrage lorsque l'une des mises à jour est appliquée
Le plugin cache automatiquement l'écran de démarrage lorsque aucune mise à jour n'est nécessaire
Vous n'avez pas besoin d'écouter manuellement les appReady événements ou d'appeler SplashScreen.hide()

Gestion manuelle de l'écran de démarrage

Si vous préférez un contrôle manuel ou avez besoin de logique personnalisée, vous pouvez désactiver autoSplashscreen et le gérer vous-même :

import { CapacitorUpdater } from '@capgo/capacitor-updater';
import { SplashScreen } from '@capacitor/splash-screen';

CapacitorUpdater.addListener('appReady', () => {
  // Hide splash screen
  SplashScreen.hide();
});

CapacitorUpdater.notifyAppReady();

Le appReady L'événement se déclenche une fois l'application a terminé de s'initialiser et d'appliquer les mises à jour en attente. C'est le moment où il est sûr de montrer l'interface utilisateur de votre application, car cela garantit que l'utilisateur verra la dernière version.

En plus de gérer l'événement appReady nous recommandons de définir l'option de configuration sur keepUrlPathAfterReload lorsque vous utilisez un mode d'application instantanée. Cela préserve l'actuelle URL de chemin lorsqu'une mise à jour est appliquée, ce qui aide à maintenir la position de l'utilisateur dans l'application et à réduire la désorientation. true Si vous n'avez pas géré l'événement

et défini appReady lorsque vous utilisez un mode d'application instantanée, l'utilisateur peut brièvement voir une version obsolète de l'application, être redirigé vers la route initiale ou voir un éclatement lors de l'application de la mise à jour. keepUrlPathAfterReload __CAPGO_KEEP_0__

En utilisant un mode d'application instantanée, vous pouvez livrer des correctifs critiques ou des mises à jour de sécurité, mais cela comporte quelques compromis :

L’utilisateur peut voir un bref éclat ou un état de chargement pendant que la mise à jour est appliquée si vous n'avez pas géré correctement l'écran de splash (soit avec autoSplashscreen ou le traitement manuel appReady des événements).
Si la mise à jour modifie l'état de l'application ou l'interface utilisateur, l’utilisateur peut voir un changement disruptif au milieu d'une session.
La localisation de l'utilisateur dans l'application peut être perdue si keepUrlPathAfterReload n'est pas défini, ce qui peut les dérouter.
Vous devrez gérer soigneusement la sauvegarde et la restauration de l'état pour assurer une transition fluide.

Si vous activez l'application instantanée, nous vous recommandons :

Utiliser autoSplashscreen: true pour la configuration la plus simple, ou gérer manuellement l'événement appReady si vous avez besoin de logique personnalisée.
Paramètres keepUrlPathAfterReload à true contexte
pour conserver l'emplacement de l'utilisateur dans l'application.
Enregistrez et restaurez l'état de l'application chaque fois que nécessaire pour éviter de perdre le progrès de l'utilisateur.

In most cases, the default update behavior provides the best balance of delivering updates quickly and minimizing disruption. But for apps with specific needs, Capgo provides the flexibility to customize when and how updates are applied.

La plupart du temps, le comportement de mise à jour par défaut fournit la meilleure balance entre la livraison rapide des mises à jour et la minimisation de la perturbation. Mais pour les applications ayant des besoins spécifiques, __CAPGO_KEEP_0__ offre la flexibilité de personnaliser quand et comment les mises à jour sont appliquées.

Titre de la section « Continuez de la section Comportement de mise à jour » Si vous utilisez Comportement de mise à jour pour planifier la livraison de mises à jour en direct, connectez-l’à la mise à jour en direct Capgo pour le flux de travail du produit dans les mises à jour en direct de Capgo Vue d'ensemble pour le détail d'implémentation dans Vue d'ensemble Fonctionnalités pour le détail d'implémentation dans Fonctionnalités Types de mise à jour pour le détail d'implémentation dans Types de mise à jour, et Démarrage rapide pour le détail d'implémentation dans Démarrage rapide