Dynamics 365 Business Central: changes in the default AL runtime version

The capabilities and features of AL supported by a Dynamics 365 Business Central extension are determined by the runtime version. The runtime version supported by an AL extension can be specified in the app.json file with the following keyword:

"runtime": "11.0".

The runtime version specified in the app.json file determines which Business Central runtime the AL project is targeting. An extension can be published to a server with the same or a later runtime version as the runtime version specified in the app.json file of the extension. This is particularly important for the on-premises version.

From version 11.5, the AL Language extension changes the default runtime version when it is not explicitly specified in the extension manifest (app.json) file. It changes from the latest supported by the compiler to the first runtime version of the current major.

This means that for Dynamics 365 Business Central 2023 release wave 1, since there is already released an AL compiler version with 11.1 as default runtime version, the default will exceptionally remain as 11.1 for a while.

However, when runtime 11.2 will be introduced, the default runtime version will not change and you will have to explicitly specify 11.2 if this runtime is required by your app.

Small change but it changes an old standard behavior and you should be aware of that.

Leave a comment

This site uses Akismet to reduce spam. Learn how your comment data is processed.