了解如何将代码组件打包到解决方案文件中,并将其导入Microsoft Dataverse,以便在运行时可用。 你还了解如何连接到环境、使用 Microsoft Power Platform CLI 部署更新以及从解决方案中删除组件。
Process
创建和导入解决方案文件:
使用命令
mkdir Solutions在示例组件文件夹中创建新文件夹,并将其命名为解决方案(或所选的任何名称)。 使用命令cd Solutions导航到目录。使用 pac 解决方案 init 命令创建新的解决方案项目。 使用解决方案项目将代码组件捆绑到导入 Dataverse 的解决方案 ZIP 文件中。
pac solution init --publisher-name developer --publisher-prefix devNote
publisher-prefix和publisher-name的值对于您的环境必须是唯一的。创建新解决方案项目后,将 “解决方案 ”文件夹设置为创建的示例组件的位置。 使用 pac 解决方案添加引用 命令添加引用。 此参考将告知解决方案项目在生成过程中要添加的代码组件。 您可以在单个解决方案项目中添加对多个组件的引用。
pac solution add-reference --path c:\downloads\mysamplecomponent若要从解决方案项目生成 ZIP 文件,请转到解决方案项目目录,然后使用以下命令生成项目。 此命令使用 MSBuild 构建该解决方案项目,并在还原过程中下载 NuGet 依赖项。 仅在首次生成解决方案时使用
/restore标志。 对于此后的每次构建,请运行命令msbuild。msbuild /t:restoremsbuild或者,如果已安装 .NET SDK 版本 6 或更高版本:
dotnet buildTip
- 如果 msbuild 15.9.* 不在路径中,请打开 VS 2017 开发人员命令提示符以运行
msbuild命令。 - 在调试配置中构建解决方案将生成非托管解决方案包。 在 release 配置下生成该解决方案将生成托管解决方案包。 可以通过在文件中指定
SolutionPackageType属性cdsproj来替代这些设置。 - 将 MSBuild 配置设置为
Release以执行生产版本构建。 示例:msbuild /p:configuration=Release - 如果对解决方案运行 命令时遇到显示为
msbuild的错误,请确保解决方案名称和项目名称不相同。
- 如果 msbuild 15.9.* 不在路径中,请打开 VS 2017 开发人员命令提示符以运行
生成成功后,在文件夹中找到生成的解决方案文件
\bin\debug\。使用 Web 门户手动将解决方案导入 Dataverse,或使用Microsoft Power Platform生成工具自动导入 Dataverse。
连接到您的环境
您可以通过连接到 Dataverse 环境,然后推送更新的组件,直接从 Microsoft Power Platform CLI 部署代码组件。
按照以下列表中的步骤创建身份验证配置文件、连接到 Dataverse 并推送更新的组件。
使用 pac auth create 命令创建您的身份验证配置文件。
pac auth create --url https://xyz.crm.dynamics.com如果以前创建了身份验证配置文件,请使用 pac auth list 命令查看所有现有配置文件。
pac auth list使用 pac auth select 命令在以前创建的身份验证配置文件之间切换。
pac auth select --index <index of the active profile>使用 pac org who 命令获取有关环境的基本信息。 该连接使用默认身份验证配置文件。
pac org who使用带有
pac auth delete --index <index of the profile>语法的 pac auth delete 命令删除特定的身份验证配置文件。使用 pac 身份验证清除 命令清除本地计算机中的所有身份验证配置文件。 此操作不可逆,因为它从本地计算机中完全删除
authprofile.json文件和令牌缓存文件。
部署代码组件
创建身份验证配置文件后,开始使用所有最新更改将代码组件推送到 Dataverse 实例。
此功能 push 加快了内部开发人员周期开发的速度,因为它绕过了代码组件版本控制要求,并且不需要生成解决方案(cdsproj)来导入代码组件。
若要使用 push 该功能,请执行以下步骤:
请确保您拥有有效的身份验证配置文件。
转到示例组件文件所在的目录。
运行 pac pcf push 命令。
pac pcf push --publisher-prefix <your publisher prefix>Note
你与
push命令一起使用的发布者前缀,应与包含这些组件的解决方案的发布者前缀匹配。
从解决方案中删除组件
如果要从解决方案文件中删除代码组件:
编辑解决方案项目目录中的
cdsproj文件,并删除对该组件的引用。 下面是组件引用的示例:<ItemGroup> <Projectreference Include="..\pcf_component\pcf_component.pcfproj"> <Project>0481bd83-ffb0-4b70-b526-e0b3dd63e7ef</Project> <Name>pcf_component</Name> <Targets>Build</Targets> <referenceOutputAssembly>false</referenceOutputAssembly> <OutputItemType>Content</OutputItemType> <CopyToOutputDirectory>Always</CopyToOutputDirectory> </Projectreference> </ItemGroup>使用以下命令执行重新生成(或清理):
msbuild /t:rebuild
另见
将代码组件添加到模型驱动应用中的列或表中
将组件添加到画布应用
Power Apps组件框架 API 参考
Power Apps组件框架概述
Microsoft Power Platform CLI 命令组