Vue d’ensemble de la documentation

Commencez par l’intégration minimale répondant aux besoins de votre composant. L’enregistrement de base suffit pour une vue native unique ; les paramètres facultatifs l’adaptent aux changements de contenu et au cycle de vie de l’application. Les API avancées constituent une approche distincte pour les moteurs de rendu qui gèrent déjà les lots ou le placement.

Choisir selon le problème à résoudre

Cas	Point de départ	Pourquoi
Une modale Web doit couvrir la barre d’onglets native d’un plugin	Enregistrement de base, puis le guide d’intégration du framework	Enregistrez une fois la vue et son hôte DOM ; l’Engine gère la capture et la restauration.
Un repli masqué revient avec l’ancienne sélection d’un interrupteur	Liaisons de valeurs	Reflétez les données natives actuelles sur l’hôte de repli, indépendamment de son lieu d’affichage.
Les boutons de barre d’outils d’arrière-plan et ceux de la modale de premier plan nécessitent des durées de transfert différentes	Surfaces du moteur de rendu	Séparez les propriétaires pour que fermer une surface ne puisse pas restaurer les contrôles d’une autre.
Un moteur de rendu existant fait se chevaucher les mises à jour ou perd une confirmation native	File de mises à jour	Sérialisez les passes de lecture de l’état actuel et réconciliez la connexion sans rejouer les actions utilisateur.

L’ordre de lecture complet suit. Ignorez les API avancées sauf si votre moteur de rendu gère le travail décrit dans leurs cas d’usage.

1. Comprendre l’approche

Les concepts et limites expliquent ce que permet la projection, ses différences avec l’interface native active et le repli Web, et les responsabilités qui restent au plugin.

2. Initialiser et intégrer

Lisez l’initialisation de base pour l’appel minimal et les paramètres obligatoires. Choisissez ensuite un guide de plateforme-framework :

• Plugin Capacitor : dépendances, points d’entrée du plugin natif, transmission des événements et démontage.
• Plugin Cordova : le même enregistrement avec le démarrage et la gestion des ressources Cordova.

Aucune de ces approches ne nécessite une seconde enveloppe Engine côté application ni les API avancées de moteur de rendu.

3. Ajouter des comportements facultatifs

Les paramètres d’enregistrement présentent les valeurs par défaut et les situations nécessitant chaque option. Ne lisez que les détails pertinents :

• Notifications : informer l’Engine des changements d’apparence ou de présentation.
• Liaisons de valeurs : maintenir les données du composant de l’hôte de repli en accord avec l’état natif.
• Timing de capture : préparer les pixels après stabilisation de l’apparence native.
• Superpositions Ionic : raccorder la couverture Ionic avec un initialiseur applicatif partagé.

4. Utiliser les API avancées lorsque vous possédez un moteur de rendu

Choisissez une API avancée avant d’en ajouter une. Ces guides répondent à des besoins distincts de moteurs de rendu existants ; ils ne forment pas une suite d’étapes de configuration obligatoires.

• Surfaces de pages et de modales
• Projection Web de bas niveau et lots
• Transfert natif et liaisons de défilement
• Placement différé sur Android
• Sérialisation des mises à jour et récupération

Référence

Utilisez ces pages pour vérifier les contrats et comportements pris en charge pendant l’implémentation de l’une ou l’autre approche :

• Contrat de projection et durée de vie
• Conteneurs HTML et Ionic pris en charge
• Intention de présentation observable
• Limites de capture et des plateformes

Contribution

Développement et publications présente la structure du dépôt, les vérifications locales, la CI et la publication. Sa lecture n’est pas nécessaire pour consommer l’Engine.