Herramientas de control de código fuente

Para trabajar con código de Android, necesitas usar Git (un sistema de control de versión de código abierto) y Repo (una herramienta de administración de repositorios creada por Google que se ejecuta en Git). Consulta la página Flujo de trabajo de control de fuente para obtener un resumen de las acciones habituales que puedes realizar, como subir cambios para su revisión.

Git

Git controla proyectos grandes que se distribuyen en varios repositorios. Android lo usa para operaciones locales como ramificaciones, confirmaciones, diferencias y ediciones locales. Uno de los desafíos que implicó configurar el proyecto de Android fue encontrar la mejor manera de incluir a la comunidad externa (desde aficionados hasta grandes OEM que crean dispositivos de consumo de venta masiva). Queríamos que se pudieran reemplazar los componentes y que los elementos interesantes tuvieran vida propia aparte de Android. Primero, elegimos un sistema de control de revisiones distribuido y, luego, nos decidimos por Git.

Para obtener más detalles, consulta esta documentación sobre Git.

Repo

Repo unifica los repositorios de Git cuando es necesario, realiza las cargas al sistema de control de revisiones de Gerrit y automatiza partes del flujo de trabajo de desarrollo de Android.

El Launcher de Repo ofrece una secuencia de comandos de Python que inicializa un procesamiento y descarga la segunda parte, la herramienta Repo completa, que se incluye en la implementación del código fuente de Android. De forma predeterminada, se encuentra en $SRCDIR/.repo/repo/... y recibe comandos reenviados desde el Launcher de Repo descargado.

Repo no reemplaza a Git; simplemente facilita el trabajo con Git en el contexto de Android. Usa archivos de manifiesto para agregar proyectos de Git al superproyecto de Android. Puedes colocar el comando repo, que es una secuencia de comandos ejecutable de Python, en cualquier parte de la ruta de acceso. A la hora de trabajar con los archivos de origen de Android, puedes usar Repo para las operaciones en toda la red. Por ejemplo, con un único directorio de trabajo de Repo.

En la mayoría de las situaciones, puedes usar Git en lugar de Repo o combinar comandos de ambos para formar comandos complejos. Sin embargo, usar Repo para operaciones básicas en toda la red facilita considerablemente tu trabajo. Para obtener más información sobre Repo, consulta la Referencia de comandos de Repo, el archivo README de Repo, los hooks de precarga (pruebas) que se pueden habilitar en Repo y la documentación general de AOSP.

Para descargar e instalar el Launcher de Repo de git-repo-downloads, consulta Cómo instalar Repo.

Gerrit

Gerrit es un sistema de revisión de código basado en la Web para proyectos que usan Git. Este sistema fomenta el uso más centralizado de Git, ya que permite a todos los usuarios autorizados enviar cambios, que se fusionan automáticamente si pasan la revisión de código. Además, para facilitar la revisión, Gerrit muestra los cambios uno al lado del otro en el navegador y permite que se incluyan comentarios intercalados.

Busca la interfaz de revisión de Gerrit de Android en android-review.googlesource.com y la interfaz de navegación de código en android.googlesource.com.

La Búsqueda de código fuente público de Android te permite realizar búsquedas en el AOSP sin descargar nada. Puedes usar la Búsqueda de código fuente público para ver el código fuente del AOSP, alternar entre ramas de código abierto y navegar por referencias cruzadas. Si quieres obtener más información, consulta la documentación de la Búsqueda de código fuente público en el sitio de Google Developers.

Otras herramientas

Android Studio es el entorno de desarrollo integrado (IDE) oficial que se usa en el desarrollo de apps para Android.

Android Debug Bridge (ADB) te permite conectar tu estación de trabajo de desarrollo directamente a tu dispositivo Android para poder instalar paquetes y evaluar cambios.

En el caso de Android 10 y versiones posteriores, usa el IDE de IntelliJ con AIDEgen en el desarrollo para la plataforma de Android.

Cómo instalar Repo

Sigue estos pasos para instalar Repo:

  1. Ejecuta estos comandos para usar el paquete oficial de tu distribución de Linux:
      sudo apt-get update
      sudo apt-get install repo
    
    Si esos comandos no funcionaron en tu sistema (por ejemplo, ves que la versión del paquete está desactualizada o no hay un paquete oficial disponible en tu distribución de Linux), instala Repo manualmente con los siguientes comandos:
    export REPO=$(mktemp /tmp/repo.XXXXXXXXX)
    curl -o ${REPO} https://storage.googleapis.com/git-repo-downloads/repo
    gpg --recv-key 8BB9AD793E8E6153AF0F9A4416530D5E920F5C65
    curl -s https://storage.googleapis.com/git-repo-downloads/repo.asc | gpg --verify - ${REPO} && install -m 755 ${REPO} ~/bin/repo
    
  2. Estos comandos configuran un archivo temporal, descargan el repositorio y verifican que la clave proporcionada coincida con la clave requerida. Si esos pasos se realizan correctamente, la instalación continúa.

    Después de la instalación, verifica que repo version informe algo similar a lo siguiente cuando se ejecute en un directorio normal. (Un directorio normal no es parte de un cliente de repositorio; por ejemplo, es tu directorio principal).

  3. Ejecuta este comando:
  4. repo version
  5. Debes recibir un informe similar al siguiente:
  6. <repo not installed>
    repo launcher version 2.15
    (from /usr/bin/repo)
    
    • Si repo launcher version informa 2.15 o un número superior, quiere decir que el número de versión es correcto y que la instalación es adecuada.
    • (from /usr/bin/repo) indica la instalación desde un paquete.
    • (from /home/<>/bin/repo) indica la instalación manual.

Cómo completar la instalación

Siguiente: Para finalizar la instalación de la herramienta Repo completa, consulta Cómo inicializar un cliente de Repo en la página Cómo descargar la fuente.