Aktualisierung auf v2.3

Wenn Sie ein PWA Kit-Projekt aktualisieren, das vor der Verfügbarkeit von v2 erstellt wurde, befolgen Sie zuerst die Anweisungen für die Aktualisierung auf v2.

Um die in v2.3 verfügbaren aktivierbaren Funktionalitäten - insbesondere die react-query-Integration - zu nutzen, müssen Sie an _app-config/index.js, _app/index.js und package.json in Ihrem PWA Kit-Projekt einige Änderungen vornehmen.

Öffnen Sie _app-config/index.js und nehmen Sie die folgenden Änderungen vor.

Importieren Sie die übergeordneten Komponenten, die für die Aktivierung von react-query und die fortgesetzte getProps-Unterstützung erforderlich sind.

Fügen Sie das options-Objekt mit der empfohlenen React Query-Konfiguration hinzu.

Aktualisieren Sie die exportierte AppConfig-Komponentendefinition.

Öffnen Sie _app/index.js und nehmen Sie die folgenden Änderungen vor.

Deklarieren Sie eine Variable namens DEFAULT_LOCALE, um das Standard-Gebietsschema für die Meldungsanzeige in Ihrer Anwendung zu speichern. Bei einem neu generierten Projekt werden die Standardmeldungen gemäß des USA-Gebietsschemas auf Englisch geschrieben. Wenn Sie die Standardmeldungen nicht umgeschrieben haben, dann ist en-US der richtige Wert für DEFAULT_LOCALE. Setzen Sie ansonsten DEFAULT_LOCALE auf einen anderen Wert wie beispielsweise fr-fr oder ja-jp.

Weisen Sie DEFAULT_LOCALE der Eigenschaft targetLocale als Standardwert zu.

Ersetzen Sie defaultLocale durch den neuen statischen Wert.

Sofern aktiviert, werden die Funktionen useQuery und getProps parallel ausgeführt. Ein Nebeneffekt dieser parallelen Ausführung ist, dass das bedingte Rendering einer Komponente anhand des Rückgabewerts von getProps dazu führen kann, dass einige useQuery-Hooks auf dem Server nicht ausgeführt werden. Der Einfachheit halber empfehlen wir, dass Sie für den Datenabruf entweder getProps oder useQuery wählen.

Fügen Sie react-query zu devDependencies hinzu.

Sie können testen, ob Ihre Änderungen erfolgreich waren. Führen Sie dazu die folgenden Befehle aus:

  1. npm install, um die erforderliche react-query-Abhängigkeit zu installieren.
  2. npm start, um zu bestätigen, dass die App lokal ausgeführt werden kann.
  3. npm run build, um zu bestätigen, dass der Build-Prozess erfolgreich ist.
  4. npm run push (und über Runtime Admin bereitstellen), um zu bestätigen, dass die Bereitstellung eines Bündels erfolgreich ist.

In der React Query-Dokumentation erfahren Sie mehr über React Query und die Anwendung dieser Bibliothek.