Types de mise à jour

Capgo supports several types of over-the-air (OTA) updates. This page lists and explains all of them so you can choose the right combination for your app.

Appliquer le timing

Contrôles lorsque même si une mise à jour est appliquée après qu'elle est téléchargée. Le plugin vérifie les mises à jour lorsque l'application passe en avant-plan et sur un horloge répétitive tout en restant ouverte. periodCheckDelay les contrôles de cet intervalle (par défaut 10 minutes).

Type	Description	Utilisation
autoUpdate: atBackground	Vérifiez et téléchargez à chaque vérification en avant-plan, appliquez lorsque l'application passe en arrière-plan	La plupart des applications; une perturbation minimale
autoUpdate: atInstall	Appliquer immédiatement uniquement après une installation fraîche ou une mise à jour de l'application native ; sinon utilisez atBackground	Les nouveaux utilisateurs obtiennent la dernière version ; les utilisateurs existants utilisent l'application de mise à jour en arrière-plan
autoUpdate : onLaunch	Appliquer immédiatement uniquement au démarrage froid (arrêté → avant-plan) ; puis reculez vers atBackground	Équilibre entre fraîcheur et stabilité de session
autoUpdate : always	Vérifiez à chaque transition en avant-plan et appliquez immédiatement chaque fois qu'une mise à jour est disponible	Correctifs critiques, applications avec un état simple
autoUpdate : onlyDownload	Vérifiez et téléchargez automatiquement, émettez updateAvailable et n'appliquez jamais automatiquement	Applications qui montrent leur propre invite de mise à jour ou contrôlent exactement quand appeler set()

Configurez en capacitor.config.ts:

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

Conseil

Pour obtenir des informations détaillées et gérer l'écran de démarrage, voir Mise à jour du comportement.

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 en arrière-plan	Évitez d'appliquer pendant les changements d'application rapides
version native	Exigez une version minimale de la version native du binaire	Bloquez les mises à jour pour les versions natives incompatibles code
kill	Attendez la prochaine événement de suppression d'application	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

Le kill La condition déclenche après le premier événement de suppression, et non la prochaine en arrière-plan comme les autres. Cela sera corrigé dans une prochaine mise à jour.

Bloqueur de version (Politique de canal)

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

Stratégie	Blocs	Permet	Utilisation
aucun	Rien	N'importe quelle version de bundle cible	Par défaut; mise à jour complète automatique
majeur	Majeur supérieur version_build, par exemple 1.2.3 -> 2.0.0	Même numéro majeur, par exemple 1.2.3 -> 1.9.0 ou 1.2.3 -> 1.2.4	Empêchez les modifications de rupture de parvenir aux anciens natives code
mineur	Différent numéro majeur ou mineur que version_build, par exemple 1.2.3 -> 1.3.0	Même numéro majeur et mineur, par exemple 1.2.3 -> 1.2.4	Conservez les mises à jour à l'intérieur d'une ligne native mineure
patch	Toute modification de numéro majeur, mineur ou patch, par exemple 1.0.0 -> 1.0.1	Seules les modifications de suffixe MAJOR.MINOR.PATCH reste identique, par exemple 1.0.0-beta.1 -> 1.0.0-beta.2 ou 1.0.0+build.1 -> 1.0.0+build.2	Mode le plus strict : pas de mouvement de version de la bibliothèque principale
méta-données	Manquant min_update_version, ou version_build en dessous de cela	Bundle cible dont min_update_version est inférieur ou égal à version_build	Règles de compatibilité personnalisées par bundle

Ces vérifications comparent le bundle cible avec la base native transmise sous la forme de version_build, et non le bundle téléchargé actuellement installé transmis sous la forme de version_name.

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

Attention

patch et metadata exige une configuration soigneuse. Voir CLI commandes et Ciblage de version pour plus de détails.

Types de livraison

Comment le bundle est transféré

à l'appareil.	Type	Description
Quand utiliser	Bundle complet	Tout le bundle JS 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, plus de 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

Lors de l'utilisation des 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
Appliquer un timing	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 de comportement — Configurez le timing d'application et les retards
• Ciblage de version — Routage de version basé sur le canal
• Mises à jour (manifeste) Delta — Activez les téléchargements partiels
• Canaux — Configuration et priorité des canaux

Continuez de là des types d'actualisation

Si vous utilisez Types d'actualisation pour planifier la livraison d'actualisations en direct, connectez-le avec 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 de mise à jour pour les détails d'implémentation dans Comportement de mise à jour, et Démarrage rapide pour les détails d'implémentation dans Démarrage rapide.