Vue d’ensemble de la documentation
Créez des écrans pilotés par le Web avec des contrôles et des capacités natives. Ces guides expliquent comment intégrer l’Engine dans un plugin pour faire coexister Web UI et Native UI. Commencez par le modèle partagé : comment un composant natif trouve sa place dans une mise en page Web, quelle couche le présente et comment les interactions reviennent à la vue active. Le défilement et les superpositions sont des exemples de cette coordination, pas des modèles d’intégration distincts.
Choisissez ensuite l’intégration minimale adaptée à vos responsabilités. Enregistrez une vue native et son conteneur DOM, connectez les notifications de cycle de vie nécessaires à votre interface et n’ajoutez les API avancées que si vous gérez déjà les lots ou le placement d’un moteur de rendu.
Choisir selon le problème à résoudre
| Cas | Point de départ | Pourquoi |
|---|---|---|
| Une vue SDK native admissible appartient à un flux Web défilant | Enregistrement de base et limites des plateformes | Associez-la à son conteneur DOM ; le suivi natif ou la présentation temporaire d’une image dépend de la plateforme et de la mise en page. |
| 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 la vue et son hôte DOM, puis connectez le cycle de vie des superpositions ; l’Engine coordonne le transfert 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é.
- Superpositions Web personnalisées : réexporter pause/resume depuis un plugin pour que les applications encadrent leurs propres superpositions.
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.