Skip to content

Most visited

Recently visited

navigation

Crear y administrar dispositivos virtuales

En este documento:

  1. Acerca de los AVD
  2. Visualizar y administrar tus AVD
  3. Crear un AVD
  4. Crear un perfil de hardware
  5. Trabajar con AVD existentes
  6. Trabajar con perfiles de hardware existentes
  7. Ejecutar y detener un emulador, y borrar datos
  8. Importar y exportar perfiles de hardware
  9. Propiedades de perfiles de hardware
  10. Propiedades de AVD
  11. Crear máscaras de emulador

Dependencias y requisitos previos

  • Android Studio 2.0 o versiones posteriores
  • SDK Tools 25.0.10 o versiones posteriores
  • Habilitación de la integración de adb a través de Tools > Android > Enable ADB Integration

La definición de un Android Virtual Device (AVD) te permite definir las características de un teléfono Android, una tablet, o un dispositivo Android Wear o Android TV que desees simular en Android Emulator. El Administrador de AVD te permite crear y administrar AVD fácilmente.

Para probar tu app de manera efectiva, debes crear un AVD que modele cada tipo de dispositivo que tu app pueda admitir. Por ejemplo, te recomendamos crear un AVD para cada nivel de API igual o superior al valor que especificaste para tu minSdkVersion. Al probar con niveles API superiores a los que necesita tu app, garantizas la compatibilidad con versiones posteriores cuando los usuarios descargan actualizaciones de sistema.

Acerca de los AVD

Un AVD contiene un perfil de hardware, una imagen de sistema, un área de almacenamiento y una máscara, entre otras propiedades.

El perfil de hardware define las características de un dispositivo cuando se envía desde la fábrica. El Administrador de AVD viene cargado previamente con determinados perfiles de hardware, como dispositivos de teléfono Nexus, y puedes definir e importar perfiles de hardware cuando sea necesario. Puedes sobrescribir algunas configuraciones en tu AVD, si es necesario.

El Administrador de AVD te permite elegir una imagen de sistema para tu AVD proporcionando recomendaciones: También te permite descargar imágenes de sistema, algunas con bibliotecas de complementos como las API de Google, que puede necesitar tu app. Ten en cuenta que las imágenes de sistema x86 se ejecutan de manera más rápida en el emulador.

El AVD tiene un área dedicada al almacenamiento en tu equipo de desarrollo. Almacena los datos del usuario del dispositivo, como las apps y las configuraciones instaladas, así como también una tarjeta SD emulada.

Una máscara de emulador especifica la apariencia de un dispositivo. El Administrador de AVD proporciona algunas máscaras predefinidas. También puedes definir tus propias máscaras o usar máscaras proporcionadas por terceros.

Al igual que con un dispositivo real, para que las apps usen determinadas funciones definidas en un AVD, como la cámara, este debe tener la correspondiente configuración <uses-feature> en el manifiesto de app.

Visualizar y administrar tus AVD

El Administrador de AVD te permite administrar todos tus AVD en un solo sitio.

Para ejecutar el Administrador de AVD:

Aparece el Administrador de AVD.

Ventana principal del Administrador de AVD

Muestra cualquier AVD que hayas definido. Cuando instales Android Studio por primera vez, crea un AVD. Si definiste los AVD para Android Emulator 24.0.x o versiones anteriores, debes volver a crearlos.

Desde esta página puedes:

Crear un AVD

Puedes crear un AVD nuevo desde el comienzo o duplicar un AVD y cambiar algunas propiedades.

