Herramientas de control de fuente

Trabajar con código de Android requiere el uso de Git (un sistema de control de versiones de código abierto) y Repo (una herramienta de administración de repositorios creada por Google que se ejecuta sobre Git). Consulte la página Flujo de trabajo de control de código fuente para obtener un resumen de las acciones habituales que puede realizar, como cargar cambios para su revisión.

git

Git maneja grandes proyectos que se distribuyen en múltiples repositorios. Android usa Git para operaciones locales como bifurcaciones locales, confirmaciones, diferencias y ediciones. Uno de los desafíos al configurar el proyecto Android fue determinar cómo apoyar mejor a la comunidad externa, desde la comunidad de aficionados hasta los grandes fabricantes de equipos originales que construyen dispositivos de consumo para el mercado masivo. Google quería que los componentes fueran reemplazables y quería que los componentes interesantes tuvieran vida propia, fuera de Android. Google primero eligió un sistema de control de revisiones distribuido y luego lo redujo a Git.

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

repositorio

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

El Repo Launcher proporciona un script de Python que inicializa un pago y descarga la segunda parte, la herramienta Repo completa. La herramienta Repo completa se incluye en la compra del código fuente de Android. Está ubicado, de forma predeterminada, en $SRCDIR/.repo/repo/... y recibe comandos reenviados desde el Repo Launcher descargado.

Repo no reemplaza a Git, solo facilita el trabajo con Git en el contexto de Android. Repo utiliza archivos de manifiesto para agregar proyectos de Git en el superproyecto de Android. Puede colocar el comando repo , que es un script ejecutable de Python, en cualquier lugar de su ruta. Al trabajar con los archivos fuente de Android, puede utilizar Repo para operaciones entre redes, como por ejemplo con un único directorio de trabajo de Repo.

En la mayoría de las situaciones, puede usar Git en lugar de Repo, o mezclar comandos de Repo y Git para formar comandos complejos. Sin embargo, utilizar Repo para operaciones básicas entre redes simplifica mucho el trabajo. Para obtener más detalles sobre Repo, consulte la Referencia de comandos de Repo , el README de Repo , los ganchos de carga previa (pruebas) que se pueden habilitar en Repo y los documentos generales en AOSP .

Para descargar e instalar Repo Launcher desde git-repo-downloads , consulte Instalación de Repo .

Gerrit

Gerrit es un sistema de revisión de código basado en web para proyectos que utilizan Git. Gerrit fomenta un uso más centralizado de Git al permitir que todos los usuarios autorizados envíen cambios, que se fusionan automáticamente si pasan la revisión del código. Además, Gerrit facilita la revisión, mostrando los cambios uno al lado del otro en el navegador y permitiendo comentarios en línea.

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

Búsqueda de código de Android

Android Code Search te permite buscar AOSP sin descargar nada. Puede utilizar Code Search para ver el código fuente de AOSP, cambiar entre ramas de código abierto y navegar por referencias cruzadas. Para obtener más información, consulte el sitio de Google Developers para obtener la documentación de búsqueda de código .

Otras herramientas

Android Studio es el entorno de desarrollo integrado (IDE) oficial para el desarrollo de aplicaciones de Android.

Android Debug Bridge (ADB) le permite conectar su estación de trabajo de desarrollo directamente a su dispositivo Android para que pueda instalar paquetes y evaluar sus cambios.

Para el desarrollo de AOSP, utilice Android Studio for Platform (ASfP) .

Instalación del repositorio

Siga estos pasos para instalar Repo.

1. Ejecute estos comandos para usar el paquete oficial de su distribución de Linux:

     sudo apt-get update
     sudo apt-get install repo
   

   Si esos comandos no funcionaron para su sistema (por ejemplo, ve que la versión del paquete está desactualizada o no hay un paquete oficial disponible en su Distribución de Linux, instale Repo manualmente usando los siguientes comandos:

   export REPO=$(mktemp /tmp/repo.XXXXXXXXX)
   curl -o ${REPO} https://storage.googleapis.com/git-repo-downloads/repo
   gpg --recv-keys 8BB9AD793E8E6153AF0F9A4416530D5E920F5C65
   curl -s https://storage.googleapis.com/git-repo-downloads/repo.asc | gpg --verify - ${REPO} && install -m 755 ${REPO} ~/bin/repo
   

Estos comandos configuran un archivo temporal, descargan el repositorio y verifican que la clave proporcionada coincida con la clave requerida. Si tienen éxito, la instalación continúa.

Nota: Las claves están registradas en claves.openpgp.org y funcionan de forma predeterminada para distribuciones basadas en Debian. Si no puede descargar la clave o si la verificación falla, consulte la documentación de su distribución para usar Gnu Privacy Guard (GPG). Para obtener un recurso adicional, consulte el sitio web de GnuPG .

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

2. Ejecute este comando:

repo version

3. Espere un informe similar a este:

<repo not installed>
repo launcher version 2.15
(from /usr/bin/repo)

• El número repo launcher version que informa como 2.15 o superior indica un número de versión correcto y una instalación adecuada.
• (from /usr/bin/repo) indica instalación desde un paquete.
• (from /home/<>/bin/repo) indica instalación manual.

Completando la instalación

Siguiente: Para completar la instalación completa de la herramienta Repo, consulte Inicialización de un cliente Repo , en la página Descarga del código fuente .