Proyecto Doha es un trabajo propiedad de MundoReturn© y MundoAndroides© y así está registrado con copyright. Por favor, si deseas hacerte eco de Proyecto Doha en otras páginas web y/o foros y copiar su contenido, antes ponte en contacto con nosotros a la atención de Shinji Mikami para solicitar el permiso correspondiente en http://www.mundoreturn.com o http://www.mundoandroides.com desde la sección de contacto.

En la entrega anterior del Proyecto Doha instalamos, configuramos y preparamos nuestro entorno de trabajo bajo Ubuntu/Linux. Llegados a este punto es momento de “pasar a la acción” y ponernos manos a la obra y adentrarnos en las Custom ROM de una forma directa y a la vez muy sencilla como podréis comprobar a medida que os vayáis adentrando en el Proyecto Doha.

A partir de aquí el único requisito con el que tenemos que contar es prestar atención, no saltarse ni adelantarse a nada y sobre todo disfrutar de la experiencia que desde MundoReturn / MundoAndroides os hemos preparado. ¿Estáis listos? Pues adelante. Aprende con este intenso curso / tutorial a hacer Custom ROM de una forma firme y segura.

Desmontar / Descompilar una ROM

Como es lógico, si queremos aprender a hacer Custom ROMs necesitaremos una ROM base. Éstas suelen ser las oficiales de cada fabricante, y a partir de ahí somos nosotros los que dotamos a estas ROMs de nuevas experiencias y prestaciones que de origen no traen. Por supuesto también podremos poner nuestras manos sobre las ROMs de la AOSP, o directamente sobre otras Custom ROMs de los desarrolladores de la comunidad, esto ya depende de cada uno de vosotros sobre qué base queráis trabajar. Aquí sí quería puntualizar algo, y es que hay una regla no escrita. Si coges el trabajo de otro miembro de la comunidad, déjaselo saber y que no se te olvide citarlo y agradecerle en los créditos de tu trabajo. La comunidad te lo agradecerá y te respetará por ello, que no te quepa la mínima duda.

Por pequeña que sea la modificación que se realice sobre una ROM ésta ya pasa a ser una Custom ROM en toda regla. El código original fue modificado, por lo tanto dicha ROM ya cuenta con los cambios de nuestra propia customización.

Pero pongámonos manos a la obra. Lo primero que debemos tener en nuestro poder es una ROM oficial base sobre la que realizar las modificaciones y customización. Android, al contar con tanta variedad de marcas, modelos y terminales, nos es muy difícil trabajar sobre ejemplos de todos los modelos, así que nos tenemos que decantar por un modelo en concreto como ejemplo, y éste será el Samsung Galaxy S II GT-I9100.

Esto significa que bajo ningún concepto podréis flashear / instalar el software a partir de aquí citado en vuestro terminal, salvo que se trate del mismo modelo, el GT-I9100 de la familia Galaxy S II (no valen variantes como el GT-I9100G o similares, y mucho menos otros modelos diferentes o de distintas marcas y fabricantes).

Por otro lado, remarcar que esta guía / tutorial es válida para cualquier otro terminal Android (HTC, Samsung, etc…), pero tendréis que buscar el software adecuado para vuestros terminales concretos.

Así que, por favor, que esta cita anterior quede muy clara, ya que si instalamos en nuestro terminal un software que no le corresponda, muy posiblemente quede inservible de forma definitiva, y tenga que ser reemplazado por otro nuevo o ser enviado al servicio de asistencia técnica del fabricante para que sustituyan el hardware dañado. Ahora sí, comenzamos de forma firme con el Proyecto Doha.

VÁLIDO TANTO PARA ROMS PARTICIONADAS (VARIOS ARCHIVOS COMO CODE, MODEM, CSC) O DE UNA ÚNICA PARTICIÓN (DE UN SOLO ARCHIVO CODE)