Para crear un AVD nuevo:

  1. Desde la página Your Virtual Devices del Administrador de AVD, haz clic en Create Virtual Device.
  2. Opcionalmente, ejecuta tu app desde Android Studio. En el diálogo Select Deployment Target, haz clic en Create New Emulator.

    Aparecerá la página Select Hardware.

    Página de perfil de hardware del Administrador de AVD
  3. Selecciona un perfil de hardware y haz clic en Next.
  4. Si no ves el perfil de hardware que deseas, puedes crear o importar un perfil de hardware.

    Aparecerá la página de System Image.

    Página System Image del Administrador de AVD
  5. Selecciona la imagen del sistema para un nivel de API particular y luego haz clic en Next.
  6. En la pestaña Recommended aparecen listas de imágenes recomendadas del sistema. En las otras pestañas se incluye una lista más completa. En el panel derecho se describe la imagen de sistema seleccionada. Las imágenes x86 son las que se ejecutan más rápido en el emulador.

    Si visualizas Download junto a la imagen de sistema, debes hacer clic en la opción para descargar la imagen de sistema. Debes estar conectado a Internet para descargarla.

    El nivel de API del dispositivo de destino es importante, ya que tu app no podrá ejecutarse en una imagen de sistema con un nivel de API inferior al que se necesita en tu app, según se especifica en el atributo minSdkVersion del archivo de manifiesto de la app. Para obtener más información sobre la relación entre el nivel de API del sistema y minSdkVersion, consulta el Control de versiones de tus apps.

    Si tu app declara un elemento <uses-library> en el archivo de manifiesto, requerirá una imagen de sistema en la cual se encuentre esta biblioteca. Si deseas ejecutar tu app en un emulador, crea un AVD que incluya la biblioteca obligatoria. Para hacerlo, probablemente debas usar un componente complementario para la plataforma de AVD; por ejemplo, el complemento de las API de Google contiene la biblioteca de Google Maps.

    Aparecerá la página Verify Configuration.

    Página Verify Configuration del Administrador de AVD
  7. Modifica las propiedades de AVD según sea necesario y luego haz clic en Finish.

    Haz clic en Show Advanced Settings para mostrar más configuraciones, como la máscara.

  8. El nuevo AVD aparecerá en la página Your Virtual Devices o en el diálogo Select Deployment Target.

Para crear un AVD a partir de una copia:

  1. Desde la página Your Virtual Devices del Administrador de AVD, haz clic con el botón secundario en un AVD y selecciona Duplicate.
  2. O haz clic en Menu y selecciona Duplicate.

    Aparecerá la página Verify Configuration.

  3. Haz clic en Change o Previous si debes realizar modificaciones en las páginas System Image y Select Hardware.
  4. Realiza tus modificaciones y luego haz clic en Finish.
  5. El AVD aparece en la página Your Virtual Devices.

Crear un perfil de hardware

El Administrador de AVD proporciona perfiles de hardware predefinidos para dispositivos comunes a fin de que puedas agregarlos fácilmente a tus definiciones de AVD. Si debes definir un dispositivo diferente, puedes crear un perfil de hardware nuevo. Puedes establecer un perfil de hardware nuevo desde el principio, o copiar un perfil de hardware para empezar. No es posible editar los perfiles de hardware precargados.

Para crear un perfil de hardware nuevo desde el comienzo:

  1. En la página Select Hardware, haz clic en New Hardware Profile.
  2. En la página Configure Hardware Profile, modifica las propiedades del perfil de hardware según sea necesario.
  3. Haz clic en Finish.
  4. Tu perfil de hardware nuevo aparecerá en la página Select Hardware. Opcionalmente, puedes crear un AVD que use el perfil de hardware haciendo clic en Next. También puedes hacer clic en Cancel para regresar a la página Your Virtual Devices o al diálogo Select Deployment Target.

Para crear un perfil de hardware a partir de una copia:

  1. En la página Select Hardware, selecciona un perfil de hardware y haz clic en Clone Device.
  2. También puedes hacer clic con el botón secundario en un perfil de hardware y seleccionar Clone.

  3. En la página Configure Hardware Profile, modifica las propiedades del perfil de hardware según sea necesario.
  4. Haz clic en Finish.
  5. Tu perfil de hardware nuevo aparecerá en la página Select Hardware. Opcionalmente, puedes crear un AVD que use el perfil de hardware haciendo clic en Next. También puedes hacer clic en Cancel para regresar a la página Your Virtual Devices o al diálogo Select Deployment Target.

Trabajar con AVD existentes

Desde la página Your Virtual Devices, puedes realizar las siguientes operaciones en un AVD existente:

Trabajar con perfiles de hardware existentes

Desde la página Select Hardware, puedes realizar las siguientes operaciones en un perfil de hardware existente:

No puedes editar ni borrar los perfiles de hardware predefinidos.

Ejecutar y detener un emulador, y borrar datos

