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 Flujo de trabajo de control de fuente para obtener un resumen de las acciones habituales, como subir cambios para la revisión.

Git

Git está diseñado para controlar 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 la comunidad de 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 la 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.

Repo consta de dos partes: la primera es el Launcher de Repo, que puedes descargar e instalar desde git-repo-downloads. Se trata de una secuencia de comandos de Python que sabe cómo inicializar el procesamiento y puede descargar la segunda parte: la herramienta Repo completa, incluida en la implementación del código fuente de Android. De forma predeterminada, la herramienta Repo completa está en $SRCDIR/.repo/repo/... y recibe comandos reenviados desde el Launcher de Repo que se descargó.

Repo no está diseñada para reemplazar a Git, sino facilitar el trabajo con Git en el contexto de Android. Usa archivos de manifiesto para agregar proyectos de Git al superproyecto de Android. El comando repo es una secuencia de comandos ejecutable de Python que puedes incluir en cualquier parte de la ruta de acceso. Cuando trabajas con los archivos de origen de Android, usas 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.

Otras herramientas

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.

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.

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

Cómo instalar Repo

Repo es una herramienta que facilita el trabajo con Git en el contexto de Android. Consulta la descripción general de Repo más arriba para conocer su propósito y los vínculos a documentos relacionados.

Repo consta de dos partes: una secuencia de comandos de selector que debes instalar y la herramienta Repo completa con la que se conecta, incluida en una implementación de código fuente. Para instalar Repo, haz lo siguiente:

  1. Asegúrate de tener un directorio bin/ en tu directorio principal y de que esté incluido en la ruta:

    mkdir ~/bin
    PATH=~/bin:$PATH
    
  2. 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
    
  3. De manera opcional, verifica que el selector coincida con nuestras firmas:

    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

Si usas un sistema antiguo sin Python 3.6 ni una versión posterior, descarga una versión anterior del selector de Repo que admita Python 2.7. Esto no funcionará indefinidamente, pero podría ser útil hasta que se actualice tu sistema.

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