Crea o importa un proyecto

Android Studio for Platform (ASfP) te ayuda a configurar tu entorno de desarrollo para el Proyecto de código abierto de Android (AOSP). ASfP se basa en el modelo de espacio de trabajo de IntelliJ y admite tanto la configuración manual como las plantillas de equipo compartibles.

Inicia el asistente de configuración del proyecto

Puedes iniciar el asistente de configuración del proyecto de dos maneras:

  • Desde la pantalla de bienvenida: Haz clic en New Project o Import ASfP Project.
  • Desde un proyecto abierto: En el menú principal, selecciona ASfP > Project > New Project o Import ASfP Project.

Importa desde una plantilla

Si tu equipo comparte un archivo de configuración .asfp-project estándar, puedes inicializar tu espacio de trabajo directamente desde esa plantilla:

  1. En el asistente de configuración del proyecto, selecciona Import from template.
  2. Navega hasta el archivo .asfp-project o .asfp-template YAML compartido y selecciónalo.
  3. Después de que el asistente complete la configuración del proyecto a partir de la plantilla, verifica la ruta de acceso local de Repo checkout y, luego, haz clic en Finish.

Configurar manualmente

Para crear una nueva configuración del proyecto desde cero, haz lo siguiente:

  1. En el asistente de configuración del proyecto, elige configurar el proyecto de forma manual y completa los detalles del proyecto:

    • Repo checkout (rutas de acceso de módulos): Especifica la ruta de acceso absoluta a la raíz de tu Repo checkout de código fuente de AOSP local (por ejemplo, /path/to/aosp).
    • Objetivo de almuerzo: Ingresa el objetivo de almuerzo que usas para la compilación (por ejemplo, aosp_cf_x86_64_phone-aosp_current-userdebug).
    • Nombre del proyecto: Asigna un nombre descriptivo a tu proyecto.
    • Directorios y módulos: Enumera los directorios iniciales o los módulos de Soong que se incluirán en tu proyecto (en relación con la raíz del repositorio, como frameworks/base o packages/apps/Settings).
    • Lenguajes: Si tu flujo de trabajo incluye código de plataforma en C, C++ o Rust, selecciona C o C++ o Rust. Java, Kotlin y Android.bp se incluyen de forma predeterminada.
    • Variables de entorno y opciones de compilación: En el campo Variables de entorno del asistente, agrega las variables de entorno personalizadas que desees, como SOONG_ALLOW_MISSING_DEPENDENCIES=true, y, de manera opcional, selecciona la casilla de verificación Soong Partial Compile (SOONG_PARTIAL_COMPILE) para obtener compilaciones incrementales más rápidas.
  2. Haz clic en Finish. ASfP crea la estructura del proyecto, genera el archivo de configuración .asfp-project en la raíz del proyecto y ejecuta la sincronización inicial.

Comparte o personaliza la configuración de tu proyecto

Después de la configuración inicial, puedes personalizar tu proyecto en cualquier momento editando el archivo .asfp-project (ASfP > Project > Open Config):

  • Agrega o excluye directorios y módulos de Soong.
  • Habilita idiomas adicionales (cpp, rust).
  • Configura marcas y variables de entorno de Soong personalizadas.

Para exportar tu configuración para tus compañeros de equipo, haz clic con el botón derecho en la pestaña .asfp-project y selecciona Exportar a plantilla.

Para obtener más información sobre los parámetros de .asfp-project, los modos de sincronización y las acciones de Android.bp en el editor, consulta Descripción general de proyectos y flujos de trabajo de Soong.