Desde la página Your Virtual Devices, puedes realizar las siguientes operaciones en un emulador:

Importar y exportar perfiles de hardware

Desde la página Select Hardware, puedes importar y exportar perfiles de hardware:

Propiedades de perfiles de hardware

Puedes especificar las siguientes propiedades de los perfiles de hardware en la página Configure Hardware Profile. Las propiedades de configuración del AVD anulan las propiedades del perfil de hardware, y ambas son anuladas por las propiedades del emulador que estableces mientras este se halla en funcionamiento.

No se pueden editar los perfiles de hardware predefinidos que se incluyen con el Administrador AVD. Sin embargo, puedes copiarlos y editar las copias.

Propiedad del perfil de hardware Descripción
Nombre del dispositivo Nombre del perfil de hardware. El nombre puede contener mayúsculas o minúsculas, números del 0 al 9, puntos (.), guiones bajos (_) y paréntesis ( () ). El nombre del archivo que contiene el perfil de hardware deriva del nombre de este.
Tipo de dispositivo Selecciona una de las siguientes opciones:
  • Teléfono/Tablet
  • Android Wear
  • Android TV
Tamaño de pantalla El tamaño físico de la pantalla, en pulgadas, medidas en diagonal. Si el tamaño es superior al de la pantalla de tu computadora, se reduce en tamaño en el inicio.
Resolución de la pantalla Escribe una medida de ancho y alto en píxeles para especificar el número total de píxeles en la pantalla simulada.
Redondo Selecciona esta opción si el dispositivo tiene una pantalla redonda, como un dispositivo de Android Wear.
Memoria: RAM Escribe un tamaño de memoria RAM para el dispositivo y selecciona las unidades; B (bytes), KB (kilobytes), MB (megabytes), GB (gigabytes) o TB (terabytes).
Entrada: botones de hardware (Atrás/Página principal/Menú). Selecciona esta opción si tu dispositivo tiene botones de navegación de hardware. Anula esta selección si estos botones se implementan únicamente en software. Si seleccionas esta opción, los botones no aparecerán en la pantalla. Puedes usar el panel lateral del emulador para “presionar” los botones, en cualquier caso.
Entrada: teclado de hardware. Selecciona esta opción si tu dispositivo tiene un teclado de hardware. Anula la selección si no lo tiene. Si seleccionas esta opción, no aparecerá un teclado en la pantalla. Puedes usar el teclado de tu computadora para enviar la pulsación de teclas al emulador, en cualquier caso.
Estilo de navegación

Selecciona una de las siguientes opciones:

  • Ninguno: sin controles de hardware. La navegación tiene lugar a través del software.
  • D-pad: compatibilidad con mando de dirección.
  • Bola de seguimiento
  • Rueda

Estas opciones son para controles reales de hardware en el propio dispositivo. Sin embargo, los eventos enviados al dispositivo a través de un controlador externo son los mismos.

Estados de dispositivos compatibles

Selecciona una o ambas opciones:

  • Vertical: orientación de mayor altura que ancho.
  • Horizontal: orientación de mayor ancho que altura.

Si seleccionas ambas orientaciones, puedes intercambiarlas en el emulador. Debes seleccionar al menos una opción para continuar.

Cámaras

Selecciona una o ambas opciones:

  • Cámara frontal: las lentes se orientan hacia el lado opuesto al del usuario.
  • Cámara posterior: las lentes se orientan hacia el usuario.

Luego, puedes usar una cámara web o una foto proporcionada por el emulador para simular que tomas una foto con la cámara.

Sensores: acelerómetro Indica si el dispositivo cuenta con hardware que le permita determinar su orientación.
Sensores: giroscopio Indica si el dispositivo cuenta con hardware que detecte rotación o giros. En combinación con un acelerómetro, puede proporcionar una detección de orientación más fluida y admitir un sistema de orientación de seis ejes.
Sensores: GPS Indica si el dispositivo cuenta con hardware compatible con el sistema de posicionamiento global (GPS) de navegación por satélite.
Sensores: sensor de proximidad Indica si el dispositivo cuenta con hardware que determine si el dispositivo se encuentra cerca de la cara durante una llamada telefónica para deshabilitar entradas desde la pantalla.
Máscara predeterminada Selecciona una máscara que controle la apariencia del dispositivo cuando se muestre en el emulador. Recuerda que especificar un tamaño de pantalla demasiado reducido para la resolución puede hacer que la pantalla quede cortada y no puedas verla completa. Consulta Crear máscaras de emulador para obtener más información.

