Native Bridge

Appelez le téléphone depuis votre PWA

Le Bridge expose l'objet window.PWA2APP à votre page, uniquement sur votre origine autorisée. Le SDK @pwa2app/bridge l'enveloppe avec des types complets et des replis web.

Un exemple, tel qu'il s'écrit

Dans un navigateur normal, isNative() vaut false et le SDK utilise l'équivalent web quand il existe.

app.js

import { PWA2APP } from "@pwa2app/bridge";

if (PWA2APP.isNative()) {
  const position = await PWA2APP.location.getCurrent({ precision: "approximate" });
  await PWA2APP.share.share({
    title: "Ma position",
    text: position.lat + "," + position.lng,
  });
}

const photo = await PWA2APP.camera.capture({ quality: 0.8, max_size_px: 1600 });
// photo.data_base64 contient l'image JPEG, jamais un chemin de fichier.

Fonctionnalités disponibles sur Android

27 méthodes réparties en 8 fonctionnalités activables, plus les fonctions de base (appareil, réseau, application, barre d'état, retour haptique, partage).

Appareil photo et galerie

Prendre une photo ou choisir une image ; la permission est demandée au moment de l'usage.

Localisation

Position ponctuelle ou surveillée, approximative par défaut.

Notifications locales

Demander l'autorisation et programmer des notifications.

Biométrie

Empreinte ou visage : la page reçoit seulement oui ou non.

Fichiers et presse-papiers

Sélecteur système, enregistrement, partage, presse-papiers.

Vibration

Faire vibrer l'appareil avec un motif.

La sécurité repose sur l'origine, pas sur un secret

Un secret placé dans le JavaScript d'une page ne protège rien : tout script de la page peut le lire. Le Bridge vérifie donc l'origine de la frame appelante (fournie par le système), n'accepte que la frame principale, ne connaît que les méthodes de la liste blanche activées dans la configuration signée, valide chaque paramètre et limite le débit. Il n'existe aucune méthode générique de type exec ou eval.

Limites actuelles

Android uniquement ; iOS : Bientôt.
Le jeton de notification push (FCM) n'est pas fourni : les notifications sont locales.
Un message est limité à 1 Mo, donc l'enregistrement de gros fichiers depuis la page est limité.
Le Bridge n'existe pas en mode TWA.

Pour aller plus loin : la documentation correspondante.

Essayez avec votre propre PWA

Trois applications gratuites à vie. Aucune carte bancaire.

Commencer gratuitement — 3 applications offertes Voir la documentation

Sans carte bancaire. Sans engagement.