Configurar el control de versiones de Git

R2026b
Reemplaza a Configurar el control de versiones de Git (R2024b).

Puede utilizar el control de versiones de Git™ en MATLAB® para gestionar sus archivos y colaborar con otros. Al utilizar Git, puede registrar los cambios en sus archivos y recuperar versiones específicas más tarde. Para obtener más información, consulte Realizar un seguimiento del trabajo localmente con Git en MATLAB y Colaborar usando Git en MATLAB.

Antes de utilizar Git, siga estos pasos para configurarlo para MATLAB:

A partir de la versión R2024a, puede ejecutar Git Hooks desde dentro de MATLAB. Los Git Hooks compatibles son pre-commit, commit-msg, post-commit, prepare-commit-msg, pre-push, pre-merge-commit, post-checkout y post-merge. Para ver un ejemplo, consulte Use Git Hooks in MATLAB.

Registrar archivos binarios con Git

Si utiliza herramientas de control de versiones externas, debe registrar sus extensiones de archivo de MATLAB y Simulink® como .mlx, .mat, .fig, .mlapp, .mdl, .slx, .mdlp, .slxp, .sldd y .p como formatos binarios. Registre también extensiones para archivos MEX, como .mexa64, .mexmaci64, .mexmaca64 y .mexw64. Si no registra las extensiones, estas herramientas pueden dañar los archivos al enviarlos, cambiando los caracteres de final de línea, expandiendo los tokens, sustituyendo las palabras clave o intentando fusionar automáticamente. El daño se puede producir si utiliza herramientas de control de versiones que no sean de MATLAB o si intenta enviar archivos desde MATLAB sin registrar primero los formatos de archivo.

Registre también otras extensiones de archivo, como .xlsx, .jpg, .pdf y .docx, como formatos binarios para evitar que se dañen durante la operación de envío.

Para registrar las extensiones de sus archivos binarios con Git, añádalos al archivo .gitattributes de su repositorio. Si crea un nuevo proyecto que utilice el control de versiones de Git o cambia un proyecto existente de otro sistema de control de versiones al control de versiones de Git, MATLAB crea automáticamente un archivo .gitattributes y lo rellena con una lista de archivos binarios comunes que se registrarán.

Si no se crea automáticamente un archivo .gitattributes, puede crear uno que contenga la lista de archivos binarios comunes que se registrarán. En la ventana de comandos de MATLAB, escriba lo siguiente:

copyfile(fullfile(matlabroot,'toolbox','shared','cmlink','git','auxiliary_files', ...
'mwgitattributes'),fullfile(pwd,'.gitattributes'))

De forma alternativa, cree un archivo .gitattributes en blanco en su repositorio y rellene su contenido.

  1. Añada * text=auto a la parte superior del archivo .gitattributes.

  2. Para cada extensión de archivo binario ext, agregue *.ext binary. Por ejemplo, *.mlapp binary.

Habilitar compatibilidad para rutas largas

Habilite la compatibilidad con rutas largas en un sistema Windows siguiendo estos pasos.

  1. En la pestaña Home, en la sección Environment, haga clic en Settings. Seleccione MATLAB > Source Control > Git.

  2. En la sección Windows, seleccione Enable support for long paths. Al hacerlo, se establece el valor de core.longpaths en true en su archivo de configuración global de Git.

Para obtener más información, consulte Configure Git Settings.

Habilitar la firma de confirmaciones

Ajuste la configuración de su control de versiones para permitir que MATLAB firme confirmaciones de Git automáticamente siguiendo estos pasos. Cuando MATLAB verifica una firma de confirmación, aparece un icono de verificación verde junto a su avatar y nombre de usuario tanto en Branch Manager como en las anotaciones de línea en el editor de MATLAB.

  1. En la pestaña Home, en la sección Environment, haga clic en Settings. Seleccione MATLAB > Source Control > Git.

  2. En la sección Commit Signing, establezca la clave de firma, el formato de la clave de firma y el programa de firma. Para obtener más información, consulte Configure Git Settings.

Configurar MATLAB para utilizar la autenticación de SSH de Git

Para evitar las frecuentes peticiones de inicio de sesión cuando interactúe con su repositorio remoto usando HTTPS, agregue una nueva clave pública y clone el repositorio usando SSH en su lugar. Configure MATLAB para utilizar la autenticación de SSH siguiendo estos pasos.

  1. Genere una clave SSH utilizando el comando ssh-keygen. Por ejemplo, en una línea de comandos, introduzca este comando:

    ssh-keygen -t ed25519 -C "your_email@example.com"
    ssh-keygen le solicita que confirme dónde guardar la clave y le pide una contraseña. Si no desea escribir una contraseña al usar la clave, deje la contraseña vacía.

    Si ya tiene claves en la carpeta especificada, ssh-keygen pregunta si desea sobrescribirlas.

  2. Configure el uso de claves de SSH en MATLAB. En la pestaña Home, en la sección Environment, haga clic en Settings. Seleccione MATLAB > Source Control > Git. Después, ajuste la configuración.

    1. En la sección SSH, seleccione, si no lo está, Enable SSH.

      De manera predeterminada, MATLAB busca claves en un agente de SSH. En Windows, utilice OpenSSH como agente de SSH. Para obtener más información, consulte Autenticación basada en claves en OpenSSH para Windows.

      Utilizar un agente de SSH permite almacenar y usar varias claves.

    2. Si no está utilizando un agente de SSH para almacenar sus claves, puede introducirlas manualmente. Desmarque la casilla Use SSH agent. Después, especifique la ruta de sus archivos de claves públicas y privadas en Public key file y Private key file. Para obtener más información, consulte Configure Git Settings.

      Para habilitar el uso de una contraseña y recibir una solicitud una vez por sesión, seleccione Key is pass-phrase protected.

  3. Configure su cuenta de GitHub® o GitLab® para utilizar las claves de SSH. Para hacerlo, vaya a la carpeta .ssh y copie el contenido del archivo .pub. Después, vaya a la configuración de su cuenta y, en la sección SSH keys, pegue el contenido del archivo .pub en el campo Add SSH key.

