Mise à jour Types

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.

Supports plusieurs types d'actualisations sur l'air (OTA). Cette page liste et explique tous les types afin que vous puissiez choisir la combinaison appropriée pour votre application.

Contrôles lorsque 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étitif tout en restant ouverte. periodCheckDelay Contrôles cette 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; minimisation de la perturbation
autoUpdate: atInstall	Appliquez immédiatement uniquement après une installation fraîche ou une mise à jour de l'application native ; sinon utilisez atBackground	Nouveaux utilisateurs obtiennent la dernière version ; les utilisateurs existants utilisent l'application de fond
autoUpdate : onLaunch	Appliquez immédiatement uniquement au démarrage froid (arrêté → avant-plan) ; puis reculez-vous 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 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 en arrière-plan	Évitez d'appliquer pendant des changements d'application rapides
version native	Exigez une version minimale de la bibliothèque native __CAPGO_KEEP_0__	Empêchez les mises à jour sur des versions natives incompatibles code
kill	Attendez jusqu'à l'événement de suppression 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

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

Blocage de version (Politique de canal)

Contrôle des mises à jour mises à jour 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	Supérieur à majeur version_buildpar exemple 1.2.3 -> 2.0.0	Même version majeure, par exemple 1.2.3 -> 1.9.0 ou 1.2.3 -> 1.2.4	Empêchez les modifications de version qui atteignent les natives anciennes code
mineure	Différent de la version majeure ou mineure que version_buildpar exemple 1.2.3 -> 1.3.0	Même version majeure et mineure, 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 de version majeure, mineure ou patch, par exemple 1.0.0 -> 1.0.1	Seuls les changements 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 comparant le bundle cible avec la base native transmise sous forme de version_build, et non le bundle téléchargé actuellement installé transmis sous 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	Tout le bundle	Le bundle JS complet est téléchargé
Première installation, grandes modifications, ou lorsque le delta n'est pas 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

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
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)

Relatifs

• Comportement de mise à jour — 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 la section « Continuez de la mise à jour »

Si vous utilisez Mises à jour 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 l'aperçu, Fonctionnalités pour les détails d'implémentation dans les fonctionnalités, Comportement de mise à jour pour les détails d'implémentation dans le comportement de mise à jour, et Démarrage pour les détails d'implémentation dans le démarrage.