• Descargamos una ROM base sobre la que trabajar.
• En este caso elegimos la XXKH3 2.3.4 Gingerbread para el Samsung Galaxy S II GT-I9100
• Esta base ROM es particionada (varios archivos: CODE, MODEM, CSC)
• Enlace de descarga: click aquí o descarga aquí

Elegimos ésta porque es Re-Particionada y nos vendrá bien aprender a trabajar sobre este tipo de ROMs. Cuando tengamos que trabajar sobre ROMs de una partición sabremos hacerlo fácilmente, pero no al contrario. Poseedores de otro terminal, buscad una ROM oficial base para vuestro modelo concreto.

• Si queremos seguir el Proyecto Doha con una base ROM de una única partición podremos elegir otra base
• Por ejemplo la ROM base 4.0.3 Ice Cream Sandwich XXLPQ
• Enlace de descarga: click aquí

• Una vez descargada, nos aseguramos que la tenemos en la carpeta Descargas de Ubuntu
• El fichero .zip descargado se llamará I9100XXKH3
• Descomprimir el .zip (botón derecho del ratón y “extraer”)
• Se creará una carpeta llamada I9100KH3
• Renombramos esa carpeta y la llamamos Base para aclararnos mejor con el nombre
• Mucha atención a las mayúsculas y minúsculas
• El archivo .zip descargado I9100XXKH3.zip podemos moverlo a otro sitio donde no nos moleste
• Tendremos que tener algo así

• Dentro de la carpeta Base veremos 7 archivos, pero no los utilizaremos todos como veremos más adelante
• Una vez dentro de la carpeta Base con los 7 archivos, creamos 3 carpetas nuevas y las llamaremos de la siguiente forma:

CODE, PHONE, CSC

Si estamos siguiendo Proyecto Doha con una ROM base de un único archivo, al descomprimir sólo veremos un archivo con el mismo nombre que la carpeta, por lo tanto no aparecerán multi-archivos como en el anterior caso. Sólo debemos crear una carpeta llamada CODE

• Ahora, dentro de la carpeta nueva CODE metemos el siguiente archivo:
• CODE_I9100XXKH3_CL479037_REV02_user_low_ship.tar.md5
• Da igual que copies o peguéis el archivo

Para base ROM de una sola partición, poner dentro de la carpeta CODE el único .tar.md5 creado al descomprimir la carpeta, que llevará la nombreclatura de la ROM a la que pertenece

• De forma seguida ponemos dentro de la carpeta PHONE el siguiente archivo:
• MODEM_I9100XXKH3_REV_02_CL1050544.tar.md5
• Y por último, dentro de la carpeta CSC ponemos el siguiente archivo:
• GT-I9100-CSC-HOME-MULTI-OXAKH3.tar.md5
• El resto de archivos los eliminamos, y nos aseguramos que nos quede únicamente las 3 carpetas creadas, CODE, PHONE y CSC con sus correspondientes archivos dentro

• Llegados a este punto, es momento de descargar un útil imprescindible para descomprimir una imagen de fábrica, en concreto el ext4_utils.
• Dicho archivo lo descargamos desde aquí
• Una vez descargado, lo ponemos dentro de la carpeta Base, y junto al resto de carpetas CODE, PHONE y CSC
• No descomprimimos todavía el archivo
• Si todo ha ido correctamente, tienes que tener dentro de la carpeta Descargas una carpeta llamada Base. Dentro de esta última tienes que tener una carpeta llamda CODE con su .tar.md5 dentro, otra llamada PHONE con su correspondiente .tar.md5 dentro también, otra carpeta llamada CSC con su archivo correspondiente dentro y por último el archivo ext4_utils.zip

• Para el caso de una base ROM de una sola partición, únicamente veremos la carpeta CODE y el archivo ext4_utils.zip

Llegamos a este punto, es hora de ponerse con el código y comenzar a desmontar la imagen de la ROM para poder tener acceso total a la misma y comenzar con las modificaciones que queramos. Si hasta este punto no te ha parecido muy difícil, pensamos que a partir de aquí tampoco te será mucho más complicado, pues trataremos de llevarte hasta el éxito de la mejor forma posible, parando en cada detalle y punto explicativo.

