Tester les builds natifs sans mises à jour en temps réel

Lorsque vous testez un nouveau binaire natif, assurez-vous qu'il démarre à partir des actifs web embarqués dans ce binaire — et non à partir d'une mise à jour live téléchargée précédemment. Utilisez l'un ou combinez les sécurités suivantes.

1. Augmentez la version de base native

Configurer CapacitorUpdater.version à partir de la version utilisée pour votre version native, et augmentez-la pour chaque build natif. Une nouvelle base native rend le fichier binaire installé distinct des anciens bundles et, par défaut resetWhenUpdate: true, supprime les bundles téléchargés lorsque l'application native plus récente est installée.

import type { CapacitorConfig } from '@capacitor/cli';
import pkg from './package.json';

const config: CapacitorConfig = {
  plugins: {
    CapacitorUpdater: {
      // Keep this aligned with, and increase it for, every native build.
      version: pkg.version,
      autoUpdate: 'atBackground',
    },
  },
};

export default config;

Par exemple, un fichier binaire construit avec version: '1.4.1' a une base native plus élevée qu'un bundle existant. 1.4.0 Ne réutilisez pas une version native lorsque vous devez vérifier les actifs embarqués.

2. Bloquer les mises à jour de l'émulateur et des builds de développement dans la console

Ouvrez votre application dans le Capgo console, allez dans Canauxcontext Nom du canal de publication de Capgo. Page/zone : page de marketing des solutions de Capgo. Rôle : étiquette de navigation ou élément de menu court. Vu dans : page solutions/white-label.astro. Clé de message `solutions_white_label_visual_cell2_value` (Solutions White Label Visual Cell2 Value). tab. Désactivez off both Permettre la construction de développement et Permettre aux émulateurs.

La fenêtre d'informations du canal affiche les paramètres Permettre la construction de développement et Permettre aux émulateurs

Attention

Attention

La capture d'écran montre où trouver les paramètres ; ses boutons de mise en surbrillance sont activés. Désactivez les deux boutons pour un canal qui ne doit pas livrer les mises à jour en temps réel aux constructions de développement ou aux émulateurs : il peut toujours recevoir des mises à jour physiques signées en production selon les autres paramètres du canal.

3. Activez les mises à jour en direct uniquement dans les builds CI natifs

Pour les équipes qui souhaitent que les builds locaux, les émulateurs et les développeurs soient sécurisés par défaut, activez les mises à jour en direct par l'intermédiaire d'une variable d'environnement. La configuration suivante désactive les vérifications de mise à jour à moins que CAPGO_LIVE_UPDATES est exactement true:

import type { CapacitorConfig } from '@capacitor/cli';
import pkg from './package.json';

const liveUpdatesEnabled = process.env.CAPGO_LIVE_UPDATES === 'true';

const config: CapacitorConfig = {
  appId: 'com.example.app',
  appName: 'Example App',
  plugins: {
    CapacitorUpdater: {
      // Bump package.json for every native build.
      version: pkg.version,
      // Local builds are off; native CI explicitly enables live updates.
      autoUpdate: liveUpdatesEnabled ? 'atBackground' : false,
    },
  },
};

export default config;

Fixez la variable uniquement dans l'étape CI qui synchronise et construit l'application native :

- run: CAPGO_LIVE_UPDATES=true npx cap sync
- run: ./build-native-app.sh

Exécuter npx cap sync après avoir fixé la variable car Capacitor copie cette configuration dans les projets natifs pendant la synchronisation. Sans la variable, les builds locaux et les builds d'émulateur conservent autoUpdate: false et ne vérifient pas les mises à jour en direct.

Liste rapide de vérification

1. Augmentez la version utilisée par CapacitorUpdater.version pour le binaire natif.
2. Désactiver Permettre la construction de développement et Permettre les émulateurs sur le canal lors du test de ces types de construction.
3. Construire localement sans CAPGO_LIVE_UPDATES.
4. Définir CAPGO_LIVE_UPDATES=true seulement avant npx cap sync dans le job CI natif qui devrait recevoir les mises à jour en direct.

Lié

• Canaux — Gestion des canaux et des politiques.
• Mise à jour — Lorsque les mises à jour sont vérifiées et appliquées.
• Ciblage de version context : Page/zone : Page de marketing des solutions Capgo. Rôle : En-tête de section ou de page. Voir : page solutions/ciblage-de-version.astro. Message clé `solutions_ciblage_de_version_title` (Titre du ciblage de version des solutions). | Page/zone : Page de marketing des solutions Capgo. Rôle : Étiquette de navigation ou élément de navigation court. Voir : page solutions/ciblage-de-version.astro. Message clé `solutions_ciblage_de_version` (Ciblage de version des solutions).