Cómo probar el código de la plataforma con atest
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
Android Studio for Platform (ASfP) se integra con la herramienta de línea de comandos atest, lo que te permite ejecutar pruebas en tu dispositivo o emulador conectado directamente desde el IDE.
Requisitos previos
- Abre un proyecto de ASfP con tu código fuente de AOSP.
- Compila y, luego, instala tu código correctamente en un dispositivo o emulador.
- Inicializa tu entorno de compilación con
source build/envsetup.sh y lunch.
Cómo ejecutar pruebas
Puedes ejecutar pruebas con atest en ASfP de varias maneras:
Íconos de ejecución en el margen: Haz clic en el ícono Ejecutar play_circle.
junto a una clase o un método de prueba en el editor para ejecutar esa prueba específica.
Menú contextual: Haz clic con el botón derecho en un archivo, una clase o un método de prueba en la ventana Project o en el editor, y selecciona Run 'atest'.
Usa la terminal: Abre la terminal integrada en ASfP (View > Tool Windows > Terminal) y ejecuta comandos de atest directamente. Por ejemplo: bash
atest MyTestModule
atest MyTestClass#myTestMethod.
Consulta los resultados de la prueba
Los resultados de la prueba se muestran en la ventana de herramientas Run dentro de ASfP. En esta ventana, se muestra el progreso de la prueba, el estado de aprobación o falla, y se proporcionan registros y resultados para cada prueba.
Configuraciones de prueba
Cuando ejecutas una prueba desde el margen o el menú de clic derecho, ASfP crea automáticamente una configuración temporal de ejecución o depuración. Puedes modificar y guardar estos parámetros de configuración para volver a ejecutar rápidamente pruebas con opciones o marcas específicas:
- Ve a Run > Edit Configurations.
- Busca la configuración de
atest que deseas modificar o crea una nueva haciendo clic en el botón + y seleccionando atest.
- Especifica el módulo, la clase y el método de prueba, y agrega las opciones de línea de comandos
atest necesarias.
Sugerencias para realizar pruebas
- Pruebas segmentadas: Ejecuta solo las pruebas específicas que necesitas para ahorrar tiempo. Usa el formato
Module:Class#Method o cualquier otro filtro de atest.
- Usa instantáneas del emulador: Para ejecutar pruebas más rápido en emuladores, considera usar instantáneas para volver rápidamente a un estado correcto conocido.
- Verifica los registros: Usa los registros en la ventana de herramientas Ejecutar para diagnosticar cualquier falla en las pruebas.
El contenido y las muestras de código que aparecen en esta página están sujetas a las licencias que se describen en la Licencia de Contenido. Java y OpenJDK son marcas registradas de Oracle o sus afiliados.
Última actualización: 2025-09-05 (UTC)
[[["Fácil de comprender","easyToUnderstand","thumb-up"],["Resolvió mi problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Falta la información que necesito","missingTheInformationINeed","thumb-down"],["Muy complicado o demasiados pasos","tooComplicatedTooManySteps","thumb-down"],["Desactualizado","outOfDate","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Problema con las muestras o los códigos","samplesCodeIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 2025-09-05 (UTC)"],[],[],null,["Android Studio for Platform (ASfP) integrates with the `atest` command-line\ntool, letting you run tests on your connected device or emulator directly from\nthe IDE.\n\nPrerequisites\n\n- Open an ASfP project with your AOSP source code.\n- Successfully build and flash your code to a device or emulator.\n- Initialize your build environment using `source build/envsetup.sh` and `lunch`.\n\nRun tests\n\nYou can run tests using `atest` in ASfP in several ways:\n\n- **Gutter run icons:** Click the **Run** icon play_circle\n\n next to a test class or method in the editor to run that specific test.\n- **Right-click menu:** Right-click on a test file, class, or method in the\n Project window or editor and select **Run 'atest'**.\n\n- **Using the terminal:** Open the integrated terminal in ASfP (**View \\\u003e Tool\n Windows \\\u003e Terminal** ) and run `atest` commands directly. For example: `bash\n atest MyTestModule\n atest MyTestClass#myTestMethod`\n\nView test results\n\nTest results are displayed in the **Run** tool window within ASfP. This window\nshows the test progress, pass or fail status, and provides logs and output for\neach test.\n\nTest configurations\n\nWhen you run a test from the gutter or right-click menu, ASfP automatically\ncreates a temporary run or debug configuration. You can modify and save these\nconfigurations to quickly re-run tests with specific options or flags:\n\n1. Go to **Run \\\u003e Edit Configurations**.\n2. Find the `atest` configuration you want to modify or create a new one by clicking the **+** button and selecting **atest**.\n3. Specify the test module, class, method, and add any necessary `atest` command-line options.\n\nTips for testing\n\n- **Targeted testing:** Run only the specific tests you need to save time. Use the format `Module:Class#Method` or other `atest` filters.\n- **Use emulator snapshots:** For faster test runs on emulators, consider using snapshots to quickly revert to a known good state.\n- **Check logs:** Use the logs in the **Run** tool window to diagnose any test failures."]]
