快速入门:从头开始创建代码应用

本文介绍如何从 Vite 设置空白应用,并将其转换为 Power Apps 代码应用。 它介绍如何使用适用于代码应用的 Power Apps 客户端库配置 TypeScript 应用。

先决条件

注释

从适用于代码应用的 Power Apps 客户端库开始 v1.0.4 及更高版本,代码应用的客户端库包括基于 npm 的代码应用的 CLI。 此新 CLI 减少了生成代码应用的先决条件,并将替换 Power Platform CLI 的 pac code 命令,该命令将在将来的版本中弃用。 若要详细了解新命令并开始使用,请参阅 新的 npm CLI 快速入门

步骤

  1. 打开新终端并输入:

    npx degit github:microsoft/PowerAppsCodeApps/templates/vite my-app
    cd my-app 
    
  2. 针对 Power Platform 租户对 Power Platform CLI 进行身份验证,并选择环境:

    pac auth create
    pac env select --environment < Your environment ID >
    

    出现提示时,使用 Power Platform 帐户登录。 所有 Power Platform 应用、流和代理都发布到环境。 PAC CLI 的 auth 命令会提示您使用 Microsoft Entra 身份进行身份验证,并确保您在指定环境中添加连接的代码应用能够正确发布到 Power Platform。

  3. 安装用于代码应用的 Power Apps 客户端库,并使用以下命令初始化代码应用:

    npm install
    pac code init --displayname "App From Scratch"
    
  4. 输入以下命令在本地测试代码应用:

    npm run dev 
    

然后,打开标记为 “本地播放”的 URL。

重要

在与 Power Platform 租户相同的浏览器配置文件中打开 URL。

注释

本地网络访问限制

自 2025 年 12 月起,Chrome 和 Microsoft Edge 浏览器默认阻止从公共源到本地终结点的请求。

你应该会看到应用程序打开成类似于以下所示:

查看在浏览器中本地播放的测试应用

构建并部署到 Power Apps

在终端窗口中运行以下命令:

npm run build | pac code push
  • npm run build 运行package.json文件中通过键值build配置的脚本。 在本例中,脚本为 "tsc -b && vite build".
  • pac 代码推送 发布代码应用的新版本。

如果成功,此命令将返回 Power Apps URL 以运行应用。

(可选)可以打开 Power Apps 以查看应用。 可以从那里播放、共享或查看详细信息。

恭喜! 你已成功推送第一个代码应用程序!