Aller au contenu principal
@capgo/capacitor-webview-guardian Auth & sécurité Open source

WebView Guardian Plugin Capacitor

Détectez quand la WebView est tuée en arrière-plan et relancez-l’au retour au premier plan

Installer

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

Guide

Comment utiliser WebView Guardian dans Capacitor

Tester sur l'appareil

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

Lien QR pour l'aperçu du plugin WebView Guardian code

Utiliser @capgo/capacitor-webview-guardian

Le plugin Capacitor pour détecter quand la WebView est fermée en arrière-plan et la relancer au premier plan.

Installer

bun add @capgo/capacitor-webview-guardian
bunx cap sync

bunx cap sync copie le code natif du plugin dans vos projets natifs. Relancez-l’après chaque mise à jour du plugin.

Importer

import { WebviewGuardian } from '@capgo/capacitor-webview-guardian';

Aperçu de API

Méthode Description
startMonitoring Commence l'observation des événements au premier plan et vérifie automatiquement l'état de la WebView.
stopMonitoring Arrête toute surveillance automatique au premier plan.
getState Retourne le dernier état de surveillance connu.
checkNow Force immédiatement un test de santé de la WebView.

Exemples

startMonitoring()

Commence l'observation des événements au premier plan et vérifie automatiquement l'état de la WebView.

import { WebviewGuardian } from '@capgo/capacitor-webview-guardian';

const result = await WebviewGuardian.startMonitoring();
console.log(result);

stopMonitoring()

Arrête toute surveillance automatique au premier plan.

import { WebviewGuardian } from '@capgo/capacitor-webview-guardian';

const result = await WebviewGuardian.stopMonitoring();
console.log(result);

getState()

Retourne le dernier état de surveillance connu.

import { WebviewGuardian } from '@capgo/capacitor-webview-guardian';

const result = await WebviewGuardian.getState();
console.log(result);

checkNow()

Force immédiatement un test de santé de la WebView.

import { WebviewGuardian } from '@capgo/capacitor-webview-guardian';

const result = await WebviewGuardian.checkNow();
console.log(result);

Écouter les événements

addListener renvoie un handle. Appelez handle.remove() lorsque l'écran est démonté.

Référence complète

Continuer depuis « Utiliser @capgo/capacitor-webview-guardian »

Si vous utilisez Utiliser @capgo/capacitor-webview-guardian pour planifier le comportement des médias et de l'interface natifs, connectez-l’à @capgo/capacitor-webview-guardian pour les détails d'implémentation dans @capgo/capacitor-webview-guardian, Prise en main pour les détails d'implémentation dans Getting Started Utiliser @capgo/capacitor-live-activities pour la capacité native dans Utiliser @capgo/capacitor-live-activities @capgo/capacitor-live-activities pour les détails d'implémentation dans @capgo/capacitor-live-activities, et Utiliser @capgo/capacitor-video-player pour la fonctionnalité native dans Utilisation de @capgo/capacitor-video-player.

FAQ

FAQ du plugin WebView Guardian

Comment installer le plugin WebView Guardian dans une application Capacitor ?

Exécutez "bun add @capgo/capacitor-webview-guardian" (ou "npm install @capgo/capacitor-webview-guardian"), puis lancez "bunx cap sync" pour que les projets iOS et Android prennent en compte le code natif. Importez-le depuis "@capgo/capacitor-webview-guardian" dans votre code.

Est-ce que @capgo/capacitor-webview-guardian fonctionne avec React, Vue et Angular ?

Oui. WebView Guardian est un package Capacitor, il fonctionne donc avec n'importe quel framework web tournant dans Capacitor, y compris Ionic, React, Vue, Angular, Svelte et le JavaScript pur.

Quelle version de Capacitor est supportée par @capgo/capacitor-webview-guardian ?

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 le plugin v8 avec Capacitor 8). Le tableau de compatibilité du README de GitHub recense les versions maintenues.

Est-ce que @capgo/capacitor-webview-guardian est gratuit et open source ?

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

Puis-je mettre à jour code utilisant WebView Guardian sans passer par une revue de l'App Store ?

L'installation ou la mise à jour du plugin modifie le code natif, ce qui impose un nouveau build pour les stores. Ensuite, les changements JavaScript, HTML et CSS qui appellent le plugin peuvent être livrés instantanément via les live updates de Capgo.

Déployez les changements de WebView Guardian sans attendre la validation de l'app

Une fois le plugin intégré à votre build de store, Capgo live updates déploie vos changements JavaScript, HTML et CSS aux utilisateurs en quelques minutes.

Commencez avec Capgo