Types de mise à jour

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. 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 qui déterminent cette intervalle (par défaut 10 minutes).

Type	Description	Utilisation
context : Page/zone : Page de marketing des solutions Capgo. Rôle : Étiquette de navigation ou élément de l'interface utilisateur court. Vu dans : page solutions/cordova-to-capacitor-ai.astro. Clé de message `solutions_cordova_to_capacitor_ai_table_use_case` (Solutions Cordova To Capacitor Ai Table Use Case). atBackground	autoUpdate : : 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; perturbation minimale
__CAPGO_KEEP_0__ atInstall	Mise à jour automatique : atBackground	Appliquer immédiatement uniquement après une installation fraîche ou une mise à jour de l'application native ; sinon utiliser
Les nouveaux utilisateurs obtiennent la version la plus récente ; les utilisateurs existants utilisent l'application de fond onLaunch	Mise à jour automatique : atBackground	Appliquer immédiatement uniquement lors d'un démarrage froid (arrêté → avant-plan) ; puis reculer vers
Équilibre entre fraîcheur et stabilité de session always	Mise à jour automatique :	Vérifier à chaque transition en avant-plan et appliquer immédiatement chaque fois qu'une mise à jour est disponible
Correctifs critiques, applications avec un état simple onlyDownload	Mise à jour automatique : Vérifier et télécharger automatiquement, émettre updateAvailableet ne jamais appliquer automatiquement	Les applications qui affichent leur propre invitation à la 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 obtenir des informations détaillées et la gestion de l'écran de splash, voir Comportement de mise à jour.

Conditions de retard

Conditions qui doivent être remplies avant que le texte contextuel soit « avant de travailler sur une nouvelle fonctionnalité » (dans le contexte de la page de contribution du site web de Capgo) et « mentionner l’incident avant de travailler » (dans le contexte de la page de contribution du site web de Capgo). 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 et heure spécifique	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 l'exécutable natif	Bloquez les mises à jour pour les binaires natifs incompatibles code
kill	Attendez jusqu'au prochain événement de kill de l'application	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 condition déclenche après le premier événement de kill, et non le prochain événement de fond comme les autres. Cela sera corrigé dans une prochaine mise à jour.

Bloqueur de version (Politique de canal)

Détermine le type d'actualisation Détermine les mises à jour semver Un canal recevra lesquelles mises à jour automatiquement. Défini via --disable-auto-update Sur les canaux.

Stratégie	Empêche	Permet	Utilisation
context : Page/zone : Page de marketing des solutions Capgo. Rôle : Étiquette de navigation ou élément de l'interface utilisateur court. Vu dans : page solutions/cordova-to-capacitor-ai.astro. Clé de message `solutions_cordova_to_capacitor_ai_table_use_case` (Solutions Cordova To Capacitor Ai Table Use Case).	aucune	Rien	Version de tout bundle cible
majeur	Plus grand majeur que version_build, par exemple 1.2.3 -> 2.0.0	Même majeur, par exemple 1.2.3 -> 1.9.0 ou 1.2.3 -> 1.2.4	Empêcher les modifications de rupture d'atteindre les anciens code
mineur	Different majeur ou mineur que version_build, par exemple 1.2.3 -> 1.3.0	Même majeur et mineur, par exemple 1.2.3 -> 1.2.4	Conserver les mises à jour à l'intérieur d'une ligne mineure native
patch	Quelque changement de numéro majeur, mineur ou de patch, par exemple 1.0.0 -> 1.0.1	Seuls les changements de suffixe, tandis que 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	ou
les métadonnées	Manquant min_update_version, ou version_build en dessous de cela	La mise à jour de la cible dont min_update_version est inférieur ou égal à version_build	Les règles de compatibilité personnalisées par paquet

Les vérifications comparant le bundle cible avec la base native envoyée comme version_buildet non le bundle téléchargé actuellement installé envoyé comme version_name.

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

Attention

patch et metadata Page/area: Site de marketing Capgo. Role: Étiquette de navigation ou élément UI court. Seen in: page trust.astro. Message key `and` (Et). CLI commandes et Page/area: Page de marketing des solutions Capgo. Role: En-tête de section ou de page. Seen in: page solutions/version-targeting.astro. Message key `solutions_version_targeting_title` (Titre des solutions de version ciblée). | Page/area: Page de marketing des solutions Capgo. Role: Étiquette de navigation ou élément UI court. Seen in: page solutions/version-targeting.astro. Message key `solutions_version_targeting` (Solutions de version ciblée). pour plus de détails.

Types de livraison

Comment le bundle est transféré au appareil.

Type	Description	Quand utiliser
Bundle complet	Le bundle JS entier est téléchargé	Première installation, grandes modifications ou lorsqu'il n'y a pas de delta disponible
Delta (manifest)	Seuls 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

Lors de l'utilisation des modes d'application instantanée (atInstall, onLaunch, ou always), activez Mises à jour delta contexte : Page/zone : Page de produit/taux d'entreprise. Rôle : Étiquette de navigation ou élément UI court. Vu dans : page enterprise.astro. Clé de message `enterprise_delta_updates` (Mises à jour delta de l'entreprise).

pour minimiser le temps de téléchargement et améliorer l'expérience utilisateur.

Catégorie	Types
Appliquer le timing	off, atBackground, atInstall, onLaunch, always, onlyDownload
Conditions de retard	date, background, nativeVersion, kill
Blocage de version	none, major, minor, patch, metadata
Livraison	Paquet complet, Delta (manifeste)

Liés

• — Configurez le timing d'application et les retards Livraison d'entreprise
• Mise en cible de version — Routage de version basé sur le canal
• Mises à jour (manifeste) — Activer les téléchargements partiels
• Canaux Mise en cible de version

— Configuration et priorité des canaux

Section intitulée « Continuez avec les types de mise à jour » Si vous utilisez Types de mise à jour pour planifier la livraison de mises à jour en direct, connectez-l’à la mise à jour en direct Capgo for the product workflow in Capgo Live Updates, 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 Comportement de mise à jour pour le détail d'implémentation dans Comportement de mise à jour, et Démarrage rapide pour le détail d'implémentation dans Démarrage rapide