Initialisation de base

Commencez par NativeUIProjection lorsqu’un plugin possède une vue native et un conteneur Web correspondant. L’enregistrement démarre le runtime, lie ce conteneur et coordonne le transfert vers l’image et la restauration. Cette approche ne nécessite pas les API de moteur de rendu.

Utilisez le guide Capacitor ou Cordova pour l’installation des dépendances, les points d’entrée du cycle de vie du plugin et la transmission des notifications. Les exemples ci-dessous montrent l’enregistrement minimal dans ces points d’entrée, puis les paramètres obligatoires. Après l’initialisation, le guide de configuration présente les comportements facultatifs ; les API avancées ont leur propre point d’entrée.

Par exemple, un plugin dessine déjà une barre d’onglets native, mais l’application ouvre un panneau de réglages Web au-dessus. Enregistrez la barre et son hôte de navigation de repli afin que l’Engine puisse placer la barre capturée sous ce panneau et rétablir les interactions natives à sa fermeture. Le plugin conserve son API existante de sélection d’onglet.

Initialisation minimale

Créez et conservez un enregistrement après que le moteur de rendu a attaché sa vue native. Le sélecteur peut correspondre à un conteneur DOM ajouté ultérieurement, mais la présentation native attend que ce conteneur existe. Donnez-lui une boîte de mise en page prise en charge.

Dans un plugin Capacitor Swift, à l’intérieur de load() ou de l’initialiseur existant du moteur de rendu :

projection = try NativeUIProjection(
    webView: bridge?.webView,
    plugin: jsName,
    projectionSelector: "#native-ui-fallback",
    view: { [weak self] in self?.nativeView }
)

Dans un plugin Capacitor Kotlin, installez le canal partagé dans load() avant la première navigation de la WebView. L’enregistrement peut être créé plus tard, lorsque sa vue est prête :

NativeUIProjection.install(bridge.webView)
projection = NativeUIProjection(
    window = activity.window,
    webView = bridge.webView,
    plugin = pluginHandle.id,
    projectionSelector = "#native-ui-fallback",
    view = { nativeView }
)

Ces deux extraits doivent se trouver dans le périmètre de gestion des erreurs du guide d’intégration ; conservez le repli Web existant si l’initialisation échoue. projection et nativeView sont des propriétés de votre plugin. Libérez l’enregistrement avec destroy() sur iOS ou close() sur Android lorsque ce moteur de rendu est retiré. Tous les appels natifs de cycle de vie s’exécutent sur le thread UI.

Cordova utilise le même enregistrement avec runtime: .cordova / runtime = Runtime.CORDOVA, ainsi que sa propre WebView et son identité de plugin. Suivez le guide Cordova pour ces points d’entrée et le gestionnaire de ressources Android.

Paramètres obligatoires

Ces paramètres établissent la propriété des ressources. Ils n’indiquent pas à l’Engine quand le contenu change ni quand une transition de l’application doit modifier la présentation.

Ensuite : configurer une interface évolutive

L’enregistrement minimal établit la propriété des ressources. Poursuivez avec les paramètres facultatifs pour le raccordement des événements, la réflexion des valeurs, la capture et la politique d’échec. Chaque paramètre précise sa valeur par défaut et les cas où il est nécessaire. Consultez les API avancées uniquement si votre moteur de rendu gère déjà des lots, le placement ou la réconciliation des mises à jour.

Vue d’ensemble de la documentation