Importar repositorios de GitHub con git, Eclipse y Android Studio

Última actualización:13/09/2020

GitHub

Los ejemplos del blog y mis proyectos personales se encuentran alojados en repositorios git en GitHub. Son numerosos los motivos que me han llevado a tomar esta decisión:

  • Se puede acceder a los repositorios sin necesidad de tener una cuenta en GitHub (aunque es muy recomendable tal y como veremos al final del artículo).
  • Permitir que los lectores puedan consultar todo el código sin necesidad de descargarlo.
  • Poder ver las correcciones y mejoras en los proyectos a lo largo del tiempo. Utilizar un sistema de control de versiones es imprescindible.
  • Es el servicio gratuito de este tipo más popular.

Puesto que algunos lectores no estarán familiarizados con el uso de GitHub, con este artículo pretendo ofrecer una mini-guía para que no haya problemas a la hora de descargarse los ejemplos del blog o cualquier otro repositorio de GitHub. El funcionamiento del sistema de control de versiones git no será cubierto en este artículo, al final del mismo se pueden encontrar enlaces al respecto.

Descargar el repositorio en un zip

Existe la posibilidad de obtener el contenido de un repositorio (sólo el contenido sin control de versiones) en un .zip. Simplemente hay que pulsar el botón “Download ZIP” dentro del desplegable “Clone” tal y como muestra la siguiente captura. Es lo más sencillo si solo se quiere obtener el código sin más complicaciones.

Clonar el repositorio en nuestro equipo

Se puede crear una copia en local del repositorio completo mediante la línea de comandos de git o bien mediante clientes gráficos, ya sea dentro o fuera de un IDE. En esta sección se va mostrar cómo hacerlo desde la línea de comandos y desde Eclipse y Android Studio / IntelliJ.

Desde la línea de comandos

El primer paso es tener instalado git en el equipo. En sistemas GNU\Linux suele encontrarse en los repositorios oficiales y lo instalaremos con yum, apt-get,etc en función de la distro que usemos (de hecho git fue creado originalmente por Linus Torvalds como sistema de control de versiones para el desarrollo de Linux). Por ejemplo, en cualquier sabor de Ubuntu usaremos el siguiente comando

sudo apt-get install git

Para Windows tenemos el instalador disponible aquí (y que además incluye un sencillo cliente gráfico). Con respecto a la instalación, simplemente comentar que en la siguiente pantalla deberemos seleccionar la segunda opción para que git se incluya automáticamente en el classpath y no tengamos que hacerlo posteriormente a mano. El resto de opciones de instalación podemos en principio dejar las que vienen por defecto.

instalacion git

Una vez instalado git, procedemos a “clonar” el repositorio que queramos. Para ello sólo necesitamos su url que encontraremos en el mismo desplegable que vimos en la sección anterior para descargar el código en un .zip

Cursos aplicaciones móviles

git clone https://github.com/danielme-com/Android-Paginated-ListView-Demo.git

El repositorio se clonará en el directorio desde el que se ejecute el comando con el nombre del .git de la url, que en el ejemplo anterior es Android-Paginated-ListView-Demo, pero podemos especificar otro directorio tal que así:

git clone https://github.com/danielme-com/Android-Paginated-ListView-Demo.git /home/dani/repo

Desde Eclipse

Como he comentado, Eclipse tiene un excelente plugin para trabajar con git llamado Egit que nos permitirá gestionar de forma totalmente gráfica y dentro del IDE nuestros repositorios. Dependiendo de la versión y “sabor” de Eclipse que tengamos instalado, es muy probable (casi seguro) que ya tengamos instalado este plugin. Para comprobarlo, basta con irnos a “Help->About Eclipse” y fijarnos si tenemos el icono de dicho plugin:

about

Si no lo encontramos tocará instalarlo desde el propio Eclipse. Se puede hacer de dos formas:

  1. Desde el marketplace(Help->Eclipse Marketplace…). Buscamos Egit e instalamos el primer resultado (en la captura aparece la opción Uninstall porque ha sido tomada a partir de un Eclipse que ya tenía el plugin instalado).

    marketplace

  2. Si no podemos instalarlo desde el Marketplace, siempre se puede instalar manualmente desde el repositorio oficial. Para ello nos vamos a Help->”Install New Software..” y añadimos la ubicación http://download.eclipse.org/egit/updates

    install new software

    Aceptamos la licencia, instalamos y reiniciamos Eclipse.

