Bearbeiten

Verwendung von Community Native Modules

Architekturbewertung erforderlich: Diese Dokumentation wurde zur Unterstützung der Entwicklung gegen die "alte" oder "Legacy"-Architektur von React Native geschrieben. Sie ist möglicherweise nicht direkt auf die Entwicklung mit der neuen Architektur anwendbar und muss überprüft und möglicherweise aktualisiert werden. Informationen zu React Native-Architekturen in React Native Windows finden Sie unter Neu vs. Alt Architektur.

Die neuesten Informationen zur nativen Entwicklung unter Windows finden Sie unter Native Plattform: Übersicht.

Community-Native-Module werden normalerweise als npm-Pakete vertrieben. Um mehr über npm-Pakete zu erfahren, könnte Ihnen dieser Leitfaden hilfreich sein.

Das Verwenden von nativen Modulen erfordert die Aktualisierung der nativen Build-Dateien Ihrer App, um von den nativen Build-Dateien des Moduls abhängig zu sein, was als „Linking“ bezeichnet wird. Viele Module unterstützen „Autolinking“, bei dem diese Aktualisierungen automatisch ausgeführt werden, wenn der run-windows-Befehl ausgeführt wird. Andere erfordern möglicherweise, dass Sie das Modul manuell verknüpfen.

Dieses Dokument beschreibt die allgemeinen Schritte zum manuellen Verknüpfen eines Moduls (react-native-foo) mit Ihrem Projekt.

Nicht alle Community-Module wurden für die Verwendung unter Windows aktualisiert. Wenn Sie ein Modul finden, das unter Windows nicht funktioniert, reichen Sie bitte ein Issue auf GitHub ein. Wir verfolgen die Liste der inkompatiblen Module, für die wir Unterstützung hinzufügen, auf GitHub.

Beachten Sie, dass einzelne Module unterschiedliche oder spezifische Schritte für das Verknüpfen mit Windows haben können. Die in diesem Dokument beschriebenen Schritte sind nützlich, wenn das Modul-Repository nicht beschreibt, wie das Modul unter Windows verwendet wird.

Weitere Informationen zur Funktionsweise von Autolinking finden Sie unter Autolinking von nativen Modulen.

Schritt 1: Aktualisieren Sie die Lösungsdatei

Fügen Sie das Projekt ReactNativeFooCPP zu Ihrer Lösung hinzu.

1. Öffnen Sie die Lösung in Visual Studio 2019
2. Klicken Sie mit der rechten Maustaste auf das Lösungs-Symbol im Projektmappen-Explorer > Hinzufügen > Vorhandenes Projekt
3. Wählen Sie node_modules\react-native-foo\windows\vNext\ReactNativeFooCPP\ReactNativeFooCPP.vcxproj aus

Schritt 2: Aktualisieren Sie die .vcxproj-Datei

Fügen Sie eine Referenz auf ReactNativeFooCpp zu Ihrem Hauptanwendungsprojekt hinzu. In Visual Studio 2019

1. Klicken Sie mit der rechten Maustaste auf das Hauptanwendungsprojekt > Hinzufügen > Verweis...
2. Aktivieren Sie ReactNativeFooCpp unter Projektmappenprojekte.

Schritt 3: Aktualisieren Sie die pch.h-Datei

Fügen Sie #include "winrt/ReactNativeFooCPP.h" hinzu.

Schritt 4: Registrieren Sie das Paket

Fügen Sie PackageProviders().Append(winrt::ReactNativeFooCPP::ReactPackageProvider()); vor InitializeComponent(); ein.