如何通过命令行从.pq文件构建.mez？实现GitHub Actions自动化构建PowerBI连接器

核心依赖 #

构建依赖Power Query SDK自带的Microsoft.Mashup.Tools.exe工具，默认安装路径为C:\Program Files\Microsoft Power Query SDK\tools\Microsoft.Mashup.Tools.exe。

PowerShell构建命令 #

针对完整项目（含.mashupproj） #

# 定义工具路径
$mashupTools = "C:\Program Files\Microsoft Power Query SDK\tools\Microsoft.Mashup.Tools.exe"

# 执行打包：指定项目目录/项目文件，输出.mez文件
& $mashupTools pack --project "C:\path\to\your\connector-project" --output "C:\output\path\YourConnector.mez"

针对单个.pq文件 #

若仅存在单个.pq文件，需先在同目录创建简单的.mashupproj项目文件，内容如下：

<?xml version="1.0" encoding="utf-8"?>
<Project xmlns="http://schemas.microsoft.com/powerquery/2014/01/project">
  <Files>
    <File>YourConnector.pq</File>
  </Files>
</Project>

之后执行上述打包命令，指向该项目文件即可。

GitHub Actions自动化配置示例 #

name: Build PowerBI Connector
on: [push, pull_request]

jobs:
  build-connector:
    runs-on: windows-latest
    steps:
      - name: 拉取代码
        uses: actions/checkout@v4
        
      - name: 安装Power Query SDK
        run: choco install powerquery-sdk --yes
        
      - name: 定位构建工具
        id: find-tool
        run: |
          $toolPath = (Get-ChildItem "C:\Program Files\Microsoft Power Query SDK\tools\Microsoft.Mashup.Tools.exe").FullName
          echo "tool-path=$toolPath" >> $env:GITHUB_OUTPUT
          
      - name: 构建.mez文件
        run: |
          & "${{ steps.find-tool.outputs.tool-path }}" pack --project "./your-connector-dir" --output "./dist/YourConnector.mez"
          
      - name: 上传构建产物
        uses: actions/upload-artifact@v4
        with:
          name: powerbi-connector
          path: ./dist/YourConnector.mez

内容的提问来源于stack exchange，提问作者Ritika