• Abrimos un terminal: Presionamos Ctrl + Alt + T
• En este momento se abrirá una consola de comandos desde la que ejecutaremos todo el código necesario para abrir por completo la imagen y acceder a su esqueleto
• Desde el terminal tenemos que navegar hasta la carpeta necesaria.
• Escribimos lo siguiente (Respetar SIEMPRE mayúsculas y minúsculas)

cd Descargas/Base

• Veréis como desde el terminal nos encontramos en la carpeta Base
• Es comento de descomprimir el archivo ext4_utils, y lo haremos desde el terminal
• Escribimos el siguiente comando

unzip ext4_utils.zip

• Veremos como de forma automática ha aparecido un LOG de comandos en el terminal, informándonos de todos los archivos que han sido descomprimidos bajo la orden “inflatting”
• De forma automática se ha generado una carpeta nueva llamada ext4_utils
• Entremos en ella escribiendo desde el terminal lo siguiente:

cd ext4_utils

• Ahora, dentro de la carpeta ext4_utils necesitamos compilar todos los archivos que se encuentran dentro de dicha carpeta para posteriormente ser válidas para desmontar la imagen de la ROM
• Escribimos el siguiente comando:

make all

• Veremos de nuevo un LOG de compilación en el terminal. Es importante no reportar ningún mensaje de ERROR dentro de dicho LOG. En caso de aparecer algún comando con ERROR algo hemos dejado de hacer bien y tendremos que repasar todo de nuevo, ya que si continuamos, algo nos dará error más adelante
• Ahora necesitaremos editar una línea de comando dentro del archivo mkuserimg.sh por medio del editor de texto gedit
• Para dicha acción tecleamos lo siguiente en el terminal

gedit mkuserimg.sh

• Como vemos se nos acabará de abrir un editor de texto con el log correspondiente del archivo mkuserimg.sh
• Nos desplazamos hasta la línea 50 (bajo, al pie del editor nos marca en qué línea nos encontramos tras el prefijo “Ln”)
• Una vez estamos en la línea 50 veremos el siguiente comando:

MAKE_EXT4FS_CMD=”./make_ext4fs $ENABLE_SPARSE_IMAGE -l $SIZE -a $MOUNT_POINT $OUTPUT_FILE $SRC_DIR”

• Tendremos que editarlo variando, eliminando, parte de su texto
• Tendremos que quitar el siguiente punto y barra ./
• Tiene que quedar así

MAKE_EXT4FS_CMD=”make_ext4fs $ENABLE_SPARSE_IMAGE -l $SIZE -a $MOUNT_POINT $OUTPUT_FILE $SRC_DIR”

• Una vez modificada la línea 50, arriba del editor de texto gedit le damos al icono de “Guardar”

Ya hemos modificado la línea de comando de mkuserimg.sh. Esto nos abre las puertas a para la descompilación de la ROM base y entrar a su esqueleto. A partir de ahora comenzaremos a “atacar” directamente sobre la ROM para descompilarla y que quede a nuestra merced.

• Seguimos en el terminal y escribimos la siguiente línea de comando

sudo cp make_ext4fs /bin/

• Ponemos nuestro password de superusuario, como siempre, y damos a intro. Parecerá que no pasa nada, pero sí ejecutó la orden cp make
• Continuamos con otra orden y mismo procedimiento

sudo cp simg2img /bin/

• Y para acabar con esta batería de órdenes, una última

sudo cp mkuserimg.sh /bin/

• En caso de fallar alguna orden de esta serie no os preocupéis, podréis repetirla sin ningún problema.
• Os dejo una gráfica del LOG del terminal en esta secuencia de comandos