Propiedades de AVD

Puedes especificar las siguientes propiedades para las configuraciones de AVD en la página Verify Configuration. La configuración de AVD especifica la interacción entre la computadora de desarrollo y el emulador, así como las propiedades que deseas anular en el perfil del hardware.

Las propiedades de configuración del AVD anulan las propiedades del perfil de hardware, y ambas son anuladas por las propiedades del emulador que estableces mientras este se halla en funcionamiento.

Propiedades AVD Descripción
Nombre de AVD Nombre del AVD. El nombre puede contener mayúsculas o minúsculas, números del 0 al 9, puntos (.), guiones bajos (_) y paréntesis ( () ). El nombre del archivo que contiene la configuración de AVD deriva del nombre de este.
ID del AVD (avanzada) El nombre de archivo de AVD deriva del ID y puedes usarlo para hacer referencia al AVD desde la línea de comandos.
Perfil de hardware Haz clic en Change para seleccionar un perfil de hardware diferente en la página Select Hardware.
Imagen de sistema Haz clic en Change para seleccionar una imagen de sistema diferente en la página System Image. Se requiere una conexión activa de Internet para descargar una imagen nueva.
Inicio: escala Selecciona el tamaño inicial que desees usar cuando se inicie el emulador. Este tamaño podría ajustarse a un tamaño más reducido si es superior al de la pantalla de la computadora. El valor predeterminado es “Auto” (automático).
Inicio: orientación

Selecciona una opción para la orientación inicial del emulador:

  • Vertical: orientación de mayor altura que ancho.
  • Horizontal: orientación de mayor ancho que altura.

Se habilita una opción solo si se encuentra seleccionada en el perfil de hardware. Cuando se ejecuta el AVD en el emulador, puedes modificar la orientación si se admiten el formato vertical y horizontal en el perfil de hardware.

Cámara (avanzada)

Selecciona una o ambas opciones:

  • Frontal: la lente se orienta hacia el lado opuesto al del usuario.
  • Posterior: las lentes se orientan hacia el usuario.

Esta opción está disponible solo si se encuentra seleccionada en el perfil de hardware. No está disponible para Android Wear y Android TV.

Red: velocidad (avanzada)

Selecciona un protocolo de red para determinar la velocidad de la transferencia de datos:

  • GSM - Global System for Mobile Communications
  • HSCSD - High-Speed Circuit-Switched Data
  • GPRS - Generic Packet Radio Service
  • EDGE - Enhanced Data rates for GSM Evolution
  • UMTS - Universal Mobile Telecommunications System
  • HSPDA - High-Speed Downlink Packet Access
  • Full (default): transfiere datos tan rápido como lo permite la computadora.
Red: Latencia (avanzada) Selecciona un protocolo de red para establecer el tiempo (demora) necesario para que el protocolo transfiera un paquete de datos de un punto a otro.
Rendimiento emulado: gráficos

Selecciona el modo en que se representan los gráficos en el emulador:

  • Hardware: usa la tarjeta de gráficos de tu computadora para una presentación más rápida.
  • Software: emula los gráficos en el software, que resulta útil si tienes un problema con la representación en tu tarjeta de gráficos.
  • Auto: permite que el emulador decida la mejor opción según tu tarjeta de gráficos.
