Power Apps-Clientbibliothek für Code-Apps v1.0-Migrationshandbuch

Da Code-Apps die allgemeine Verfügbarkeit erreichen, verbessern wir die Power Apps-Clientbibliothek für Code-Apps und veröffentlichen Version 1.0. Zu diesen Verbesserungen gehören einschneidende Änderungen von Version 0.3.21.

Initialisierung ist nicht erforderlich

Die Power Apps-Clientbibliothek für Code-Apps, Version 1.0 und höher, entfernen die Funktion. Apps dürfen nicht mehr importieren oder aufrufen. Sie können jetzt Datenaufrufe tätigen, Kontext abrufen und direkt mit der Plattform interagieren, ohne auf die Power Apps-Clientbibliothek für die Initialisierung von Code-Apps zu warten.

Erforderliche Änderungen

Überprüfen Und wenden Sie die folgenden Änderungen an, um vorhandene Code-Apps aus der Power Apps-Clientbibliothek für Code-Apps v0.3.21 zu v1.0 zu migrieren.

Importe von Funktionen entfernen

Entfernen Sie Code wie die folgende Import-Anweisung, die normalerweise am Anfang der Datei zu finden ist.

import { initialize } from '@microsoft/power-apps

Entfernen von Logik, die auf Initialisierungsereignisse der Clientbibliothek wartet

Entfernen Sie Code wie das folgende Beispiel, das die Funktion aufruft, und legt Initialisierungsstatuskennzeichnungen fest.

useEffect(() => {
// Define an async function to initialize the Power Apps client library for code apps
const init = async () => {
      try {
            await initialize(); // Wait for client library initialization
            setIsInitialized(true); // Mark the app as ready for data operations
      } catch (err) {
            setError('Failed to initialize Power Apps client library for code apps'); // Handle initialization errors
            setLoading(false); // Stop any loading indicators
      }
};

init(); // Call the initialization function when the component mounts
}, []);

useEffect(() => {
// Prevent data operations until the client library is fully initialized
if (!isInitialized) return;

// Place your data reading logic here
}, []);

Entfernen von Initialisierungsstatuskennzeichnungen

Entfernen Sie Code, der Initialisierungsstatuskennzeichnungen überprüft, z . B. vor der Verwendung von Clientbibliotheksmethoden.

Neue API

Eine neue API ist über @microsoft/power-apps/app verfügbar. Mithilfe dieser API können Apps sich für optionale Verhaltensweisen und Observability-Features entscheiden.

Zu den unterstützten Konfigurationsoptionen gehören:

Logger: Bereitstellen eines Loggers mit einer Funktion. Diese Funktion protokolliert Sitzungs- und Netzwerkmetriken an den Telemetrie- oder Überwachungsdienst Ihrer Wahl. Weitere Informationen finden Sie unter How to: Set up Azure App Insights for your code app.