Types d'actualisation

Capgo prend en charge plusieurs types d'actualisations en temps réel (OTA). Cette page liste et explique tous les types afin que vous puissiez choisir la combinaison appropriée pour votre application.

Appliquer le timing

Contrôles lorsque Une mise à jour est appliquée après son téléchargement.

Type	Description	Utilisation
autoUpdate: "Télécharger en arrière-plan, appliquer lorsque l'utilisateur se déconnecte ou tue l'application" atBackground	La plupart des applications; perturbation minimale	autoUpdate: "Appliquer immédiatement uniquement lors d'une mise à jour de l'application ou d'une mise à jour de l'app store"
Nouveaux utilisateurs obtiennent la dernière version; utilisateurs existants utilisent le flux par défaut atInstall	autoUpdate: "Appliquer immédiatement lors de l'installation, de la mise à jour de l'app store ou après la fermeture de l'application"	Nouveaux utilisateurs obtiennent la dernière version; utilisateurs existants utilisent le flux par défaut
autoUpdate: "Appliquer immédiatement lors de l'installation, de la mise à jour de l'app store ou après la fermeture de l'application" onLaunch	Nouveaux utilisateurs obtiennent la dernière version; utilisateurs existants utilisent le flux par défaut	Équilibre entre fraîcheur et stabilité de session
autoUpdate: always	Appliquer immédiatement chaque fois qu'une mise à jour est téléchargée (y compris lors de la reprise)	Correctifs critiques, applications avec un état simple
autoUpdate: onlyDownload	Télécharger automatiquement et émettre updateAvailable, mais ne jamais appliquer ou définir le prochain bundle automatiquement	Applications qui affichent leur propre invite de mise à jour ou contrôlent exactement quand appeler set()

Configurer dans capacitor.config.ts:

plugins: {
  CapacitorUpdater: {
    autoUpdate: 'atBackground', // default; true is still accepted
    // or: 'off' | 'atInstall' | 'onLaunch' | 'always' | 'onlyDownload'
  }
}

Conseil

Pour plus de détails et la gestion de l'écran de démarrage, voir Comportement de mise à jour.

Conditions de retard

Conditions qui doivent être remplies avant qu'une mise à jour soit installée. Utilisez setMultiDelay pour les combiner (toutes les conditions doivent être satisfaites).

Condition	Description	Exemple
date	Attendez jusqu'à une date spécifique/heure	Coordonner avec la mise à jour côté serveur
arrière-plan	Attendez une durée minimale (ms) après que l'application est passée en arrière-plan	Évitez d'appliquer lors de changements rapides d'application
nativeVersion	Exigez une version minimale de la version binaire native	Bloquer les mises à jour sur la version native incompatible code
kill	Attendez jusqu'à l'événement de kill de l'application suivante	Appliquer uniquement lors d'un redémarrage complet

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

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

Danger

The kill La condition déclenche après le premier événement de mort, et non l'événement de fond suivant comme les autres. Cela sera corrigé dans une prochaine mise à jour.

Bloqueur de version (Politique de canal)

Contrôle les mises à jour semver un canal livrera automatiquement. Défini via --disable-auto-update sur les canaux.

Stratégie	Bloque	Permet d'	Utilisation
aucune	Rien	Toutes les mises à jour	Par défaut; mise à jour complète
majeure	0.0.0 → 1.0.0	Même majeure (par exemple 1.x → 1.y)	Empêcher les modifications de rupture d'atteindre les natives anciennes
mineure	0.0.0 → 1.1.0, 1.1.0 → 1.2.0	Même mineure (par exemple 1.2.x → 1.2.y)	Contrôle plus strict dans la majeure
correction	Toute modification excepté la correction de version	Seulement 0.0.311 → 0.0.314	Très strict; mises à jour uniquement par correction de version
méta-données	Mises à jour sans min_update_version	Mises à jour avec des méta-données de compatibilité explicites	Règles de compatibilité personnalisées par paquet

npx @capgo/cli channel set production --disable-auto-update major

Attention

patch et nécessite une configuration soigneuse. Voir metadata __CAPGO_KEEP_0__ commandes CLI commands Version ciblée pour plus de détails. Types de livraison

Section intitulée « Types de livraison »

le bundle est transféré au appareil. Type

and	Description	Quand utiliser
Tout le bundle	Le bundle JS complet est téléchargé	Première installation, grandes modifications ou lorsqu'il n'y a pas de delta disponible
Delta (manifeste)	Seuls les fichiers modifiés sont téléchargés	La plupart des mises à jour ; plus rapide et plus économe en bande passante

# Full bundle (default)
npx @capgo/cli bundle upload --channel production

# Delta updates
npx @capgo/cli bundle upload --channel production --delta

Conseil

Lorsque vous utilisez les modes d'application instantanée (atInstall, onLaunch, ou always), activez Mises à jour Delta pour minimiser le temps de téléchargement et améliorer l'expérience utilisateur.

Référence rapide

Catégorie	Types
Moment d'application	off, atBackground, atInstall, onLaunch, always, onlyDownload
Conditions de retard	date, background, nativeVersion, kill
Blocage de version	none, major, minor, patch, metadata
Livraison	Bundle complet, Delta (manifeste)

Liés

• Mise à jour du comportement — Configurez le moment et les délais d'application
• Ciblage de version — Routage de version basé sur le canal
• Mises à jour de Delta (manifeste) — Activez les téléchargements partiels
• Canaux — Configuration et priorité des canaux

Continuez à partir des types d'actualisation

Si vous utilisez Types d'actualisation pour planifier la livraison d'actualisations en direct, connectez-le à Capgo Mises à jour en direct pour le flux de travail du produit dans Capgo Mises à jour en direct, Vue d'ensemble pour les détails d'implémentation dans Vue d'ensemble, Fonctionnalités pour les détails d'implémentation dans Fonctionnalités, Comportement d'actualisation pour les détails d'implémentation dans Mise à jour de comportement, et Démarrage pour les détails d'implémentation dans Démarrage.