Ahora ya estamos en condiciones de clonar un repositorio en local desde Eclipse. Los pasos a seguir son los siguientes:

  1. Abrir File->Import… y seleccionar Git->Projects from Git


    asistente 1

  2. En la siguiente pantalla seleccionar URI

    asistente 2
  3. Proporcionamos la url del respositorio que vimos anteriormente en el campo URI, el resto se rellenará automáticamente. Los repositorios del blog son públicos, pero para descargar repositorios privados deberemos propocionar las credenciales de un usuario en GitHub que tenga los permisos correspondientes.

    asistente 3
  4. Tras pulsar Next> , Eclipse se conectará al repositorio y nos mostrará las ramas del proyecto para que seleccionemos las que queramos descargar. En los ejemplos del blog casi siempre vamos a tener sólo una (la principal o master).

    asistente 4
  5. Seleccionamos la ubicación en la que queremos descargar el proyecto, por defecto siempre se utiliza el directorio del usuario por lo que lo habitual será cambiarlo al que usemos para los proyectos.

    asistente 5
  6. Al pulsar Next> se descargará el repositorio en la ubicación elegida. En la última pantalla si lo deseamos podemos importar el proyecto descargado en Eclipse. Si se trata de un proyecto Eclipse usaremos la primera opción, pero en los ejemplos del blog no suelo incluir ficheros de IDE alguno salvo en algunos proyectos para Android Studio. En el caso de un proyecto Maven, podemos usar el asistente si tenemos el plugin de Maven instalado en Eclipse o simplemente pulsar Cancelar y generar desde la línea de comandos el proyecto para Eclipse con Maven. En cualquier caso llegados a esta pantalla ya tenemos una copia del repositorio en nuestro equipo.


    asistente 6
  7. Android Studio

    Además de incluir soporte de serie para git, Android Studio también proporciona integración directa con GitHub permitiendo tanto importar como publicar nuevos repositorios de forma visual. Lo mismo es aplicable para IntelliJ, el IDE en el que se basa.

    Dentro del IDE, hay que seleccionar la opción File->New->Project From Version Control->.

    Se abrirá un cuadro de diálogo donde indicamos la url del repositorio a clonar y un directorio vacio. Tras la descarga, se nos preguntará si deseamos abrir el proyecto.

    También se puede hacer desde la pantalla de bienvenida con la opción “Get from Version Control” que abre la ventana de la captura anterior.

    ¿Por qué debería tener una cuenta en GitHub?

    Los repositorios públicos de GitHub son libremente accesibles. Sin embargo, tener una cuenta gratuita en GitHub es altamente recomendable debido a las siguientes ventajas:

    • Crear sin limitación todos los repositorios, tanto públicos como privados, que queramos, y dar acceso a un número ilimitado de colaboradores. Los repositorios incluyen, entre otros, un sistema de gestión de incidencias, una wiki, y la posibilidad de definir acciones automáticas al subirse código creando de este modo un flujo de trabajo.
    • Crear entradas en el sistema de control de incidencias (issues) de cualquier proyecto al que tengamos acceso.
    • Recibir notificaciones con actualizaciones de incidencias, nuevas releases de los proyectos que seguimos, etc.

    Con una cuenta en GitHub se puede hacer un “fork” de un repositorio, esto es, crear en una cuenta una copia de otro repositorio. Una vez realizado dicho fork, podemos descargar el repositorio en nuestro equipo siguiendo lo indicado en este artículo con la ventaja de que al estar el repositorio en nuestra cuenta podemos publicar los cambios que queramos en GitHub (si queremos hacer cambios en un repositorio que no es nuestro el propietario deberá darnos de alta como colaborador o bien solicitar nosotros un pull request desde nuestro fork para que se incluyan los cambios).

    Trabajar con git

    Como referencia recomiendo utilizar el libro “oficioso” Git Pro de dominio público bajo licencia Creative Commons. La versión española se encuentra aquí. Entre las herramientas para trabajar gráficamente con git, además de los plugins de los IDE, recomiendo fervientemente SmartGIT, de pago pero gratuito para proyectos Open Source y sin ánimo de lucro. Como alternativa gratuita, se puede recurrir a SourceTree.

    Master Pyhton, Java, Scala or Ruby

4 comentarios sobre “Importar repositorios de GitHub con git, Eclipse y Android Studio

Responder

Introduce tus datos o haz clic en un icono para iniciar sesión:

Logo de WordPress.com

Estás comentando usando tu cuenta de WordPress.com. Cerrar sesión /  Cambiar )

Google photo

Estás comentando usando tu cuenta de Google. Cerrar sesión /  Cambiar )

Imagen de Twitter

Estás comentando usando tu cuenta de Twitter. Cerrar sesión /  Cambiar )

Foto de Facebook

Estás comentando usando tu cuenta de Facebook. Cerrar sesión /  Cambiar )

Conectando a %s

Este sitio usa Akismet para reducir el spam. Aprende cómo se procesan los datos de tus comentarios .