Creating Runtime Packages for Business Central On-Premises
If you want to distribute extensions, you can generate runtime packages that do not contain AL code, but only the final artifacts used by the server at runtime. Runtime packages thereby allow you to protect the intellectual property represented by your AL source code.
When the runtime package is generated on the server, the developer license is checked for permissions to the used extension IDs. The extension in a runtime package can then be installed on servers that do not have a developer license; the server only needs permissions to run the objects, but not to modify or insert them.
Start using runtime packages
The first step in using runtime packages is to have an extension developed and published to an on-premise instance. Next, use the following PowerShell command to connect to the server, find the extension, and download the runtime package.
For more information about this cmdlet, see Get-NAVAppRuntimePackage cmdlet.
The following example gets the NAV App runtime package with the provided name and version.
Get-NAVAppRuntimePackage -ServerInstance DynamicsNAV -AppName 'Proseware SmartApp' -Version 126.96.36.1990 -Path 'Prosware SmartApp_188.8.131.520_runtime.app'
The limitation of runtime packages is that they only work for on-premise installations and therefore cannot be submitted to AppSource. For more information about the extension requirements for AppSource, see Technical Validation Checklist. Moreover, debugging into an extension to view the source code is not allowed by default; the
ShowMyCode flag is by default set to
Runtime packages are guaranteed to work only if published to a platform with the same version as the one where they were produced.
If you set the
ShowMyCode flag to
true when running the
Get-NavAppRuntimePackage cmdlet, you can enable debugging and you thereby also allow viewing the source code.