Continuamos en nuestro camino firme y seguro a la conquista de nuestra base ROM desmontada sobre la cual poder manipular y modificar a nuestro antojo. En este momento tenemos la base ROM totalmente preparada para su desmonte. Ya va quedando menos. El siguiente paso será trabajar directamente sobre la imagen de la ROM. Para ello tendremos que entrar a la carpeta CODE que previamente preparamos con el archivo .tar.md5 en su interior. Seguimos

• Dejamos el terminal de comandos y nos vamos a la interface de Ubuntu
• Nos movemos por la siguiente ruta de carpetas desde Ubuntu: Descargas/Base/CODE
• Una vez dentro de la carpeta CODE nos encontraremos el siguiente archivo .tar.md5 que previamente pusimos dentro:
• CODE_I9100XXKH3_CL479037_REV02_user_low_ship.tar.md5
• Hacemos click sobre él con el botón derecho del ratón y le damos a la opción “Extraer aquí”
• Esperamos unos instantes que se extraigan los archivos
• Se creará una carpeta con el mismo nombre en la que podemos entrar
• Dentro encontraremos los siguientes archivos que mostramos en la gráfica siguiente

• Ahora retrocedemos y volvemos un paso atrás a la raíz de la carpeta recién extraída del tar.md5
• Para facilitar el trabajo en el terminal vamos a renombrar la carpeta extraída a un nombre más corto y sencillo
• Hacemos click con el botón derecho sobre la carpeta extraída
• Pulsamos la opción “Renombrar”
• Le ponemos el nombre de DOHA
• Con esto tendremos el nombre más sencillo que el anterior a la hora de referirnos a esta carpeta en el terminal de comandos
• Si todo ha ido bien, tendremos que tener esto tal cual

• Volvemos al terminal de comandos de Linux
• Como nos encontramos en el directorio ext4_utils en el terminal, tenemos que llegar hasta la carpeta recién creada DOHA
• Escribimos lo siguiente en el terminal

cd ..

cd CODE

cd DOHA

• En este instante nos encontraremos en el directorio DOHA en nuestro terminal de comando
• Ahora es momento de montar el RAW de la ROM. El festival a comenzado
• Ejecutamos la siguiente orden desde el terminal

sudo simg2img factoryfs.img factoryfs.img.raw

• Esperamos unos instantes a que monte el RAW de la imagen de nuestra ROM
• En breves instantes el terminal volverá a estar operativo
• En este momento la imagen de la ROM comienza a poder ser manipulable. Pero debemos continuar
• Ahora tenemos que crear una carpeta nueva dentro del directorio donde nos encontramos
• Lo haremos directamente desde el terminal y el directorio donde nos encontramos
• Escribimos el siguiente comando

mkdir ROM

• Aunque no lo hayamos visto, pero nos ha creado una carpeta llamada ROM dentro de la carpeta DOHA
• Ahora es momento de montar el factoryfs.img.raw que creamos antes en la nueva carpeta ROM que acabamos de crear.
• Escribimos en el terminal el siguiente comando:

sudo mount -o loop factoryfs.img.raw ROM/

• De nuevo, y aunque no hayamos visto nada, habremos hecho un comando importante
• Ya tenemos montado el factoryfs.img.raw en la carpeta ROM dentro de DOHA

Esto significa que ya tenemos nuestra base ROM lista y preparada para ser customizada y modificada a nuestro antojo. Llegados a este punto del Proyecto Doha no me queda otra que daros la enhorabuena, pues aunque no os hayáis dado cuenta, habéis descomprimido una base ROM y montado una img.raw listo para su modificación. Vamos hasta la carpeta desde la interface de Ubuntu, pero lo haremos de una forma diferente.

Ahora, en lugar de ir navegando de forma clásica por Ubuntu, ejecutaremos desde el terminal de comando una orden para navegar desde la interface de Ubuntu como auténticos Root / Superuser de nuestro equipo, así cualquier carpeta/directorio estará accesible para nosotros, ya que de hacerlo del modo clásico sin identificarnos como Superusuarios de nuestro equipo es posible que nos encontremos sin permisos para entrar en alguna de las carpetas últimas creadas.

