create-pcf 用于为模型驱动应用(model-driven apps)创建或扩展 Power Apps Component Framework(PCF)控件,目标产物是可运行的 TypeScript PCF 项目,而非设计稿或代码片段。
主要能力
- 支持字段控件(绑定单个列)与数据集控件(绑定表视图/子网格)的创建与扩展。
- 要求每个新控件使用 pac pcf init --framework react 脚手架,使用宿主提供的 React 与 Fluent UI v9 平台库。
- 控件逻辑、组件与测试使用 .ts/.tsx 编写,不使用纯 JavaScript;不修改自动生成文件。
- 通过 context.webAPI 执行 Dataverse 操作,通过解决方案打包支持发布与跨环境推广。
- 提供质量检查清单,以及组件模式、清单参考、虚拟控件生命周期等官方文档参考材料。
使用方式
- 勘察仓库说明、现有 PCF 项目、清单、生成类型、依赖、共享辅助、本地化资源与测试,尽量扩展已有虚拟控件。
- 确认缺失决策:控件名称/命名空间/目录、新建或扩展、字段或数据集绑定、目标位置与设备尺寸、默认值/激活/提交/取消行为、可空与可访问性要求、打包与部署信息。
- 核验 PAC CLI、Node/npm、MSBuild 及项目构建要求,使用配置的 npm 源并固定与平台契约兼容的版本。
- 在约定目录执行 pac pcf init 脚手架(field 或 dataset 模板、react 框架),复用脚手架的 pcf-scripts、生成类型与构建管线。
- 实现 ComponentFramework.ReactControl 生命周期、数据流、Dataset 绑定与 Dataverse 操作,并遵循非文本可空字段编辑器的空值到默认值契约。
- 未经明确批准不得部署。
适用场景
- 为模型驱动应用构建或扩展自定义字段编辑器、评分、开关等 PCF 控件。
- 构建数据集控件并在真实宿主中测试分页、筛选/排序、选择与 WebAPI 行为。
- 需要遵循 React 与 Fluent UI v9 平台库契约、TypeScript 边界与解决方案打包规范的项目。
限制
- 不使用 React 18 API(如 createRoot、useId),不引入独立的打包器。
- 不使用 Xrm.WebApi、直接 Dataverse fetch/HTTP 客户端或父窗口 API;字段值通过绑定输出由表单管理保存生命周期。
- 测试工具不完全实现数据集 API,相关行为需在真实模型驱动宿主中验证。
- 文中列出的运行时版本为编写时的参考快照,不是当前可用性的承诺。