Skip to main content
The Build Power Platform action builds Power Platform solutions from unpacked source files, creating managed or unmanaged solution packages that can be deployed to Power Platform environments.

Usage

- uses: microsoft/AL-Go/Actions/[email protected]
  with:
    solutionFolder: 'PowerPlatformSolution'
    outputFolder: '.artifacts'
    outputFileName: 'MySolution'

Inputs

shell
string
default:"powershell"
Shell in which you want to run the action (powershell or pwsh)
solutionFolder
string
required
The Power Platform solution pathThis should point to the folder containing the unpacked Power Platform solution files.
outputFolder
string
required
Output folder where the zip file will be placedThe built solution package will be created in this directory.
outputFileName
string
required
The name of the output zip file (without .zip extension)
companyId
string
default:""
The Business Central company IDUsed when the Power Platform solution integrates with Business Central.
environmentName
string
default:""
The Business Central environment nameUsed when the Power Platform solution integrates with Business Central.
appBuild
string
default:""
The app build numberSets the build portion of the solution version number.
appRevision
string
default:""
The app revision numberSets the revision portion of the solution version number.

Example Workflows

Basic Solution Build

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      
      - name: Build Power Platform Solution
        uses: microsoft/AL-Go/Actions/[email protected]
        with:
          solutionFolder: 'src/PowerPlatformSolution'
          outputFolder: '.artifacts'
          outputFileName: 'MySolution'
      
      - name: Upload artifacts
        uses: actions/upload-artifact@v4
        with:
          name: power-platform-solution
          path: .artifacts/MySolution.zip

Build with Business Central Integration

- name: Build Power Platform Solution with BC Integration
  uses: microsoft/AL-Go/Actions/[email protected]
  with:
    solutionFolder: 'src/PowerPlatformSolution'
    outputFolder: '.artifacts'
    outputFileName: 'MySolution'
    companyId: ${{ secrets.BC_COMPANY_ID }}
    environmentName: 'Production'

Build with Version Numbers

- name: Build Power Platform Solution with Version
  uses: microsoft/AL-Go/Actions/[email protected]
  with:
    solutionFolder: 'src/PowerPlatformSolution'
    outputFolder: '.artifacts'
    outputFileName: 'MySolution'
    appBuild: ${{ github.run_number }}
    appRevision: '0'

Multi-Solution Build

strategy:
  matrix:
    solution:
      - name: 'Solution1'
        folder: 'src/Solution1'
      - name: 'Solution2'
        folder: 'src/Solution2'
steps:
  - name: Build ${{ matrix.solution.name }}
    uses: microsoft/AL-Go/Actions/[email protected]
    with:
      solutionFolder: ${{ matrix.solution.folder }}
      outputFolder: '.artifacts'
      outputFileName: ${{ matrix.solution.name }}
This action automatically installs the Power Platform tools and handles canvas app processing during the build.
The action performs a test pack as a workaround for a known issue in the Power Platform VS Code extension. This temporary file is automatically removed.

Build docs developers (and LLMs) love