Exercício – Controle do código-fonte com Git
Este exercício foi criado para usar a empresa de exemplo Cronus da versão norte-americana do Business Central. Talvez você precise fazer ajustes nas etapas se usar a empresa de exemplo de seu país/região.
Cenário
Você é um desenvolvedor que trabalha na CRONUS International Ltd. Você deseja criar uma nova extensão de AL, adicioná-la ao controle de versão com o Git e proteger o código no Azure Repos.
Tarefas
Criar uma nova Extensão AL
Adicionar o código-fonte a um repositório local do Git
Adicionar o Azure Repos como repositório remoto do Git
Enviar por push o repositório local do Git para o repositório remoto
Etapas
Inicie o Visual Studio Code.
Selecione Exibir>Extensões (Ctrl + Shift + X).
Digite Linguagem de AL na caixa de seleção Pesquisar Extensões no Marketplace.
Clique no botão verde Instalar.
Crie um novo projeto da Extensão AL. Selecione Exibir>Paleta de Comandos... (Ctrl + Shift + P).
Digite AL: Go!na caixa de pesquisa e selecione o comando na lista.
Aceite o caminho sugerido (ou você pode inserir outro caminho).
Selecione a plataforma de destino mais recente.
Selecione Área restrita da nuvem da Microsoft como o ponto de extremidade de desenvolvimento.
Baixe os símbolos do aplicativo selecionando Exibir>Paleta de Comandos... (Ctrl + Shift + P).
Digite AL: Download symbols na caixa de pesquisa e selecione o comando na lista.
Se solicitado, forneça suas credenciais organizacionais (conta do Microsoft 365/conta do Microsoft Entra ID).
Abra o arquivo App.json e altere a configuração nome para Hello Business Central, altere a configuração do editor para Cronus International Ltd.
Instale o Git (se não estiver instalado) usando a página Instalar o Git.
No Visual Studio Code, selecione Exibir>SCM (Ctrl + Shift + G) para abrir o modo de exibição "Controle de Origem".
Selecione o botão Inicializar Repositório para inicializar um repositório local para a Extensão AL atual.
Os arquivos agora são exibidos com um status U no final, informando que não foram rastreados. Clique com o botão direito do mouse no primeiro arquivo .app e selecione "Adicionar" a .gitignore. Você só pode executar essa etapa no modo de exibição Controle de Origem, não no modo de exibição Explorer
Repita este processo para cada arquivo .app e para o arquivo launch.json.
Selecione todos os arquivos, clique com o botão direito do mouse e escolha Alterações Preparadas ou selecione o ícone + ao lado de Alterações. Essa ação adiciona os arquivos à área de preparação.
Adicione a mensagem Confirmação Inicial na caixa de mensagem de confirmação e selecione o botão "Confirmar" (o botão de marca de seleção) ou pressione Ctrl + Enter
Abra seu navegador da Web favorito e sua organização do Azure DevOps.
Selecione o projeto Hello Business Central se ele foi criado com base na demonstração de vídeo ou crie um novo projeto, se esse projeto não estiver disponível.
Selecione Repos no menu à esquerda. Você verá que o repositório está vazio e que você pode adicionar o código ao repositório.
Copie o link https encontrado na seção Clonar para o computador.
Abra o Visual Studio Code, pressione F1 e digite Git: Adicionar Remoto... na caixa de pesquisa.
Insira um nome remoto: origem
Cole a URL copiada do Azure Repos na caixa URL remota.
Dependendo da sua configuração, o Visual Studio Code solicitará que você entre na sua conta do Azure DevOps com sua conta Microsoft/organizacional. Se isso não funcionar, e o Visual Studio Code ainda solicitar que você faça logon com um nome de usuário e uma senha, você pode voltar ao Azure DevOps e clicar no botão Gerar Credenciais do Git na caixa de entrada na qual você copiou a URL do repositório. Isso permite que você copie um nome de usuário e uma senha que podem ser usados para o Git em vez da conta padrão.
Se o repositório remoto for vinculado com êxito no Visual Studio Code, você poderá clicar no ícone Publicação na parte inferior esquerda da janela do Visual Studio Code. Esse botão é um ícone nuvem com uma seta para cima. Ele será encontrado ao lado do botão branch mestre.
Essas etapas publicarão seu código local no Azure Repos.
Abra o Azure DevOps, atualize a página e seu código deverá estar visível.
Abra o Visual Studio Code, abra o arquivo HelloWorld.al e altere Hello World no Hello Business Central na função "Mensagem". Salve as modificações (Ctrl + S).
Abra o modo de exibição "Controle de Origem". O arquivo HelloWorld.al deve estar visível como alterado. Selecione o arquivo e adicione-o à área de preparação.
Adicione uma mensagem de confirmação e clique no botão "Confirmar".
Agora, enviar por push suas alterações para o repositório remoto. Você pode clicar nos três pontos ... para abrir um menu e selecionar enviar por push. Você também pode clicar no ícone sincronização na parte inferior da janela (mesmo local onde você clicou no ícone publicação). Essa ação será sincronizada. Portanto, uma janela ficará visível, mencionando que essa ação executará uma recepção e um push. Você pode concordar clicando em Sim.
Abra o Azure DevOps, atualize a página e selecione o arquivo HelloWorld.al. As modificações devem estar visíveis.