Aller directement au contenu principal
@capgo/capacitor-moteur de mise à jour Mises à jour Logiciel à jour

Mise à jour plugin Capacitor

Déployez des mises à jour Ionic et Capacitor instantanément auprès de vos utilisateurs sans retard de la part des magasins d'applications.

Installer

bun add @capgo/capacitor-updater bunx cap sync
npm, pnpm ou yarn
  • npm install @capgo/capacitor-updater
  • pnpm add @capgo/capacitor-updater
  • yarn add @capgo/capacitor-updater

Guide

Comment utiliser Mise à jour dans Capacitor

Tester sur appareil

Télécharger l'application Capgo, puis scannez le code QR code.

Lien QR de prévisualisation du plugin de mise à jour code

Mises à jour Ionic et Capacitor en direct avec @capgo/capacitor-updater

@capgo/capacitor-updater est le plugin de mise à jour open-source derrière les mises à jour en direct Capgo pour les applications Ionic et Capacitor. Il télécharge des ensembles de web approuvés, les applique avec une protection de rollback native et garde les modifications binaires uniquement sur la voie de revue normale de l'App Store et de Play.

Utilisez-le lorsque vous avez besoin d'actualisations OTA pour HTML, CSS, JavaScript, les actifs et d'autres modifications de la couche web après que votre shell native soit approuvée.

Installer

npm install @capgo/capacitor-updater
npx cap sync

Où ça rentre

Pour les équipes Ionic, les mises à jour en direct signifient généralement le même workflow : envoyer un nouveau bundle web sans obliger chaque utilisateur à passer par une mise à jour complète du magasin. Capgo gère ce workflow pour les applications Capacitor avec des canaux, des contrôles de compatibilité, un contrôle de déploiement, des journaux de dispositif et un rollback.

Les plugins natifs, les autorisations, les modifications de la manifest Android, les modifications de plist iOS et les mises à jour binaires SDK nécessitent encore une mise à jour normale du magasin. Conservez ces modifications dans votre pipeline de construction native et utilisez les mises à jour en direct pour la couche web approuvée.

Ce que ce plugin expose

  • notifyAppReady - Avertir la couche native que JavaScript s'est initialisé avec succès.
  • setUpdateUrl - Définir l'URL de mise à jour de l'application dynamiquement en temps de exécution.
  • setStatsUrl - Définir l'URL de statistiques de l'application dynamiquement en temps de exécution.
  • setChannelUrl - Définir l'URL de canal de l'application dynamiquement en temps de exécution.

Exemple d'utilisation

notifyAppReady

Avertir la couche native que JavaScript s'est initialisé avec succès.

import { CapacitorUpdater } from '@capgo/capacitor-updater';

const result = await CapacitorUpdater.notifyAppReady();
console.log(result);

setUpdateUrl

Set the update URL for the app dynamically at runtime.

import { CapacitorUpdater } from '@capgo/capacitor-updater';

await CapacitorUpdater.setUpdateUrl({ url: 'https://example.com' });

setStatsUrl

Définir l'URL de statistiques de l'application dynamiquement en temps de exécution.

import { CapacitorUpdater } from '@capgo/capacitor-updater';

await CapacitorUpdater.setStatsUrl({ url: 'https://example.com' });

setChannelUrl

Définir l'URL de canal de l'application dynamiquement en temps de exécution.

import { CapacitorUpdater } from '@capgo/capacitor-updater';

await CapacitorUpdater.setChannelUrl({ url: 'https://example.com' });

Référence complète

Continuez à partir de @capgo/capacitor-mises-à-jour

Si vous utilisez @capgo/capacitor-mises-à-jour planifier les mises à jour en direct, connectez-l’avec Mises à jour en direct pour le flux de travail du produit, @capgo/capacitor-mises-à-jour pour les détails d'implémentation, Prise en main, Canaux, et Remontées.

FAQ

FAQ du plugin Updater

Comment installer le plugin Updater dans une application Capacitor ?

Exécutez la commande « bun add @capgo/capacitor-updater » (ou « npm install @capgo/capacitor-updater »), puis exécutez « bunx cap sync » afin que les projets iOS et Android prennent en compte les natives code. Importez-l’à partir de « @capgo/capacitor-updater » dans votre application code.

Le plugin @capgo/capacitor-updater fonctionne-t-il avec React, Vue et Angular ?

Oui. Le plugin Updater est un package Capacitor, il fonctionne donc avec tout framework web qui s'exécute dans Capacitor, y compris Ionic, React, Vue, Angular, Svelte et JavaScript pur.

Quelle version de Capacitor est prise en charge par @capgo/capacitor-updater ?

Les plugins Capgo suivent la version majeure de Capacitor : utilisez la version majeure du plugin qui correspond à la version majeure de votre Capacitor (par exemple, plugin v8 avec Capacitor 8). La table de compatibilité dans le README du GitHub liste les versions maintenues.

Le plugin @capgo/capacitor-updater est-il gratuit et open source ?

Oui. Le code source code est public sur GitHub à l'adresse https://github.com/Cap-go/capacitor-updater/ et le package est gratuit pour l'installer depuis npm. Les rapports de bugs et les demandes de pull sont les bienvenus.

Peut-on mettre à jour code qui utilise Updater sans passer par une revue de l'App Store ?

L'installation ou la mise à jour du plugin change les natives code, il faut donc une nouvelle build de l'application. Une fois cela fait, les modifications JavaScript, HTML et CSS qui appellent le plugin peuvent être déployées instantanément avec les mises à jour Capgo.

Mise à jour sans attendre l'approbation de l'application

Une fois le plugin est dans votre magasin de construction, les mises à jour en direct Capgo envoient vos modifications de JavaScript, HTML et CSS aux utilisateurs en quelques minutes.

Commencez avec Capgo