Android Studio for Platform (ASfP) es el entorno de desarrollo integrado (IDE) recomendado para desarrollar la plataforma de Android, incluidos los proyectos de vehículos definidos por software (SDV) del sistema operativo Android Automotive (AAOS). ASfP proporciona un amplio conjunto de herramientas para la edición, compilación, depuración y prueba de código, que incluyen las siguientes:
- Asistencia potenciada por IA (Gemini)
- Compatibilidad con los lenguajes Rust, C o C++ y Java
- Integraciones útiles para el desarrollo de SDV en AAOS (por ejemplo, compatibilidad con el emulador de Cuttlefish y el lenguaje VSIDL)
Cómo instalar Android Studio for Platform
Para instalar ASfP, haz lo siguiente:
Descarga Android Studio for Platform.
Elige la versión que mejor se adapte a tus necesidades:
- Estable: La versión de producción más reciente, recomendada para la mayoría de los usuarios
- Canary: Compilaciones de acceso anticipado con las funciones más recientes, pero potencialmente menos estables
Sigue las instrucciones de instalación que se proporcionan en la página de descarga.
Cómo configurar un proyecto de SDV de AAOS
Para configurar un proyecto de SDV de AAOS, haz lo siguiente:
Verifica que tengas acceso al repositorio de código fuente del SDV de AAOS y que hayas inicializado y sincronizado tu confirmación local. Consulta Descarga, compila y ejecuta para obtener detalles sobre cómo acceder al código fuente y cómo inicializar el repositorio.
Inicia Android Studio for Platform.
Si es la primera vez que usas el SDK, sigue el asistente de configuración para personalizar el entorno de desarrollo.
Crea un proyecto nuevo:
- Si no tienes un proyecto abierto, haz clic en Nuevo en la pantalla de bienvenida.
- Si ya tienes un proyecto abierto, haz clic en Open o selecciona ASfP > Project > Import ASfP Project en el menú.
Completa los detalles de configuración del proyecto en el asistente:
Implementación de Repo: Especifica la ruta de acceso absoluta a la raíz de la implementación local del código fuente del SDV de AAOS (por ejemplo,
/path/to/sdv_source).lunch target: Ingresa el objetivo de inicio adecuado para el desarrollo de SDV de AAOS en Cuttlefish, por ejemplo,
sdv_core_cf-trunk_staging-userdebug. Consulta Cómo elegir un objetivo para ver más objetivos disponibles.Fuentes del proyecto: Enumera los directorios o módulos iniciales que deseas incluir en tu proyecto, o bien haz clic en el ícono de carpeta para abrir el explorador del sistema de archivos y seleccionar los directorios. Seleccionar demasiados directorios o módulos afecta el rendimiento de la indexación y la búsqueda del IDE, por lo que solo debes incluir los directorios o módulos pertinentes.
Compatibilidad con idiomas: Selecciona Rust y C++ como idiomas compatibles.
Nombre del proyecto: Asigna a tu proyecto un nombre descriptivo.
Finaliza la configuración: Haz clic en Finalizar. ASfP crea la estructura del proyecto y el archivo de configuración
.asfp-project.
La ASfP inicia automáticamente un proceso de sincronización inicial. ASfP analiza tu código fuente, resuelve las dependencias con el sistema de compilación de Soong y compila la información necesaria para las funciones de asistencia para el código. Esto puede llevar una cantidad significativa de tiempo, especialmente para la primera sincronización.
Personaliza el proyecto
El archivo .asfp-project en la raíz de tu proyecto permite una mayor personalización.
Puedes editar este archivo para hacer lo siguiente:
- Agregar o quitar directorios y módulos
- Habilita la compatibilidad con otros lenguajes, como C++ o Rust (Java y Kotlin son los lenguajes predeterminados).
- Configura marcas de compilación.
Para realizar cambios en el archivo de configuración, selecciona ASfP > Project > Open Config. Consulta la Descripción general de los proyectos para conocer las opciones de configuración disponibles.
Depura y prueba
Para depurar y probar código en ASfP, consulta Cómo depurar código de la plataforma y Cómo probar código de la plataforma con atest.
Integraciones disponibles
ASfP incluye algunas integraciones útiles para el desarrollo de SDV de AAOS, como la compatibilidad con Cuttlefish y el Protocolo de servidor de lenguaje (LSP) en VSIDL.
Complemento de Cuttlefish
El complemento de Cuttlefish permite a los usuarios crear y ejecutar dispositivos Cuttlefish locales directamente desde ASfP.
Instala el complemento
El complemento de Cuttlefish viene preinstalado con ASfP y no requiere configuración. El complemento requiere que las herramientas de Cuttlefish estén instaladas en el dispositivo. Sigue las instrucciones para instalar las herramientas de Cuttlefish si es necesario.
Cómo crear un dispositivo Cuttlefish
Para crear un dispositivo nuevo, sigue estos pasos:
Para abrir la ventana de herramientas Administrador de dispositivos, selecciona Tools > Device Manager o haz clic en el ícono Running Devices en el panel derecho si el Administrador de dispositivos ya está fijado allí.
Haz clic en el ícono + y selecciona Create Cuttlefish Device.
Configura el nuevo dispositivo Cuttlefish. Puedes crear dispositivos Cuttlefish de dos maneras:
Desde la confirmación del árbol de fuentes de Android local:
- Selecciona la ruta de acceso al destino compilado que corresponde a tu configuración de inicio (consulta Cómo elegir un destino para obtener más detalles).
- Selecciona la ruta de acceso del host.
- De manera opcional, selecciona los parámetros de configuración del dispositivo disponibles o Ninguno para la configuración predeterminada.
Desde la configuración canónica (usa esta opción para crear varios dispositivos a partir de una sola configuración):
- Selecciona la ruta de acceso a la configuración del dispositivo.
- De manera opcional, proporciona cualquier marca de anulación para anular las opciones de configuración.
Espera a que se cree el dispositivo Cuttlefish y se agregue a la lista de dispositivos en ejecución en el Administrador de dispositivos.
Selecciona el dispositivo Cuttlefish en el menú Running Devices.
Puedes iniciar o detener dispositivos Cuttlefish individuales haciendo clic en el ícono de detener o iniciar junto al dispositivo en el Administrador de dispositivos.
Cómo acceder a la página del dispositivo Cuttlefish
El complemento de Cuttlefish tiene una ventana de herramientas que muestra la página Cuttlefish Device, en la que puedes acceder a las funciones de duplicación de pantalla.
Para abrir la ventana de herramientas de Cuttlefish, haz clic en el ícono … en el panel lateral izquierdo y selecciona Cuttlefish. También puedes buscar Cuttlefish en el elemento de menú Help > Find Action.
Protocolo del servidor de lenguaje en VSIDL
En VSIDL, el LSP proporciona un amplio conjunto de funciones del IDE para mejorar tu flujo de trabajo de desarrollo cuando trabajas con archivos VSIDL (con una extensión .vsidl) en ASfP.
Resaltado de sintaxis semántico
El servidor LSP proporciona resaltado de sintaxis para los archivos VSIDL.
Qué hace: Destaca palabras clave (
service_bundle,publisher), campos (package:,message:) y literales.Cómo probarlo: Abre cualquier archivo VSIDL. El archivo está codificado por colores para distinguir las palabras clave estructurales de los identificadores definidos por el usuario.
Diagnóstico en vivo (errores y advertencias)
El servidor del LSP valida los archivos de forma continua y muestra los problemas en tiempo real.
Qué hace: Detecta errores de sintaxis, referencias de tipos no válidas y otros errores en todo el catálogo y sus dependencias.
Cómo probarlo: Introduce un error tipográfico en el nombre de un mensaje (por ejemplo,
TiiirePressure). Aparecerá una línea roja ondulada debajo del error ortográfico. Coloca el cursor sobre la palabra para ver el mensaje de error o consulta la lista completa en la ventana de herramientas Problems que se encuentra en la parte inferior del IDE.
Navegación e inteligencia
Puedes usar las funciones de navegación y de inteligencia para explorar las relaciones entre las diferentes partes de tu catálogo de VSIDL.
Autocompletado: Presiona Control + Espacio para ver sugerencias de palabras clave, mensajes de protobuf, servicios de RPC, temas y canales. Las sugerencias de palabras clave incluyen explicaciones breves y útiles sobre su propósito directamente en el menú de finalización. El LSP también proporciona fragmentos inteligentes para bloques como
publisheroserverpara acelerar tu flujo de trabajo.Ir a una definición: Mantén presionada la tecla Control y haz clic (o presiona Control + B) en una referencia a un mensaje, servicio, tema o canal para ir directamente a su definición de origen, incluso si se encuentra en un archivo .proto o VSIDL diferente.
Buscar referencias: Coloca el cursor en la palabra clave
publisher,subscriber,serveroclient, y presiona Alt + Mayúsculas + F7 para encontrar todas las ocurrencias.Información sobre el desplazamiento del cursor: Mueve el cursor a un tipo o propiedad (o presiona Ctrl + Q). Aparece una información sobre la herramienta que muestra los comentarios de la documentación (si existen).
Características estructurales
El servidor LSP te ayuda a administrar y navegar por la estructura de archivos VSIDL grandes:
Símbolos del documento (esquema): Presiona Control+F12 para ver una sugerencia de navegación rápida o abre la ventana de herramientas Structure (Control+Alt+7) para ver una vista de árbol de todos los paquetes y unidades del archivo.
Plegado de rangos: Haz clic en los íconos > o V en el margen (junto a los números de línea) para contraer o expandir grandes bloques lógicos, como
service_bundleo definiciones de asignación.Formato del documento: Presiona Control + Alt + L para volver a darle formato al archivo automáticamente y crear una sangría y un espaciado coherentes.