Biblioteca cliente de Power Apps para aplicaciones de código v1.0 Guía de migración

A medida que las aplicaciones de código se aproximan a la disponibilidad general, estamos mejorando la librería cliente de Power Apps para aplicaciones de código y lanzando la versión 1.0. Estas mejoras incluyen cambios importantes de la versión 0.3.21.

La inicialización no es necesaria

La biblioteca cliente de Power Apps para aplicaciones de código versión 1.0 y posteriores quita la función initialize. 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 que se inicialicen las aplicaciones de código en la biblioteca cliente de Power Apps.

Cambios necesarios

Revise y aplique los siguientes cambios para migrar aplicaciones de código existentes desde la biblioteca cliente de Power Apps para aplicaciones de código 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 de la biblioteca cliente

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

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 de biblioteca cliente.

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 Cómo configurar App de Azure Insights para su aplicación de código.