Esta página aún no se ha traducido para esta versión. Puede ver la versión más reciente de esta página en inglés.

Utilice el control de código fuente con proyectos

Puede usar proyectos para trabajar con archivos bajo control de código fuente. El control de código fuente almacena archivos en un repositorio, le permite comprobar los archivos fuera del repositorio para trabajar en él y volver a ellos para preservar los cambios, y le permite ver el historial de las diferentes versiones de los archivos que se han protegido. Para obtener más información sobre el uso del control de código fuente en productos de MathWorks, consulte.Acerca de la integración de Source controlMathWorks

Los proyectos se integran con dos sistemas de control de fuentes y (SVN).Git™Subversion®

Para configurar un proyecto con control de código fuente, utilice cualquiera de estos flujos de trabajo:

  • Cree un nuevo proyecto a partir de un repositorio existente.

  • Agregue un proyecto existente al control de código fuente.

  • Cree un nuevo proyecto en una carpeta que ya esté bajo control de código fuente.

A continuación, cuando el proyecto está bajo control de código fuente, puede realizar operaciones desde dentro, como comprobar los archivos de entrada y salida, ejecutar comprobaciones y confirmar y revertir los cambios.MATLAB®

Setup Source control

Hay tres maneras de configurar un proyecto con control de código fuente.

Crear nuevo proyecto a partir de repositorio existente

Cree una nueva copia local de un proyecto a partir de un repositorio existente recuperando archivos del control de código fuente. Puede clonar un repositorio, o desmarcar archivos de un repositorio SVN, o usar otra integración de control de código fuente.Git

Para crear un nuevo proyecto a partir de un repositorio existente:

  1. En la pestaña, haga clic enHome New > Project > From Git O New > Project > From SVN. Se abre el cuadro de diálogo Crear nuevo proyecto a partir de control de código fuente.

  2. Si conoce la ubicación del repositorio, péguelo en el campo.Repository Path

    De lo contrario, para buscar y validar la ruta del repositorio para recuperar archivos, haga clic en.Change

    1. En el cuadro de diálogo, especifique la dirección URL del repositorio introduciendo o pegando una dirección URL en el campo, seleccionando de la lista de repositorios recientes o haciendo clic en el botónRepositoryGenerate URL from folder.

    2. Haga clic para comprobar la ruta del repositorio.Validate Si la ruta de acceso no es válida, Compruebe la dirección URL en el explorador del repositorio de control de código fuente.

    3. Si ve un cuadro de diálogo de autenticación para su repositorio, introduzca la información de inicio de sesión para continuar.

    4. Si es necesario, seleccione una carpeta más profunda en el árbol del repositorio. Con SVN, es posible que desee desmarcar de o una carpeta de sucursal en.trunktags

    5. Cuando haya terminado de especificar la ruta de acceso URL que desea recuperar, haga clic en.OK El cuadro de diálogo se cierra y vuelve al cuadro de diálogo Crear nuevo proyecto desde el control de código fuente.

  3. En el campo, seleccione la carpeta de trabajo en la que desea colocar los archivos recuperados para el nuevo proyecto.Sandbox Con SVN, utilice una carpeta local para obtener mejores resultados, ya que el uso de una carpeta de red es lento.

  4. Haga clic.Retrieve

    Si el repositorio ya contiene un proyecto, el proyecto estará listo cuando la herramienta termine de recuperar archivos en la carpeta de Sandbox seleccionada.

    Si el entorno Sandbox aún no contiene un proyecto, un cuadro de diálogo le preguntará si desea crear un proyecto en la carpeta. Para crear un proyecto, especifique un nombre de proyecto y haga clic en.OK La pantalla de bienvenida aparece para ayudarle a configurar su nuevo proyecto. Para obtener más información sobre la configuración de un proyecto, consulte.Configure Project

Si encuentra errores como al clonar repositorios grandes, edite sus preferencias para aumentar el tamaño del montón.OutOfMemoryError: Java heap spaceGitMATLAB

  1. En la pestaña, en la sección, haga clic en.HomeAmbientePreferences

  2. Seleccione MATLAB > General > Java Heap Memory.

  3. Mueva el control deslizante para aumentar el tamaño del montón y, a continuación, haga clic en.OK

  4. Reiniciar.MATLAB

