Microsoft.Dynamics.BusinessCentral.Development.Tools 18.0.43.1464

Overview

Welcome to the AL Development Tools package for Microsoft Dynamics 365 Business Central.

Note: To deploy code built using this package you must sign up for a Dynamics 365 Business Central Sandbox tenant.

Note: This package ships the AL .NET Tool and AL project templates. If you are looking for the dependency libraries to reference from another project, install the matching platform-specific dependency package instead:

• Microsoft.Dynamics.BusinessCentral.Development.Tools.Win
• Microsoft.Dynamics.BusinessCentral.Development.Tools.Linux
• Microsoft.Dynamics.BusinessCentral.Development.Tools.Osx

Getting Started

To get started with the AL Development Tools package, follow these steps:

1. Install the .NET Tool (see instructions below).
2. Install the AL Templates (see instructions below).
3. Explore the available tools and templates to create and customize your AL projects.

.NET Tool

This package contains the AL .NET Tool, which enables easy access to common AL Development Tools for pipelines and automates processes.

Read more about .NET tools here: https://learn.microsoft.com/dotnet/core/tools/global-tools

Installation

To install the AL .NET Tool, run the following command:

dotnet tool install Microsoft.Dynamics.BusinessCentral.Development.Tools --interactive --prerelease --global

--prerelease will give you the latest pre-release version of the tool

After installing the .NET Tool, you have access to the al command. To view the available tools, run:

al help

Available Tools

Examples of available tools

• GetPackageManifest: Get the manifest from an .app file.
• CreateSymbolPackage: Create a symbol-only package from an .app file.
• GetLatestSupportedRuntimeVersion: Get the latest supported AL runtime version for a platform version.

To get help on a specific tool, run:

al help

For example:

al help GetPackageManifest

Some tools also support the --help suffix:

al CreateSymbolPackage --help

Templates

This package contains the AL Templates.

Read more about installing dotnet templates here: https://learn.microsoft.com/dotnet/core/tools/dotnet-new-install

Installation

To install the templates, run the following command:

dotnet new install Microsoft.Dynamics.BusinessCentral.Development.Tools

After installing the templates, you can create a new project by calling:

dotnet new algo

Documentation

Read more about developing in AL in our documentation here: https://learn.microsoft.com/dynamics365/business-central/dev-itpro.

Support

If you encounter bugs with the package, ensure you have the latest version before reporting them through GitHub https://github.com/microsoft/al/issues.

License and Privacy

The package is made available under the Microsoft Dynamics 365 Business Central License Terms for your use with Microsoft Dynamics 365 Business Central or Microsoft Dynamics 365 Business Central On-Premises. Your use of Microsoft Dynamics 365 Business Central or Microsoft Dynamics 365 Business Central On-Premises is subject to the license/use rights provided to you by Microsoft, and the following Microsoft Enterprise and Developer Privacy Statement.