Types d'actualisation

Capgo propose plusieurs types d'actualisations en ligne (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 contrôles 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_utilisation` (Solutions Cordova To Capacitor Ai Table Utilisation). 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 immédiate uniquement après une installation fraîche ou une mise à jour de l'application native; sinon utilisez atBackground	Les nouveaux utilisateurs obtiennent la version la plus récente; les utilisateurs existants utilisent l'application de fond
__CAPGO_KEEP_0__ onLaunch	Mise à jour immédiate uniquement à l'arrêt (killed → avant-plan); puis reculez-vous vers atBackground	Équilibre entre la fraîcheur et la stabilité de session
__CAPGO_KEEP_0__ 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
__CAPGO_KEEP_0__ onlyDownload	Vérifiez et téléchargez automatiquement, émettez updateAvailable, et ne l'appliquez jamais 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

Les conditions qui doivent être remplies avant que, contexte : fragment de texte HTML d'une chaîne de dialogue Capgo plus longue (clé parente `create_an_issue_and_discuss_before_working_on_a_new_feature`). Page/zone : site Web de marketing Capgo. Rôle : Paragraphe de marketing ou juridique long. Vu dans : page contributing.astro. Clé de message `create_an_issue_and_discuss_before_working_on_a_new_feature` (Créez une question et discutez avant de travailler sur une nouvelle fonctionnalité). | Fragment de texte HTML d'une chaîne de dialogue Capgo plus longue (clé parente `mention_issue_before_working`). Page/zone : site Web de marketing Capgo. Rôle : Phrase de site Web. Vu dans : page contributing.astro. Clé de message `mention_issue_before_working` (Mentionner l'incident avant de travailler). 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
nativeVersion	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 mort 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 mort, 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)

Contrôle les mises à jour semver Mises à jour semver Une stratégie de mise à jour semver --disable-auto-update Une stratégie de mise à jour semver

Stratégie	Blocage	Permet	Utilisation
aucune	Rien	Toute version de bundle cible	Par défaut; mise à jour complète
majeur	Majeur supérieur à 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 natives 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	Toute modification de numéro majeur, mineur ou de maintenance, par exemple 1.0.0 -> 1.0.1	Seuls les changements de suffixe alors 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 noyau
metadata	Manquant min_update_versionou version_build En dessous de cela	Ciblez le bundle dont min_update_version est inférieur ou égal à version_build	Règles de compatibilité personnalisées par bundle

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 rôle : Étiquette de navigation ou élément de navigation court. Voir dans : page trust.astro. Clé de message `and` (Et). CLI commandes et rôle : Étiquette de navigation ou élément de navigation court. Voir dans : page trust.astro. Clé de message `and` (Et). Versionnement ciblé : Titre de la section ou de la page (Solutions de versionnement ciblé). | Versionnement ciblé : Étiquette de navigation ou élément de navigation court (Solutions de versionnement ciblé).

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 lorsque le delta n'est pas disponible
Delta (manifeste)	Seules les fichiers modifiés sont téléchargés	La plupart des mises à jour; plus rapide et plus amicale en termes de 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 le timing	off, atBackground, atInstall, onLaunch, always, onlyDownload
Conditions de retard	date, background, nativeVersion, kill
Blocage de version	none, major, minor, patch, metadata
Livraison	Full bundle, Delta (manifest)

Liés

• Comportement de mise à jour — Configurez l'application du timing et les retards
• 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

Sous-titre « 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 de Capgo : Capgo Mises à jour en direct 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 la mise à jour pour le détail d'implémentation dans Comportement de la mise à jour, et Démarrage pour le détail d'implémentation dans Démarrage