Segue abaixo um tutorial traduzido do site code.google.com/android que explica em detalhes como instalar o plugin ADT para integrar o Android ao Eclipse e desenvolver aplicações para essa plataforma.
Android oferece um plugin customizado para o Eclipse, chamado ADT (Android Development Tools, Ferramenta de desenvolvimento Android), que foi desenvolvido para fornecer um ambiente poderoso e integrado para a construção de aplicações Android.
O ADT extende os recursos do Eclipse para permitir que você configure rapidamente projetos Android, crie uma aplicação, adicione componentes baseados na API do frameworf Android, depure suas aplicações usando as ferramentas do SDK e até exporte APK assinadas (ou não) distribuir sua aplicação.
Em geral, usar o Eclipse com o ADT é a forma mais recomendada de desenvolver aplicações Android e o jeito mais rápido de começar. Se vicê usa Eclipse, o plugin ADT lhe fornecerá um impulso incrivel no desenvolvimento de aplicações Android.
Para instalar e atualizar o plugin ADT, você pode tirar vantagem do recurso de atualização remota do Eclipse. Configurando um site de atualização, você pode facilmente baixar, instalar e verificar atualizações do ADT. Alternativamente, você pode baixar a última versão do ADT para seu computador como um arquivo local. As seções abaixo fornecem instruções para ambos os metódos.
Preparando para instalação
Se você for desenvolver no Eclipse usando o plugin ADT – o caminho recomendado se você for começar com Android – certifique-se que tem a versão necessária do Eclipse instalada em seu computador (3.4 ou mais recente é recomendado). Se você precisar instalar o Eclipse, você pode baixar desse local:
http://www.eclipse.org/downloads/
Uma versão Java ou RCP do Eclipse é recomendada.
Instalando o Plugin ADT
Após ter instalado o Eclipse, como descrito na seção anterior, siga os passos para baixar o plugin ADT e instalar em seu ambiente Eclipse.
Eclipse 3.4 (Ganymede) | Eclipse 3.5 (Galileo) |
---|---|
* Inicie o Eclipse, então selecione Help > Software Updates…. Na caixa de dialógo que aparece, clique na aba Available Software. * Clique Add Site… * Na caixa de dialogo que aparece, entre a URL abaixo no campo “Location”: https://dl-ssl.google.com/android/eclipse/ Nota: Se você tiver problemas ao obter o plugin, tente usar “http” na URL, no lugar de “https” (https é preferível por razões de segurança). |
* Inicie o Eclipse, então selecione Help > Install New software. * Na caixa de dialogo “Available Software” clique Add… * Na caixa de dialogo que aparece, entre com um nome para o site (por exemplo “Android Plugin”) no campo “Name”. No campo “Location”, entre essa URL: https://dl-ssl.google.com/android/eclipse/ Nota: Se você tiver problemas para obter o plugin, você pode tentar usar “http” na URL, no lugar de “https” (https é preferível por razões de segurança). |
Agora modifique suas preferencia do Eclipse para indicar o diretório do SDK do Android:
- Selecione Window > Preferences… para abrir o painel de Preferências (MacOSX: Eclipse > Preferences).
- Selecione Android do painel a esquerda.
- No painel principal, clique Browser e localize o diretório de sua SDK Android.
- Clique Apply, e depois OK.
Feito! Se você não encontrar nenhum problema, então você está pronto para começar a desenvolver aplicações Android.
Problemas na Instalação do ADT
Se você tiver algum problema para baixar o plugin ADT após seguir os passos acima, aqui estão algumas sugestões para contornar esses problemas:
- Se o Eclipse não encontrar o site remoto contendo o plugin ADT, tente mudar a URL para usar http em lugar de https. Isto é, mude o campo “Location” para:
http://dl-ssl.google.com/android/eclipse/
- Se você estiver atrás de um firewall (como em um ambiente corporativo), certifique-se que você configurou corretamente suas preferencias de proxy no Eclipse. No Eclipse 3.3/3.4 você pode configurar a informação de proxy em Window (no MAcOSX, Eclipse) > Preferences > General > Network Connections.
Se você ainda não conseguir baixar o plugin desta forma, você pode baixar o arquivo zip do plugin e instala-lo manualmente:
- Baixar a versão atual do plugin ADT da tabela abaixo (não extraia ele).
Name Package Size MD5 Checksum ADT 0.9.5 ADT-0.9.5.zip 3372982 bytes 227ec538359fbe417ccde7f0ad614a96 - Siga os passos 1 e 2 descritos acima.
- Na caixa de dialogo Add Site, clique Archive.
- Localize e selecione o arquivo zip.
- Apenas no Eclipse 3.5, entre um nome para o site local (por exemplo “Android Plugin”) no campo “Name”.
- Clique OK.
- Siga os procedimentos restantes de forma analoga ao listado na instalação padrão, começando dos passos 4.
Para atualizar seu plugin uma vez que você instalou usando o arquivo zip, você terá que seguir esses passos novamente ao invés das instruções de atualização padrão.
Outros erros de instalação
Note que existem caracteristicas do ADT que requerem alguns componentes opcionais do Eclipse (por exemplo WST). Se você encontrar algum erro ao instalar o ADT, sua instalação do Eclipse pode não incluir esses componentes. Para informações sobre como adicionar rapidamente componentes ao Eclipsem veja o tópico ADT Installation Error: “requires plug-in org.eclipse.wst.sse.ui”.
Para usuários Linux
Se você de deparar com esse erro durante a instalação do plugin ADT:
An error occurred during provisioning. Cannot connect to keystore. JKS
…significa que sua máquina não tem uma Máquina Virtual java adequada. A instalação do Sun Java 6 resolverá esse problema e você pode então instalar o plugin.
Atualizando o Plugin ADT
De tempos em tempos, uma nova versão do plugin ADT fica disponivel. Siga os passos abaixo para verificar se uma atualização está disponivel e, se estiver, para instalar ela. Para informações sobre novas características do ADT, veja o documento ADT Plugin Notes.
Eclipse 3.4 (Ganymede) | Eclipse 3.5 (Galileo) |
---|---|
|
|
Se você encontrar problemas durante a atualização do ADT, você pode tentar remover o plugin existente e executar uma instalação do zero. Para remover o plugin, siga as instruções do item abaixo. Para reinstalar o plugin, siga as instruções dos itens acima.
Desinstalando o Plugin do ADT
Se você encontrar problemas ao instalar ou atualizar o ADT, você pode tentar remover o plugin existente e executar uma nova instalação. Para remover o plugin, siga os passos:
Eclipse 3.4 (Ganymede) | Eclipse 3.5 (Galileo) |
---|---|
|
|