• Vamos al terminal de comando
• Como nos encontramos en el directorio DOHA, vamos a retroceder hasta el directorio Descargas
• Sabéis que el modo de ir retrocediendo de directorio por medio del terminal se realiza poniendo el siguiente comando

cd ..

• Lo escribimos tantas veces como sea necesario hasta que lleguemos al directorio /Descartas$ de nuestro terminal de comando
• Una vez llegado a dicho directorio es momento de entrar a la interface de Ubuntu como Superusuarios
• Para tal empeño escribimos el siguiente comando

gksu nautilus Base&

En ese momento es posible que nos vuelva a pedir la contraseña de Root del equipo, o quizá no lo haga ya que nos tiene identificados en ese momento. Se abrirá una nueva ventana de interface de Ubuntu. Nos encontraremos de ello en la carpeta Base. Ahora navegamos por CODE/DOHA/ROM y nos encontraremos lo siguiente que muestra la gráfica a continuación

Esta gráfica superior es ni más ni menos que la ROM totalmente abierta y disponible a nuestra total libertad para modificarla a nuestro antojo. Pero todavía no es momento de ponerse con las modificaciones, ya que quedan algunos puntos que tratar todavía antes que pasar directamente a la Custom ROM. El Proyecto Doha no quiere dejar nada en el tintero.

• Una vez que hemos entrado en la carpeta ROM salimos a la raíz de ésta
• Con el botón derecho del ratón hacemos click sobre la carpeta ROM
• Le damos a la orden “Copiar”
• Copiamos y la pegamos en la carpeta raíz “Descargas”
• Volvamos al terminal de comando
• Retrocedemos desde el terminal hasta la raíz /Descargas

cd ..

• Una vez en la raíz /Descargas$ de nuestro terminal vamos a crear una carpeta nueva
• Podríamos haberlo hecho desde la propia interface de Ubuntu, pero elegimos desde el terminal de comando para familiarizarse con todo el entorno Linux
• La siguiente carpeta albergará la Custom ROM que montemos por nosotros mismos
• Se llamará Proyecto Doha
• Volvemos al terminal desde la raíz /Descargas$
• Escribimos el siguiente comando:

mkdir Proyecto_Doha

• De forma automática habremos creado una carpeta dentro del directorio /Descargas llamada Proyecto_Doha
• Ahora desde el propio terminal vamos a copia la carpeta ROM que trajimos desde CODE/DOHA dentro de la nueva carpeta creada llamada Proyecto_Doha
• Escribimos el siguiente comando desde el terminal:

sudo cp -r ROM Proyecto_Doha

• Ya tenemos copiada la carpeta ROM dentro de la carpeta Proyecto_Doha
• Ahora desde el propio terminal vamos a renombrar la carpeta ROM por el nombre de system
• Como bien sabéis, esto se podría hacer desde la propia interface de Ubuntu con el botón derecho del ratón igual que se hace en Windows, pero mi intención es que os familiaricéis con las líneas de comando de Linux
• Volvemos al terminal, donde nos encontramos en la raíz Descargas$ y escribimos lo siguiente:

cd Proyecto_Doha sudo mv ROM system

• Ahora ya tenemos renombrada dicha carpeta como system
• La ruta actual debe ser así: Descargas/Proyecto_Doha/system
• Verificarlo desde la interface de Ubuntu y de ser así es que todo ha ido con éxito

Ahora debemos seguir y de terminar de montar nuestra ROM donde trabajar en nuestra futura Custom ROM. Ya tenemos system totalmente para nosotros, es momento de tener también el resto de binarios, como el Modem, el Kernel y el CSC. Esto será coser y cantar.