Agregar proyecto existente a control de código fuente

Si tiene un proyecto existente, puede agregarlo al control de código fuente SVN.Git

Para agregar un proyecto al control de código fuente:

  1. En la pestaña, en la sección, haga clic en.ProjectSource ControlUse Source Control Se abre el cuadro de diálogo información de control de código fuente.

  2. Haga clic en.Add project to source control button Se abre el cuadro de diálogo Agregar al control de código fuente.

  3. En la lista, seleccione la herramienta adecuada para su repositorio.Source control tool

  4. Si está utilizando un repositorio remoto, haga clic en el botón para seleccionar un repositorio existente o crear uno nuevo.Change

    • Para especificar un repositorio existente, haga clic en elGenerate URL from folderbotón para buscar el repositorio, pegue una dirección URL en el campo o utilice la lista para seleccionar un repositorio reciente.Repository

    • Para crear un nuevo repositorio, haga clic en elCreate a repositoryBotón. Para obtener más información sobre la creación de un nuevo repositorio, consulte.Crear nuevo repositorio

    Haga clic para comprobar la ruta de acceso al repositorio seleccionado y, a continuación, haga clic en.ValidateOK

  5. Haga clic para terminar de agregar el proyecto al control de código fuente.Convert

    El proyecto ejecuta comprobaciones de integridad.

  6. Después de ejecutar las comprobaciones de integridad, haga clic para volver al proyecto.Open Project

    El proyecto muestra los detalles de la herramienta de control de código fuente actual y la ubicación del repositorio.

  7. Si ha creado un nuevo repositorio, seleccione el Files > Modified vista y haga clic para confirmar la primera versión de los archivos en el nuevo repositorio.Commit En el cuadro de diálogo, escriba un comentario si lo desea y haga clic en.Submit

Si desea fusionar ramas con, debe seguir pasos de configuración adicionales.Git Para obtener más información, consulte.Configurar el control de código fuenteGit

Si desea utilizar una versión de SVN que no sea la versión incorporada, consulte.Configurar SVN Source control

Crear nuevo proyecto en la carpeta ya bajo control de código fuente

Si crea un nuevo proyecto a partir de una carpeta que ya está bajo control de código fuente, puede Agregar automáticamente el nuevo proyecto al control de código fuente.MATLAB Después de crear el proyecto, haga clic en el botón.Detect Para obtener más información sobre cómo crear un proyecto a partir de una carpeta, consulte.Crear proyectos

Realizar operaciones de control de código fuente

Recuperar versiones y desproteger archivos de proyecto

En esta tabla se muestra cómo comprobar los archivos de proyecto modificados, actualizar revisiones, obtener y administrar bloqueos de archivo y etiquetar archivos de proyecto.

AcciónProcedimiento
Actualizar el estado de los archivos de proyecto.

Para comprobar si hay archivos modificados localmente, en la pestaña, en la sección, haga clic en.ProjectSource controlRefresh Actualizar consulta el estado de Sandbox local y comprueba si hay cambios realizados con otra herramienta fuera de.MATLAB

Para obtener más información, consulte o.Actualizar estado del archivo SVN y revisiónActualizar estado del archivo y revisiónGit

Compruebe si hay modificaciones en los archivos de proyecto.

Para averiguar si hay una nueva versión del proyecto en el repositorio, en la vista, haga clic con el botón derecho en el archivo y seleccioneFiles Source control > Check for Modifications.

Con SVN, esta opción se pone en contacto con el repositorio para comprobar si hay modificaciones externas. El proyecto compara los números de revisión del archivo local y la versión del repositorio. Si el número de revisión en el repositorio es mayor que el de la carpeta de espacio aislado local, el proyecto se muestra junto al número de revisión del archivo local.(not latest)

Actualizar todos los archivos de proyecto.

Usando SVN, para obtener los últimos cambios de todos los archivos del proyecto, vaya a la pestaña, y en la sección, haga clic en.ProjectSource controlUpdate El proyecto muestra un cuadro de diálogo que enumera todos los archivos que han cambiado en el disco. Puede controlar este comportamiento mediante la preferencia del proyecto.Show changes on source control update Para obtener más información, consulte.Actualizar estado del archivo SVN y revisión

