Configurando Android Virtual Devices

O conceito de AVD foi criado a partir do SDK 1.5 para auxiliar no desenvolvimento de aplicações Android, para que o emulador possa simular exatamente uma configuração de um celular real, como o HTC G1.

Desta forma é possível criar várias configurações de AVD para testar as aplicações. Por exemplo, se você sabe que sua aplicação deve executar sobre um G1, será necessário criar uma configuração compatível com o SDK 1.1.

Se sua aplicação vai utilizar novos recursos, como o teclado virtual (SDK 1.5), é possível criar um AVD compatível com isto.


Listando configurações disponíveis

Para você saber quais configurações (image targets) estão disponíveis, abra um prompt, navegue até a pasta tools do SDK e digite:

android list targets

No SDK 1.5 o resultado é algo assim:


/android-sdk-windows-1.5_r1/tools>android list targets

Available Android targets:
id: 1
Name: Android 1.1
Type: Platform
API level: 2
Skins: HVGA (default), HVGA-L, HVGA-P, QVGA-L, QVGA-P
id: 2
Name: Android 1.5
Type: Platform
API level: 3
Skins: HVGA (default), HVGA-L, HVGA-P, QVGA-L, QVGA-P
id: 3
Name: Google APIs
Type: Add-On
Vendor: Google Inc.
Description: Android + Google APIs
Based on Android 1.5 (API level 3)
Libraries:
* com.google.android.maps (maps.jar)
API for Google Maps
Skins: QVGA-P, HVGA-L, HVGA (default), QVGA-L, HVGA-P


Nesta lista podemos ver que existem as configurações com id: 1, 2 e 3.

id = 1: Imagem do sistema operacional exatamente como o SDK 1.1 e o suporte aos mapas. Se você deseja total compatibilidade com o SDK 1.1 escolha este.
id = 2: Imagem do sistema operacional exatamente como o SDK 1.5.
id = 3: Imagem do sistema operacional exatamente como o SDK 1.5 + o suporte aos mapas.


Criando um AVD

Depois de escolher qual imagem do sistema você deseja testar a sua aplicação utilize o seguinte comando para criar um AVD:
android create avd [opções]

Ao digitar este comando no prompt é possível visualizar os parâmetros disponíveis, como o nome do AVD, id da configuração escolhida, informações sobre o sdcard, etc.

\android-sdk-windows-1.5_r1\tools>android create avd
Error: The parameters --target, --name must be defined for action 'create avd'

Usage:
android [global options] action [action options]

Global options:
-h --help This help.
-s --silent Silent mode: only errors are printed out.
-v --verbose Verbose mode: errors, warnings and informational messages are printed.

Action "create avd":
Creates a new Android Virtual Device.
Options:
-t --target Target id of the new AVD [required]
-c --sdcard Path to a shared SD card image, or size of a new sdcard for the new AVD
-p --path Location path of the directory where the new AVD will be created
-n --name Name of the new AVD [required]
-f --force Force creation (override an existing AVD)
-s --skin Skin of the new AVD

Desta forma para criar um AVD com o nome G1 e compatível com o SDK 1.1 basta digitar o seguinte comando.

android create avd -n G1 -t 1

Será necessário responder se você deseja criar um perfil customizado do hardware, o padrão é não (no).
Se você escolher sim várias opções serão solicitadas.
A seguir podemos ver a saída do prompt, informando que o AVD com o nome G1 e compatível com o SDK 1.1 foi criado com sucesso.

\android-sdk-windows-1.5_r1\tools>android create avd -n G1 -t 1
Android 1.1 is a basic Android platform.
Do you wish to create a custom hardware profile [no]
>> Created AVD 'G1' based on Android 1.1

Depois que o AVD já foi criado é possível listar todas as configurações:

\android-sdk-windows-1.5_r1\tools>android list avd
Available Android Virtual Devices:
Name: G1
Path: C:\Documents and Settings\ricardo\.android\avd\G1.avd
Target: Android 1.1 (API level 2)
Skin: HVGA



Executando o Emulador

A partir do SDK 1.5 para executar o emulador é necessário informar o AVD com o parâmetro -avd:

\android-sdk-windows-1.5_r1\tools>emulator -avd G1

Note que quando o emulador está executando, no título da janela é exibido o nome do AVD e a porta em que o emulador foi aberto.


Executando o Emulador pelo Eclipse

No Eclipse executar o emulador em determinado AVD é simples. Basta entrar nas propriedades do projeto e selecionar o AVD desejado da lista.

Ao executar o projeto, o emulador vai ser executado com o AVD padrão, ou é possível customizar isto no menu Run -> Run Configurations...


Qual configuração escolher SDK 1.1 ou SDK 1.5 ?

Isto depende do seu projeto. Se você deseja que sua aplicação seja compatível com todos os SDKs é melhor ficar com a configuração 1.1.

Mas se você precisa utilizar algum novo recurso introduzido no SDK 1.5 ou superior é necessário configurar um AVD para isto.

Para visualizar os principais recursos adicionados no SDK 1.5 visite este link:
http://developer.android.com/sdk/preview/features.html