• Navegamos por la interface de Ubuntu abierta con el comando gksu nautilus para poder manipular todos los archivos con facilidad al ser root
• Si por algún casual cerraste la ventana de Ubuntu de gksu nautilus, vuelve a abrila
• Ve al terminal
• Sitúate en la raíz del terminal /Descargas$
• Pon el siguiente comando

gksu nautilus Base&

• Ahora vamos a hacer lo mismo con la Banda base (Modem)
• Nos desplazamos por la interface de Ubuntu hasta la siguiente ruta:
• Descargas/Base/PHONE
• Los que sigáis el Proyecto Doha con una base de un único archivo seguir una ruta diferente:
• Descargas/Base/CODE/DOHA (sólo para ROMs de un único archivo)
• Ahora, dentro de la carpeta PHONE encontraremos el siguiente archivo:
• MODEM_I9100XXKH3_REV_02_CL1050544.tar.md5
• Hacer click sobre él con el botón derecho y darle a la orden “Extraer”
• Aparecerá un archivo llamado modem.bin
• Los que sigáis el Proyecto Doha con una base de un único archivo ya habréis encontrado el archivo modem.bin descomprimido dentro de la carpeta DOHA
• Hacer click con el botón derecho del ratón, Copiar y llevarlo al Proyecto Doha siguiendo esta ruta:
• Descargas/Proyecto_Doha
• El archivo modem.bin debe quedar junto al de zImage y la carpeta system

Por último, de momento, nos queda el CSC. Esta operación no es tan fácil y rápida como el modem.bin y el zImage, pero no será nada complicado. Con lo que hasta ahora llevamos hecho, esto será coser y cantar, os lo aseguro.

• Volvemos al terminal de comandos
• Nos desplazamos desde el terminal hasta el directorio donde está el CSC
• En el caso de una base ROM de varios archivos Re-Particionada seguimos la siguiente ruta

cd Descargas/Base/CSC

• El el caso de tener una base ROM de un archivo y una partición seguimos la siguiente ruta:

cd Descargas/Base/CODE/DOHA

• Ahora, y seguimos en el terminal de comando, ejecutamos la siguiente batería de órdenes para poder desmontar el CSC y poder llevarlo junto a los otros archivo en el Proyecto_Doha

mkdir CACHE

(Este comando siguiente sólo para las base ROM de varios archivos Reparticionadas)

sudo tar -xvf GT-I9100-CSC-HOME-MULTI-OXAKH3.tar.md5

A partir de ahora válido para base ROM Re-Particionadas o de una única partición

sudo simg2img cache.img cache.img.raw

Damos a intro y seguimos con el siguiente comando

sudo mount -o loop cache.img.raw CACHE/

De nuevo intro y el siguiente comando

gksu nautilus CACHE&

• Ahora se nos abrirá una ventana de de Ubuntu con el comando gksu nautilus siendo Root
• Aparecerán dos carpetas llamadas: Recovery y Samsung
• Hacemos doble click en la carpeta Recovery
• Aparecerán dos archivos. Nos fijamos en el que se llama sec.csc.zip
• Hacemos click con el botón derecho del ratón y le damos a “Extraer”
• Aparecerá una carpeta con el mismo nombre sec.csc
• Hacemos doble click y entramos
• Ahora aparecerán las carpetas META-INF y system
• Entramos en la carpeta system
• Aparecerán 2 carpetas y 2 archivos: csc, T9DB, CSCVersion.txt y SW_Configuration.xml
• Copiamos todo, los 4 archivos, y lo movemos a la siguiente ruta
• Descargas/Proyecto_Doha/system
• Pegamos los 4 elementos dentro de /system
• Debe quedar así:

En este instante ya tenemos nuestra Custom ROM totalmente abierta, con system y Framework a nuestra total merced, con el Kernel listo para sustituir, el Modem también preparado y el CSC. Desde este momemto podríamos comenzar con las modificaciones con toda facilidad, pero no lo haremos todavía. Es importante que sigáis confiando en el Proyecto Doha, si sigáis los pasos marcados para un éxito final rotundo y sin paliativos.