Skip to content
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions .github/AL-Go-Settings.json
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
{
"$schema": "https://raw.githubusercontent.com/microsoft/AL-Go/0c7b1de38ba518aaf5fdee3902c2d2ae886ede32/Actions/.Modules/settings.schema.json",
"$schema": "https://raw.githubusercontent.com/microsoft/AL-Go/dc3e26be0e944a133933216cae88cf8f86263a28/Actions/.Modules/settings.schema.json",
"type": "PTE",
"templateUrl": "https://github.com/microsoft/AL-Go-PTE@preview",
"bcContainerHelperVersion": "preview",
Expand Down Expand Up @@ -93,7 +93,7 @@
]
},
"UpdateALGoSystemFilesEnvironment": "Official-Build",
"templateSha": "87ad9f919052f78e0cc462d90fec1cf3c2e72c80",
"templateSha": "a7e66c88e3f97b96ec5f55026cb353d3ccc64b3d",
"commitOptions": {
"messageSuffix": "Related to AB#539394",
"pullRequestAutoMerge": true,
Expand Down
80 changes: 80 additions & 0 deletions .github/RELEASENOTES.copy.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,8 +2,88 @@

Note that when using the preview version of AL-Go for GitHub, we recommend you Update your AL-Go system files, as soon as possible when informed that an update is available.

### Added support for workspace compilation

With v28 of Business Central, the ALTool now also provides the ability to compile workspaces of apps. This has the added advantage that the ALTool can compute the dependency graph for the apps in the workspace and compile apps in parallel (if possible). For AL-Go projects with large amounts of apps that can save a lot of time. If you want to try this out you can enable it via the following setting

```json
"workspaceCompilation": {
"enabled": true
}
```

By default apps are compiled sequentially but this can be changed via the parallelism property. This allows you to configure the maximum amount of parallel compilation processes. Set to 0 or -1 to use all available processors.

```json
"workspaceCompilation": {
"enabled": true,
"parallelism": 4
}
```

### Test Projects — split builds and tests for faster feedback

AL-Go now supports **test projects**: a new project type that separates test execution from compilation. A test project does not build any apps itself — instead it depends on one or more regular projects, installs the apps they produce, and runs tests against them.

This lets you re-run tests without waiting for a full recompilation, and makes it easy to organize large repositories where builds and test suites have different scopes or cadences.

**Getting started**

Add a `projectsToTest` setting to the project-level `.AL-Go/settings.json` of an empty project (no `appFolders` or `testFolders`):

```json
{
"projectsToTest": ["build/projects/MyProject"]
}
```

AL-Go will automatically:

- Resolve the dependency so the test project always builds after its target project(s).
- Install the Test Runner, Test Framework, and Test Libraries into the container.
- Run all tests from the installed test apps.

**Key rules**

- A test project must **not** contain buildable code (no `appFolders`, `testFolders`, or `bcptTestFolders`). AL-Go will fail with a clear error if it detects both `projectsToTest` and buildable folders.
- A test project cannot depend on another test project.
- You can target multiple projects: `"projectsToTest": ["build/projects/ProjectA", "build/projects/ProjectB"]`.
- Use full project paths as they appear in the repository.

### Improving error detection and build reliability when downloading project dependencies

The `DownloadProjectDependencies` action now downloads app files from URLs specified in the `installApps` and `installTestApps` settings upfront, rather than validating URLs at build time. This change provides:

- Earlier detection of inaccessible or misconfigured URLs
- Clearer error messages when secrets are missing or URLs are invalid
- Warnings for potential issues like duplicate filenames

### Improve overall performance by postponing projects with no dependants

The time it takes to build projects can vary significantly depending on factors such as whether you are using Linux or Windows, Containers or CompilerFolders, and whether apps are being published or tests are being run.

By default, projects are built according to their dependency order. As soon as all dependencies for a project are satisfied, the project is added to the next layer of jobs.

The new setting `postponeProjectInBuildOrder` allows you to delay long running jobs (f.ex. test runs) with no dependants until the final layer of the build order. This can improve overall build performance by preventing subsequent layers from waiting on projects that take longer to complete but are not required for further dependencies.

### Issues

- Attempt to start docker service in case it is not running
- NextMajor (v28) fails when downloading dependencies from NuGet-feed
- Issue 2084 Multiple artifacts failure if you re-run failed jobs after flaky tests
- Issue 2085 Projects that doesn't contain both Apps and TestApps are wrongly seen as not built.
- Issue 2086 Postpone jobs, which doesn't have any dependents to the end of the build order.
- Rework input handling of workflow 'Update AL-Go System Files' for trigger 'workflow_call'

### New Settings

- `postponeProjectInBuildOrder` is a new project setting, which will (if set to true) cause the project to be postponed until the last build job when possible. If set on test projects, then all tests can be deferred until all builds have succeeded.

## v8.3

### Issues

- Issue 2107 Publish a specific build mode to an environment
- Issue 1915 CICD fails on releases/26.x branch - '26.x' cannot be recognized as a semantic version string

### The default pull request trigger is changing
Expand Down
2 changes: 1 addition & 1 deletion .github/Test Next Major.settings.json
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
{
"$schema": "https://raw.githubusercontent.com/microsoft/AL-Go/0c7b1de38ba518aaf5fdee3902c2d2ae886ede32/Actions/.Modules/settings.schema.json",
"$schema": "https://raw.githubusercontent.com/microsoft/AL-Go/dc3e26be0e944a133933216cae88cf8f86263a28/Actions/.Modules/settings.schema.json",
"artifact": "////nextmajor",
"cacheImageName": "",
"versioningStrategy": 15
Expand Down
2 changes: 1 addition & 1 deletion .github/Test Next Minor.settings.json
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
{
"$schema": "https://raw.githubusercontent.com/microsoft/AL-Go/0c7b1de38ba518aaf5fdee3902c2d2ae886ede32/Actions/.Modules/settings.schema.json",
"$schema": "https://raw.githubusercontent.com/microsoft/AL-Go/dc3e26be0e944a133933216cae88cf8f86263a28/Actions/.Modules/settings.schema.json",
"artifact": "////nextminor",
"cacheImageName": "",
"versioningStrategy": 15
Expand Down
56 changes: 28 additions & 28 deletions .github/workflows/CICD.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -51,7 +51,7 @@ jobs:
trackALAlertsInGitHub: ${{ steps.SetALCodeAnalysisVar.outputs.trackALAlertsInGitHub }}
steps:
- name: Dump Workflow Information
uses: microsoft/AL-Go/Actions/DumpWorkflowInfo@0c7b1de38ba518aaf5fdee3902c2d2ae886ede32
uses: microsoft/AL-Go/Actions/DumpWorkflowInfo@dc3e26be0e944a133933216cae88cf8f86263a28
with:
shell: powershell

Expand All @@ -62,13 +62,13 @@ jobs:

- name: Initialize the workflow
id: init
uses: microsoft/AL-Go/Actions/WorkflowInitialize@0c7b1de38ba518aaf5fdee3902c2d2ae886ede32
uses: microsoft/AL-Go/Actions/WorkflowInitialize@dc3e26be0e944a133933216cae88cf8f86263a28
with:
shell: powershell

- name: Read settings
id: ReadSettings
uses: microsoft/AL-Go/Actions/ReadSettings@0c7b1de38ba518aaf5fdee3902c2d2ae886ede32
uses: microsoft/AL-Go/Actions/ReadSettings@dc3e26be0e944a133933216cae88cf8f86263a28
with:
shell: powershell
get: type,powerPlatformSolutionFolder,useGitSubmodules,trackALAlertsInGitHub
Expand All @@ -82,7 +82,7 @@ jobs:
- name: Read submodules token
id: ReadSubmodulesToken
if: env.useGitSubmodules != 'false' && env.useGitSubmodules != ''
uses: microsoft/AL-Go/Actions/ReadSecrets@0c7b1de38ba518aaf5fdee3902c2d2ae886ede32
uses: microsoft/AL-Go/Actions/ReadSecrets@dc3e26be0e944a133933216cae88cf8f86263a28
with:
shell: powershell
gitHubSecrets: ${{ toJson(secrets) }}
Expand All @@ -103,7 +103,7 @@ jobs:

- name: Determine Projects To Build
id: determineProjectsToBuild
uses: microsoft/AL-Go/Actions/DetermineProjectsToBuild@0c7b1de38ba518aaf5fdee3902c2d2ae886ede32
uses: microsoft/AL-Go/Actions/DetermineProjectsToBuild@dc3e26be0e944a133933216cae88cf8f86263a28
with:
shell: powershell
maxBuildDepth: ${{ env.workflowDepth }}
Expand All @@ -116,23 +116,23 @@ jobs:

- name: Determine Delivery Target Secrets
id: DetermineDeliveryTargetSecrets
uses: microsoft/AL-Go/Actions/DetermineDeliveryTargets@0c7b1de38ba518aaf5fdee3902c2d2ae886ede32
uses: microsoft/AL-Go/Actions/DetermineDeliveryTargets@dc3e26be0e944a133933216cae88cf8f86263a28
with:
shell: powershell
projectsJson: '${{ steps.determineProjectsToBuild.outputs.ProjectsJson }}'
checkContextSecrets: 'false'

- name: Read secrets
id: ReadSecrets
uses: microsoft/AL-Go/Actions/ReadSecrets@0c7b1de38ba518aaf5fdee3902c2d2ae886ede32
uses: microsoft/AL-Go/Actions/ReadSecrets@dc3e26be0e944a133933216cae88cf8f86263a28
with:
shell: powershell
gitHubSecrets: ${{ toJson(secrets) }}
getSecrets: ${{ steps.DetermineDeliveryTargetSecrets.outputs.ContextSecrets }}

- name: Determine Delivery Targets
id: DetermineDeliveryTargets
uses: microsoft/AL-Go/Actions/DetermineDeliveryTargets@0c7b1de38ba518aaf5fdee3902c2d2ae886ede32
uses: microsoft/AL-Go/Actions/DetermineDeliveryTargets@dc3e26be0e944a133933216cae88cf8f86263a28
env:
Secrets: '${{ steps.ReadSecrets.outputs.Secrets }}'
with:
Expand All @@ -142,7 +142,7 @@ jobs:

- name: Determine Deployment Environments
id: DetermineDeploymentEnvironments
uses: microsoft/AL-Go/Actions/DetermineDeploymentEnvironments@0c7b1de38ba518aaf5fdee3902c2d2ae886ede32
uses: microsoft/AL-Go/Actions/DetermineDeploymentEnvironments@dc3e26be0e944a133933216cae88cf8f86263a28
env:
GITHUB_TOKEN: ${{ github.token }}
with:
Expand All @@ -158,21 +158,21 @@ jobs:
uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2

- name: Read settings
uses: microsoft/AL-Go/Actions/ReadSettings@0c7b1de38ba518aaf5fdee3902c2d2ae886ede32
uses: microsoft/AL-Go/Actions/ReadSettings@dc3e26be0e944a133933216cae88cf8f86263a28
with:
shell: powershell
get: templateUrl

- name: Read secrets
id: ReadSecrets
uses: microsoft/AL-Go/Actions/ReadSecrets@0c7b1de38ba518aaf5fdee3902c2d2ae886ede32
uses: microsoft/AL-Go/Actions/ReadSecrets@dc3e26be0e944a133933216cae88cf8f86263a28
with:
shell: powershell
gitHubSecrets: ${{ toJson(secrets) }}
getSecrets: 'ghTokenWorkflow'

- name: Check for updates to AL-Go system files
uses: microsoft/AL-Go/Actions/CheckForUpdates@0c7b1de38ba518aaf5fdee3902c2d2ae886ede32
uses: microsoft/AL-Go/Actions/CheckForUpdates@dc3e26be0e944a133933216cae88cf8f86263a28
env:
GITHUB_TOKEN: ${{ github.token }}
with:
Expand Down Expand Up @@ -241,7 +241,7 @@ jobs:
uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2

- name: Download artifacts - ErrorLogs
uses: actions/download-artifact@37930b1c2abaa49bbe596cd826c3c89aef350131 # v7.0.0
uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8.0.1
if: (success() || failure())
with:
pattern: '*-*ErrorLogs-*'
Expand All @@ -251,7 +251,7 @@ jobs:
- name: Process AL Code Analysis Logs
id: ProcessALCodeAnalysisLogs
if: (success() || failure())
uses: microsoft/AL-Go/Actions/ProcessALCodeAnalysisLogs@0c7b1de38ba518aaf5fdee3902c2d2ae886ede32
uses: microsoft/AL-Go/Actions/ProcessALCodeAnalysisLogs@dc3e26be0e944a133933216cae88cf8f86263a28
with:
shell: powershell

Expand Down Expand Up @@ -280,18 +280,18 @@ jobs:
uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2

- name: Download artifacts
uses: actions/download-artifact@37930b1c2abaa49bbe596cd826c3c89aef350131 # v7.0.0
uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8.0.1
with:
path: '.artifacts'

- name: Read settings
uses: microsoft/AL-Go/Actions/ReadSettings@0c7b1de38ba518aaf5fdee3902c2d2ae886ede32
uses: microsoft/AL-Go/Actions/ReadSettings@dc3e26be0e944a133933216cae88cf8f86263a28
with:
shell: powershell

- name: Determine ArtifactUrl
id: determineArtifactUrl
uses: microsoft/AL-Go/Actions/DetermineArtifactUrl@0c7b1de38ba518aaf5fdee3902c2d2ae886ede32
uses: microsoft/AL-Go/Actions/DetermineArtifactUrl@dc3e26be0e944a133933216cae88cf8f86263a28
with:
shell: powershell

Expand All @@ -300,7 +300,7 @@ jobs:
uses: actions/configure-pages@983d7736d9b0ae728b81ab479565c72886d7745b # v5.0.0

- name: Build Reference Documentation
uses: microsoft/AL-Go/Actions/BuildReferenceDocumentation@0c7b1de38ba518aaf5fdee3902c2d2ae886ede32
uses: microsoft/AL-Go/Actions/BuildReferenceDocumentation@dc3e26be0e944a133933216cae88cf8f86263a28
with:
shell: powershell
artifacts: '.artifacts'
Expand Down Expand Up @@ -336,12 +336,12 @@ jobs:
uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2

- name: Download artifacts
uses: actions/download-artifact@37930b1c2abaa49bbe596cd826c3c89aef350131 # v7.0.0
uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8.0.1
with:
path: '.artifacts'

- name: Read settings
uses: microsoft/AL-Go/Actions/ReadSettings@0c7b1de38ba518aaf5fdee3902c2d2ae886ede32
uses: microsoft/AL-Go/Actions/ReadSettings@dc3e26be0e944a133933216cae88cf8f86263a28
with:
shell: ${{ matrix.shell }}
get: type,powerPlatformSolutionFolder
Expand All @@ -355,15 +355,15 @@ jobs:

- name: Read secrets
id: ReadSecrets
uses: microsoft/AL-Go/Actions/ReadSecrets@0c7b1de38ba518aaf5fdee3902c2d2ae886ede32
uses: microsoft/AL-Go/Actions/ReadSecrets@dc3e26be0e944a133933216cae88cf8f86263a28
with:
shell: ${{ matrix.shell }}
gitHubSecrets: ${{ toJson(secrets) }}
getSecrets: '${{ steps.envName.outputs.envName }}-AuthContext,${{ steps.envName.outputs.envName }}_AuthContext,AuthContext'

- name: Deploy to Business Central
id: Deploy
uses: microsoft/AL-Go/Actions/Deploy@0c7b1de38ba518aaf5fdee3902c2d2ae886ede32
uses: microsoft/AL-Go/Actions/Deploy@dc3e26be0e944a133933216cae88cf8f86263a28
env:
Secrets: '${{ steps.ReadSecrets.outputs.Secrets }}'
with:
Expand All @@ -375,7 +375,7 @@ jobs:

- name: Deploy to Power Platform
if: env.type == 'PTE' && env.powerPlatformSolutionFolder != ''
uses: microsoft/AL-Go/Actions/DeployPowerPlatform@0c7b1de38ba518aaf5fdee3902c2d2ae886ede32
uses: microsoft/AL-Go/Actions/DeployPowerPlatform@dc3e26be0e944a133933216cae88cf8f86263a28
env:
Secrets: '${{ steps.ReadSecrets.outputs.Secrets }}'
with:
Expand All @@ -398,25 +398,25 @@ jobs:
uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2

- name: Download artifacts
uses: actions/download-artifact@37930b1c2abaa49bbe596cd826c3c89aef350131 # v7.0.0
uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8.0.1
with:
path: '.artifacts'

- name: Read settings
uses: microsoft/AL-Go/Actions/ReadSettings@0c7b1de38ba518aaf5fdee3902c2d2ae886ede32
uses: microsoft/AL-Go/Actions/ReadSettings@dc3e26be0e944a133933216cae88cf8f86263a28
with:
shell: powershell

- name: Read secrets
id: ReadSecrets
uses: microsoft/AL-Go/Actions/ReadSecrets@0c7b1de38ba518aaf5fdee3902c2d2ae886ede32
uses: microsoft/AL-Go/Actions/ReadSecrets@dc3e26be0e944a133933216cae88cf8f86263a28
with:
shell: powershell
gitHubSecrets: ${{ toJson(secrets) }}
getSecrets: '${{ matrix.deliveryTarget }}Context'

- name: Deliver
uses: microsoft/AL-Go/Actions/Deliver@0c7b1de38ba518aaf5fdee3902c2d2ae886ede32
uses: microsoft/AL-Go/Actions/Deliver@dc3e26be0e944a133933216cae88cf8f86263a28
env:
Secrets: '${{ steps.ReadSecrets.outputs.Secrets }}'
with:
Expand All @@ -436,7 +436,7 @@ jobs:

- name: Finalize the workflow
id: PostProcess
uses: microsoft/AL-Go/Actions/WorkflowPostProcess@0c7b1de38ba518aaf5fdee3902c2d2ae886ede32
uses: microsoft/AL-Go/Actions/WorkflowPostProcess@dc3e26be0e944a133933216cae88cf8f86263a28
env:
GITHUB_TOKEN: ${{ github.token }}
with:
Expand Down
12 changes: 6 additions & 6 deletions .github/workflows/DeployReferenceDocumentation.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -30,24 +30,24 @@ jobs:

- name: Initialize the workflow
id: init
uses: microsoft/AL-Go/Actions/WorkflowInitialize@0c7b1de38ba518aaf5fdee3902c2d2ae886ede32
uses: microsoft/AL-Go/Actions/WorkflowInitialize@dc3e26be0e944a133933216cae88cf8f86263a28
with:
shell: powershell

- name: Read settings
uses: microsoft/AL-Go/Actions/ReadSettings@0c7b1de38ba518aaf5fdee3902c2d2ae886ede32
uses: microsoft/AL-Go/Actions/ReadSettings@dc3e26be0e944a133933216cae88cf8f86263a28
with:
shell: powershell

- name: Determine ArtifactUrl
id: determineArtifactUrl
uses: microsoft/AL-Go/Actions/DetermineArtifactUrl@0c7b1de38ba518aaf5fdee3902c2d2ae886ede32
uses: microsoft/AL-Go/Actions/DetermineArtifactUrl@dc3e26be0e944a133933216cae88cf8f86263a28
with:
shell: powershell

- name: Determine Deployment Environments
id: DetermineDeploymentEnvironments
uses: microsoft/AL-Go/Actions/DetermineDeploymentEnvironments@0c7b1de38ba518aaf5fdee3902c2d2ae886ede32
uses: microsoft/AL-Go/Actions/DetermineDeploymentEnvironments@dc3e26be0e944a133933216cae88cf8f86263a28
env:
GITHUB_TOKEN: ${{ github.token }}
with:
Expand All @@ -60,7 +60,7 @@ jobs:
uses: actions/configure-pages@983d7736d9b0ae728b81ab479565c72886d7745b # v5.0.0

- name: Build Reference Documentation
uses: microsoft/AL-Go/Actions/BuildReferenceDocumentation@0c7b1de38ba518aaf5fdee3902c2d2ae886ede32
uses: microsoft/AL-Go/Actions/BuildReferenceDocumentation@dc3e26be0e944a133933216cae88cf8f86263a28
with:
shell: powershell
artifacts: 'latest'
Expand All @@ -78,7 +78,7 @@ jobs:

- name: Finalize the workflow
if: always()
uses: microsoft/AL-Go/Actions/WorkflowPostProcess@0c7b1de38ba518aaf5fdee3902c2d2ae886ede32
uses: microsoft/AL-Go/Actions/WorkflowPostProcess@dc3e26be0e944a133933216cae88cf8f86263a28
env:
GITHUB_TOKEN: ${{ github.token }}
with:
Expand Down
Loading
Loading