Mediante, para obtener los cambios más recientes para todos los archivos de proyecto de un repositorio de control de código fuente y combinarlos en la rama actual, vaya a la pestaña y, en la sección, haga clic en.GitProjectSource controlPull Para obtener cambios y combinarlos manualmente, en la pestaña, en la sección, haga clic en.ProjectSource controlFetch Esto actualiza todas las ramas de origen en el repositorio local. Al hacer clic, los archivos de Sandbox no se modifican.Fetch Para ver los cambios de otros, combine los cambios de origen en las ramas locales. Para obtener más información, consulte.Tire, empuje y recupere archivos conGit

Actualice la revisión de los archivos de proyecto seleccionados.

Para actualizar un conjunto de archivos seleccionado, en la vista, haga clic con el botón derecho en los archivos y seleccione elFiles Source control > Update comando para el sistema de control de código fuente que está utilizando. Por ejemplo, si está utilizando SVN, seleccione Source control > Update from SVN para obtener copias locales frescas de los archivos seleccionados del repositorio.

Obtener bloqueos de archivos SVN.

Para obtener bloqueos de archivo SVN, en la vista, seleccione los archivos que desea desmarcar.Files Haga clic con el botón derecho en los archivos seleccionados y seleccione Source control > Get File Lock. Aparece un símbolo de candado en la columna de control de origen de SVN. Otros usuarios no ven el símbolo de bloqueo en sus entornos sandbox, pero no pueden obtener un bloqueo de archivo o comprobar en un cambio cuando se tiene el bloqueo. Para ver o romper bloqueos, en la pestaña, haga clic en.ProjectLocks

es sólo para SVN. no tiene cerraduras.Get File LockGit

Gestione los bloqueos del repositorio SVN.

Para gestionar bloqueos SVN globales para un repositorio, en la pestaña, en la sección, haga clic en.ProjectSource controlLocks Para obtener más información, consulte.Obtener bloqueos de archivos SVN

Etiquetar versiones de archivos de proyecto.

Para identificar revisiones específicas de todos los archivos de proyecto, en la pestaña, en la sección, haga clic en.ProjectSource controlTag Especifique el texto de la etiqueta y haga clic.OK La etiqueta se agrega a cada archivo de proyecto. Los errores aparecen si no tiene una carpeta en el repositorio.tags Para obtener más información, consulte.Configurar SVN Source control

Revisar cambios en archivos de proyecto

Puede revisar los cambios en los archivos de proyecto mediante el Files > Modified Vista. Esta tabla muestra cómo ver la lista de archivos de proyecto modificados, revisar el historial de un archivo y comparar las revisiones de dos archivos.

AcciónProcedimiento
Ver archivos de proyecto modificados.

En la vista, seleccione elFiles Modified (number of files) pestaña. el Files > Modified vista solo está visible si usa el control de código fuente con el proyecto.

Sugerencia

Utilice el diseño para ver los archivos sin necesidad de expandir las carpetas.List

Puede identificar el contenido de la carpeta modificada o conflictada mediante el estado de resumen del control de código fuente. En la vista, las carpetas muestran el estado del control de origen desplegado.Files Esto facilita la localización de los cambios en los archivos, especialmente en los archivos conflictados. Puede pasar el cursor sobre el estado del control de código fuente de una carpeta (por ejemplo, la columna o) de una carpeta para ver una información sobre herramientas que muestra cuántos archivos dentro se modifican, conflicted, se agregan y se eliminan.GitSVN

Actualizar lista de archivos modificados.

Para actualizar la lista de archivos modificados, en la pestaña, en la sección, haga clic en.ProjectSource controlRefresh

Ver historial de revisiones.

En la vista, haga clic con el botón derecho en un archivo y seleccioneFiles Source control > Show Revisions.

Para examinar y comparar archivos dentro de los conjuntos de cambios SVN confirmados, en la pestaña, en la sección, seleccione.ProjectSource controlShow Log En el cuadro de diálogo revisiones de archivo, seleccione una revisión para ver una lista de archivos modificados. Haga clic con el botón derecho en los archivos de la lista inferior para ver los cambios o guardar las revisiones.

Compara las revisiones.

