Google se compromete a impulsar la igualdad racial para las comunidades afrodescendientes. Obtén información al respecto.

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. Asegúrate de tener un directorio bin/ en tu directorio principal y de que esté incluido en la ruta:
  2. mkdir ~/bin
    PATH=~/bin:$PATH
    
  3. Descarga el selector de Repo y asegúrate de que sea ejecutable:
    curl https://storage.googleapis.com/git-repo-downloads/repo > ~/bin/repo
    chmod a+x ~/bin/repo
    
    Si el comando no aparece en la terminal después de este paso, presiona Intro.
  4. De manera opcional, verifica que el selector coincida con las firmas de Google:
    gpg --recv-key 8BB9AD793E8E6153AF0F9A4416530D5E920F5C65
    curl https://storage.googleapis.com/git-repo-downloads/repo.asc | gpg --verify - ~/bin/repo

Repo previo para sistemas heredados de Python 2

Para descargar una versión anterior del Launcher de Repo, usa los siguientes comandos:

curl https://storage.googleapis.com/git-repo-downloads/repo-1 > ~/bin/repo
chmod a+x ~/bin/repo

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.