Importar repositorios de GitHub con git, Eclipse y Android Studio


VERSIONES

  1. 07/08/2013 (Primera publicación)
  2. 18/07/2015:
    • Android Studio

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 que los proyectos han sufrido con el paso del tiempo.

Puesto que muchos 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” tal y como se indica en la imagen. Es lo más sencillo si solo se quiere descargar el código sin más complicaciones.

download zip

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 que es el IDE que utilizo y que cuenta con un excelente plugin para trabajar con el sistema de control de versiones git. Otros IDEs populares como IntelliJ y Netbeans también incluyen soporte integrado para git.

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 usaremos 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 la pantalla principal del repositorio en GitHub tal y como muestra la siguiente imagen:

git url

Con esa url, abrimos un terminal de Linux o el cmd de Windows y escribimos el siguiente comando:

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 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 de forma análoga a como lo hicimos con la línea de comandos. 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.

    asistente 3
  4. Tras pulsar Next> , Eclipse se conectará al repositorio y nos mostrará las ramas del proyecto para que seleccionemos la que queramos descargar. En los ejemplos del blog 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 (es el caso de mis proyectos Android) usaremos la primera opción. En caso contrario, por ejemplo 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.

    1. Dentro del IDE, seleccionar la opción File->New->Project From Version Control->GitHub
      android studio github

      También se puede hacer desde la pantalla de bienvenida
      android studio github

    2. Proporcionar los datos de login en GitHub (esta pantalla no aparece si ya tenemos registrado en Android Studio una cuenta)
      android studio github
    3. Finalmente indicamos la url de repositorio (el .git) y dónde queremos que se descargue el proyecto.

      android studio github

    4. ¿Por qué debería crearme 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 públicos que queramos, y dar acceso a un número ilimitado de colaboradores. Los repositorios incluyen, entre otros, un sistema de gestión de incidencias y una wiki, todo de forma gratuita.
      • Poder crear entradas en el sistema de control de incidencias (issues).
      • Colaborar con otros usuarios y, en definitiva, ser miembros de una de las comunidades de desarrolladores Open Source más grande y activa del mundo.

      Con una cuenta en GitHub se puede hacer un “fork” de un repositorio, esto es, crear en una cuenta una copia de otro repositorio para desarrollar. 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

      Aunque como hemos visto hay herramientas gráficas, los comandos de git son muy intuitivos. Como referencia se puede tomar el libro “oficial” Git Pro de dominio público bajo licencia Creative Commons. La versión española se encuentra aquí.

      Hay una buena y breve introducción tanto a la historia de git como a sus principales comandos en la siguiente presentación en español.

4 Responses to Importar repositorios de GitHub con git, Eclipse y Android Studio

  1. 92teamanare dice:

    Muchas gracias por tu guía, me ha resultado realmente útil en mi trabajo.

    Un fuerte abrazo, saludos

  2. Guillermo dice:

    Muchas gracias, muy buen aporte, saludos.

  3. Reblogueó esto en elisvelasquezy comentado:
    Excelente articulo para importar proyectos copiados en GUT

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 )

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 )

Google+ photo

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

Conectando a %s

A %d blogueros les gusta esto: