Types d'actualisation

Capgo prend en charge 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 chronomètre répétitif 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. Voir : 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; une 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 mise à jour en arrière-plan onLaunch	Mise à jour automatique : atBackground	Appliquer immédiatement uniquement à la démarrage froid (arrêté → avant-plan) ; puis reculer vers
Équilibre entre la fraîcheur et la 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 la splashscreen, voir Comportement de mise à jour.

Conditions de retard

Conditions qui doivent être remplies avant, contexte : fragment de texte HTML d'une chaîne de Capgo UI 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 Capgo UI 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
version native	Exigez une version minimale de l'exécutable natif	Empêchez 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 l'événement de fond suivant. Cela sera corrigé dans une prochaine mise à jour.

Empêchement de version (Politique de canal)

Contrôle qui mises à jour semver un canal livrera 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 UI 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	Toute version de 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 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	Quelque changement de numéro majeur, mineur ou de patch, 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	ou
metadata	Manquant min_update_version, ou version_build en dessous de cela	La mise à jour de la 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 référence native envoyée comme version_build, et 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 contexte: Site de marketing Capgo. Rôle: Étiquette de navigation ou élément UI court. Vu dans: page trust.astro. Clé de message `and` (Et). CLI commandes et contexte: Site de marketing Capgo. Rôle: Étiquette de navigation ou élément UI court. Vu dans: page trust.astro. Clé de message `and` (Et). Version ciblée par version

Types de livraison

Comment le bundle est transféré vers le dispositif.

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 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	Paquet complet, Delta (manifeste)

Lié

• — Configurez l'application du timing et les retards Enterprise Delivery Label
• 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 pour le flux de travail du produit dans les mises à jour en direct Capgo 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