Guide de migration du Kit de développement logiciel (SDK) Power Apps v1.0 (préversion)

À mesure que les applications de code approchent de la disponibilité générale, nous améliorons le Kit de développement logiciel (SDK) et publions la version 1.0. Ces améliorations incluent les changements cassants du SDK version 0.3.21.

L’initialisation n’est pas requise

Le KIT SDK version 1.0 et versions ultérieures suppriment la initialize fonction. Les applications ne doivent plus importer ou appeler initialize. Vous pouvez désormais effectuer des appels de données, récupérer le contexte et interagir directement avec la plateforme sans attendre l’initialisation du SDK.

Modifications requises

Passez en revue et appliquez les modifications suivantes pour migrer les applications de code existantes du Kit de développement logiciel (SDK) v0.3.21 vers la version 1.0.

Supprimer les importations de initialize fonction

Supprimez du code comme l’instruction import suivante, qui se trouve généralement en haut de votre fichier.

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

Supprimer la logique qui attend les événements d’initialisation du Kit de développement logiciel (SDK)

Supprimez le code comme l’exemple suivant qui appelle la initialize fonction et définit les indicateurs d’état d’initialisation.

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

Supprimer les indicateurs d’état d’initialisation

Supprimez le code qui vérifie les indicateurs d’état d’initialisation, tels que isInitialized, avant d’utiliser des méthodes sdk.

Nouvelle setConfig API

Une nouvelle setConfig API est disponible à partir de @microsoft/power-apps/app. À l’aide de cette API, les applications peuvent opter pour des comportements facultatifs et des fonctionnalités d’observabilité.

Les options de configuration prises en charge sont les suivantes :

Enregistreur d’événements : fournissez un enregistreur d’événements avec une logMetric fonction. Cette logMetric fonction consigne les métriques de session et de réseau dans le service de télémétrie ou de surveillance de votre choix. Pour plus d’informations, consultez Guide pratique pour configurer Azure App Insights pour votre application de code (préversion).