CPU de núcleo múltiple (avanzada) Selecciona el número de núcleos del procesador en tu computadora que quisieras usar para el emulador. El uso de más núcleos acelera el emulador.
Memoria y almacenamiento: RAM El volumen de memoria RAM en el dispositivo. El fabricante de hardware fija este valor, pero puedes anularlo si es necesario; por ejemplo, para lograr que el emulador funcione más rápido. El aumento de tamaño ocupa más recursos de tu computadora. Escribe un tamaño de memoria RAM y selecciona las unidades; B (bytes), KB (kilobytes), MB (megabytes), GB (gigabytes) o TB (terabytes).
Memoria y almacenamiento: montón de VM Tamaño del montón de VM. El fabricante de hardware fija este valor, pero puedes anularlo si es necesario. Escribe un tamaño de montón y selecciona las unidades; B (bytes), KB (kilobytes), MB (megabytes), GB (gigabytes) o TB (terabytes). Para obtener más información en las MV de Android, consulta Administración de memoria para diferentes máquinas virtuales.
Memory and Storage: almacenamiento interno Espacio disponible de memoria no extraíble en el dispositivo. El fabricante de hardware fija este valor, pero puedes anularlo si es necesario. Escribe un tamaño y selecciona las unidades; B (bytes), KB (kilobytes), MB (megabytes), GB (gigabytes) o TB (terabytes).
Memory and Storage: tarjeta SD Espacio disponible de memoria extraíble para almacenar datos en el dispositivo. Para usar una tarjeta SD administrada por Android Studio, selecciona Studio, escribe un tamaño y selecciona las unidades; B (bytes), KB (kilobytes), MB (megabytes), GB (gigabytes) o TB (terabytes). Se recomiendan como mínimo 100 MB para usar la cámara. Para administrar el espacio en un archivo, selecciona Archivo externo y haz clic en ... para especificar el archivo y la ubicación. Para obtener más información, consulta mksdcard.
Marco de dispositivo: habilitar marco de dispositivo Habilita un marco alrededor de la ventana del emulador que reproduzca la apariencia de un dispositivo real.
Definición de máscara personalizada (avanzada) Selecciona una máscara que controle la apariencia del dispositivo cuando se muestre en el emulador. Recuerda que especificar un tamaño de pantalla demasiado reducido para la resolución puede hacer que la pantalla quede cortada y no puedas verla completa. Consulta Crear máscaras de emulador para obtener más información.
Teclado: habilitar entrada de teclado (avanzado) Selecciona esta opción si deseas usar tu teclado de hardware para interactuar con el emulador. Está deshabilitada para Android Wear y Android TV.

Crear máscaras de emulador

Una máscara de emulador de Android es una colección de archivos que definen los elementos visuales y de control de una pantalla de emulador. Si las definiciones de máscaras disponibles en las configuraciones AVD no cumplen con tus requisitos, puedes crear tu propia definición de máscara personalizada y luego aplicarla a tu AVD.

Cada máscara de emulador contiene:

Para crear y usar una máscara personalizada:

  1. Crea un directorio nuevo en el que guardarás tus archivos de configuración de máscara.
  2. Define la apariencia visual de la máscara en un archivo de texto llamado layout. Este archivo define muchas características de la máscara, como el tamaño y los recursos de imagen para botones específicos. Por ejemplo:
    parts {
        device {
            display {
                width   320
                height  480
                x       0
                y       0
            }
        }
    
        portrait {
            background {
                image background_port.png
            }
    
            buttons {
                power {
                    image  button_vertical.png
                    x 1229
                    y 616
                }
            }
        }
        ...
    }
    
  3. Agrega los archivos de mapas de bits de las imágenes del dispositivo en el mismo directorio.
  4. Especifica configuraciones adicionales de dispositivo específicas de hardware en un archivo hardware.ini para las configuraciones del dispositivo, como hw.keyboard y hw.lcd.density.
  5. Guarda los archivos en la carpeta de máscaras y selecciona el archivo de almacenamiento como una máscara personalizada.

Para obtener información más detallada sobre la creación de máscaras de emulador, consulta la Especificación de archivos de máscaras Android Emulator en el código fuente de las herramientas.

This site uses cookies to store your preferences for site-specific language and display options.

Get the latest Android developer news and tips that will help you find success on Google Play.

* Required Fields

Hooray!

Follow Google Developers on WeChat

Browse this site in ?

You requested a page in , but your language preference for this site is .

Would you like to change your language preference and browse this site in ? If you want to change your language preference later, use the language menu at the bottom of each page.

This class requires API level or higher

This doc is hidden because your selected API level for the documentation is . You can change the documentation API level with the selector above the left navigation.

For more information about specifying the API level your app requires, read Supporting Different Platform Versions.

Take a short survey?
Help us improve the Android developer experience.
(Sep 2017 survey)