打包代码组件

了解如何将代码组件打包到解决方案文件中,并将其导入Microsoft Dataverse,以便在运行时可用。 你还了解如何连接到环境、使用 Microsoft Power Platform CLI 部署更新以及从解决方案中删除组件。

Process

创建和导入解决方案文件:

  1. 使用命令mkdir Solutions在示例组件文件夹中创建新文件夹,并将其命名为解决方案(或所选的任何名称)。 使用命令 cd Solutions导航到目录。

  2. 使用 pac 解决方案 init 命令创建新的解决方案项目。 使用解决方案项目将代码组件捆绑到导入 Dataverse 的解决方案 ZIP 文件中。

    pac solution init --publisher-name developer --publisher-prefix dev
    

    Note

    publisher-prefix 和 publisher-name 的值对于您的环境必须是唯一的。

  3. 创建新解决方案项目后,将 “解决方案 ”文件夹设置为创建的示例组件的位置。 使用 pac 解决方案添加引用 命令添加引用。 此参考将告知解决方案项目在生成过程中要添加的代码组件。 您可以在单个解决方案项目中添加对多个组件的引用。

     pac solution add-reference --path c:\downloads\mysamplecomponent
    
  4. 若要从解决方案项目生成 ZIP 文件,请转到解决方案项目目录,然后使用以下命令生成项目。 此命令使用 MSBuild 构建该解决方案项目,并在还原过程中下载 NuGet 依赖项。 仅在首次生成解决方案时使用 /restore 标志。 对于此后的每次构建,请运行命令 msbuild。

    msbuild /t:restore
    
    msbuild
    

    或者,如果已安装 .NET SDK 版本 6 或更高版本:

    dotnet build
    

    Tip

    • 如果 msbuild 15.9.* 不在路径中,请打开 VS 2017 开发人员命令提示符以运行 msbuild 命令。
    • 在调试配置中构建解决方案将生成非托管解决方案包。 在 release 配置下生成该解决方案将生成托管解决方案包。 可以通过在文件中指定 SolutionPackageType 属性 cdsproj 来替代这些设置。
    • 将 MSBuild 配置设置为 Release 以执行生产版本构建。 示例: msbuild /p:configuration=Release
    • 如果对解决方案运行 命令时遇到显示为 msbuild 的错误,请确保解决方案名称和项目名称不相同。
  5. 生成成功后,在文件夹中找到生成的解决方案文件 \bin\debug\ 。

  6. 使用 Web 门户手动将解决方案导入 Dataverse,或使用Microsoft Power Platform生成工具自动导入 Dataverse。

连接到您的环境

您可以通过连接到 Dataverse 环境,然后推送更新的组件,直接从 Microsoft Power Platform CLI 部署代码组件。

按照以下列表中的步骤创建身份验证配置文件、连接到 Dataverse 并推送更新的组件。

  1. 使用 pac auth create 命令创建您的身份验证配置文件。

    pac auth create --url https://xyz.crm.dynamics.com 
    
  2. 如果以前创建了身份验证配置文件,请使用 pac auth list 命令查看所有现有配置文件。

     pac auth list 
    
  3. 使用 pac auth select 命令在以前创建的身份验证配置文件之间切换。

     pac auth select --index <index of the active profile>
    
  4. 使用 pac org who 命令获取有关环境的基本信息。 该连接使用默认身份验证配置文件。

    pac org who 
    
  5. 使用带有 pac auth delete --index <index of the profile> 语法的 pac auth delete 命令删除特定的身份验证配置文件。

  6. 使用 pac 身份验证清除 命令清除本地计算机中的所有身份验证配置文件。 此操作不可逆,因为它从本地计算机中完全删除 authprofile.json 文件和令牌缓存文件。

部署代码组件

创建身份验证配置文件后,开始使用所有最新更改将代码组件推送到 Dataverse 实例。

此功能 push 加快了内部开发人员周期开发的速度,因为它绕过了代码组件版本控制要求,并且不需要生成解决方案(cdsproj)来导入代码组件。

若要使用 push 该功能,请执行以下步骤:

  1. 请确保您拥有有效的身份验证配置文件。

  2. 转到示例组件文件所在的目录。

  3. 运行 pac pcf push 命令。

    pac pcf push --publisher-prefix <your publisher prefix>
    

    Note

    你与 push 命令一起使用的发布者前缀,应与包含这些组件的解决方案的发布者前缀匹配。

从解决方案中删除组件

如果要从解决方案文件中删除代码组件:

  1. 编辑解决方案项目目录中的 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>
    
  2. 使用以下命令执行重新生成(或清理):

    msbuild /t:rebuild
    

另见

将代码组件添加到模型驱动应用中的列或表中
将组件添加到画布应用
Power Apps组件框架 API 参考
Power Apps组件框架概述
Microsoft Power Platform CLI 命令组