Esercizio - Controllo del codice sorgente con Git
Questo esercizio usa la società demo Cronus, fornita nella versione statunitense di Business Central. Se si usa la società demo fornita del proprio Paese o area geografica, potrebbe essere necessario apportare alcune modifiche ai passaggi che seguono.
Scenario
Si lavora presso CRONUS International Ltd. come sviluppatore e si vuole creare una nuova estensione AL, aggiungerla al controllo della versione con Git e proteggere il codice in Azure Repos.
Attività
Creare una nuova estensione AL
Aggiungere il codice sorgente a un repository Git locale
Aggiungere Azure Repos come repository Git remoto
Eseguire il push del repository Git locale nel repository remoto
Passaggi
Avviare Visual Studio Code.
Selezionare Visualizza>Estensioni (CTRL+MAIUSC+X).
Digitare AL Language nella casella di ricerca Cerca estensioni nel Marketplace.
Fare clic sul pulsante Installa verde.
Creare un nuovo progetto di estensione AL. Selezionare Visualizza>Riquadro comandi... (CTRL+MAIUSC+P).
Immettere AL: Go! nella casella di ricerca e selezionare il comando dall'elenco.
Accettare il percorso suggerito (o immettere un altro percorso).
Selezionare la piattaforma di destinazione più recente.
Selezionare Microsoft cloud sandbox come endpoint di sviluppo.
Scaricare i simboli dell'applicazione selezionando Visualizza>Riquadro comandi... (CTRL+MAIUSC+P).
Digitare AL: Download symbols nella casella di ricerca e selezionare il comando nell'elenco.
Se richiesto, fornire le credenziali dell'organizzazione (account Microsoft 365 o account Microsoft Entra ID).
Aprire il file App.json e modificare l'impostazione name in Hello Business Central, quindi modificare l'impostazione publisher in Cronus International Ltd.
Installare Git (se non è installato) usando la pagina Installazione di Git.
In Visual Studio Code selezionare Visualizza>SCM (CTRL+MAIUSC+G) per aprire la visualizzazione Controllo del codice sorgente.
Selezionare il pulsante Inizializza repository per inizializzare un repository locale per l'estensione AL corrente.
I file vengono ora visualizzati con stato U (Untracked) alla fine, a indicare Non incluso nel controllo della versione. Fare clic con il pulsante destro del mouse sul primo file .app e selezionare Aggiungi a .gitignore. È possibile eseguire questo passaggio solo dalla visualizzazione Controllo del codice sorgente, non dalla visualizzazione Esplora
Ripetere questo processo per ogni file .app e per il file launch.json.
Selezionare tutti i file, fare clic con il pulsante destro del mouse e selezionare Prepara modifiche per commit oppure selezionare l'icona + accanto a Modifiche. Questa azione aggiunge i file all'area di gestione temporanea.
Aggiungere il messaggio Commit iniziale nella finestra di messaggio del commit, quindi selezionare il pulsante Commit (pulsante con il segno di spunta) oppure premere CTRL+INVIO
Aprire il Web browser preferito e aprire l'organizzazione Azure DevOps.
Selezionare il progetto Hello Business Central se è stato creato dalla dimostrazione video oppure creare un nuovo progetto se il progetto non è disponibile.
Selezionare Repos nel menu a sinistra. Si noterà che il repository è vuoto e che è possibile aggiungere codice al suo interno.
Copiare il collegamento https indicato nella sezione Clona nel computer.
Aprire Visual Studio Code e premere F1, quindi digitare Git: Add Remote... nella casella di ricerca.
Immettere un nome per il repository remoto: origin
Incollare l'URL copiato da Azure Repos nella casella URL remoto.
A seconda della configurazione, Visual Studio Code chiede di accedere a Azure DevOps con l'account Microsoft o l'account dell'organizzazione. Se l'operazione non riesce e Visual Studio Code continua a chiedere di accedere con un nome utente e una password, è possibile tornare ad Azure DevOps e fare clic sul pulsante Genera credenziali GIT sotto la casella di input in cui è stato copiato l'URL del repository. In questo modo, è possibile copiare un nome utente e una password, che possono essere usati per Git al posto dell'account standard.
Se il repository remoto è collegato in Visual Studio Code, è possibile fare clic sull'icona Pubblica in basso a sinistra della finestra di Visual Studio Code. Il pulsante è un'icona a forma di nuvola con una freccia rivolta verso l'alto. Si trova accanto al pulsante del ramo master.
Questi passaggi permettono di pubblicare il codice locale in Azure Repos.
Aprire Azure DevOps e aggiornare la pagina per visualizzare il codice.
Aprire Visual Studio Code, aprire il file HelloWorld.al e modificare Hello World in Hello Business Central nella funzione Messaggio. Salvare le modifiche (CTRL+S).
Aprire la visualizzazione Controllo del codice sorgente. Il file HelloWorld.al verrà visualizzato come file modificato. Selezionare il file e aggiungerlo all'area di staging.
Aggiungere un messaggio di commit e fare clic sul pulsante Commit.
Eseguire ora il push delle modifiche nel repository remoto. È possibile fare clic sui tre punti di sospensione ... per aprire un menu e selezionare push. In alternativa, è possibile fare clic sull'icona di sincronizzazione nella parte inferiore della finestra (stessa posizione dell'icona Pubblica). L'azione verrà sincronizzata. Verrà visualizzata una finestra che indica che l'azione esegue un pull e un push. È possibile confermare facendo clic su Sì.
Aprire Azure DevOps e aggiornare la pagina, quindi selezionare il file HelloWorld.al. Verranno visualizzate le modifiche apportate.