Guía de migración del SDK de Power Apps v1.0 (versión preliminar)

A medida que las aplicaciones de código se aproximan a la disponibilidad general, estamos mejorando el SDK y publicando la versión 1.0. Estas mejoras incluyen cambios importantes de la versión 0.3.21 del SDK.

La inicialización no es necesaria

La versión 1.0 del SDK y versiones posteriores quitan la initialize función . Las aplicaciones ya no deben importar ni llamar a initialize. Ahora puede realizar llamadas de datos, recuperar contexto e interactuar con la plataforma directamente sin esperar a la inicialización del SDK.

Cambios necesarios

Revise y aplique los siguientes cambios para migrar aplicaciones de código existentes de SDK v0.3.21 a v1.0.

Eliminar las importaciones de la función initialize

Elimine código como la declaración de importación siguiente, que normalmente se encuentra en la parte superior de su archivo.

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

Eliminación de la lógica que espera en los eventos de inicialización del SDK

Quite código como el ejemplo siguiente que invoca la initialize función y establece las marcas de estado de inicialización.

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
}, []);

Quitar marcas de estado de inicialización

Quite el código que comprueba las marcas de estado de inicialización, como isInitialized, antes de usar métodos del SDK.

Nueva setConfig API

Hay disponible una nueva setConfig API en @microsoft/power-apps/app. Con esta API, las aplicaciones pueden optar por comportamientos opcionales y características de observabilidad.

Entre las opciones de configuración admitidas se incluyen:

Registrador: proporcione un registrador con una logMetric función . Esta logMetric función registra las métricas de sesión y red en el servicio de telemetría o supervisión que prefiera. Para más información, consulte Configuración de Azure App Insights para la aplicación de código (versión preliminar).