Uso de control de versiones externo
De un vistazo
- Comprenda las diferencias básicas entre los flujos de trabajo de los repositorios Git y SVN.
- Descubra dónde consultar el estado de los archivos, acceder al historial de revisiones y realizar acciones de control de versiones en los paneles Projects y Storage Manager.
- Explore cómo las funciones de comparación de esquemáticos y PCB ayudan a los equipos que trabajan en diseños compartidos.
Una de las mayores ventajas de un entorno de creación y edición electrónica es la facilidad con la que se puede crear y modificar un archivo. Esta capacidad permite plasmar, explorar y desarrollar ideas rápidamente, pero también puede dificultar el seguimiento de los cambios realizados en archivos valiosos, como el código fuente y los datos de diseño electrónico.
La necesidad de llevar un seguimiento de los cambios realizados en un archivo, junto con la necesidad de disponer de una solución sistemática para gestionar los archivos fuente en formato electrónico, ha dado lugar a los sistemas de control de versiones (VCS). Los sistemas de control de versiones son herramientas de software que no solo permiten mantener un historial de las distintas versiones de un archivo, sino también abrir cualquier revisión de ese archivo y comparar los cambios realizados entre dos versiones cualesquiera. Por lo general, un VCS se integra con el sistema operativo (SO) local y proporciona funciones y operaciones adicionales de control de versiones para carpetas y archivos.
Los sistemas de control de versiones pueden funcionar de forma completamente independiente del entorno de creación y edición utilizado para crear un archivo. Normalmente, ofrecen una interfaz que permite añadir archivos y, a continuación, confirmar su incorporación a un área de almacenamiento central denominada repositorio; una función de extracción para copiar un archivo del repositorio a una carpeta de trabajo; una función de confirmación para devolver los cambios al repositorio; un método para registrar información sobre un cambio; y mucho más.
Estas funciones se encuentran en extensiones del shell de Windows, como el cliente Tortoise, y también están incluidas en el propio Altium Designer. Las operaciones de VCS se pueden realizar dentro del entorno de Altium Designer sin necesidad de acceder al sistema de archivos del SO.
Resulta útil comprender la terminología utilizada en los sistemas de control de versiones. Aunque hay numerosos sistemas disponibles, por lo general todos utilizan términos similares para describir sus funciones.
Conceptos básicos del control de versiones
Altium Designer admite los sistemas de control de versiones (VCS) Subversion (SVN) y Git. Gracias a su compatibilidad interna con estos sistemas, proporciona acceso a los comandos habituales de gestión de archivos de SVN/Git, como Confirmar, Actualizar, etc., desde Altium Designer, junto con funciones adicionales de Subversion, como la posibilidad de crear un repositorio SVN. Esto se integra con las funciones de comparación de esquemáticos y PCB, lo que facilita la comparación e identificación rápida de diferencias entre dos revisiones de un documento de esquemático o PCB y, en el caso de los diseños de PCB, la resolución de conflictos entre revisiones simultáneas.
El procedimiento básico para trabajar con un sistema de control de versiones (VCS) consiste en obtener del repositorio una copia de los archivos del proyecto en los que se desea trabajar, editarlos en Altium Designer y, a continuación, «confirmar» los archivos modificados para devolverlos al repositorio. La interacción con el repositorio se realiza a través de una interfaz del sistema de control de versiones, que Altium Designer incorpora en su panel Storage Manager y en el panel Projects.
La clave del funcionamiento de un sistema de control de versiones es que supervisa el estado de los archivos obtenidos del repositorio mediante una carpeta de trabajo y, por tanto, lleva un seguimiento de la revisión en la que se está trabajando y de si se ha modificado. Aunque el resultado es el mismo, la organización del repositorio y de los archivos de trabajo difiere entre los distintos tipos de sistemas de control de versiones: Git o SVN.
VCS Git
La siguiente figura ilustra el concepto de un repositorio Git remoto compartido que contiene una secuencia de revisiones de archivos de diseño (hasta la revisión 5), cuyo contenido se ha copiado a un repositorio Git de trabajo local, normalmente clonando el repositorio remoto o incorporando sus datos al repositorio de trabajo mediante una operación pull. Cuando los archivos del repositorio de trabajo se abren en el entorno de Altium Designer, este reconoce que un archivo de proyecto está bajo el control de versiones de Git y muestra su estado actual de control de versiones tanto en el panel Storage Manager como en el panel Projects.
► Consulte la página Control de versiones basado en Git para obtener más información.
VCS Subversion
La siguiente figura ilustra el concepto de un repositorio Subversion que contiene una secuencia de revisiones de archivos de diseño (hasta la revisión 5), con la copia más reciente extraída (File » Check Out) en una carpeta de trabajo. Cuando los archivos de la carpeta de trabajo se abren en el entorno de Altium Designer, este reconoce que un archivo de proyecto está bajo el control de versiones de SVN y muestra su estado actual de control de versiones tanto en el panel Storage Manager como en el panel Projects.
► Consulte la página Control de versiones basado en SVN para obtener más información.
En ambos sistemas VCS anteriores, el vínculo entre el repositorio de origen y la ubicación de trabajo se registra en la base de datos VCS de esta última (en la subcarpeta del sistema .svn o .git).
Cuando los archivos de trabajo del VCS están abiertos en Altium Designer, el menú contextual del panel Storage Manager (y del panel Projects) permite realizar acciones estándar de VCS, como confirmar un archivo modificado en el repositorio central (SVN) o en el repositorio de trabajo (Git).
Acceso al control de versiones
En Altium Designer, las acciones relacionadas con el VCS se pueden realizar a través de los paneles Projects y Storage Manager; este último proporciona acceso directo a comandos e información adicionales del VCS. Al abrir los documentos del proyecto en Altium Designer, los paneles muestran dichos documentos y su estado de VCS correspondiente.
Los paneles se pueden abrir desde el menú del botón
, situado en la parte inferior derecha del área de trabajo, o desde el menú principal View » Panels.
Panel Projects
El panel Projects muestra todos los proyectos abiertos actualmente en Altium Designer, junto con los documentos que los componen y el estado de control de versiones asociado a cada archivo.
El estado de los archivos en el VCS se indica en el panel mediante una serie de iconos que corresponden a condiciones específicas de los archivos detectadas por el sistema de control de versiones. En términos generales, el estado de cada archivo se determina con respecto a su equivalente bajo control de versiones en el repositorio vinculado. Se accede a los comandos del VCS del panel Projects desde la opción Version Control del menú contextual que aparece al hacer clic con el botón derecho en el panel.
Iconos de control de versiones tal como aparecen en el panel Projects
► Consulte la página Panel Projects para obtener más información.
Panel Storage Manager
El panel Storage Manager ofrece una vista detallada del documento activo desde la perspectiva del almacenamiento de archivos y proporciona acceso al historial local del documento y al estado y los comandos del control de versiones.
El estado de los archivos en el VCS se indica en el panel mediante una serie de descripciones e iconos correspondientes que reflejan condiciones específicas de los archivos detectadas por el sistema de control de versiones. En términos generales, el estado de cada archivo se determina con respecto a su equivalente bajo control de versiones en el repositorio vinculado.
Se accede a los comandos del VCS del panel Storage Manager desde el menú contextual que aparece al hacer clic con el botón derecho. Para realizar una acción del VCS en un archivo específico, haga clic con el botón derecho en su entrada del panel y seleccione el comando deseado; por ejemplo, Confirmar cambios, Actualizar, Resolver conflicto, etc.
El historial de revisiones del archivo seleccionado y el historial local del documento se pueden ver en la sección inferior del panel, o bien como una cronología general de eventos si cambia a la «vista clásica» – Switch to Classic View en las opciones del menú contextual. El número de revisión indicado se incrementará con cada confirmación de cambios en el VCS; la primera revisión (Revisión 1) corresponde a la creación de las carpetas del proyecto en el VCS, antes de añadir los archivos.
► Consulte la página Panel Storage Manager para obtener más información.
Estado del control de versiones
Tanto en el panel Projects como en el panel Storage Manager, el estado actual en el VCS de cada archivo bajo control de versiones se muestra junto a su entrada en el panel.
El sistema de control de versiones supervisa y compara los archivos de la carpeta de trabajo con sus equivalentes en el repositorio de diseño. Altium Designer solicita e intercambia información con el sistema de control de versiones a través de su interfaz VCS y responde en consecuencia a los estados resultantes de la comparación de archivos. En la práctica, esto se refleja en los iconos de archivo de los paneles Projects y Storage Manager, en diversas alertas del VCS y en los cambios pertinentes en los comandos de gestión de archivos disponibles.
Los iconos y su significado se describen en la sección Iconos de estado del control de versiones de la página Gestión de documentos del proyecto.
Acceso multiusuario
En la mayoría de los casos, la infraestructura de control de versiones de una empresa se basará en repositorios centrales SVN o Git, accesibles a través de la red mediante uno de los protocolos disponibles: svn, svn+ssh, https, etc. Esto proporciona acceso a todos los usuarios de la red, según sus permisos, y un medio para desarrollar proyectos de forma colaborativa a partir de una única fuente.
A su vez, las capacidades de acceso múltiple permiten a distintos miembros del equipo seguir trabajando en un proyecto de forma independiente, sin tener que esperar a que otra persona vuelva a registrar un archivo en el repositorio para poder trabajar en él. Un sistema distribuido de control de versiones Git lleva esta ventaja un paso más allá al permitir confirmar los cambios de los archivos en el repositorio de trabajo local mientras se trabaja y enviarlos posteriormente al repositorio central de Git en cualquier momento; por lo tanto, no requiere una conexión de red hasta entonces.
No obstante, un VCS apto para el trabajo en equipo requiere herramientas y técnicas que permitan resolver la situación inevitable en la que dos usuarios han modificado el mismo archivo. Cuando se dispone de estas capacidades, se sientan las bases para una verdadera colaboración multiusuario en el diseño y sus ventajas asociadas.
Para facilitar esta tarea, Altium Designer incluye funciones de comparación (o «diff») de esquemas y PCB, disponibles a través del panel Storage Manager.
Repositorios del VCS
La mejor manera de trabajar a partir de un conjunto conocido de archivos fuente es almacenar el proyecto de diseño en un entorno controlado, como un repositorio de control de versiones. Esto es importante porque la única forma de garantizar que los archivos de salida procedan de los archivos fuente correctos es:
- Confirmar que el conjunto de archivos fuente esté actualizado.
- Crear una instantánea de ellos.
- Generar los archivos de salida a partir de esa instantánea.
En Altium Designer, este tipo de repositorio se denomina Design Repository. El repositorio de diseño pertenece al equipo de diseño, contiene una vista detallada del historial del proceso de diseño y es la principal herramienta de colaboración que utiliza el equipo.
El repositorio de diseño se convierte en el repositorio central desde el que varios miembros del equipo pueden extraer y registrar datos, manteniendo en todo momento un historial completo de revisiones de todos los cambios realizados en el diseño. Por lo tanto, un diseño se almacena como una serie de versiones de los documentos de proyecto y fuente que lo componen, lo que permite construir una imagen progresiva de la intención del diseñador a lo largo del tiempo. Al utilizar un repositorio de diseño bajo control de versiones, se tiene la garantía de que nunca se perderá ninguna revisión del diseño, lo que permite colaborar de forma segura en el mismo diseño entre miembros de un equipo que pueden estar dispersos geográficamente. La propia naturaleza del sistema de control de versiones proporciona un registro de auditoría del diseño. La transparencia sobre quién cambió qué, en qué documento fuente y cuándo permite una trazabilidad completa de las responsabilidades. El sistema puede admitir varios repositorios de diseño bajo control de versiones, y la conexión con un repositorio específico se establece mediante el vínculo de control de versiones dentro de la carpeta del proyecto.
Antes de utilizar el control de versiones, tanto el VCS como Altium Designer deben reconocer los archivos del proyecto como archivos bajo control de versiones. Este proceso puede variar según los métodos y las aplicaciones de VCS, pero básicamente consiste en crear un repositorio de diseño o conectarse a uno y añadirle los archivos del proyecto de diseño.
Los repositorios de diseño se basan en una estructura de base de datos y almacenan internamente la información en una jerarquía de archivos y directorios denominada árbol de archivos. El repositorio al que se conecte puede ser un repositorio central SVN, un repositorio de trabajo Git (asociado a un repositorio Git remoto) o uno que haya creado en una ubicación accesible, como el PC local o una ubicación de red compartida.
Actualizar los nuevos cambios en el control de versiones
Cuando se añade un proyecto al control de versiones, su carpeta de trabajo local queda vinculada a su equivalente en el repositorio VCS, tal como indica el icono de enlace asociado a las entradas de la carpeta del proyecto en el panel Storage Manager. Para confirmar las ubicaciones de la carpeta y el repositorio vinculados, haga clic con el botón derecho en cualquier entrada de archivo del panel y seleccione la opción VCS Properties (no disponible al utilizar Git). El cuadro de diálogo Properties que aparece a continuación incluye las rutas de las ubicaciones vinculadas e información sobre la última revisión del VCS.
Archivo identificado mediante el icono de enlace y el panel Properties correspondiente, que contiene información sobre la última revisión del VCS
El cuadro de diálogo Properties proporciona la siguiente información (solo para consulta; no se permiten modificaciones):
- Path - la ruta del documento local en su carpeta de trabajo).
- URL - la URL de la ubicación del documento en el repositorio VCS.
- Repository Root - la raíz del repositorio.
- Repository UUID - el UUID del repositorio.
- Revision - la revisión actual del documento en su carpeta de trabajo local.
- Last Change Author - el autor del último cambio.
- Last Change Revision - la revisión del último cambio.
- Last Change Time - la fecha y la hora del último cambio.
- Conflicted - si el documento presenta conflictos o no.
Gracias al vínculo VCS registrado, el sistema de control de versiones puede supervisar y detectar cualquier diferencia entre los archivos de la carpeta local del proyecto y sus equivalentes en la carpeta del repositorio VCS. Cuando se detecta una diferencia, por ejemplo, cuando se edita y guarda un archivo de diseño en Altium Designer, el sistema de control de versiones cambia el estado del archivo local a Modified y Altium Designer ofrece un conjunto adecuado de comandos VCS en el menú contextual de los paneles.
Confirmar cambios
Después de editar y guardar un archivo de documento del proyecto en Altium Designer, este se marca como Modified y se indica como tal en los paneles Projects y Storage Manager. Para confirmar esos cambios como una nueva revisión en el VCS, haga clic con el botón derecho en la entrada del archivo en el panel y seleccione el comando Commit del menú contextual, o seleccione el comando Project » History & Version Control » Commit de los menús principales.
También se puede utilizar el comando Commit Whole Project, que confirma todos los archivos modificados del proyecto. Al confirmar todo el proyecto, se abre el cuadro de diálogo Commit to Version Control.

