Skip to main content

BUSINESS CENTRAL APP ON-PREM + GIT HUB - step by step guide

        
GitHub Logo
Salut ✊🏽🖐🏽!

INTRODUCTION

With the introduction of AL + Visual Studio Code, Business Central users
can now make use of the variety of source code management tools available
in the new developer tool. This is a game changer as it simplifies the
process of change tracking of your customizations unlike previously when
you had track any changes through meticulous code commenting in C/SIDE.
In this blog I shall provide a step by step guide on how to setup source
code management for your on-premises Business Central extension development.
So let's begin:

STEP 1 : Install VS Code and Configure Git

Open your visual studio code IDE (Download and install from here) and locate
the Source Control button in the Action Bar (Ctrl+Shift+G).
If you haven't installed and configured Git then you will see the screen below:
VSCode Without GIT Installed


Click on Install git. This will navigate to the GitHub download page where you will
down load the executable file and run in in your windows machine. After installing git,
open the git bash located in C:\Program Files\Git and enter the two commands shown below:
(Replace the user email and user name with you actual credentials)
Git Email Configuration


Now when you open VS Code and click on the Source Control button in the Action Bar
(Ctrl+Shift+G) the VS Code window will look below:

STEP 2 : Clone Remote Repository

The easiest way to link to GitHub is to clone an already existing repo into a
local folder structure. Once you click on the "clone repository" button, VS Code
asks you to select the folder where your local copy shall be cloned to and then
you are taken to the GitHub login screen.
After you have entered your credentials, VS Code then asks for your repo URL Link
which can be gotten from your GitHub account. Once you enter the URL Link the folders
and files will be downloaded and a local copy of your GitHub Repository will be created
for you in the folder you selected earlier.

STEP 3 : AL GO!

At this point, we create our AL Project files and folder using VS Code AL GO snippet.

Comments