Control de versiones basado en Git

Los repositorios de tipo Git se crean fuera de Altium Designer, y al contenido de un repositorio Git local de trabajo se accede abriendo archivos desde su carpeta anfitriona. La gestión tanto de los repositorios Git remotos como de los repositorios Git locales de trabajo suele realizarse mediante sistemas de la empresa y herramientas Git externas, mientras que las operaciones a nivel de archivo (Commit, Push, Update, etc.) se gestionan en el entorno de edición de Altium Designer.

Agregar al control de versiones Git

Como sistema de control de versiones distribuido, Git usa un flujo de trabajo diferente al de SVN, aunque la diferencia es mínima cuando se trabaja con archivos de proyecto ya establecidos en Altium Designer. En resumen, Git aplica la transferencia de datos entre múltiples repositorios, en lugar de centrarse en la dependencia de un único repositorio de destino.

► Consulte el sitio web de Git para obtener más información y Version Control Essentials para una descripción general de los principios aplicables.

Un sistema Git VCS suele basarse en un servidor Git remoto centralizado que puede alojar múltiples repositorios Git según sea necesario. La naturaleza rápida y ligera de Git favorece la práctica de crear un repositorio remoto para cada proyecto, que luego puede clonarse (copiarse) como repositorio de trabajo para cualquier usuario que trabaje en el proyecto. Después, los archivos actualizados en el repositorio Git de trabajo de un usuario se “envían” al repositorio remoto en el servidor Git para lograr la sincronización.

El método utilizado para establecer un proyecto de Altium Designer en un sistema Git dependerá de la infraestructura y las prácticas de la empresa, e implicará herramientas y procesos externos a Altium Designer. Sin embargo, una vez que un proyecto está en el sistema de control de versiones y disponible como repositorio local de trabajo, trabajar con un Git VCS en Altium Designer es prácticamente igual que trabajar con un SVN VCS.

Agregar un proyecto a Git

A modo de ejemplo, un proyecto existente de Altium Designer puede añadirse a un repositorio Git local utilizando las herramientas básicas de línea de comandos de Git. Con este enfoque, la carpeta del proyecto se convierte en el repositorio Git local (de trabajo), y este se vincula y finalmente se actualiza con un repositorio Git remoto disponible.

Aquí, las herramientas se usan para:

1. Crear (initialize) el repositorio Git de trabajo en la carpeta del proyecto.
2. Agregar los archivos del proyecto al control de versiones Git. La especificación de archivo *.* agrega archivos, pero no carpetas.
3. Especificar la referencia de vínculo al repositorio Git remoto compartido en un servidor web. PCrepo es un alias local asignado a la URL del repositorio remoto.

Proyecto agregado a un repositorio Git local

Cuando el proyecto se abre en Altium Designer, el estado de sus archivos en los paneles Projects y Storage Manager es Scheduled for Addition (). Cuando luego se confirman en el repositorio de trabajo, los archivos cambian al estado Ahead of Server (), ya que aún no están bajo control de versiones en el repositorio Git remoto.

Archivos programados como Scheduled for Addition y Ahead of Server

El comando Push actualizará los archivos del repositorio local en el servidor Git remoto, que puede solicitar credenciales válidas para el repositorio de destino; es un proceso que se realiza una sola vez.

Los archivos se actualizan tras la solicitud de credenciales válidas

El proyecto de Altium Designer, que ahora ya está completamente bajo control de versiones Git, queda disponible para otros usuarios desde el repositorio Git remoto. Otro usuario puede, por ejemplo, clonar el repositorio en su máquina local y, finalmente, enviar sus archivos editados de vuelta al repositorio remoto dentro de un flujo de trabajo colaborativo.

Clonar un repositorio Git

Un proyecto local que se ha añadido al control de versiones Git puede ser editado por Altium Designer desde la carpeta local del proyecto (el repositorio de trabajo), y los cambios confirmados se actualizan después en el repositorio Git remoto. El repositorio local y el repositorio remoto están vinculados y, en última instancia, sincronizados mediante un comando de PushVCS.

Otros usuarios que deseen colaborar en el diseño pueden acceder al proyecto clonando el repositorio Git remoto en un repositorio local de trabajo. Aunque la forma de acceder a los archivos desde un repositorio Git remoto variará según los sistemas y métodos de la empresa, una manera básica de clonar el contenido de un repositorio remoto en un repositorio local de trabajo es usando el comando Git; git clone [remote repository URL] [target working repository folder], como se muestra en la siguiente imagen.

Cambios confirmados actualizados en el repositorio Git remoto

El proceso replicará el repositorio remoto compartido como un repositorio local de trabajo y extraerá automáticamente la revisión más reciente (HEAD) de la rama maestra. Luego, los archivos podrán editarse, guardarse y confirmarse en el VCS en Altium Designer y, finalmente, enviarse de vuelta al repositorio Git remoto.

Conectarse a un repositorio Git existente

Altium Designer no ofrece controles para crear un nuevo repositorio Git ni para conectarse a uno existente. Sin embargo, puede conectarse de manera efectiva a un repositorio existente de este tipo por otros medios (que son la técnica tradicional preferida por los usuarios de Git). Para hacerlo:

1. Cree su repositorio Git remoto o acceda al repositorio externo de su empresa, en el que se almacenan sus proyectos de Altium Designer.
2. Clone el repositorio para crear su repositorio Git local de trabajo.
3. Abra un proyecto de Altium Designer desde el repositorio local.

Altium Designer reconocerá que el proyecto está bajo control de versiones en un repositorio basado en Git y proporcionará estados relacionados con VCS, así como comandos/funciones para trabajar con los archivos (incluidos Commit (al repositorio Git local de trabajo) y Push (del repositorio Git local al repositorio Git remoto)).