通过


快速入门:使用新的 npm CLI 从头开始创建代码应用(预览版)

从适用于代码应用的 Power Apps 客户端库版本 1.0.4 开始,客户端库包含适用于代码应用的基于 npm 的 CLI。 此新 CLI 减少了生成代码应用的先决条件,并替换了 Power Platform CLI pac code 的命令,这些命令在将来的版本中已弃用。

本文介绍如何为代码应用安装Power Apps客户端库,从 Vite 设置空白应用,并使用新的基于 npm 的 CLI 命令将其转换为Power Apps代码应用。

先决条件

  • 启用了代码应用的 Power Platform 环境
  • Node.js (LTS 版本)
  • Git

指令

代码应用 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 浏览器默认阻止从公共源到本地终结点的请求。

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

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

构建并部署到 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 以查看、播放、共享或查看应用详细信息。