Guia de Migração do SDK do Power Apps v1.0 (versão prévia)

À medida que os aplicativos de código abordam a disponibilidade geral, estamos melhorando o SDK e lançando a versão 1.0. Essas melhorias incluem alterações significativas do SDK versão 0.3.21.

A inicialização não é necessária

O SDK versão 1.0 e posterior remove a initialize função. Os aplicativos não devem mais importar ou chamar initialize. Agora você pode fazer chamadas de dados, recuperar contexto e interagir diretamente com a plataforma sem esperar pela inicialização do SDK.

Alterações necessárias

Examine e aplique as seguintes alterações para migrar aplicativos de código existentes do SDK v0.3.21 para v1.0.

Remover importações da função initialize

Remova o código como a instrução de importação a seguir, que normalmente é encontrada na parte superior do arquivo.

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

Remover lógica que aguarda eventos de inicialização do SDK

Remova o código como o exemplo a seguir que invoca a função e define os initialize sinalizadores de estado de inicialização.

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

Remover sinalizadores de estado de inicialização

Remova o código que verifica os sinalizadores de estado de inicialização, como isInitialized, antes de usar métodos SDK.

Nova setConfig API

Uma nova setConfig API está disponível no @microsoft/power-apps/app. Usando essa API, os aplicativos podem optar por comportamentos opcionais e recursos de observabilidade.

As opções de configuração com suporte incluem:

Logger: forneça um registrador com uma logMetric função. Essa logMetric função registra as métricas de sessão e de rede no serviço de telemetria ou monitoramento de sua escolha. Para obter mais informações, consulte Como configurar o Azure App Insights para seu aplicativo de código (versão prévia).