En la vista, haga clic con el botón derecho en un archivo y seleccioneFiles Compare > Compare to Ancestor para ejecutar una comparación con el repositorio local () o contra la última versión desprotegida en el espacio aislado (SVN).Git La herramienta de comparación muestra un informe.

Para comparar otras revisiones de un archivo, seleccione Compare > Compare to Revision.

Para ver un informe de comparación, seleccione las revisiones que desea comparar y haga clic en.Compare Selected O seleccione una revisión y haga clic en.Compare to Local Para obtener más información, consulte.Compare archivos y carpetas y combinar archivos

Archivos de definiciones de proyecto.  Los archivos de la carpeta son archivos de definición de proyecto generados por los cambios.resources/project Los archivos de definición de proyecto permiten agregar metadatos a los archivos sin deshacerlos, por ejemplo, mediante la creación de accesos directos, la adición de etiquetas y la adición de una descripción del proyecto. Los archivos de definición de proyecto también definen los archivos que se agregan al proyecto.

Los cambios que realice en el proyecto (por ejemplo, en accesos directos, etiquetas, categorías o archivos del proyecto) generarán cambios en la carpeta.resources/project Estos archivos almacenan la definición del proyecto en archivos XML cuyo formato está sujeto a cambios.

No es necesario ver los archivos de definición de proyecto directamente, excepto cuando la herramienta de control de código fuente requiere una combinación. Los archivos se muestran para que sepa acerca de todos los archivos que se confirman en el sistema de control de código fuente.

Si desea cambiar el archivo de definición de proyecto del tipo utilizado cuando se creó el proyecto, consulte.export

Ejecutar comprobaciones de proyecto

Para ejecutar comprobaciones de un proyecto, vaya a la pestaña y haga clic enProject Run Checks > Check Project. El proyecto comprueba si hay problemas con la integridad del proyecto, como archivos que faltan, archivos no guardados o archivos que no están bajo control de código fuente. Un cuadro de diálogo notifica los resultados. Puede hacer clic para obtener más información y seguir las indicaciones para solucionar problemas.

Si desea comprobar los archivos requeridos, haga clic para analizar las dependencias de los archivos modificados.Dependency Analysis Utilice las herramientas de dependencia para analizar la estructura del proyecto.

Para obtener más información sobre los problemas que pueden solucionar los cheques, consulte y.Trabajar con archivos derivados en proyectosAnalizar dependencias del proyecto

Confirmar archivos de proyecto modificados

Después de revisar los cambios y ejecutar las comprobaciones del proyecto, está listo para confirmar los archivos de proyecto modificados en el control de código fuente. Esta tabla muestra cómo confirmar los archivos de proyecto modificados.

AcciónProcedimiento
Confirme todos los archivos modificados en el control de código fuente.

En la vista, seleccione elFiles Modified (number of files) pestaña. En la pestaña, en la sección, haga clic en.ProjectSource controlCommit Escriba comentarios en el cuadro de diálogo y haga clic en.Submit Si usa el control de código fuente, se compromete a su repositorio local.Git Si está utilizando el control de código fuente de SVN, esto confirma los cambios en su repositorio.

Aparece un mensaje si no se puede confirmar porque el repositorio se ha movido por delante. Antes de que pueda confirmar el archivo, debe actualizar su revisión hasta la revisión HEAD actual. Si usa el control de código fuente, haga clic en.GitPull Si está utilizando el control de origen SVN, haga clic en.Update Resuelva cualquier conflicto antes de confirmar.

Confirme los archivos seleccionados en el control de código fuente.

En la vista, seleccione los archivos, haga clic con el botón derecho y seleccioneFiles Source control > Commit.

Si confirma archivos individuales, se arriesga a no comprometer los archivos de definición de proyecto relacionados que mantienen un registro de sus archivos. Para evitarlo, confirme todos los archivos modificados.

Inserte archivos de proyecto con.Git

Para enviar confirmaciones locales al repositorio remoto, en la pestaña, en la sección, haga clic en.ProjectSource controlPush Aparece un mensaje si no puede insertar los cambios directamente porque el repositorio se ha movido. Haga clic para recuperar todos los cambios del repositorio remoto.Fetch Combine ramas y resuelva conflictos y, a continuación, puede insertar los cambios. Para obtener más información, consulte.Tire, empuje y recupere archivos conGit

