Cómo descargar el código fuente de Android

El código fuente de Android se encuentra en una colección de repositorios Git alojados en Google. El repositorio Git tiene todo el historial del código fuente de Android, lo que incluye los cambios en el código fuente y el momento en que se hicieron. En esta página, se describe cómo descargar el código fuente.

Cómo inicializar un cliente de Repo

Configura tu cliente para acceder al repositorio de código fuente de Android:

  1. Crea un directorio de trabajo y navega hasta este:

    $ mkdir WORKING_DIRECTORY
$ cd WORKING_DIRECTORY

  2. Inicializa tu directorio de trabajo para controlar el código fuente:

    $ repo init -b main -u https://android.googlesource.com/platform/manifest

    La opción -b se utiliza para identificar la rama que estás por inicializar. Si no se brinda -b, repo init se establece, de forma predeterminada, en la rama principal. Para obtener una lista de los nombres de las ramas y etiquetas, consulta Etiquetas de código fuente y compilaciones.

    La opción -u es obligatoria y se utiliza para especificar un archivo de manifiesto, que es un archivo en formato XML que especifica dónde se colocan los distintos proyectos Git en el código fuente de Android dentro de tu directorio de trabajo. En este ejemplo, no se especifica el nombre del archivo de manifiesto, por lo que el comando utiliza el archivo de manifiesto predeterminado (default.xml).

    La salida debería contener el siguiente mensaje:

    $ repo has been initialized in path_to_working_directory

Para obtener información sobre el formato del archivo de manifiesto, consulta Formato de manifiesto del repositorio.

Para obtener una lista de todos los comandos de Repo, consulta Referencia de comandos de Repo.

Cómo descargar el código fuente de Android

Ejecuta el siguiente comando para descargar el árbol del código fuente de Android en tu directorio de trabajo:

$ repo sync -c -j8

El argumento -c le indica a Repo que obtenga la rama actual del manifiesto del servidor. El comando -j8 divide la sincronización en subprocesos para que se completen más rápido.

Esta operación debería tardar un poco más de una hora.

Si tienes algún problema durante una descarga, consulta Cómo solucionar problemas y corregir errores de sincronización.

Cómo descargar objetos binarios patentados

AOSP puede ejecutarse en emuladores Cuttlefish directamente, pero AOSP no puede utilizarse en hardware sin bibliotecas propietarias adicionales específicas del dispositivo. A continuación, te indicamos cómo obtener estos objetos binarios del dispositivo:

  • Si piensas descargar la rama main y compilarla para un dispositivo Nexus o Pixel, descarga los últimos objetos binarios del sitio de vista previa de objetos binarios.
  • Si piensas descargar y compilar la rama main para tu propio dispositivo, debes proporcionar tus objetos binarios específicos del dispositivo.
  • Si piensas descargar y compilar una rama etiquetada que no sea principal para un dispositivo Nexus o Pixel, descarga el objeto binario específico del dispositivo desde Objetos binarios para dispositivos Nexus y Pixel.

Cómo extraer objetos binarios propietarios

Cada conjunto de objetos binarios consiste en una secuencia de comandos de extracción automática incluida en un archivo comprimido. Para extraer y colocar estos objetos binarios en la ubicación correcta de tu árbol del código fuente, haz lo siguiente:

  1. Extrae el archivo.
  2. Ejecuta la secuencia de comandos de shell de extracción automática incluida desde la raíz del árbol del código fuente de AOSP.
  3. Acepta los términos del contrato de licencia incluido. Se instalan los objetos binarios y los archivos makefile correspondientes en la jerarquía vendor/ del árbol del código fuente.

Cómo verificar la legitimidad del código (opcional)

Si te preocupa la legitimidad del código fuente, por ejemplo, si proviene de Google, puedes verificar las etiquetas git de la rama. Para ello, haz lo siguiente:

  1. Copia y pega el siguiente bloque de claves en un archivo de texto, como keyfile.asc.

    -----BEGIN PGP PUBLIC KEY BLOCK-----
Version: GnuPG v1.4.2.2 (GNU/Linux)

