Power Apps SDK v1.0 迁移指南

随着代码应用即将正式发布，我们正在改进 SDK 并发布版本 1.0。 这些改进包含 SDK 0.3.21 版本的重大变更。

不需要初始化

SDK 版本 1.0 及更高版本会删除该 initialize 函数。 应用不能再导入或调用 initialize。 现在可以进行数据调用、检索上下文并与平台直接交互，而无需等待 SDK 初始化。

所需的更改

查看并应用以下更改，将现有代码应用从 SDK v0.3.21 迁移到 v1.0。

删除 initialize 函数的导入

删除类似于以下 import 语句的代码，通常位于文件顶部。

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

删除等待 SDK 初始化事件的逻辑

删除调用函数并设置初始化状态标志的代码，如以下示例 initialize 所示。

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

删除初始化状态标志

在使用 SDK 方法之前，请删除检查初始化状态标志的代码，例如 isInitialized。

新建 setConfig API

一个新的 setConfig API 可从 @microsoft/power-apps/app 获取。 使用此 API，应用可以选择使用可选行为和可观测性功能。

支持的配置选项包括：

记录器：提供一个带有logMetric函数的记录器。 此 logMetric 函数将会话和网络指标记录到所选的遥测或监视服务。 有关详细信息，请参阅 如何：为代码应用设置 Azure App Insights。