Inserte carpetas de proyecto vacías con.Git

No puede Agregar carpetas vacías al control de código fuente, por lo que no puede hacer clic y, a continuación, clonar una carpeta vacía.GitPush Puede crear una carpeta vacía en un proyecto, pero si empuja los cambios y, a continuación, sincroniza un nuevo entorno sandbox, la carpeta vacía no aparece en el nuevo entorno Sandbox. En su lugar, ejecute, lo que crea la carpeta vacía para usted.Check Project

Como alternativa, para insertar carpetas vacías en el repositorio para que otros usuarios se sincronicen, cree un archivo en la carpeta y, a continuación, inserte los cambios.gitignore

Cree los stashes.Git

almacena los cambios no confirmados para su uso posterior.Git Para crear un alijo, en la pestaña, en la sección, haga clic en.ProjectSource controlStashes Se abre el cuadro de diálogo Stashes. Haga clic para crear un escondite que contenga los archivos modificados actualmente.New Stash Para obtener más información, consulte.Use StashesGit

Crear una ramificación con.Git

Para crear una ramificación, en la pestaña, en la sección, haga clic en.ProjectSource controlBranches Aparece el cuadro de diálogo ramas, donde puede ver, cambiar, crear y fusionar ramas.

Seleccione un origen para la nueva rama. Haga clic en un nodo del diagrama de navegador de sucursales o escriba un identificador único en el cuadro de texto origen. Puede introducir una etiqueta, un nombre de sucursal o un prefijo único del hash SHA1 (por ejemplo,) para identificar una confirmación específica.73c637 Deje los valores predeterminados para crear una ramificación desde el cabezal de la rama actual. Escriba un nombre en el cuadro de texto y haga clic en.Branch nameCreate

Cambiar, comparar, guardar y fusionar ramas con.Git

Para cambiar, comparar, guardar y fusionar ramas, en la pestaña, en la sección, haga clic en.ProjectSource controlBranches Aparece el cuadro de diálogo ramas, donde puede ver, cambiar, crear y fusionar ramas. Para obtener más información, consulte.Ramificar y fusionar conGit

Resolver conflictos.

Si usted y otro usuario cambian el mismo archivo en diferentes entornos Sandbox o en diferentes ramas, aparece un mensaje de conflicto cuando intenta confirmar los archivos modificados. Extraiga los marcadores de conflicto si es necesario, compare las diferencias que causan el conflicto y resuelva el conflicto.

Busque archivos conflictados en el Files > Modified Vista. Identifique el contenido de las carpetas conflictivas utilizando el estado de resumen del control de código fuente. Las carpetas muestran el estado del control de código fuente desplegado. Esto facilita la localización de los cambios en los archivos, especialmente en los archivos conflictados. Puede pasar el cursor sobre el estado del control de origen de una carpeta para ver una información sobre herramientas que muestra cuántos archivos dentro se modifican, conflicted, se agregan y se eliminan.

Sugerencia

Utilice el diseño para ver los archivos sin necesidad de expandir las carpetas.List

Compruebe la columna de estado del control de origen (o) para los archivos con un símbolo de advertencia rojo, que indica un conflicto.GitSVN Haga clic con el botón derecho en el archivo confliccionado y seleccione Comparar versiones.View Conflicts Se abre un informe de comparación que muestra las diferencias entre los archivos conflictados.

Cuando haya resuelto los cambios y desee confirmar la versión en el entorno sandbox, haga clic con el botón derecho en el archivo y seleccione Source control > Mark Conflict Resolved.

Para, el estado del panel cambia a.GitBranchGitMERGINGSAFE

Seleccione el Files > Modified vista para comprobar los cambios.

Revertir los cambios

Esta tabla muestra cómo revertir los cambios en los archivos de proyecto. Para obtener más información sobre la reversión de cambios, consulte.Revertir cambios en el control de código fuente

AcciónProcedimiento
Revertir los cambios locales.

Para liberar bloqueos y revertir a la versión de la última actualización de Sandbox (es decir, la última versión sincronizada o recuperada del repositorio), en la vista, haga clic con el botón derecho en los archivos que desea revertir y seleccioneFiles Source control > Discard Local Changes and Release Locks.

