Creación y gestión de releases

La funcionalidad Releases de GitHub le ayuda a empaquetar y proporcionar a los usuarios versiones estables de su software. Considérela como un anuncio formal de una nueva versión.

Es fundamental para los proyectos que necesitan distribuir binarios compilados, documentación o instantáneas específicas del código fuente.

Cada versión de GitHub está asociada directamente a una etiqueta de Git. Una etiqueta marca un punto específico del historial de su repositorio, normalmente un número de versión como v1.0.0.

• Las etiquetas proporcionan una referencia permanente e inmutable a un commit.
• Las versiones añaden metadatos enriquecidos (como notas de la versión y recursos) sobre esta etiqueta.

Antes de crear una versión, asegúrese de haber enviado a GitHub la etiqueta deseada.

Las notas de la versión son descripciones que explican qué hay de nuevo, qué se ha mejorado o qué se ha corregido en una versión concreta. Son esenciales para comunicar los cambios a los usuarios.

• Utilice un lenguaje claro y conciso.
• Destaque las funcionalidades principales y las correcciones de errores.
• Se admite el formato Markdown para aplicar formato enriquecido al texto.

Los recursos de la versión son archivos que puede adjuntar a una versión para que estén disponibles para su descarga. Pueden incluir:

• Binarios compilados (por ejemplo, .exe, .dmg)
• Código fuente comprimido (.zip, .tar.gz)
• Archivos de documentación o instaladores

Proporcionan en un solo lugar todo lo que los usuarios necesitan para esa versión específica.

Para crear una versión:

1. Vaya a su repositorio en GitHub.
2. Haga clic en 'Releases' (normalmente se encuentra en la barra lateral derecha o en la pestaña 'Code').
3. Haga clic en el botón 'Draft a new release'.

Se abrirá un formulario en el que podrá definir los detalles de la versión.

En la página de creación de la versión podrá:

• Elegir una etiqueta de Git existente o crear una nueva.
• Proporcionar un título de versión (por ejemplo, 'Version 1.0.0 - Initial Release').
• Escribir las notas de la versión detalladas.

Puede marcarla como 'pre-release' (para pruebas) o publicarla directamente.

¡GitHub puede ayudarle a generar notas de versión automáticamente!

Al hacer clic en 'Generate release notes', GitHub analizará los commits y las solicitudes de incorporación de cambios combinados desde la última etiqueta de versión y sugerirá un resumen. Después podrá editarlo y perfeccionarlo.

Cuando las notas de la versión estén listas, puede subir los recursos.

Solo tiene que arrastrar y soltar los archivos en el área designada o hacer clic para buscarlos. GitHub los subirá y aparecerán como archivos descargables en la página de la versión.

¡Los errores ocurren! Siempre puede editar o eliminar una versión.

• En la página 'Releases', busque la versión que desea modificar.
• Haga clic en el icono del lápiz para editarla o en el icono de la papelera para eliminarla.

La edición permite cambiar las notas, el título o los recursos. Al eliminarla, se quita la versión de GitHub, pero la etiqueta de Git subyacente permanece.

¿Cuáles de los siguientes son componentes o características esenciales de una versión de GitHub?

¡Ha aprendido a crear y gestionar versiones de GitHub!

• Las versiones proporcionan instantáneas formales y versionadas de su proyecto.
• Se basan en etiquetas de Git e incluyen notas de la versión y recursos opcionales.
• Puede crear, editar y eliminar versiones mediante la interfaz de usuario de GitHub.

Esto ayuda a los usuarios a encontrar y descargar fácilmente versiones estables de su software.