El cuadro de diálogo Commit to Version Control
Opciones y controles del cuadro de diálogo Confirmar en el control de versiones
Panel superior
El panel superior muestra todos los archivos del proyecto seleccionado e indica si están o no en el VCS. También se muestra información adicional relevante, como si un archivo está marcado para añadirse o eliminarse. El diseñador puede seleccionar los archivos que desea confirmar en el control de versiones. La columna Path muestra la ruta de cada archivo y la columna Status muestra su estado actual. Esta parte del cuadro de diálogo también incluye un pequeño menú contextual con las siguientes opciones:
- Select All - Haga clic para seleccionar todos los archivos que aparecen en el cuadro de diálogo. Los archivos seleccionados se añadirán al VCS.
- Select None - Haga clic para deseleccionar todos los archivos que aparecen en el cuadro de diálogo. Estos archivos no se añadirán al VCS.
- Select Project Documents - Haga clic para seleccionar únicamente los documentos del proyecto. Solo los archivos seleccionados se añadirán al VCS.
Panel inferior
- Comment - El diseñador puede escribir comentarios en este cuadro de texto antes de confirmar los archivos en el control de versiones.
- Commit and Push - Este comando se utiliza para registrar en el repositorio VCS las modificaciones realizadas en la copia de trabajo de los archivos seleccionados (en la región Archivos del panel Administrador de almacenamiento) y enviar las actualizaciones del proyecto al servidor. Los archivos modificados se distinguen por el estado Modified.
- Commit - Utilice el menú desplegable para acceder al botón Confirmar, que permite registrar en el repositorio VCS las modificaciones realizadas en la copia de trabajo de los archivos seleccionados (en la región Archivos del panel Storage Manager ). Los archivos modificados se distinguen por el estado Modified.
-
When using Subversion (SVN): El proceso de confirmación copia el archivo actualizado de la carpeta local al repositorio, incrementa el número de revisión de la entrada del VCS y restablece el estado del archivo a
No Modification -
When using Git: El proceso de confirmación actualiza el repositorio VCS de trabajo local, incrementa el número de revisión de la entrada y establece el estado del archivo en
Ahead of ServerPuede seguir editando, guardando y confirmando archivos en el repositorio de trabajo o ratificar los nuevos cambios mediante el comando Push para actualizar el repositorio Git remoto; el estado del archivo volverá entonces aNo Modification
Consulte el panel Storage Manager para ver la secuencia de acciones en la sección VCS Revisions, que incluirá la creación de una nueva revisión del VCS (con un número de revisión incrementado) para ese archivo; en este caso, la revisión 3 y el comentario añadido. El icono
indica la revisión más reciente y actual del archivo seleccionado o, en términos de control de versiones, la revisión Head.
La sección Revisiones de VCS del panel Storage Manager
Para ver de forma conjunta las entradas de revisiones y de eventos del historial, cambie a la vista única de línea de tiempo seleccionando Switch to Combined View en el menú contextual del botón derecho.
Obtener del control de versiones
Como se ha indicado anteriormente, un proyecto local que se haya añadido al control de versiones se puede editar en Altium Designer desde la carpeta local del proyecto y, a continuación, los cambios se actualizan en el repositorio VCS. La carpeta local y la carpeta del repositorio están vinculadas y, en última instancia, el VCS las sincroniza.
Otro usuario, que no tendrá acceso al proyecto desde su carpeta de origen (que es local en su PC), puede utilizar el proceso Clonar (Git) u Obtener (SVN) para obtener su propia copia de los archivos del repositorio VCS que aloja el proyecto. Todos los usuarios que deseen colaborar en el diseño del proyecto deberán conectarse a ese repositorio de diseño común, que normalmente se configura para que sea accesible a través de la red local o desde un servidor.
La carpeta del proyecto seleccionada en el repositorio y los archivos que contiene se descargarán en la carpeta local especificada y se abrirán en Altium Designer. Tenga en cuenta que la carpeta local es la definida como carpeta de trabajo para el repositorio seleccionado, y que el proyecto obtenido queda vinculado a su homólogo en el repositorio VCS. El vínculo de VCS indica al sistema de control de versiones que supervise y detecte cualquier diferencia entre los archivos de la carpeta de trabajo local y sus equivalentes en la carpeta del repositorio VCS.
Confirme los cambios cuando termine de editar los archivos; esto sincronizará los archivos del repositorio de diseño para que coincidan con los de la carpeta de trabajo y creará una nueva revisión de VCS.
Obtener frente a abrir un proyecto
Cuando un proyecto local se ha añadido al control de versiones, existen dos formas de editarlo y actualizarlo en VCS:
-
Abriendo el proyecto local (File » Open Project) en Altium Designer y, a continuación, confirmando los cambios guardados en el repositorio VCS. En este caso, el VCS vincula la carpeta local del proyecto y su homóloga en el repositorio.
-
Obteniendo el proyecto (File » Check Out) del repositorio VCS y, a continuación, confirmando en el repositorio los cambios guardados realizados en Altium Designer. En este caso, el VCS vincula el proyecto de la carpeta de trabajo designada y su homólogo en el repositorio.
El proyecto local es la fuente, o el origen, del proyecto de VCS que se comparte con otros usuarios. Según cómo desee trabajar, esta versión de origen local podría eliminarse o bloquearse como fuente archivada del proyecto, y después utilizar el método Check Out para realizar más modificaciones. También puede seguir abriendo y trabajando en los archivos del proyecto desde la carpeta local de «origen» (Open Project).
Lo más recomendable es utilizar siempre un mismo método (se recomienda obtener el proyecto), ya que las dos opciones utilizan una carpeta de trabajo en ubicaciones diferentes: la carpeta local del proyecto de origen o la carpeta de trabajo de VCS designada. Por el contrario, si se utilizan ambos métodos, habrá varias copias activas del mismo proyecto en el PC local. No obstante, si estas versiones se confirman sistemáticamente en el repositorio VCS centralizado después de cada modificación, el repositorio siempre contendrá la revisión más reciente del proyecto, tal como se pretende.
Tenga en cuenta también que, una vez que un proyecto se ha obtenido por primera vez del repositorio VCS, existe localmente y puede volver a abrirse directamente desde la carpeta de trabajo (File » Open Project). En este caso, vuelve a existir la opción de obtener un proyecto de VCS o abrir la versión local; sin embargo, solo hay una copia local. En términos prácticos de VCS, los dos métodos son muy similares, pero se comportarán de forma diferente en algunas circunstancias; por ejemplo, cuando falta un archivo local, el proceso de obtención lo restaurará, pero un comando Open Project lo eliminará del proyecto.
Revisiones del control de versiones
Al trabajar en Altium Designer con documentos de diseño que están bajo control de versiones, los archivos de diseño a los que se haya accedido desde el repositorio VCS central (compartido) corresponderán a la revisión más reciente de esos archivos. Cuando se hayan completado las modificaciones locales y se hayan confirmado (o enviado, en el caso de Git) en el repositorio VCS compartido, estas versiones de los archivos pasarán a ser las revisiones más recientes.
Por tanto, la secuencia habitual de obtener, editar, guardar y confirmar (y enviar, con Git) añade progresivamente nuevas revisiones de los archivos al VCS central a medida que se desarrolla el diseño del proyecto. Sin embargo, cuando varios diseñadores desarrollan un proyecto de forma colaborativa, cualquier diseñador puede confirmar nuevas revisiones en el repositorio central (compartido) en cualquier momento.
Revisión desactualizada
La interacción entre varios diseñadores y el repositorio central puede manifestarse de diversas formas; una de ellas es que un proyecto abierto localmente ya no sea la revisión más reciente: un proyecto obtenido del repositorio o abierto desde la carpeta de trabajo local tiene el estado Out of date en el panel Projects.
Archivo etiquetado como desactualizado
En este caso, otro usuario ha editado y confirmado el mismo proyecto en el repositorio desde la última vez que se editó localmente. Por ejemplo, un usuario local Barry está trabajando en el proyecto y ha confirmado, por ejemplo, Revision 14, pero otro usuario Harold ha confirmado Revision 15 después de ese momento, como se indica en el panel Storage Manager que se muestra a continuación. Dado que el VCS detecta la diferencia entre un archivo de la carpeta de trabajo local y su homólogo en el repositorio (que, en este caso, es más reciente), el sistema considera que la revisión más reciente de local (indicada por el icono está desactualizada.
Diferentes estados de revisión en Storage Manager
Esta situación se corrige actualizando los archivos locales para que coincidan con los del repositorio VCS central mediante el comando Update del menú contextual del botón derecho del panel Projects o Storage Manager. Las dos versiones del archivo quedan entonces sincronizadas y la versión local (del usuario Barry) se actualiza a la revisión más reciente; en este ejemplo, Revision 15. Tenga en cuenta que, si realiza la acción Save en un archivo marcado como Out of date, se generará una situación de Conflict en VCS, en la que el VCS detecta que se ha actualizado una revisión anterior de un archivo en la carpeta de trabajo.
El repositorio central y la revisión local en Storage Manager
También puede seleccionar el comando Update Whole Project para acceder al cuadro de diálogo Update from Version Control , que permite seleccionar los archivos que se obtendrán de un repositorio compartido. En el cuadro de diálogo se muestran todos los documentos del proyecto que están desactualizados o contienen conflictos. Puede seleccionar documentos específicos para actualizarlos o elegir actualizarlos todos a la vez. Los documentos seleccionados se actualizan desde el repositorio y todos los documentos desactualizados se seleccionan de forma predeterminada. Todos los documentos seleccionados se actualizarán a la versión más reciente del repositorio.

El cuadro de diálogo Update from Version Control
La columna Path muestra el directorio del archivo. La Status columna muestra el estado actual del archivo. Si el estado de un archivo se muestra como Conflict, al hacer clic en OK para actualizar los archivos se abrirá un cuadro de diálogo de confirmación. Haga clic en OK para actualizar a la última versión del repositorio o en Cancel para salir y guardar los cambios en la versión que se encuentra actualmente en el repositorio.
Conflicto de revisiones
La interacción entre varios diseñadores y el repositorio central también puede dar lugar a una situación en la que dos usuarios de Altium Designer hayan editado y guardado localmente el mismo archivo y uno de ellos haya confirmado esos cambios.
Esto significa que la secuencia de pasos de un diseñador (extraer, editar, guardar, confirmar) se ha intercalado con la de otro, por lo que un archivo que un usuario ha extraído del repositorio para editarlo puede no remain como la última revisión mientras se trabaja en él: otro usuario ha actualizado la revisión durante ese tiempo. En este caso, quien confirme primero las modificaciones en el repositorio tendrá prioridad al crear una nueva revisión, mientras que el otro usuario que haya editado y guardado el mismo archivo se encontrará en una situación de Conflict, indicada por el icono
.
Ejemplo de conflicto de revisiones
Desde la perspectiva de un VCS, que compara los archivos de la carpeta de trabajo con los del repositorio, un conflicto representa la situación en la que se ha editado y guardado una revisión desactualizada de un archivo en la carpeta de trabajo.
Revisiones del VCS Git en el panel Storage Manager
Hay varias opciones de comando, accesibles desde el menú contextual History & Version Control del panel Projects, el menú principal Project » History & Version Control y el panel Storage Manager, que pueden utilizarse cuando un archivo tiene el estado Conflict:
-
Commit – esta opción provocará un error de Subversion, ya que confirmar la revisión editada localmente (por ejemplo,
Revision 15) sobrescribiría la revisión más reciente (Revision 16) que ya ha confirmado otro usuario. -
Update – esta opción actualizará la revisión del archivo local a la última versión del repositorio central (
Revision 16), con lo que se perderán todos los cambios locales que haya realizado enRevision 15. -
Resolve Conflict – esta opción descartará los cambios confirmados en el repositorio desde la última actualización. Tras ejecutar el comando, aparecerá un cuadro de diálogo de confirmación; haga clic en Yes para continuar. El archivo de proyecto de su carpeta de trabajo se actualizará a la última revisión incorporada al repositorio por el otro usuario, pero el editor conservará los cambios que usted haya realizado en la revisión anterior. Por lo tanto, el archivo local adquirirá el estado Modified, lo que le permitirá confirmar esos cambios en una nueva revisión del repositorio mediante el comando Commit o el comando Commit Whole Project. Una vez que haya confirmado el archivo de proyecto, el otro usuario verá los archivos con el estado Out of date, ya que usted habrá creado una revisión más reciente en el repositorio.
Esta opción solo se recomienda cuando hay un conflicto en un archivo text, ya que el sistema Subversion intentará fusionar las diferencias en el archivo local. Ese proceso podría dañar otros tipos de archivo, como los documentos de diseño, por lo que la mejor forma de resolver un conflicto es actualizar a la última revisión del repositorio o revertir los cambios locales.
-
Revert – Esta opción eliminará (deshará) los cambios locales y devolverá el archivo local a su revisión base; en este caso,
Revision 15. De este modo se resuelve el conflicto de revisiones, pero el archivo se marcará comoOut of date, ya que existe una revisión más reciente (Revision 16) en el repositorio.
Comparar revisiones
Una función muy útil al trabajar con el control de versiones es la posibilidad de comparar revisiones anteriores de los archivos de diseño. Esta función la ofrece el comparador de diferencias integrado de Altium Designer, al que se accede desde el panel Administrador de almacenamiento. Cuando se utiliza junto con el panel Diferencias, se puede realizar una comparación lógica o gráfica entre revisiones del VCS y, al mismo tiempo, explorar de forma interactiva los objetos afectados. Se pueden comparar revisiones tanto de esquemas como de PCB.
► Consulte la página Panel Diferencias para obtener más información sobre cómo navegar por las diferencias.
Para iniciar una comparación entre dos revisiones, seleccione ambas entradas (mediante el método estándar Ctrl+click) en la lista VCS Revisions del panel Storage Manager y, a continuación, seleccione el comando Compare en el menú contextual del panel.
El comando Compare en el panel Storage Manager
Ambas revisiones del archivo se abrirán en modo de pantalla dividida, donde podrán compararse visualmente. Las diferencias que se muestran dependen de las opciones seleccionadas para los tipos de comparación física en la pestaña Comparador del cuadro de diálogo Options for Project – Project » Project Options.
La clave para localizar y visualizar las diferencias de la comparación está en el panel Differences, que proporciona una lista seleccionable de las diferencias lógicas o gráficas entre los documentos. Las entradas del panel correspondientes a cada revisión del documento interactúan con el editor, lo que permite resaltar gráficamente una diferencia detectada (como un objeto desplazado) al seleccionarla.
Las diferencias de la comparación se localizan y visualizan en el panel Differences
La función de comparación también se aplica a las revisiones de documentos PCB, así como a las revisiones de esquemas y documentos de texto.
- Para los documentos de esquemas o PCB (de diseño o de biblioteca), se realiza una comparación gráfica y las diferencias detectadas se enumeran en el panel Differences. Con las dos versiones del documento abiertas una junto a otra en la ventana del editor de diseño, puede examinar las diferencias gráficamente. Al hacer clic en una carpeta de nivel superior correspondiente a una diferencia detectada, esta se resaltará en ambos documentos simultáneamente.
- Para los documentos ASCII de texto, el CompareForm aparecerá el cuadro de diálogo, que muestra una comparación gráfica de las dos versiones del documento. Los documentos seleccionados se muestran uno al lado del otro. El cuadro de diálogo solo permite realizar comparaciones: no se puede modificar ningún documento cargado. Mediante un código de colores, el cuadro de diálogo resalta las distintas diferencias entre las dos versiones del documento: líneas añadidas (rosa), líneas modificadas (verde) y líneas eliminadas (azul). En la parte inferior izquierda del cuadro de diálogo se presenta un resumen de los cambios y una leyenda del código de colores.
El comando Compare se puede aplicar a cualquier par de revisiones, incluso a la revisión local actual (en la carpeta de trabajo) y a una revisión más reciente del repositorio. En esta situación, la revisión local más reciente se indica en el panel Storage Manager como Out of date , pero aun así se puede comparar con una revisión más reciente que otro usuario haya añadido al repositorio.
La revisión local se indica en el panel Storage Manager como Desactualizada
Este método permite obtener una vista previa gráfica de los cambios que se aplicarán al actualizar a la nueva revisión. En la imagen de ejemplo anterior, la revisión local actual (indicada por el icono es Revision 19, pero otro usuario ha confirmado una nueva revisión en el repositorio (Revision 22). Al iniciar una comparación visual entre Revision 19 y Revision 22, puede tomar una decisión informada sobre si aceptar los nuevos cambios del repositorio y, por consiguiente, si aplicar el comando Update o rechazar los cambios provocando un conflicto, para lo cual debevolver a guardar el archivo local y resolver el conflicto a favor de su versión local.
Terminología del control de versiones
| Término | Significado |
|---|---|
| Base | La revisión del repositorio que ha extraído para utilizarla como su Working Copy local. También se denomina revisión extraída. |
Check-in |
Guardar la copia de trabajo del archivo en el repositorio. Se denomina Commit en Altium Designer. |
Check-out |
Obtener una copia de un archivo del repositorio del sistema de control de versiones (VCS) en una carpeta de trabajo. Generalmente se trata de la revisión más reciente del archivo, aunque también se puede extraer cualquier revisión anterior. Según el VCS, el archivo puede marcarse simplemente como extraído o como extraído en exclusiva (bloqueado). |
Clone |
Un comando de Git que copia (clona) un repositorio Git remoto en un repositorio Git de trabajo ubicado en una carpeta local, al tiempo que extrae automáticamente la versión HEAD (la más reciente) en dicha carpeta. El repositorio local incluye la referencia al repositorio remoto ( |
Commit |
Guardar la copia de trabajo del archivo en el repositorio. Se denomina Check-in en algunos sistemas de control de versiones. En el software de diseño de Altium, el comando habitual Save guarda un archivo editado en la carpeta de trabajo, mientras que Commit guarda ese archivo de la carpeta en el repositorio como una nueva revisión (versión). |
Conflict |
La situación que se produce cuando dos usuarios de Altium Designer intentan confirmar cambios que afectan a la misma región del mismo archivo. Estos conflictos deben resolverse, ya sea mediante una herramienta de fusión, manualmente o determinando qué versión prevalecerá (se convertirá en la nueva revisión). |
Database |
El almacenamiento principal de todos los archivos sujetos al control de versiones (o de código fuente), también conocido en la práctica como Repository . |
Git |
Git es un sistema de control de versiones de código abierto. Altium Designer incorpora funciones de Git (a través de la extensión VCS Provider - Git), lo que permite realizar un seguimiento de las revisiones y acceder a ellas directamente desde sus paneles Administrador de almacenamiento y Proyectos. |
Head |
La revisión más reciente confirmada en el sistema de control de versiones. |
Log message |
Un comentario sobre los cambios realizados en una revisión cuando esta se vuelve a registrar (confirmar) en el repositorio. Los mensajes de registro se pueden utilizar como resumen de la evolución de los cambios de un archivo. |
Project |
Muchos sistemas de control de versiones admiten el concepto de proyecto. Un proyecto de VCS es un conjunto de archivos relacionados que se pueden registrar o extraer como conjunto. El VCS también puede admitir otras funciones propias de los proyectos, como establecer un número de versión para todos los archivos de un proyecto. Este concepto es distinto del de proyecto de Altium Designer, que se puede añadir al control de versiones mediante el comando Añadir carpeta del proyecto al control de versiones. |
Push |
Actualizar un repositorio Git remoto con los archivos de su repositorio de trabajo local para sincronizar los repositorios local y remoto. Este comando está disponible cuando un archivo del repositorio Git local es más reciente que su equivalente en el repositorio Git remoto. Conceptualmente, es la operación complementaria del comando Pull de Git. |
Repository |
El almacenamiento principal de todos los archivos sujetos al control de versiones (o de código fuente); también puede denominarse Database. |
Revision |
Un cambio confirmado en el historial de un archivo o conjunto de archivos. Es la referencia alfanumérica que proporciona el VCS para realizar un seguimiento de las distintas ediciones (versiones) que almacena del archivo. |
Sandbox |
La carpeta en la que se extraen los archivos del repositorio para poder trabajar en ellos; también se denomina Working Folder. Los archivos extraídos desde el software de diseño de Altium se cargan automáticamente. |
| SVN | Subversion es un sistema de control de versiones de código abierto. Altium Designer incorpora funciones de SVN (a través de la extensión VCS Provider - SVN), lo que permite realizar un seguimiento de las revisiones y acceder a ellas directamente desde sus paneles Administrador de almacenamiento y Proyectos. |
Update |
La acción de comprobar si hay cambios en la versión de un archivo del repositorio e incorporarlos a una copia de trabajo (la operación complementaria de Commit o Check-in). El proceso de fusión de las diferencias requiere una herramienta de fusión o una actualización manual. |
VCS |
Sistema de control de versiones: término genérico que se aplica a cualquier herramienta capaz de gestionar el historial de versiones de los archivos y su recuperación. |
Version |
El término versión se utiliza normalmente para referirse al número de referencia externo que una persona asigna a los archivos controlados o a su resultado (como en el caso del código fuente). La mayoría de las veces se considera una revisión. |
Working Copy |
La copia «local» de un archivo en la que se realizan los cambios; normalmente se encuentra en Working Folder. |
Working Folder |
La carpeta en la que se extraen los archivos del repositorio para poder trabajar en ellos; en Git, se trata de un repositorio de trabajo local. Los archivos extraídos desde Altium Designer se cargan automáticamente. |
Referencias
- Sitio web de SVN: http://subversion.apache.org/
- Manual en línea de SVN: http://svnbook.red-bean.com/
- Página principal del proyecto SharpSVN: https://sharpsvn.open.collab.net
- Sitio web de Git: https://git-scm.com/
- Documentación en línea de Git: https://git-scm.com/doc
- Los clientes Tortoise: http://tortoisesvn.net y https://tortoisegit.org/
- Guía práctica de control de código fuente, de Eric Sink: http://www.ericsink.com/scm/source_control.html