Para descartar los cambios locales al usar, haga clic con el botón derecho en un archivo y seleccioneGit Source control > Revert Local Changes. Para eliminar todos los cambios locales, haga clic en el panel y haga clic en.BranchesGitRevert to Head

Revertir un archivo a una revisión especificada

Para revertir un archivo a una revisión especificada, haga clic con el botón derecho en un archivo y seleccione Source control > Revert using SVN O Source control > Revert using Git.

En el cuadro de diálogo revertir archivos, elija una revisión para volver a. Seleccione una revisión para ver información sobre el cambio, como el autor, la fecha y el mensaje de registro. Haga clic.Revert

Si revierte un archivo a una revisión anterior y, a continuación, realiza cambios, no podrá confirmar el archivo hasta que resuelva el conflicto con el historial del repositorio.

Revertir un proyecto a una revisión especificada.

Para revertir un proyecto a una revisión especificada, en la pestaña, en la sección, haga clic en.ProjectSource controlRevert Project En el cuadro de diálogo revertir archivos, elija una revisión para volver a.

Cada revisión de la lista es un conjunto de cambios de archivos modificados. Seleccione una revisión para ver información sobre el cambio, como el autor, la fecha y el mensaje de registro.

Una vez que haya elegido una revisión y esté convencido de que la información es correcta, haga clic en.Revert

Trabajar con archivos derivados en proyectos

En general, es una práctica recomendada omitir los archivos derivados y temporales del proyecto o excluirlos del control de código fuente. Use en el panel o la pestaña para comprobar si hay archivos derivados o temporales.Check ProjectPrecommit ActionsProject Si agrega la carpeta a un proyecto, las comprobaciones del proyecto le aconsejan quitar esto del proyecto y ofrecer para realizar la corrección.resources

También es una práctica recomendada excluir archivos derivados del control de código fuente, ya que pueden causar problemas. Esto incluye archivos, el contenido de la carpeta u otras carpetas de generación de código..mexresources Por ejemplo:

  • Con un sistema de control de código fuente que puede hacer el bloqueo de archivos, puede encontrar conflictos. Si está bajo control de código fuente y se genera código, la mayoría de los archivos en cambio y se bloquean.resourcesresources Otros usuarios no pueden generar código debido a errores de permisos de archivo. El bloqueo de binarios, como los archivos, puede tener un impacto en un equipo..mex

  • A menudo es necesario eliminar.resources Sin embargo, la eliminación provoca problemas como errores si la carpeta está bajo algunas herramientas de control de código fuente (por ejemplo, SVN).resourcesnot a working copy

  • Si desea comprobar el código generado como un artefacto del proceso, es común copiar algunos de los archivos fuera de la carpeta de caché y en una ubicación independiente que forma parte del proyecto.resources De este modo, puede eliminar la carpeta de caché temporal cuando lo necesite. Utilice la función para enumerar los archivos de código generados y utilice la API del proyecto para agregarlos al proyecto con los metadatos apropiados.packNGo

  • La carpeta puede contener muchos archivos pequeños.resources Esto puede afectar al rendimiento con algunas herramientas de control de código fuente cuando se comprueba cada uno de esos archivos para ver si está actualizado.

Buscar archivos de proyecto con cambios no guardados

Puede comprobar el proyecto en busca de archivos con cambios no guardados. En la pestaña, en la sección, haga clic en.ProjectToolsUnsaved Changes

En el cuadro de diálogo cambios sin guardar, puede ver todos los archivos de proyecto con cambios sin guardar. Si ha hecho referencia a proyectos, los archivos se agrupan por proyecto. Puede guardar o descartar todos los cambios.

Administrar archivos abiertos al cerrar un proyecto

Cuando cierra un proyecto, si hay archivos con cambios sin guardar, un mensaje le pedirá que guarde o descarte los cambios. Puede ver todos los archivos con cambios sin guardar, agrupados por proyecto, si ha hecho referencia a proyectos. Para evitar perder el trabajo, puede guardar o descartar los cambios por archivo, por proyecto o globalmente.

Para controlar este comportamiento, en la pestaña, en la sección, haga clic enHomeAmbiente.Preferences Vete a MATLAB > Project y en la sección, Active o desactive la casilla de verificación etiquetada.Project ShutdownCheck for open project models and close them, unless they are dirty

Temas relacionados