Power Apps SDK v1.0–Migrationshandbuch

Da Code-Apps auf die allgemeine Verfügbarkeit abzielen, verbessern wir das SDK und veröffentlichen Version 1.0. Zu diesen Verbesserungen zählen die Breaking Changes der SDK-Version 0.3.21.

Initialisierung ist nicht erforderlich

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

Erforderliche Änderungen

Überprüfen Und wenden Sie die folgenden Änderungen an, um vorhandene Code-Apps von SDK v0.3.21 zu v1.0 zu migrieren.

Importe von initialize 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 SDK-Initialisierungsereignisse wartet

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

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

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

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

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

Entfernen von Initialisierungsstatuskennzeichnungen

Entfernen Sie Code, der Initialisierungsstatuskennzeichnungen überprüft, wie zum Beispiel isInitialized, bevor Sie SDK-Methoden verwenden.

Neue setConfig API

Eine neue setConfig 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 logMetric Funktion. Diese logMetric 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.