从适用于代码应用的 Power Apps 客户端库版本 1.0.4 开始,客户端库包含适用于代码应用的基于 npm 的 CLI。 此新 CLI 减少了生成代码应用的先决条件,并替换了 Power Platform CLI pac code 的命令,这些命令在将来的版本中已弃用。
本文介绍如何为代码应用安装Power Apps客户端库,从 Vite 设置空白应用,并使用新的基于 npm 的 CLI 命令将其转换为Power Apps代码应用。
先决条件
指令
代码应用 npm CLI 有三个命令:
| Command | Description |
|---|---|
init |
初始化您的代码应用。 |
run |
启动本地开发服务器。 |
push |
将新版本的代码应用程序发布到您的环境。 |
按照本文中的步骤了解如何使用这些命令。
步骤 1:初始化项目
打开终端并运行以下命令:
npx degit github:microsoft/PowerAppsCodeApps/templates/vite my-app
cd my-app
详细了解 degit 命令。
步骤 2:安装依赖项并初始化代码应用
为代码应用安装项目依赖项和 Power Apps 客户端库:
npm install
初始化您的代码应用。 可以直接提供选项或使用交互式提示:
选项 A:交互模式 (CLI 会提示输入所需信息):
npx power-apps init
选项 B:直接传递选项:
npx power-apps init --displayName "App From Scratch" --environmentId <Your environment ID>
运行 init 命令时,CLI 会自动进行身份验证。 出现提示时,使用 Power Platform 帐户登录。
步骤 3:在本地进行测试
在本地运行应用程序代码以便进行开发:
npm run dev
这会启动本地开发服务器。 打开标记为 “本地播放”的 URL。
重要
请使用与 Power Platform 租户相同的浏览器配置打开该 URL。
注释
本地网络访问限制
自 2025 年 12 月起,Chrome 和 Microsoft Edge 浏览器默认阻止从公共源到本地终结点的请求。
- 由于代码应用在开发过程中连接到 localhost,因此可能需要授予浏览器权限或配置企业策略。
- 对于嵌入式方案,请在 iframe 标记中包含
allow="local-network-access"。 - 有关详细信息,请参阅 在Microsoft Edge中控制网站对本地网络的访问以及 使用Chrome访问本地网络时的新权限提示。
你应该会看到应用程序打开成类似于以下所示:
构建并部署到 Power Apps
生成应用并将其推送到Power Apps环境:
npm run build
npx power-apps push
命令详细信息:
-
npm run build- 运行来自package.json的脚本。 执行tsc -b && vite build。 -
npx power-apps push- 将新版本的代码应用发布到环境。
命令成功完成后,它将返回Power Apps URL 来运行应用。
(可选)转到 Power Apps 以查看、播放、共享或查看应用详细信息。