Dokumentationsübersicht
Beginnen Sie mit der kleinsten Integration, die Ihre Komponente benötigt. Für eine einzelne native Ansicht genügt die grundlegende Registrierung; optionale Einstellungen passen sie an wechselnde Inhalte und den Anwendungslebenszyklus an. Erweiterte APIs sind ein separater Weg für Renderer, die Batching oder Positionierung bereits selbst übernehmen.
Nach dem zu lösenden Problem auswählen
| Fall | Einstieg | Grund |
|---|---|---|
| Ein Web-Modal muss die native Tab-Leiste eines Plugins überdecken | Grundlegende Registrierung, dann der Framework-Integrationsleitfaden | Registrieren Sie Ansicht und DOM-Host einmal; die Engine übernimmt Aufnahme und Wiederherstellung. |
| Ein verborgener Fallback kehrt mit der alten Schalterauswahl zurück | Wertbindungen | Übertragen Sie aktuelle native Daten auf den Fallback-Host, unabhängig davon, wo er dargestellt wird. |
| Toolbar-Schaltflächen im Hintergrund und Modal-Schaltflächen im Vordergrund benötigen unterschiedliche Übergabelebensdauern | Renderer-Oberflächen | Trennen Sie Besitzer, damit das Schließen einer Oberfläche nicht die Steuerelemente einer anderen wiederherstellt. |
| Ein bestehender Renderer überlappt Aktualisierungen oder verliert eine native Bestätigung | Aktualisierungswarteschlange | Serialisieren Sie Durchläufe mit aktuellem Zustand und gleichen Sie die Verbindung ab, ohne Benutzeraktionen erneut auszuführen. |
Die vollständige Lesereihenfolge folgt. Überspringen Sie erweiterte APIs, sofern Ihr Renderer die in ihren Fällen beschriebene Arbeit nicht übernimmt.
1. Den Ansatz verstehen
Konzepte und Grenzen erklärt, was Projektion ermöglicht, wie sie sich von aktiver nativer UI und Web-Fallback unterscheidet und welche Zuständigkeiten beim Plugin bleiben.
2. Initialisieren und integrieren
Lesen Sie grundlegende Initialisierung für den minimalen Aufruf und erforderliche Eingaben. Wählen Sie dann einen Plattform-/Framework-Leitfaden:
- Capacitor-Plugin: Abhängigkeiten, native Plugin-Hooks, Ereignisweiterleitung und Abbau.
- Cordova-Plugin: dieselbe Registrierung mit Cordova-Start und Ressourcenbehandlung.
Keiner der beiden Wege benötigt einen zweiten anwendungsseitigen Engine-Wrapper oder die erweiterten Renderer-APIs.
3. Optionales Verhalten ergänzen
Registrierungseinstellungen führt Standardwerte und die Situationen auf, die jede Option erfordern. Lesen Sie nur die relevanten Einzelheiten:
- Benachrichtigungen: Der Engine Änderungen von Erscheinungsbild oder Darstellung melden.
- Wertbindungen: Komponentendaten des Fallback-Hosts mit dem nativen Zustand abgleichen.
- Aufnahmezeitpunkt: Bildpunkte vorbereiten, nachdem sich das native Erscheinungsbild stabilisiert hat.
- Ionic-Overlays: Ionic-Abdeckung mit einem gemeinsamen Anwendungsinitialisierer verbinden.
4. Erweiterte APIs bei eigenem Renderer verwenden
Wählen Sie eine erweiterte API, bevor Sie eine hinzufügen. Diese Leitfäden behandeln verschiedene Anforderungen bestehender Renderer; sie bilden keine Abfolge erforderlicher Einrichtungsschritte.
- Seiten- und Modal-Oberflächen
- Untergeordnete Web-Projektion und Batches
- Native Übergabe und Scroll-Bindungen
- Aufgeschobene Android-Positionierung
- Serialisierung und Wiederherstellung von Aktualisierungen
Referenz
Prüfen Sie mit diesen Seiten Verträge und unterstütztes Verhalten bei der Implementierung beider Wege:
- Projektionsvertrag und Lebensdauer
- HTML- und Ionic-Containerunterstützung
- Beobachtbare Darstellungsabsicht
- Aufnahme- und Plattformgrenzen
Beiträge
Entwicklung und Veröffentlichungen beschreibt Repository-Struktur, lokale Prüfung, CI und Veröffentlichung. Für die Verwendung der Engine ist dies nicht erforderlich.