Administrar las credenciales de Git

De manera predeterminada, MATLAB recuerda sus nombres de usuario y tokens cuando interactúa con repositorios de Git. Para cambiar las opciones de credenciales predeterminadas, en la pestaña Home, en la sección Environment, haga clic en Settings. Seleccione MATLAB > Source Control > Git. En la sección Credentials, seleccione una de las opciones disponibles. Para obtener más información, consulte Configure Git Settings.

Como alternativa, también puede instalar un asistente de credenciales de Git externo y configurar MATLAB para que lo utilice en su lugar. El asistente de credenciales recomendado para todas las plataformas es Git Credential Manager Core. Para obtener más información, consulte Configurar MATLAB para que utilice el asistente de credenciales de Git en Configuración adicional.

Para eliminar la información de inicio de sesión guardada en un repositorio Git escriba lo siguiente en MATLAB:

matlab.git.clearCredential("https://github.com/myrepo.git")

Configurar Git para utilizar Git LFS

Si está trabajando con archivos grandes, configure Git para utilizar Git Large File Storage (LFS) instalando un Git de línea de comandos y configurando LFS.

Por ejemplo, para utilizar Git LFS en un sistema Windows, descargue y ejecute el instalador de Git para Windows utilizando las instrucciones descritas en Instalar cliente de Git de línea de comandos en Configuración adicional. En la sección Select Components del instalador de Git para Windows, seleccione Git LFS (Large File Support) y los archivos .sh correspondientes que se van a ejecutar con las opciones Bash.

Configuración adicional

  • Para utilizar Git LFS o un asistente de credenciales, debe instalar un cliente de Git de línea de comandos y ponerlo a disposición de todo el sistema.

    Para comprobar si Git está instalado, introduzca el comando !git en la ventana de comandos de MATLAB. Si el comando no devuelve una salida, tendrá que instalar un cliente Git de línea de comandos. Esta tabla proporciona instrucciones para instalar un cliente Git de línea de comandos según su sistema operativo.

    Sistema operativoInstrucciones
    Windows

    1. Descargue y ejecute el instalador en https://gitforwindows.org/.

    2. En la sección Select Components, asegúrese de seleccionar Git LFS y Associate .sh file to be run with Bash.

      • Al seleccionar Git LFS, podrá utilizar Git LFS en Windows.

      • Al seleccionar Associate .sh file to be run with Bash, podrá utilizar Git Hooks en Windows. Para ver un ejemplo sobre cómo usar Git Hooks, consulte Use Git Hooks in MATLAB.

      • De manera predeterminada, la instalación de línea de comandos de Git incluye Git Bash, que proporciona funcionalidades de comandos. Al configurar MATLAB para fusionar automáticamente modelos de Simulink, Git Bash permite ejecutar mlAutoMerge.bat en Windows. Consulte Automatically Merge Models Locally and in CI Pipeline (Simulink)

    3. En la sección Adjusting your PATH environment, elija la opción de instalación Git from the command line and also from 3rd-party software. Esta opción agrega Git a su variable PATH y hace que esté disponible en todo el sistema para que MATLAB se pueda comunicar con Git.

    4. En la sección para configurar las conversiones de nueva línea, elija la opción Checkout Windows-style, commit Unix-style line endings. El formato de nueva línea no se aplica entre máquinas y usuarios, pero puede admitir nuevas líneas consistentes para archivos de texto en el archivo .gitattributes de cada repositorio.

    5. Reinicie el sistema para que los cambios tengan efecto.

    Linux®

    Git está disponible para la mayoría de distribuciones. Instale Git para su distribución. Por ejemplo, en Debian®, instale Git introduciendo este comando:

    sudo apt-get install git
    macOSEn Mavericks (10.9) o superior, ejecute Git desde la ventana Terminal. Si todavía no tiene Git instalado, le pedirá que instale las herramientas de línea de comandos Xcode. Para obtener más información, consulte https://git-scm.com/doc.

  • MATLAB recuerda los nombres de usuario y tokens cuando interactúa con repositorios de Git. Puede utilizar un asistente de credenciales externo de Git en su lugar para almacenar sus credenciales de Git. Credential Manager Core de Git es el asistente de credenciales recomendado para todas las plataformas.

    Para instalar Git Credential Manager Core en un sistema Windows y configurar MATLAB para que lo utilice para almacenar credenciales de Git, siga estos pasos:

    1. Descargue y ejecute el instalador de Git para Windows siguiendo las instrucciones que se describen en la sección anterior.

    2. En la sección Choose a credential helper del instalador, seleccione Git Credential Manager Core como asistente de credenciales. Esto define el valor de credential.helper en el archivo .gitconfig global.

      También puede establecer el valor de credential.helper en el archivo .gitconfig global de forma manual.

Consulte también

Funciones

Temas