Power Apps 示例

欢迎来到 Power Apps 示例仓库。该仓库包含 Power Apps 的示例代码，涵盖 Dataverse、模型驱动应用、画布应用、Power Apps 组件框架、门户以及 AI Builder。

资源

• Dataverse 开发者文档
• 模型驱动应用开发者文档
• 画布应用开发者文档
• Power Apps 组件框架文档
• Power Platform 开发者文档

参与贡献

本项目欢迎您的贡献和建议。大多数贡献都需要您签署贡献者许可协议（CLA），以声明您有权并将实际授予我们使用您贡献的权利。更多信息请参阅贡献者许可协议。

当您提交拉取请求时，CLA 机器人会自动判断您是否需要提供 CLA，并相应地为 PR 添加标签或评论等标记。请按照机器人提供的指示操作。对于所有使用我们 CLA 的仓库，您只需在其中任何一个仓库中执行一次这些步骤即可。

本项目已采纳Microsoft 开源行为准则。更多信息请参阅行为准则常见问题解答，或通过电子邮件opencode@microsoft.com与我们联系，提出更多问题或意见。

Power Apps Samples 快速上手指南

Power Apps Samples 是微软官方提供的示例代码仓库，涵盖 Dataverse、模型驱动应用、画布应用、Power Apps 组件框架 (PCF)、门户及 AI Builder 等核心功能。本指南帮助开发者快速配置环境并运行示例。

环境准备

在开始之前，请确保您的开发环境满足以下要求：

• 操作系统：Windows 10/11 或 macOS / Linux（部分 .NET 相关示例推荐 Windows）。
• Node.js：版本 16.x 或更高（用于 PCF 组件开发）。
  • 国内加速：建议使用 淘宝镜像源 安装 Node.js 或配置 npm 镜像。

  npm config set registry https://registry.npmmirror.com
  

• .NET SDK：版本 6.0 或更高（用于插件和后端逻辑示例）。
  • 下载地址：.NET Download
• Power Platform CLI (pac)：微软官方命令行工具。
  • 安装命令（需先安装 .NET）：

  dotnet tool install --global Microsoft.PowerApps.CLI.Tool
  

• Visual Studio Code：推荐安装以下扩展：
  • Power Platform Tools
  • ESLint (用于 PCF 开发)

安装步骤

1. 克隆仓库 使用 Git 将示例代码下载到本地。由于仓库较大，建议按需克隆或浅层克隆。

   git clone https://github.com/microsoft/PowerApps-Samples.git
   cd PowerApps-Samples
   

   国内加速提示：如果访问 GitHub 较慢，可使用国内镜像站（如 Gitee 上的同步镜像，若有）或通过代理加速下载。

2. 安装依赖 进入具体的示例目录（以 PCF 组件为例），安装所需的 npm 包。

   cd sample-code/ts/sample-components/LinearInputControl
   npm install
   

3. 认证环境 使用 pac 工具登录到您的 Power Platform 环境（开发环境或试用环境）。

   pac auth create
   

   执行后按提示输入环境 URL、用户名和密码。

基本使用

以下以构建和部署一个简单的 Power Apps 组件框架 (PCF) 示例为例：

1. 构建组件 在组件目录下运行构建命令，生成可部署的解决方案文件。

   npm run build
   

2. 打包解决方案 使用 pac 工具将组件打包成 Power Platform 解决方案。

   pac solution pack --zipfile LinearInputSolution.zip --folder src
   

   (注：具体文件夹路径需根据实际示例结构调整)

3. 推送到环境 将打包好的解决方案直接推送到已认证的环境中。

   pac solution push --zipfile LinearInputSolution.zip
   

4. 在 Power Apps 中使用

   • 登录 make.powerapps.com。
   • 创建一个新的“画布应用”或“模型驱动应用”。
   • 在组件面板中搜索刚才部署的组件名称（例如 LinearInputControl）。
   • 将其拖拽到界面上即可进行调试和使用。

提示：对于 Dataverse 插件或工作流示例，通常需要使用 Visual Studio 打开对应的 .sln 文件，编译后通过 pac plugin push 命令进行部署。请参考各子目录下的具体 README.md 获取针对性指令。