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 qu'elle a été téléchargée.

Type	Description	Cas d'utilisation
Défaut	Télécharger en arrière-plan, appliquer lorsque l'utilisateur met l'application en arrière-plan ou ferme l'application	La plupart des applications; perturbation minimale
directUpdate: atInstall	Appliquer immédiatement uniquement lors d'une installation fraîche ou d'une mise à jour de l'application Store	Nouveaux utilisateurs obtiennent la dernière version; les utilisateurs existants utilisent le flux par défaut
directUpdate: onLaunch	Appliquer immédiatement lors d'une installation, d'une mise à jour de l'application Store ou après la fermeture de l'application	Équilibre entre fraîcheur et stabilité de session
mise à jour directe: 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

Configurer dans capacitor.config.ts:

plugins: {
  CapacitorUpdater: {
    directUpdate: false, // default
    // or: 'atInstall' | 'onLaunch' | 'always'
  }
}

Conseil

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

Conditions de retard

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

Condition	Description	Exemple
date	Attendez jusqu'à après 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 en arrière-plan	Évitez d'appliquer pendant des changements d'application rapides
version native	Exigez une version native minimale de binaire	Bloquez les mises à jour pour les binaires incompatibles code
kill	Attendez jusqu'à l'événement de kill de l'application suivant	Appliquez 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

La kill La condition déclenche après l'événement de kill initial, et non l'événement de background suivant. Cela sera corrigé dans une prochaine mise à jour.

Blocage de version (Politique de canal)

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

Bloque	Permet	Utilisation	aucune
Rien	Toutes les mises à jour	none	Mise à jour automatique complète; par défaut
majeur	0.0.0 → 1.0.0	Même version majeure (par exemple 1.x → 1.y)	Empêcher les modifications de rupture d'atteindre les natives anciennes
mineur	0.0.0 → 1.1.0, 1.1.0 → 1.2.0	Même version mineure (par exemple 1.2.x → 1.2.y)	Contrôle plus strict dans la version majeure
patch	Toute modification excepté la mise à jour de patch	Seulement 0.0.311 → 0.0.314	Très strict; mise à jour uniquement de patch
__CAPGO_KEEP_0__	Mises à jour sans min_update_version	Mises à jour avec des métadonné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 metadata exigent une configuration soigneuse. Voir CLI commandes et Ciblage de version pour plus de détails.

Types de livraison

Comment la la bibliothèque est transférée au appareil.

Type	Description	Quand utiliser
Tout le bundle	La bibliothèque JS entière est téléchargée	Première installation, grandes modifications ou lorsqu'il n'y a pas de delta disponible
Delta (manifeste)	Seules les fichiers modifiés sont téléchargés	La plupart des mises à jour ; plus rapide et plus économique 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 __CAPGO_KEEP_0__ directUpdate, 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
Appliquer un délai	Par défaut, atInstall, onLaunch, always
Conditions de retard	date, background, nativeVersion, kill
Blocage de version	none, major, minor, patch, metadata
Livraison	Bundle complet, Delta (manifeste)

Liés

• Comportement de mise à jour — Configuration de l'application de timing et de retards
• Version Ciblée — Routage de version basé sur le canal
• Mises à jour (manifeste) Delta — Activer les téléchargements partiels
• Canaux — Configuration et priorité des canaux