mQGiBEnnWD4RBACt9/h4v9xnnGDou13y3dvOx6/t43LPPIxeJ8eX9WB+8LLuROSV
lFhpHawsVAcFlmi7f7jdSRF+OvtZL9ShPKdLfwBJMNkU66/TZmPewS4m782ndtw7
8tR1cXb197Ob8kOfQB3A9yk2XZ4ei4ZC3i6wVdqHLRxABdncwu5hOF9KXwCgkxMD
u4PVgChaAJzTYJ1EG+UYBIUEAJmfearb0qRAN7dEoff0FeXsEaUA6U90sEoVks0Z
wNj96SA8BL+a1OoEUUfpMhiHyLuQSftxisJxTh+2QclzDviDyaTrkANjdYY7p2cq
/HMdOY7LJlHaqtXmZxXjjtw5Uc2QG8UY8aziU3IE9nTjSwCXeJnuyvoizl9/I1S5
jU5SA/9WwIps4SC84ielIXiGWEqq6i6/sk4I9q1YemZF2XVVKnmI1F4iCMtNKsR4
MGSa1gA8s4iQbsKNWPgp7M3a51JCVCu6l/8zTpA+uUGapw4tWCp4o0dpIvDPBEa9
b/aF/ygcR8mh5hgUfpF9IpXdknOsbKCvM9lSSfRciETykZc4wrRCVGhlIEFuZHJv
aWQgT3BlbiBTb3VyY2UgUHJvamVjdCA8aW5pdGlhbC1jb250cmlidXRpb25AYW5k
cm9pZC5jb20+iGAEExECACAFAknnWD4CGwMGCwkIBwMCBBUCCAMEFgIDAQIeAQIX
gAAKCRDorT+BmrEOeNr+AJ42Xy6tEW7r3KzrJxnRX8mij9z8tgCdFfQYiHpYngkI
2t09Ed+9Bm4gmEO5Ag0ESedYRBAIAKVW1JcMBWvV/0Bo9WiByJ9WJ5swMN36/vAl
QN4mWRhfzDOk/Rosdb0csAO/l8Kz0gKQPOfObtyYjvI8JMC3rmi+LIvSUT9806Up
hisyEmmHv6U8gUb/xHLIanXGxwhYzjgeuAXVCsv+EvoPIHbY4L/KvP5x+oCJIDbk
C2b1TvVk9PryzmE4BPIQL/NtgR1oLWm/uWR9zRUFtBnE411aMAN3qnAHBBMZzKMX
LWBGWE0znfRrnczI5p49i2YZJAjyX1P2WzmScK49CV82dzLo71MnrF6fj+Udtb5+
OgTg7Cow+8PRaTkJEW5Y2JIZpnRUq0CYxAmHYX79EMKHDSThf/8AAwUIAJPWsB/M
pK+KMs/s3r6nJrnYLTfdZhtmQXimpoDMJg1zxmL8UfNUKiQZ6esoAWtDgpqt7Y7s
KZ8laHRARonte394hidZzM5nb6hQvpPjt2OlPRsyqVxw4c/KsjADtAuKW9/d8phb
N8bTyOJo856qg4oOEzKG9eeF7oaZTYBy33BTL0408sEBxiMior6b8LrZrAhkqDjA
vUXRwm/fFKgpsOysxC6xi553CxBUCH2omNV6Ka1LNMwzSp9ILz8jEGqmUtkBszwo
G1S8fXgE0Lq3cdDM/GJ4QXP/p6LiwNF99faDMTV3+2SAOGvytOX6KjKVzKOSsfJQ
hN0DlsIw8hqJc0WISQQYEQIACQUCSedYRAIbDAAKCRDorT+BmrEOeCUOAJ9qmR0l
EXzeoxcdoafxqf6gZlJZlACgkWF7wi2YLW3Oa+jv2QSTlrx4KLM=
=Wi5D
-----END PGP PUBLIC KEY BLOCK-----

  2. Ejecuta el siguiente comando para introducir una clave pública en la base de datos de claves de GnuPG. La clave se usa para firmar etiquetas con anotaciones que representan versiones.

    $ gpg --import keyfile.asc

  3. Después de importar las claves, podrás verificar cualquier etiqueta con este comando:

    $ git tag -v TAG_NAME