Skip to main content
The Add Existing App action downloads and adds an existing Business Central app (.app file) or a .zip file containing apps to your AL-Go repository.

Usage

- uses: microsoft/AL-Go/Actions/AddExistingApp@main
  with:
    url: 'https://example.com/path/to/app.app'

Inputs

url
string
required
Direct download URL of the .app or .zip file to add to the repository.
project
string
default:"."
Project name if the repository is setup for multiple projects. Use . for the root project.
updateBranch
string
default:"${{ github.ref_name }}"
Set the branch to update. Defaults to the current branch.
directCommit
boolean
default:"false"
Whether to commit directly to the branch without creating a pull request.
shell
string
default:"powershell"
Shell in which you want to run the action. Options: powershell or pwsh.
actor
string
default:"${{ github.actor }}"
The GitHub actor running the action.
token
string
default:"${{ github.token }}"
The GitHub token running the action.

Example

Add an existing app from a direct download URL:
name: Add Existing App
on:
  workflow_dispatch:
    inputs:
      appUrl:
        description: 'URL to the .app file'
        required: true

jobs:
  add-app:
    runs-on: windows-latest
    steps:
      - uses: actions/checkout@v4
      
      - uses: microsoft/AL-Go/Actions/AddExistingApp@main
        with:
          url: ${{ github.event.inputs.appUrl }}
          directCommit: false
The action will download the app from the specified URL and add it to the appropriate location in your repository structure.
Ensure the URL is accessible and points to a valid .app or .zip file. The action requires a direct download link.

Build docs developers (and LLMs) love