Agregar y quitar archivos en Git
Después de inicializar su repositorio local de Git, puede comenzar a trabajar en su extensión de AL. Cada archivo que cree debe agregarse a su repositorio. Para hacer eso, necesita ejecutar algunos comandos. Veamos diferentes comandos para agregar o eliminar en el repositorio y confirmar los cambios en el directorio de Git.
Agregar archivos
Para agregar uno o varios archivos modificados o sin seguimiento a Git, puede usar el comando add. Esto agregará los archivos modificados del directorio de trabajo al área de almacenamiento provisional. Con el comando add, especifica el nombre del archivo para agregar. Se puede utilizar un asterisco para indicar todos los archivos.
git add <filename>
git add *
Dentro de Visual Studio Code, puede agregar un archivo haciendo clic en el signo + junto a un nombre de archivo en la ventana de control de código fuente (Ctrl+Mayús+G). Al realizar esta acción, se colocarán los archivos en el área de almacenamiento provisional. Para agregar todos los archivos modificados, puede hacer clic en el signo + en la sección de cambios.
El resultado de agregar archivos al área de almacenamiento provisional es visible en la sección de cambios almacenados provisionalmente de Visual Studio Code. En la siguiente captura de pantalla, los archivos app.json, BodyType.al y .gitignore están almacenados provisionalmente. También se les ha asignado el código de estado A, lo que indica que se han agregado.
Quitar un archivo almacenado provisionalmente
Si agregó un archivo al área de almacenamiento provisional pero no debería incluirse, puede anular el almacenamiento provisional de ese archivo. Para ello, debe utilizar el comando reset.
git reset HEAD <filename>
Esto volverá a colocar el archivo en el directorio de trabajo y lo eliminará del área de almacenamiento provisional. Si hace esto en archivos agregados recientemente, el archivo no se rastreará nuevamente.
En Visual Studio Code, puede utilizar el signo - para anular el almacenamiento provisional o ejecutar reset.
Confirmar los archivos almacenados provisionalmente en el directorio de Git
Una vez que sus archivos estén en el área de almacenamiento provisional, puede usar el comando commit para almacenarlos en el directorio de Git. Cada confirmación tomará todos los archivos del área de almacenamiento provisional, los agregará al directorio de Git e incluirá su nombre de usuario y correo electrónico en la confirmación.
git commit
Una confirmación siempre necesita un mensaje de confirmación. Si usa el comando anterior, el editor predeterminado se abrirá y le permitirá introducir un mensaje de confirmación. También puede usar la opción -m.
git commit -m "Your message comes here"
En Visual Studio Code, tiene una GUI para introducir el mensaje de confirmación. Hay dos lugares donde puede introducir ese mensaje. Puede introducirlo en el panel SCM justo encima de la sección de cambios almacenados provisionalmente.
Si no proporciona un mensaje al hacer clic en el botón para confirmar, Visual Studio Code también le pedirá que introduzca un mensaje.
La confirmación real se realiza mediante el icono de la marca de verificación o los comandos commit de la lista de comandos de Git. Puede abrir la lista de comandos haciendo clic en los tres puntos.
Los cambios para confirmar archivos almacenados provisionalmente solo son para los archivos del área de almacenamiento provisional. El icono de la marca de verificación es un método abreviado del comando para confirmar archivos almacenados provisionalmente. Normalmente, cada confirmación crea una nueva entrada de confirmación en Git. Cada confirmación genera una cadena de confirmación única que identifica de forma única esa confirmación.
Por ejemplo:
521747298a3790fde1710f3aa2d03b55020575aa
Si selecciona la opción Enmendar, sus cambios se agregarán a la última confirmación, en lugar de crear una confirmación nueva. Esto es útil si olvidó algunos archivos.
git commit --amend
Si no se agregan archivos al área de almacenamiento provisional, pero hace clic en el botón de confirmación, Visual Studio Code mostrará un mensaje que indica que no hay archivos en el área de almacenamiento provisional, pero también le preguntará si, en su lugar, desea confirmar los archivos que están en el directorio de trabajo. Por lo tanto, pasará por alto el área de almacenamiento provisional. También puede hacer esto usando la opción -a en el comando commit.
git commit -a -m "Your message comes here"
Una vez que ejecute el comando commit, haga clic en el nombre de la rama (en este ejemplo, la maestra) para ver una opción para crear una nueva rama. Sin embargo, también le mostrará el id. de confirmación que está usando la rama.
Se recomienda agregar con frecuencia los archivos modificados al área de almacenamiento provisional y, si están listos y son estables, puede enviarlos a su directorio de Git. No espere hasta el final del día; en su lugar, realice sus modificaciones con la mayor frecuencia posible.
Quitar un archivo del repositorio
Si elimina un archivo del directorio de trabajo con el Explorador de Windows o en Visual Studio Code, su archivo seguirá siendo parte del repositorio de Git. Use el comando rm para indicar el repositorio de Git del que desea eliminar el archivo del proyecto. Esta acción se almacenará en su área de almacenamiento provisional, junto con los archivos que modificó o agregó. Cuando realiza una confirmación, la eliminación del archivo se completa en el repositorio de Git.
git rm <filename>
La eliminación se detectará automáticamente en el directorio de trabajo y se hará visible en Visual Studio Code. Este archivo obtendrá un código de estado D, lo que indica que este archivo se elimina del disco. Organice este cambio para ejecutar el comando rm y use el comando commit para eliminarlo por completo del directorio de Git.
Tal vez no desee eliminar su archivo del disco, pero quiera eliminarlo de Git. Para ello, puede usar rm --cached.
git rm --cached <filename>
Esta acción eliminará el archivo del área de almacenamiento provisional y ejecutará una eliminación en el repositorio de Git, pero el archivo seguirá estando en el disco. El archivo dejará de seguirse nuevamente.
Deshacer los cambios
Si realizó algunas modificaciones en un archivo y desea recuperar la versión anterior, puede usar el comando checkout. Así obtendrá la versión confirmada del directorio de Git y colocará esta versión en el directorio de trabajo.
git checkout <filename>