#1
|
||||
|
||||
Cómo usar Github
Todos sabemos gracias a que es tan grande android. Google tuvo la gran idea de que android fuera Opensource, esto ha sido bueno para ellos a nivel de empresa, pero también a beneficiados a todos los usuarios. Después aparecieron los grandes grupos de desarrollo, principalmente CyanogenMod. Bueno todos os sabéis la historia como va.
Todos tienen en común que publican el código de sus modificaciones. Gracias a esto han aparecido muchas ROMS, prácticamente podríamos cambiar de ROM cada dia. La mayoría, por no decir todos, utilizan Github. Hace poco me metí a ver como funcionaba y hice un tutorial para dev-puremod. Y ahora os lo comparto, ya que en mi opinión es importante publicar el código, simplemente por respeto a los grandes desarrolladores que lo comparten y gracias a esto android es lo que es. IMPORTANTE: Recientemente empezó una discusión por el tema de publicar o no el código. Esto no sirve para volver a este debate. Solo para que la gente que quiera compartirlo sepa por donde empezar. Así que porfavor ninguna discusión sobre esto. ¿QUE ES GITHUB? Github es una página web que permite alojar el código de proyectos utilizando el sistema de control de versiones Git. Github tiene una cuenta gratuita y otras de pago. En la cuenta gratuita tendremos un nombre ilimitado de repositorios públicos, si almacenamos el código de un proyecto allí seria opensource. Si se quiere repositorios privados se tiene que contratar la versión de pago. CREAR CUENTA EN GITHUB Este es un paso muy sencillo que estoy seguro que todos lo sabréis hacer sin ningún problema. Entramos en github.com y directamente nos aparece una pantalla para registrarnos. Nos registramos GIT Instalar Primero de todo necesitamos instalar git. Git, tal como dice Wikipedia, es un software de control de versiones diseñado por Linus Torvalds, pensando en la eficiencia y la confiabilidad del mantenimiento de versiones de aplicaciones cuando estas tienen un gran número de archivos de código fuente. Vamos a instalar Git: Código:
apt-get install git Esto es un programa llamado git shell que seria parejo a cygwin, pero especializado por los comandos de git. Configurar Una vez que tenemos instalado git es hora de configurarlo. Para hacer esto necesitamos abrir el terminal y introducir lo siguiente: Código:
git config --global user.name "Your Name Here" Código:
git config --global user.email "[email protected]" Más adelante tendremos que generar una contraseña. Vamos a guardar la contraseña en cache para que no nos la pide cada vez. Introducimos lo siguiente en el terminal. Código:
git config --global credential.helper cache Código:
git config --global credential.helper 'cache --timeout=3600' Una vez hecho todo esto vamos a generar una SSH Key. SSH KEY La ssh key se utiliza para establecer una conexión segura entre Github y tu ordenador. Partimos de la base que no tenemos ninguna llave generada. Si queréis comprobarlo escribid lo siguiente en el terminal: Código:
cd ~/.ssh ls Código:
id_rsa.pub Código:
id_dsa.pub Generar Vamos a introducir lo siguiente en el terminal Código:
ssh-keygen -t rsa -C "[email protected]" Código:
Generating public/private rsa key pair. # Enter file in which to save the key (/home/you/.ssh/id_rsa): Ahora nos va a pedir que escribamos dos veces una contraseña. Esta contraseña nos la va a pedir cada vez que queramos subir algo a nuestra cuenta. Recordad que hemos configurado que se guarde en cache durante 1 hora. Nos aparecerá esto: Código:
Enter passphrase (empty for no passphrase): Escribir contraseña # Enter same passphrase again: Repetir contraseña Código:
Your identification has been saved in /home/you/.ssh/id_rsa. # Your public key has been saved in /home/you/.ssh/id_rsa.pub. # The key fingerprint is: # 01:0f:f4:3b:ca:85:d6:17:a1:7d:f0:68:9d:f0:a2:db [email protected] The key's randomart image is: +--[ RSA 2048]----+ | .+ + | | = o O . | | = * * | | o = + | | o S . | | o o = | | o . E | | | | | +-----------------+ Código:
~/.ssh/id_rsa.pub Código:
sudo apt-get install xclip Una vez instalado escribimos lo siguiente para copiar la llave: Código:
xclip -sel clip < ~/.ssh/id_rsa.pub Ahora toca conectar git con Github mediante la llave que hemos generado. Por esto entraremos en nuestra cuenta de Github, arriba a la derecha iremos a "Account settings" y finalmente a "SSH Keys". O para que se más fácil entramos en este enlace: https://github.com/settings/ssh Ahora presionamos "Add SSH Key" En "title" podemos poner lo que queramos (ej. Linux) o si queréis lo podéis dejar en blanco (va a aparecer vuestro correo). En la parte de "Key" pegamos lo que anteriormente copiamos con el programa xclip (simplemente botón derecho-pegar). Finalmente le damos a "Add Key" Probar si funciona Para comprobar que lo tengamos enlazado correctamente escribiremos lo siguiente: Nota: os va a aparecer una ventanita pidiendo una contraseña, debéis introducir la contraseña puesta en la configuración de la SSH Key. Si no lo haceis saldrá "Permission denied (publickey)"* Código:
ssh -T [email protected] Código:
The authenticity of host 'github.com (207.97.227.239)' can't be established. # RSA key fingerprint is 16:27:ac:a5:76:28:2d:36:63:1b:56:4d:eb:df:a6:48. # Are you sure you want to continue connecting (yes/no)? Código:
yes Código:
Hi username! You've successfully authenticated, but GitHub does not # provide shell access. * Si os aparece "Permission denied (publickey)" en más ocasiones Github tiene una página dedicada a solucionar este problema: https://help.github.com/articles/err...nied-publickey Fuente: https://help.github.com/articles/set...platform-linux https://help.github.com/articles/gen...platform-linux ------------------------------------------------------------------------------------------------------ EMPEZAR CON GITHUB Para subir nuestro código a Github tenemos dos opciones: la primera subir nuestro código del ordenador y la segunda hacer un fork de otro repositorio. Antes de seguir vamos a ver que es un repositorio. Dicho de forma rápida el repositorio es donde colgamos una parte de un proyecto (en caso de un proyecto con muchas partes. ej. codigo fuente de android) o todo el código de un proyecto (ej. una app). Para que se me entienda mejor voy a explicar ejemplos teniendo en cuenta que la finalidad es subir el código fuente de una modificación nuestra de android (una ROM). Primero empezaremos explicando como subir el código almacenado en el ordenador. SUBIR EL CÓDIGO ALMACENADO EN EL PC Primero será necesario crear un nuevo repositorio donde almacenar el código. Recordad que la cuenta gratuita de Github solo permite utilizar repositorios públicos, para proyectos opensource, si queréis repositorios privados os tocará pagar una cuota al mes. Crear un repositorio Una vez estás dentro de tu cuenta te encuentras en la página principal arriba a la derecha vas ver tu nombre de usuario, justo al lado verás tres botones, el primero sirve para crear un nuevo repositorio, el segundo es los ajustes de tu cuenta y el última para salir de tu cuenta. Lógicamente vamos a seleccionar el primero (el que está más cerca del nombre de usuario). Ahora va aparecer una página donde vamos a configurar nuestro nuevo repositorio. Vamos a introducir un nombre para el repositorio, y si queréis una descripción para el repositorio. Finalmente si queréis podéis incluir un "README" y una licencia, esto es elección vuestra. Subir el código al repositorio Vamos a abrir la carpeta donde tenemos almacenada los archivos y subcarpetas que queramos subir. Una vez dentro nos tendríamos que asegurar que no contenga una carpeta .git, ya que si la contiene puede causar errores (ej. el código de android incluye esta carpeta). Para eso tenemos que ir a "archivos--preferencias--vistas" y seleccionar "Mostrar archivos ocultos y de respaldo" Bien, ahora abrimos la carpeta en el terminal. Ahora escribiremos lo siguiente en el terminal: Código:
git init Ahora seleccionaremos que suba todo lo que contenga la carpeta Código:
git add * Código:
git status Código:
git commit -m "Proyecto subido" Código:
git remote add origin [email protected]:nombre_de_usuario/nombre_del_repositorio.git Código:
git push -u origin master Ahora si entrais en vuestro github, seleccionáis vuestro repositorio y veréis arriba de los archivos que pone "1 commit". Si entráis va a decir todos los cambios que se han producido, en este caso tendremos "Proyecto subido" HACER UN FORK DE OTRO PROYECTO Hacer un fork de otro repositorio significa que lo copiamos hacia nuestro github tal cuál. Esto significa que guarda los commits que se hayan hecho y sus "branches". Hacer un fork es muy fácil, tenemos que buscar un repositorio que nos interese, por ejemplo el repositorio "platform_frameworks_base" del Github de Android. Entramos dentro del repositorio y seleccionamos "Fork" arriba a la derecha. Y nos saldrá esta pantalla: Cuándo termine ya tendremos el repositorio copiado a nuestro Github. Ahora vamos a descargar el código a nuestro ordenador para poder realizar los cambios y subirlos a Github. Descargar el código Vamos a abrir en el terminal el lugar donde queramos guardar el código. Ahora escribiremos en el terminal: Código:
git clone [email protected]:usuario/repositorio.git Lo bueno de hacer un fork es que no es necesario asignar el nuestro repositorio. Siguiendo cualquier de estas dos opciones ya tendréis el código subido a github y sincronizado en vuestro PC. Ahora vamos a ver los comando principales y como crear nuevas "branches" CREAR NUEVAS "BRANCHES" Esta opción la realizaremos desde dentro de nuestro github, más explicitamente, dentro de nuestro repositorio. Seleccionamos "branch: master" y se abrirá una lista, y un lugar para escribir. Allí escribimos el nombre de la "branch" que queremos, como no la encontrará nos dira de crear una nueva "branch" Para cambiar la "branch" por defecto tenemos que ir al menu de la derecha y abajo seleccionar "settings" Dentro de "settings" cambiamos la "branch" por defecto en "Default Branch" COMANDOS BÁSICOS Aquí os voy a mostrar los comandos más básicos. Subir los cambios a Github Cada vez que modificamos un archivo y queramos subirlo a Github haremos lo siguiente, es lo mismo que se ha realizado en proceso de subir el código almacenado al PC a Github. Código:
git add <ruta del archivo> Si quereis comprobar los archivos añadidos utilizaremos: Código:
git status Como vemos nos salen archivos en rojo y otros en verde. Los archivos en verde ya están añadidos, y los archivos en rojo *son los que faltan para añadir. Ahora es necesario introducir un nombre para el commit Código:
git commit -m "escribir los cambios realizados" Código:
git commit -a Y finalmente el siguiente comando sirve para subir los cambios a github Código:
git push Imaginaos que por cualquier motivo habéis modificado algo directamente desde Github, o que realizáis el proyecto también en otro ordenador o con otra persona. El siguiente comando sirve para bajar los cambios que hay en el github y que no están en el PC Código:
git pull Comandos para seleccionar la "branch" Un poco más atras hemos creado una nueva "branch" ahora debemos seleccionarla para subir nuestros cambios en esta "branch". Para ver que "branches" tenemos que escribir lo siguiente en el terminal: Código:
git branch Código:
git pull Ahora si hacemos Código:
git branch Com vereis la "branch" seleccionada es "master, ahora toca seleccionar la "branch" deseada. Para eso escribimos Código:
git checkout nombre_de_la_branch Código:
git branch Ahora cada vez que hagamos Código:
git push Otros comandos Esta parte es gracias a @furious Código:
git revert < sha del decommit> Código:
git checkout <sha del commit> Código:
git log Código:
git log -p Código:
git merge <rama> http://www.dev-puremod.es/showthread.php?tid=861 Última edición por mbc596 Día 02/09/13 a las 00:25:21. |
Los siguientes 39 usuarios han agradecido a mbc596 su comentario: | ||
|
#4
|
||||
|
||||
Tenia pensado reservar uno porque iba a hacer uno para hacer cherry-picks pero se me ha olvidado... jajaja
|
#7
|
||||
|
||||
|
#10
|
||||
|
||||
Excelente trabajo. Aun recuerdo el rato que me llevo enterarme de esto bien. Asi resultan las cosas más faciles.
__________________
|
#11
|
||||
|
||||
@mbc596 en el foro PureMod te he hecho una pregunta. Pero la hago aquí también, y es relacionado sobre el
Código:
git add * Abro terminal cd android/system Corto y pego la carpeta .repo fuera de system git add * Seria correcto así?. O mantengo la carpeta repo.
__________________
|
#12
|
||||
|
||||
Por eso lo hize, me costo mucho conseguirlo y como utilizo máquina virtual seguro que la borraré más de una vez y tendré que volver a hacerlo, así no me olvidaré nunca
|
#13
|
||||
|
||||
@mbc596 en el foro PureMod te he hecho una pregunta. Pero la hago aquí también, y es relacionado sobre el
Código:
git add * Abro terminal cd android/system Corto y pego la carpeta .repo fuera de system git add * Seria correcto así?. O mantengo la carpeta repo. Yo te recomiendaria que lo subieras por partes, fijate en como lo tienen las grandes roms. Incluso android lo tiene así, se suben las carpetas que tienen un .git en su interior, es más cómodo. Y el git add * en frameworks/base tarda un ratito |
#15
|
||||
|
||||
mbc596, donde coño estabas cuando estaba aprendiendo a usar git? Me hubiera resultado muy útil toda esta información.
Ahora nadie tiene escusa, entre tu tutoriales y el de veloz de como compilar, esto de crear Roms se va a volver el pan nuestro de cada día... Gracias por el curro!!
__________________
|
Los siguientes 2 usuarios han agradecido a AlvaroOrduna su comentario: | ||
#16
|
||||
|
||||
Chincheta aqui o en el foro general de android, el de cocina, da igual, pero chincheta ya.
Gracias por el curro. Un saludo.
__________________
|
Gracias de parte de: | ||
#18
|
||||
|
||||
Estoy seguro que a más de uno le vendrá bien
__________________
Once a NeXus always a NeXus
|
#19
|
||||
|
||||
Excelente tutorial
|
|
#20
|
||||
|
||||
Mbc.. one question..
Yo hago un cherry-pick.. vale. Código:
davidvaz@davidvaz ~/android/omni/packages/apps/Settings $ git fetch https://github.com/NarpAOSP/packages_apps_Settings && git cherry-pick 8bcdb81a095db99e96c208928d32372e5e518f90 warning: no common commits remote: Counting objects: 3281, done. remote: Compressing objects: 100% (1491/1491), done. remote: Total 3281 (delta 1475), reused 3220 (delta 1418) Receiving objects: 100% (3281/3281), 5.79 MiB | 293 KiB/s, done. Resolving deltas: 100% (1475/1475), done. De https://github.com/NarpAOSP/packages_apps_Settings * branch HEAD -> FETCH_HEAD error: no se puede aplicar 8bcdb81... Add active display to ChameleonOS [2/2] consejo: después de la resolución de conflictos, marcar las rutas corregidas consejo: con «git add <paths>» o «git rm <paths>» consejo: y hacer commit del resultado con «git commit» error: Could not parse conflict hunks in res/values/arrays.xml Recorded preimage for 'res/values/strings.xml' Por que yo miro los archivos y no sale nada de <<<< HEAD... :S
__________________
Última edición por David_Vaz Día 17/10/13 a las 22:14:00. |
Estás aquí | ||||||
|