Ejercicio: Control de código origen con Git
Se ha escrito este ejercicio para usar la empresa de muestra Cronus de la versión estadounidense de Business Central. Es posible que deba realizar ajustes en los pasos si usa la empresa de muestra de su país o región.
Escenario
Trabaja como desarrollador para CRONUS International Ltd. Desea crear una nueva extensión AL, agregarla al control de versiones con Git y proteger el código en Azure Repos.
Tareas
Crear una nueva extensión AL
Agregar el código de origen a un repositorio Git local
Agregar Azure Repos como repositorio Git remoto
Enviar un repositorio Git local al repositorio remoto
Pasos
Inicie Visual Studio Code.
Seleccione Ver>Extensiones (Ctrl+Mayús+X).
Escriba Lenguaje AL en el cuadro de búsqueda Buscar extensiones en Marketplace.
Haga clic en el botón verde Instalar.
Cree un nuevo proyecto de extensión AL. Seleccione Ver>Paleta de comandos... (Ctrl+Mayús+P).
Escriba AL: Go! en el cuadro de búsqueda y seleccione el comando de la lista.
Acepte la ruta sugerida (o introduzca otra ruta).
Seleccione la plataforma de destino más reciente.
Seleccione Espacio aislado de nube de Microsoft como punto de conexión del desarrollo.
Seleccione Ver>Paleta de comandos... (Ctrl+Mayús+P) para descargar los símbolos de la aplicación.
Escriba AL: Descargar símbolos en el cuadro de búsqueda y seleccione el comando de la lista.
Si se le solicita, proporcione sus credenciales de la organización (cuenta de Microsoft 365/cuenta de Microsoft Entra ID).
Abra el archivo App.json y cambie el ajuste de nombre a Hello Business Central, así como el ajuste de editor a Cronus International Ltd.
Instale Git (si no está instalado) con la página Descargar Git.
En Visual Studio Code, seleccione Ver>SCM (Ctrl+Mayús+G) para abrir la vista Control de código de origen.
Haga clic en el botón Inicializar repositorio para inicializar un repositorio local para la extensión AL actual.
Los archivos ahora se muestran con un estado SS al final, lo que indica Sin seguimiento. Haga clic con el botón derecho en el primer archivo .app y seleccione agregar a .gitignore. Solo puede hacer esto en la vista Control de código de origen, no en la vista Explorador.
Repita este proceso para cada archivo .app y para el archivo launch.json.
Seleccione todos los archivos, haga clic con el botón derecho y seleccione Cambios de etapa, o haga clic en el icono + junto a Cambios. Al realizar esta acción, se agregarán los archivos al área de almacenamiento provisional.
Agregue el mensaje Confirmación inicial en el cuadro de mensaje de confirmación y haga clic en el botón de confirmación (el botón de marca de verificación), o pulse Ctrl+Entrar.
Abra su navegador web favorito y abra su organización de Azure DevOps.
Seleccione el proyecto Hello Business Central si lo creó a partir del vídeo de demostración, o cree un nuevo proyecto si ese proyecto no está disponible.
Haga clic en Repos en el menú de la izquierda. Verá que el repositorio está vacío y que le puede agregar código.
Copie el vínculo https que puede encontrar en la sección Clonar en el equipo.
Abra Visual Studio Code, pulse F1 y escriba Git: agregar conexión remota en el cuadro de búsqueda.
Introduzca un nombre de la conexión remota: origen.
Pegue la dirección URL que copió de Azure Repos en el cuadro Dirección URL remota.
En función de la configuración, Visual Studio Code le pedirá que inicie sesión en Azure DevOps con su cuenta de Microsoft o de su organización. Si esto no funciona, y Visual Studio Code todavía le pide que inicie sesión con un nombre de usuario y una contraseña, puede volver a Azure DevOps y hacer clic en el botón Generar credenciales de Git debajo del cuadro de entrada donde copió la dirección URL del repositorio. Esto le permite copiar un nombre de usuario y una contraseña que puede usar para Git en lugar de su cuenta estándar.
Si el repositorio remoto está vinculado correctamente en Visual Studio Code, puede hacer clic en el icono Publicar en la parte inferior izquierda de la ventana de Visual Studio Code. Este botón es un icono con forma de nube con una flecha hacia arriba. Lo encontrará junto al botón de rama maestra.
Estos pasos publicarán su código local en Azure Repos.
Abra Azure DevOps, actualice la página, y el código debería mostrarse.
Abra Visual Studio Code, abra el archivo HelloWorld.al y cambie Hello World en Hello Business Central en la función Message. Guarde las modificaciones que haya realizado (Ctrl+S).
Abra la vista Control de código de origen. El archivo HelloWorld.al debe mostrarse como cambiado. Seleccione el archivo y agréguelo al área de almacenamiento provisional.
Agregue un mensaje de confirmación y haga clic en el botón de confirmación.
Ahora envíe los cambios al repositorio remoto. Puede hacer clic en los tres puntos ... para abrir un menú y seleccionar push. O bien, puede hacer clic en el icono de sincronización en la parte inferior de la ventana (la misma ubicación en la que hizo clic en el icono de publicación). Esta acción se sincronizará. Por tanto, aparecerá una ventana que menciona que esta acción ejecutará los comandos pull y push. Haga clic en Sí para aceptar.
Abra Azure DevOps, actualice la página y luego seleccione el archivo HelloWorld.al. Deberían mostrarse las modificaciones.