You are on page 1of 69

Conhea o Android Studio

Neste documento
1. Estrutura do projeto
2. Interface do usurio
3. Sistema de compilao Gradle
4. Ferramentas de depurao e perfil
O Android Studio o ambiente de desenvolvimento integrado (IDE) oficial para o desenvolvimento de
aplicativos Android e baseado no IntelliJ IDEA . Alm do editor de cdigo e das ferramentas de desenvolvedor
avanados do IntelliJ, o Android Studio oferece ainda mais recursos para aumentar sua produtividade na
criao de aplicativos Android, como:

Um sistema de compilao flexvel baseado no Gradle

Um emulador rpido com muitos recursos

Um ambiente unificado onde voc pode desenvolver para todos os dispositivos Android

Instant Run para enviar alteraes a aplicativos em execuo sem compilar um novo APK

Modelos de cdigos e integrao com GitHub para ajudar a criar recursos comuns de aplicativos e
importar exemplos de cdigo

Ferramentas e estruturas de teste abrangentes

Ferramentas de verificao de cdigo suspeito para detectar problemas de desempenho, usabilidade e


compatibilidade de verses, entre outros

Compatibilidade com C++ e NDK

Compatibilidade integrada com o Google Cloud Platform, facilitando a integrao do Google Cloud
Messaging e do App Engine

Esta pgina oferece uma introduo aos recursos bsicos do Android Studio. Para ver um resumo das
alteraes mais recentes, consulte Notas da verso do Android Studio.

Estrutura do projeto

Figura 1. Os arquivos do projeto na visualizao do Android.


Cada projeto no Android Studio contm um ou mais mdulos com arquivos de cdigo-fonte e recursos. Os tipos
de mdulos incluem:

Mdulos de aplicativos Android

Mdulos de bibliotecas

Mdulos do Google App Engine

Por padro, o Android Studio exibe os arquivos de projeto na visualizao de projeto Android, como mostrado
na figura 1. Essa visualizao organizada por mdulos para permitir o acesso rpido aos principais arquivos
de origem do projeto.
Todos os arquivos da compilao podem ser vistos no nvel superior em Gradle Scripts e cada mdulo de
aplicativo contm as pastas a seguir:

manifests: contm o arquivo AndroidManifest.xml.

java: contm os arquivos de cdigo-fonte do Java, incluindo o cdigo de teste do JUnit.

res: contm todos os recursos que no so cdigo, como layouts XML, strings de IU e imagens em
bitmap.

A estrutura do projeto Android em disco difere dessa representao simplificada. Para ver a estrutura de
arquivos real do projeto, selecione Project na lista suspensa Project (exibida na figura 1 como Android).
Tambm possvel personalizar a visualizao dos arquivos do projeto para se concentrar em aspectos
especficos do desenvolvimento do aplicativo. Por exemplo, selecionar a visualizaoProblems do projeto exibe
links para os arquivos de origem contendo erros reconhecidos de codificao e sintaxe, como uma tag de
fechamento de elemento XML ausente em um arquivo de layout.

Figura 2. Os arquivos do projeto na visualizao Problemas, mostrando um arquivo de layout com um problema.
Para obter mais informaes, consulte Como gerenciar projetos.

Interface do usurio
A janela principal do Android Studio composta de diversas reas lgicas, identificadas na figura 3.

Figura 3. A janela principal do Android Studio.


1.

A barra de ferramentas permite executar uma grande variedade de aes, incluindo a execuo de
aplicativos e a inicializao de ferramentas do Android.

2.

A barra de navegao ajuda a navegar pelo projeto e a abrir arquivos para edio. Ela oferece uma
visualizao mais compacta da estrutura visvel na janela Project.

3.

A janela do editor o local onde voc cria e modifica cdigo. Dependendo do tipo de arquivo atual, o
editor pode mudar. Por exemplo, ao visualizar um arquivo de layout, o arquivo exibe o Editor de layout.

4.

As janelas de ferramenta permitem acessar tarefas especficas como gerenciamento de projetos,


pesquisa e controle de verses, entre outras. As janelas podem ser expandidas e recolhidas.

5.

A barra de status exibe o status do projeto e do prprio IDE, bem como todos os avisos ou mensagens.

Voc pode organizar a janela principal para obter mais espao na tela ocultando ou movendo barras e janelas
de ferramenta. Tambm possvel usar atalhos de teclado para acessar a maioria dos recursos do IDE.
A qualquer momento, voc pode pesquisar o cdigo-fonte, os bancos de dados, as aes, os elementos da
interface do usurio e assim por diante pressionando duas vezes a tecla Shift ou clicando na lupa no canto
superior direito da janela do Android Studio. Isso pode ser muito til quando, por exemplo, voc quiser localizar
uma determinada ao de IDE e esqueceu a forma de acionamento.

Janelas de ferramentas
Em vez de usar perspectivas predefinidas, o Android Studio segue o contexto e exibe automaticamente as
janelas de ferramentas relevantes de acordo com o trabalho. Por padro, as janelas de ferramentas mais
comuns so fixas na barra de janelas de ferramentas nas bordas da janela de aplicativos.

Para expandir ou recolher uma janela de ferramentas, clique no nome da ferramenta na barra de janelas
de ferramentas. Tambm possvel arrastar, fixar, desafixar, anexar e desanexar janelas de ferramentas.

Para voltar ao layout padro atual de janelas de ferramentas, clique em Window > Restore Default
Layout ou personalize o layout padro clicando em Window > Store Current Layout as Default.

Para mostrar ou ocultar toda a barra de janelas de ferramentas, clique no cone da janela

no canto

inferior esquerdo da janela do Android Studio.

Para localizar uma janela de ferramentas especfica, passe o cursor sobre o cone da janela e selecione
a janela de ferramentas no menu.

Tambm possvel usar atalhos de teclado para abrir janelas de ferramentas. A tabela 1 lista os atalhos para as
janelas mais comuns.

Tabela 1. Atalhos de teclado para algumas janelas de ferramentas teis.


Janela de ferramentas

Windows e Linux

Mac

Projeto

Alt+1

Command+1

Controle de verses

Alt+9

Command+9

Executar

Shift+F10

Control+R

Depurar

Shift+F9

Control+D

Android Monitor

Alt+6

Command+6

Voltar ao editor

Esc

Esc

Ocultar todas as janelas de ferramentas

Control+Shift+F12

Command+Shift+F12

Se voc quiser ocultar todas as barras de ferramentas, janelas de ferramentas e guias do editor, clique em View
> Enter Distraction Free Mode. ODistraction Free Mode ser ativado. Para sair do Distraction Free Mode,
clique em View > Exit Distraction Free Mode.
Voc pode usar Speed Search para pesquisar e filtrar dentro da maioria das janelas de ferramentas no Android
Studio. Para usar Speed Search, selecione a janela de ferramentas e digite a consulta de pesquisa.
Para obter mais dicas, consulte Atalhos de teclado.

Concluso de cdigo

O Android Studio tem trs tipos de concluso de cdigo, que podem ser acessados usando atalhos de teclado.

Tabela 2. Atalhos de teclado para concluso de cdigo.


Tipo

Descrio

Windows e Linux

Conclus

Exibe sugestes bsicas para variveis, tipos, mtodos, expresses e

Control+Space

o bsica

assim por diante. Se voc chamar a concluso bsica duas vezes


seguidas, ver mais resultados, incluindo membros privados e
membros estticos no importados.

Conclus

Exibe opes relevantes de acordo com o contexto. A concluso

inteligente conhece os tipos e os fluxos de dados esperados. Se voc

inteligente

chamar a concluso inteligente duas vezes seguidas, ver mais

Control+Shift+Space

resultados, incluindo cadeias.


Conclus

Conclui a instruo atual, adicionando parnteses, colchetes e chaves

o de

faltantes, formatao, etc.

Control+Shift+Enter

instrues
Tambm possvel executar correes rpidas e mostrar as aes de inteno pressionando Alt+Enter.
Para obter mais informaes sobre a concluso de cdigo, consulte Concluso de cdigo.

Navegao
Veja a seguir algumas dicas para ajud-lo na navegao do Android Studio.

Alterne entre os arquivos acessados recentemente usando a ao Recent Files.


Pressione Control+E (Command+E no Mac) para chamar a ao Recent Files. Por padro, o ltimo arquivo
acessado selecionado. Tambm possvel acessar qualquer janela de ferramentas por meio da coluna
esquerda dessa ao.

Visualize a estrutura do arquivo atual usando a ao File Structure. Chame a ao File Structure
pressionando Control+F12 (Command+F12 no Mac). Essa ao permite navegar rapidamente para
qualquer parte do arquivo atual.

Pesquise e navegue para uma classe especfica no projeto usando a ao Navigate to Class. Chame a
ao pressionando Control+N (Command+Ono Mac). A ao Navigate to Class compatvel com
expresses sofisticadas, incluindo maisculas intermedirias (camel humps), caminhos, navegar para linha e
correspondncia do nome do meio, entre muitas outras. Se voc chamar a ao duas vezes seguidas, ela
mostrar os resultados obtidos das classes do projeto.

Navegue para um arquivo ou pasta usando a ao Navigate to File. Chame a ao Navigate to File
pressionando Control+Shift+N(Command+Shift+O no Mac). Para pesquisar pastas em vez de arquivos,
adicione uma / ao final da expresso.

Navegue para um mtodo ou campo por nome usando a ao Navigate to Symbol. Chame a ao
Navigate to Symbol pressionandoControl+Shift+Alt+N (Command+Shift+Alt+O no Mac).

Encontre todos os fragmentos de cdigo que referenciam a classe, o mtodo, o campo, o parmetro ou
a instruo na posio atual do cursor pressionando Alt+F7.

Estilo e formatao
Durante a edio, o Android Studio aplica automaticamente formatao e estilos como especificado nas
configuraes de estilo do cdigo. Voc pode personalizar as configuraes de estilo do cdigo de acordo com
a linguagem de programao, incluindo a especificao de convenes para tabulao e identao, espaos,
quebras de linha, chaves e linhas em branco. Para personalizar as configuraes de estilo do cdigo, clique
em File > Settings > Editor > Code Style (Android Studio > Preferences > Editor > Code Style no Mac.)
Embora o IDE aplique automaticamente a formatao durante a edio, tambm possvel chamar
explicitamente a ao Reformat Code pressionandoControl+Alt+L (Opt+Command+L no Mac) ou identar
automaticamente todas as linhas pressionando Control+Alt+I (Alt+Option+I no Mac).

Figura 4. Cdigo antes da formatao.

Figura 5. Cdigo aps a formatao.

Conceitos bsicos do controle de verses


O Android Studio compatvel com diversos sistemas de controle de verses (VCSs), incluindo Git, GitHub,
CVS, Mercurial, Subversion e Google Cloud Source Repositories.
Aps importar o aplicativo para o Android Studio, use as opes do menu VCS do Android Studio para ativar a
compatibilidade de VCS com o sistema de controle de verses desejado, criar um repositrio, importar os novos
arquivos para o controle de verses e executar outras operaes de controle de verses:
1.

No menu VCS do Android Studio, clique em Enable Version Control Integration.

2.

No menu suspenso, selecione o sistema de controle de verses a ser associado raiz do projeto e
clique em OK.

Agora, o menu VCS exibe diversas opes de controle de verses, de acordo com o sistema selecionado.

Observao: tambm possvel usar a opo de menu File > Settings > Version Control para definir e
modificar as configuraes do controle de verses

Sistema de compilao Gradle


O Android Studio usa o Gradle como a base do sistema de compilao, com mais recursos especficos do
Android disponibilizados pelo Android Plugin for Gradle. Esse sistema de compilao executado como uma
ferramenta integrada no menu do Android Studio e de forma independente na linha de comando. Voc pode
usar os recursos do sistema de compilao para fazer o seguinte:

Personalizar, configurar e ampliar o processo de compilao.

Criar diversos APKs para o aplicativo, com diferentes recursos, usando o mesmo projeto e os mesmos
mdulos.

Reutilizar cdigo e recursos em diversos conjuntos de origem.

O uso da flexibilidade do Gradle permite que voc faa tudo isso sem modificar os arquivos de origem principais
do aplicativo. O nome dos arquivos de compilao do Android Studio build.gradle. Eles so arquivos de texto
simples que usam sintaxe do Groovy para configurar a compilao com os elementos fornecidos pelo Android
Plugin para Gradle. Cada projeto tem um arquivo de compilao de nvel superior para todo o projeto e arquivos
de compilao de mdulo separados para cada mdulo. Quando voc importa um projeto existente, o Android
Studio gera automaticamente os arquivos de compilao necessrios.
Para saber mais sobre o sistema de compilao e como configur-lo, consulte Configurar sua compilao.

Variaes de compilao
O sistema de compilao pode ajudar a criar verses diferentes do mesmo aplicativo de um nico projeto. Isso
til quando existe uma verso gratuita e uma verso paga do aplicativo ou voc quer distribuir vrios APKs
para configuraes de dispositivo diferentes no Google Play.
Para obter mais informaes sobre a configurao de variaes de compilao, consulte Configurao de
compilaes do Gradle.

Divises de APK
As divises de APK permitem criar eficientemente vrios APKs de acordo com a densidade de tela ou o ABI.
Por exemplo, as divises de APK permitem criar verses hdpi e mdpi separadas de um aplicativo sem que
sejam consideradas variaes diferentes e possibilitam o compartilhamento de configuraes de aplicativo de
teste, javac, dx e ProGuard.
Para obter mais informaes sobre o uso de divises de APK, leia divises de APK.

Reduo de recursos
A reduo de recursos no Android Studio remove automaticamente recursos no utilizados do aplicativo
empacotado e das dependncias de biblioteca. Por exemplo, se o aplicativo usar servios do Google Play para

acessar funcionalidades do Google Drive e no usar o Google Sign-In, a remoo de recursos poder remover
os diversos ativos drawable dos botesSignInButton.
Observao: a reduo de recursos trabalha em conjunto com ferramentas de reduo de cdigo, como
ProGuard.
Para obter mais informaes sobre a reduo de cdigo e recursos, consulte Reduzir cdigo e recursos.

Gerenciar dependncias
As dependncias do projeto so especificadas por nome no arquivo build.gradle. O Gradle se encarrega de
encontrar as dependncias e disponibiliz-las na compilao. Voc pode declarar dependncias de mdulos,
dependncias binrias remotas e locais no arquivo build.gradle. O Android Studio configura os projetos para
usarem por padro o repositrio central do Maven. (Essa configurao est includa no arquivo de compilao
de nvel superior para o projeto.) Para obter mais informaes sobre a configurao de dependncias,
consulte Configurar variaes de compilao.

Ferramentas de depurao e perfil


O Android Studio ajuda a depurar e melhorar o desempenho do cdigo, incluindo ferramentas de depurao em
linha e anlise de desempenho.

Depurao em linha
Use a depurao em linha para melhorar o acompanhamento do cdigo na visualizao do depurador com a
verificao em linha de referncias, expresses e valores de variveis. As informaes de depurao em linha
incluem:

Valores de variveis em linha

Objetos de referncia que referenciam um objeto selecionado

Valores de retorno de mtodos

Expresses de lambda e de operadores

Valores de dicas

Figura 6. Um valor de varivel em linha.

Para ativar a depurao em linha, na janela Debug, clique em Settings

e marque a caixa de seleo Show

Values Inline.

Monitores de desempenho
O Android Studio oferece monitores de desempenho para que voc possa facilmente acompanhar o uso de
memria e CPU do aplicativo, encontrar objetos desalocados, localizar vazamentos de memria, otimizar
desempenho de grficos e analisar solicitaes de rede. Em um aplicativo executando em um dispositivo ou
emulador, abra a janela de ferramentas Android Monitor e clique na guia Monitors.
Para obter mais informaes sobre monitores de desempenho, consulte Android Monitor.

Despejo de pilha
Durante o monitoramento do uso de memria no Android Studio, possvel, ao mesmo tempo, iniciar a coleta
de lixo e despejar a pilha Java para um instantneo de pilha em um arquivo de formato binrio HPROF
especfico do Android. O visualizador de HPROF exibe classes, instncias de cada classe e uma rvore de
referncia para ajudar a acompanhar o uso de memria e localizar vazamentos de memria.
Para obter mais informaes sobre como trabalhar com despejos de pilha, consulte Como despejar e analisar a
pilha do Java.

Rastreador de alocao
O Android Studio permite rastrear a alocao de memria durante o monitoramento do uso de memria. O
rastreamento de alocao de memria permite monitorar onde os objetos so alocados quando determinadas
aes so executadas. O conhecimento dessas alocaes possibilita a otimizao do desempenho e do uso de
memria do aplicativo com ajustes de chamadas de mtodos relacionados a essas aes.
Para obter informaes sobre o rastreamento e a anlise de alocaes, consulte Rastreador de alocao.

Acesso a arquivos de dados


As ferramentas do Android SDK, como Systrace, logcat e Traceview, geram dados de desempenho e
depurao para anlises detalhadas do aplicativo.
Para visualizar os arquivos de dados gerados disponveis, abra a janela de ferramentas Captures. Na lista de
arquivos gerados, clique duas vezes em um arquivo para exibir os dados. Clique com o boto direito do mouse
em qualquer arquivo .hprof para convert-lo para o formato de arquivo .hprofpadro.

Inspees de cdigo
Sempre que o programa for compilado, o Android Studio executar automaticamente verificaes de cdigo
suspeito e outras inspees de IDEconfiguradas para identificar e corrigir facilmente problemas de qualidade
estrutural no cdigo.
A ferramenta Lint verifica os arquivos de origem do projeto Android para localizar possveis erros e
aprimoramentos de otimizao em relao a critrios de preciso, segurana, desempenho, usabilidade,
acessibilidade e internacionalizao.

Figura 7. Os resultados de uma inspeo do Lint no Android Studio.


Alm das verificaes do Lint, o Android Studio tambm executa as inspees de cdigo do IntelliJ e valida
anotaes para otimizar o fluxo de trabalho de codificao.
Para obter mais informaes, consulte Como aprimorar o cdigo com Lint e ferramenta de verificao de cdigo
suspeito.

Anotaes no Android Studio


O Android Studio permite anotaes para variveis, parmetros e valores de retorno para ajudar a detectar
erros, como excees de ponteiros nulos e conflitos de tipos de recursos. O Android SDK Manager empacota a
biblioteca Support-Annotations no Android Support Repository para uso com o Android Studio. O Android Studio
valida as anotaes configuradas durante a inspeo do cdigo.
Para obter mais detalhes sobre as anotaes do Android, consulte Aprimoramento da inspeo do cdigo com
anotaes.

Mensagens de registro
Durante a criao e execuo do aplicativo no Android Studio, voc pode visualizar a sada do adb e
mensagens de registro do dispositivo (logcat) clicando em Android Monitor na parte inferior da janela.
Se voc quiser depurar o aplicativo com o Android Device Monitor, inicialize o Device Monitor clicando
em Tools > Android > Android Device Monitor. O Device Monitor onde voc encontrar o conjunto de
ferramentas DDMS completo para criar o perfil do aplicativo, controlar comportamentos do dispositivo e muito
mais. Ele tambm inclui a ferramenta Hierarchy Viewer para ajudar a otimizar os layouts.

Migrar do Eclipse para o Android


Studio
Neste documento
1. Conceitos bsicos do Android Studio
2. Pr-requisitos de migrao
3. Importao de projetos para o Android Studio
4. Prximas etapas
A migrao de projetos para o Android Studio exige adaptao para uma nova estrutura de projeto, sistema de
compilao e funcionalidades de IDE. Para simplificar o processo de migrao, o Android Studio oferece uma
ferramenta de importao que permite mover rapidamente o cdigo existente para projetos do Android Studio e
arquivos de compilao com base no Gradle.

Conceitos bsicos do Android Studio


Veja a seguir algumas das principais diferenas que voc deve conhecer para preparar a migrao para o
Android Studio.

Organizao de projetos e mdulos


O Android Studio baseado no IDE IntelliJ IDEA. Para conhecer os conceitos bsicos do IDE, como
navegao, concluso de cdigo e atalhos de teclado, consulte Conhea o Android Studio.
O Android Studio no usa espaos de trabalho. Portanto, projetos separados so abertos em janelas distintas
do Android Studio. O Android Studio organiza cdigo em projetos, que contm tudo o que define o aplicativo
Android, de cdigo de origem do aplicativo a configuraes da compilao e cdigo de teste. Cada projeto
contm um ou mais mdulos, que permitem dividir o projeto em unidades distintas de funcionalidade. Os
mdulos podem ser criados, testados e depurados independentemente.
Para obter mais informaes sobre projetos e mdulos do Android Studio, consulte a Viso geral de projetos.

Sistema de compilao baseado no Gradle


O sistema de compilao do Android Studio baseado no Gradle e usa arquivos de configurao de
compilao escritos na sintaxe do Groovy para facilitar a capacidade de ampliao e a personalizao.
Para obter mais informaes sobre como usar e configurar o Gradle, consulte Configurar sua compilao.

Dependncias
As dependncias de biblioteca no Android Studio usam declaraes de dependncia do Gradle e dependncias
do Maven para bibliotecas de origem e binrias locais bem conhecidas com coordenadas do Maven. Para obter
mais informaes, consulte Configurar variaes de compilao.

Cdigo de teste

No Eclipse ADT, testes de instrumentao so escritos em projetos separados e integrados por meio do
elemento <instrumentation> ao arquivo de manifesto. O Android Studio disponibiliza um
diretrio androidTest/ no conjunto de origem principal do projeto para adicionar e manter facilmente o cdigo de
teste de instrumentao na mesma visualizao de projeto. Alm disso, o Android Studio disponibiliza um
diretrio test/ no conjunto de origem principal do projeto para testes locais da JVM.

Pr-requisitos de migrao
Antes de migrar o aplicativo para o Android Studio, revise as etapas a seguir para garantir que o projeto esteja
pronto para converso e verifique se as configuraes de ferramentas necessrias esto no Android Studio:

No Eclipse ADT:

Verifique se o diretrio raiz do Eclipse ADT contm o arquivo AndroidManifest.xml. Alm disso, o
diretrio raiz deve conter os arquivos .project e.classpath do Eclipse ou os diretrios res/ e src/.

Compile o projeto para garantir que as atualizaes mais recentes de espao de trabalho e projeto
sejam salvas e includas na importao.

Transforme em comentrios todas as referncias aos arquivos de biblioteca do espao de trabalho do


Eclipse ADT nos arquivosproject.properties ou.classpath a serem importados. Essas referncias podem
ser adicionadas ao arquivo build.gradle aps a importao. Para obter mais informaes,
consulte Configurar sua compilao.

Pode ser til registrar o diretrio do espao de trabalho, as variveis de caminho e todos os
mapeamentos de caminho reais que podem ser usados para especificar caminhos relativos, variveis e
referncias de recursos vinculados no resolvidos. O Android Studio permite especificar manualmente todos
os caminhos no resolvidos durante o processo de importao.

No Android Studio:

Se ainda no tiver o Android Studio, baixe-o. Se voc j tem o Android Studio, verifique se a verso
estvel mais recente clicando em Help > Check for Updates (no Mac, Android Studio > Check for
Updates).

Como o Android Studio no migra nenhum plug-in de terceiros do Eclipse ADT, anote todos os plug-ins
de terceiros que usa no Eclipse. Voc pode verificar se h recursos equivalentes no Android Studio ou
pesquisar um plug-in compatvel no repositrio de Plug-ins IntelliJ para Android Studio. Use a opo de
menu File > Settings > Plugins para gerenciar plug-ins no Android Studio.

Se voc pretende executar o Android Studio atrs de um firewall, lembre-se de definir as configuraes
de proxy para o Android Studio e o SDK Manager. O Android Studio exige uma conexo com a Internet para
sincronizao do assistente de configurao, acesso a bibliotecas de terceiros, acesso a repositrios
remotos, inicializao e sincronizao do Gradle e atualizaes do Android Studio. Para obter mais
informaes, consulteConfiguraes de proxy.

Importao de projetos para o Android Studio

Voc deve decidir como importar os projetos atuais do Eclipse ADT de acordo com a estrutura:

Se voc tiver vrios projetos relacionados compartilhando o mesmo espao de trabalho no Eclipse ADT,
importe o primeiro projeto como um projetoe adicione os projetos relacionados subsequentes como mdulos
desse projeto.

Se os projetos do Eclipse ADT compartilham dependncias no mesmo espao de trabalho, mas no tm


qualquer outra relao, importe cada projeto do Eclipse ADT individualmente para o Android Studio como um
projeto separado. O Android Studio mantm as dependncias compartilhadas entre os projetos recmcriados como parte do processo de importao.

Importar como um projeto:


1.

Inicie o Android Studio e feche todos os projetos abertos do Android Studio.

2.

No menu do Android Studio, clique em File > New > Import Project.
o

Como alternativa, na tela Welcome, clique em Import project (Eclipse ADT, Gradle, etc.).

3.

Selecione a pasta do projeto do Eclipse ADT com o arquivo AndroidManifest.xml e clique em Ok.

4.

Selecione a pasta de destino e clique em Next.

5.

Selecione as opes de importao e clique em Finish.

6.

O processo de importao solicita que voc migre todas as dependncias de biblioteca e projeto para o
Android Studio e adicione as declaraes de dependncia ao arquivo build.gradle. Consulte Criar uma
biblioteca do Android para obter mais informaes sobre esse processo.
O processo de importao tambm substitui todas as bibliotecas de origem e binrias bem conhecidas e os
arquivos JAR que tm coordenadas Maven conhecidas por dependncias do Maven. Portanto, no mais
necessrio manter essas dependncias manualmente. As opes de importao tambm permitem inserir o
diretrio do espao de trabalho e todos os mapeamentos de caminho reais para lidar com todos caminhos,
variveis de caminho e referncias de recursos vinculados no resolvidos.

7.

O Android Studio importa o aplicativo e exibe o resumo da importao do projeto. Examine o resumo
para obter detalhes sobre a reestruturao do projeto e o processo de importao.

Aps a importao do projeto do Eclipse ADT para o Android Studio, cada pasta de mdulo de aplicativo no
Android Studio conter o conjunto de origem completo para esse mdulo, incluindo os

diretrios src/main/ e src/androidTest/, recursos, arquivo de compilao e manifesto do Android. Antes de


iniciar o desenvolvimento de aplicativos, preciso resolver todos os problemas mostrados no resumo de
importao do projeto para garantir que a reestruturao do projeto e o processo de importao concluram
corretamente.

Importar como mdulo:


1.

Inicie o Android Studio e abra o projeto ao qual quer adicionar o mdulo.

2.

No menu do Android Studio, clique em File > New > Import Module.

3.

Selecione a pasta do projeto do Eclipse ADT com o arquivo AndroidManifest.xml e clique em Ok.

4.

Modifique o nome do mdulo, se quiser, e clique em Next.

5.

O processo de importao solicita que voc migre todas as dependncias de biblioteca e projeto para o
Android Studio e adicione as declaraes de dependncia ao arquivo build.gradle. Para obter mais
informaes sobre a migrao de dependncias de biblioteca e projeto, consulte Criar uma biblioteca do
Android. O processo de importao tambm substitui todas as bibliotecas de origem e binrias bem
conhecidas e os arquivos JAR que tm coordenadas Maven conhecidas por dependncias do Maven.
Portanto, no mais necessrio manter essas dependncias manualmente. As opes de importao
tambm permitem inserir o diretrio do espao de trabalho e todos os mapeamentos de caminho reais para
lidar com todos caminhos, variveis de caminho e referncias de recursos vinculados no resolvidos.

6.

Clique em Finish.

Validar projetos importados


Aps concluir o processo de importao, use as opes de menu Build e Run do Android Studio para compilar o
projeto e verificar a sada. Se o projeto no compilar corretamente, verifique as configuraes a seguir:

Verifique se as verses instaladas das ferramentas correspondem s configuraes do projeto Eclipse


abrindo o SDK Manager (clique no boto Android SDK Manager no Android Studio ou em Tools > Android >
SDK Manager). O Android Studio herda as configuraes do SDK Manager e do JDK do projeto importado
do Eclipse.

Para verificar configuraes adicionais do Android Studio, clique em File > Project Structure e confira o
seguinte:
o

Em SDK Location, verifique se o Android Studio tem acesso aos locais e verses corretos de
SDK, NDK e JDK.

Em Project, verifique a verso do Gradle, a verso do Android Plugin e os repositrios


relacionados.

Em Modules, verifique as configuraes de aplicativo e mdulo, como configurao de


assinatura e dependncias de biblioteca.

Se o projeto depender de outro projeto, verifique se essa dependncia est definida corretamente no
arquivo build.gradle na pasta do mdulo do aplicativo. Para obter mais informaes sobre a definio de
dependncias, consulte Configurar variaes de compilao.

Se, aps verificar essas configuraes, os problemas inesperados persistirem durante a compilao e execuo
do projeto no Android Studio, considere modificar o projeto do Eclipse ADT e reiniciar o processo de importao.
Observao: a importao de um projeto do Eclipse ADT para o Android Studio cria um novo projeto do
Android Studio e no afeta o projeto existente do Eclipse ADT.

Prximas etapas
Dependendo do projeto e do fluxo de trabalho, voc pode querer ler mais sobre uso de controle de verses,
gerenciamento de dependncias, assinatura e empacotamento de aplicativos ou configurao e atualizao do
Android Studio. Para comear a usar o Android Studio, leia Conhea o Android Studio.

Configurar o controle de verses


O Android Studio compatvel com diversos sistemas de controle de verses, incluindo Git, GitHub, CVS,
Mercurial, Subversion e Google Cloud Source Repositories.
Aps importar o aplicativo para o Android Studio, use as opes do menu VCS do Android Studio para ativar a
compatibilidade de VCS com o sistema de controle de verses desejado, criar um repositrio, importar os novos
arquivos para o controle de verses e executar outras operaes de controle de verses:
1.

No menu VCS do Android Studio, clique em Enable Version Control Integration.

2.

Selecione um sistema de controle de verses para associao raiz do projeto no menu suspenso e
clique em OK. Agora, o menu VCS exibe diversas opes de controle de verses, de acordo com o sistema
selecionado.

Observao: tambm possvel usar a opo de menu File > Settings > Version Control para definir e
modificar as configuraes do controle de verses
Para obter mais informaes sobre como trabalhar com o controle de verses, consulte Referncia do controle
de verses do IntelliJ.

Android Support Repository e Google Play Services Repository


Embora o Eclipse ADT use a Android Support Library e a Google Play Services Library, o Android Studio
substitui essas bibliotecas durante o processo de importao pelo Android Support Repository e Google
Repository para manter funcionalidades compatveis e comportar os novos recursos do Android. O Android
Studio adiciona essas dependncias como dependncias do Maven usando as coordenadas conhecidas do
Maven. Portanto, essas dependncias no precisam ser atualizadas manualmente.
No Eclipse, para usar uma biblioteca de suporte, necessrio modificar as dependncias de classpath do
projeto no ambiente de desenvolvimento para cada biblioteca de suporte a ser usada. No Android Studio, no
mais necessrio copiar origens de biblioteca para os projetos. Basta declarar uma dependncia para que a

biblioteca seja baixada e mesclada automaticamente ao projeto. Isso inclui a mesclagem automtica em
recursos, entradas de manifesto, regras de excluso do ProGuard e regras personalizadas de verificao de
cdigo suspeito no momento da compilao. Para obter mais informaes sobre dependncias,
consulte Configurar variaes de compilao.

Assinatura de aplicativos
Se o aplicativo usava um certificado de depurao no Eclipse ADT, o Android Studio continuar a referenciar
esse certificado. Caso contrrio, a configurao de depurao usa o armazenamento de chaves de depurao
gerado pelo Android Studio, com senha conhecida e uma chave padro com senha conhecida, localizado
em $HOME/.android/debug.keystore. O tipo de compilao de depurao definido para usar
automaticamente essa configurao de depurao quando o projeto executado ou depurado no Android
Studio.
Na compilao do aplicativo para lanamento, o Android Studio aplica o certificado de lanamento usado no
Eclipse ADT. Se nenhum certificado de lanamento for localizado durante o processo de importao, adicione a
configurao de assinatura de lanamento ao arquivo build.gradle ou use a opo de menu Build > Generate
Signed APK para abrir o Generate Signed APK Wizard. Para obter mais informaes sobre como assinar o
aplicativo, consulte Assinatura de aplicativos.

Ajustar o tamanho mximo de pilha do Android Studio


Por padro, o tamanho mximo de pilha do Android Studio 1.280 MB. Se voc estiver trabalhando em um
projeto grande ou se o sistema tiver bastante RAM disponvel, ser possvel melhorar o desempenho
aumentando o tamanho mximo da pilha nas opes de VM do Android Studio.
Para obter mais informaes sobre a definio de configuraes do Android Studio, consulte Configurar o
Android Studio e Configurao do Android Studio.

Atualizaes de software
O Android Studio atualizado separadamente do plug-in do Gradle, das ferramentas de compilao e das
ferramentas do SDK. Voc pode especificar quais verses quer usar com Android Studio.
Por padro, o Android Studio oferecer atualizaes automticas sempre que uma nova verso estvel for
lanada. No entanto, possvel optar por atualizaes mais frequentes e tambm receber verses de
visualizao ou beta.
Para obter mais informaes sobre a atualizao do Android Studio e o uso de verses de visualizao e beta,
consulte Fique atualizado.

Configurar o Android Studio


Neste documento
1. Configuraes de proxy
O Android Studio oferece assistentes e modelos para verificar os requisitos de sistema, como o Java
Development Kit (JDK) e a RAM disponvel, e para definir configuraes padro, como uma emulao de
Android Virtual Device (AVD) otimizada padro e imagens de sistema atualizadas. Este documento descreve as
definies de configurao adicionais que voc poder usar para personalizar o uso do Android Studio.
Para obter documentao especfica sobre o emulador e a configurao e uso de dispositivos,
consulte Gerenciamento de dispositivos virtuais, Usar dispositivos de hardware e Drivers USB OEM.

Configuraes de proxy
Os proxies atuam como pontos de conexo intermedirios entre clientes HTTP e servidores web que adicionam
segurana e privacidade s conexes com a Internet.
Para permitir a execuo do Android Studio atrs de um firewall, defina as configuraes de proxy para o IDE e
o SDK Manager do Android Studio. Use a pgina de configuraes Android Studio IDE HTTP Proxy para definir
as configuraes de proxy HTTP para Android Studio. O SDK Manager tem uma pgina separada de
configuraes HTTP Proxy.
Para executar o Android Plugin para Gradle na linha de comando ou em mquinas em que o Android Studio no
esteja instalado, como servidores de integrao contnua, defina as configuraes do proxy no arquivo de
compilao do Gradle.
Observao: Aps a instalao inicial do pacote do Android Studio, ele poder ser executado com acesso
Internet ou off-line. No entanto, o Android Studio exige uma conexo com a Internet para sincronizao do
assistente de configurao, acesso a bibliotecas de terceiros, acesso a repositrios remotos, inicializao e
sincronizao do Gradle e atualizaes de verso do Android Studio.

Configurar o proxy do Android Studio


O Android Studio oferece configuraes de proxy HTTP para permitir a execuo do Android Studio atrs de um
firewall ou rede segura. Para definir as configuraes de proxy HTTP no Android Studio:
1.

No menu principal, selecione File > Settings > Appearance & Behavior -- System Settings -- HTTP
Proxy.

2.

No Android Studio, abra a caixa de dilogo IDE Settings.


o

No Windows e no Linux, selecione File > Settings > IDE Setting -- HTTP Proxy.

No Mac, selecione Android Studio > Preferences > IDE Setting -- HTTP Proxy.

exibida a pgina HTTP Proxy.


3.

Selecione auto-detection para usar um URL de autoconfigurao para definir as configuraes de


proxy ou manual para inserir cada uma das configuraes. Para obter uma explicao detalhada dessas
configuraes, consulte Proxy HTTP.

4.

Clique em Apply para ativar as configuraes de proxy.

Configuraes de proxy HTTP para o Android Plugin para Gradle


Para executar o Android Plugin na linha de comando ou em mquinas em que o Android Studio no esteja
instalado, defina as configuraes do proxy para o Android Plugin para Gradle no arquivo de compilao do
Gradle.
Para configuraes de proxy HTTP especficas de aplicativos, defina as configuraes de proxy no
arquivo build.gradle de acordo com cada mdulo do aplicativo.
apply plugin: 'com.android.application'
android {
...
defaultConfig {
...
systemProp.http.proxyHost=proxy.company.com
systemProp.http.proxyPort=443
systemProp.http.proxyUser=userid
systemProp.http.proxyPassword=password
systemProp.http.auth.ntlm.domain=domain
}
...
}

Para configuraes de proxy HTTP para todo o projeto, defina as configuraes de proxy no
arquivo gradle/gradle.properties.
# Project-wide Gradle settings.
...
systemProp.http.proxyHost=proxy.company.com
systemProp.http.proxyPort=443
systemProp.http.proxyUser=username
systemProp.http.proxyPassword=password
systemProp.http.auth.ntlm.domain=domain
systemProp.https.proxyHost=proxy.company.com
systemProp.https.proxyPort=443
systemProp.https.proxyUser=username
systemProp.https.proxyPassword=password
systemProp.https.auth.ntlm.domain=domain
...

Para obter informaes sobre o uso de propriedades do Gradle para configuraes de proxy, consulte o Guia do
usurio do Gradle.
Description

Windows/Linux

Mac

Save all

Control + S

Command + S

Synchronize

Control + Alt + Y

Command + Option + Y

Maximize/minimize editor

Control + Shift + F12

Control + Command + F12

Add to favorites

Alt + Shift + F

Option + Shift + F

Inspect current file with current profile

Alt + Shift + I

Option + Shift + I

Quick switch scheme

Control + ` (backquote)

Control + ` (backquote)

Open settings dialogue

Control + Alt + S

Command + , (comma)

Open project structure dialog

Control + Alt + Shift + S

Command + ; (semicolon)

Switch between tabs and tool window

Control + Tab

Control + Tab

Search everything (including code and menus)

Press Shift twice

Press Shift twice

Find

Control + F

Command + F

Find next

F3

Command + G

Find previous

Shift + F3

Command + Shift + G

Replace

Control + R

Command + R

General

Navigating and Searching Within Studio

Find action

Control + Shift + A

Command + Shift + A

Search by symbol name

Control + Alt + Shift + N

Command + Option + O

Find class

Control + N

Command + O

Find file (instead of class)

Control + Shift + N

Command + Shift + O

Find in path

Control + Shift + F

Command + Shift + F

Open file structure pop-up

Control + F12

Command + F12

Navigate between open editor tabs

Alt + Right/Left Arrow

Control + Right/Left Arrow

Jump to source

F4 / Control + Enter

F4 / Command + Down Arrow

Open current editor tab in new window

Shift + F4

Shift + F4

Recently opened files pop-up

Control + E

Command + E

Recently edited files pop-up

Control + Shift + E

Command + Shift + E

Go to last edit location

Control + Shift +

Command + Shift + Backspace

Backspace

Close active editor tab

Control + F4

Command + W

Return to editor window from a tool window

Esc

Esc

Hide active or last active tool window

Shift + Esc

Shift + Esc

Go to line

Control + G

Command + L

Open type hierarchy

Control + H

Control + H

Open method hierarchy

Control + Shift + H

Command + Shift + H

Open call hierarchy

Control + Alt + H

Control + Option + H

Alt + Insert

Command + N

Override methods

Control + O

Control + O

Implement methods

Control + I

Control + I

Surround with (if...else / try...catch / etc.)

Control + Alt + T

Command + Option + T

Delete line at caret

Control + Y

Command + Backspace

Collapse/expand current code block

Control + minus/plus

Command + minus/plus

Collapse/expand all code blocks

Control + Shift +

Command + Shift + minus/plus

Writing Code

Generate code (getters, setters, constructors,


hashCode/equals, toString, new file, new class)

minus/plus

Duplicate current line or selection

Control + D

Command + D

Basic code completion

Control + Space

Control + Space

Smart code completion (filters the list of methods

Control + Shift + Space

Control + Shift + Space

Complete statement

Control + Shift + Enter

Command + Shift + Enter

Quick documentation lookup

Control + Q

Control + J

Show parameters for selected method

Control + P

Command + P

and variables by expected type)

Go to declaration (directly)

Control + B or Control +

Command + B or Command + Click

Click

Go to implementations

Control + Alt + B

Command + Alt + B

Go to super-method/super-class

Control + U

Command + U

Open quick definition lookup

Control + Shift + I

Command + Y

Toggle project tool window visibility

Alt + 1

Command + 1

Toggle bookmark

F11

F3

Toggle bookmark with mnemonic

Control + F11

Option + F3

Comment/uncomment with line comment

Control + /

Command + /

Comment/uncomment with block comment

Control + Shift + /

Command + Shift + /

Select successively increasing code blocks

Control + W

Option + Up

Decrease current selection to previous state

Control + Shift + W

Option + Down

Move to code block start

Control + [

Option + Command + [

Move to code block end

Control + ]

Option + Command + ]

Select to the code block start

Control + Shift + [

Option + Command + Shift + [

Select to the code block end

Control + Shift + ]

Option + Command + Shift + ]

Delete to end of word

Control + Delete

Option + Delete

Delete to start of word

Control + Backspace

Option + Backspace

Optimize imports

Control + Alt + O

Control + Option + O

Project quick fix (show intention actions and

Alt + Enter

Option + Enter

Reformat code

Control + Alt + L

Command + Option + L

Auto-indent lines

Control + Alt + I

Control + Option + I

Indent/unindent lines

Tab/Shift + Tab

Tab/Shift + Tab

Smart line join

Control + Shift + J

Control + Shift + J

Smart line split

Control + Enter

Command + Enter

Start new line

Shift + Enter

Shift + Enter

Next/previous highlighted error

F2 / Shift + F2

F2 / Shift + F2

Build

Control + F9

Command + F9

Build and run

Shift + F10

Control + R

Debug

Shift + F9

Control + D

Step over

F8

F8

Step into

F7

F7

quick fixes)

Build and Run

Debugging

Smart step into

Shift + F7

Shift + F7

Step out

Shift + F8

Shift + F8

Run to cursor

Alt + F9

Option + F9

Evaluate expression

Alt + F8

Option + F8

Resume program

F9

Command + Option + R

Toggle breakpoint

Control + F8

Command + F8

View breakpoints

Control + Shift + F8

Command + Shift + F8

Copy

F5

F5

Move

F6

F6

Safe delete

Alt + Delete

Command + Delete

Rename

Shift + F6

Shift + F6

Change signature

Control + F6

Command + F6

Inline

Control + Alt + N

Command + Option + N

Extract method

Control + Alt + M

Command + Option + M

Extract variable

Control + Alt + V

Command + Option + V

Extract field

Control + Alt + F

Command + Option + F

Extract constant

Control + Alt + C

Command + Option + C

Refactoring

Extract parameter

Control + Alt + P

Command + Option + P

Commit project to VCS

Control + K

Command + K

Update project from VCS

Control + T

Command + T

View recent changes

Alt + Shift + C

Option + Shift + C

Open VCS popup

Alt + ` (backquote)

Control + V

Version Control / Local History

Observao: Ao usar o Android Studio, as definies da pgina de configuraes Android Studio IDE HTTP
Proxy modificam as configuraes de proxy HTTP no arquivo gradle.properties.

Configuraes de proxy HTTP do SDK Manager


As configuraes de proxy do SDK Manager permitem ativar o acesso internet via proxy para atualizaes de
pacotes e bibliotecas do Android com base em pacotes do SDK Manager.
Para definir as configuraes do SDK Manager para acesso Internet via proxy, inicie o SDK Manager e abra a
pgina SDK Manager.

No Windows, selecione Tools > Options na barra de menus.

No Mac e no Linux, selecione Tools > Options na barra de menus do sistema.

A pgina Android SDK Manager exibida. Insira as configuraes e clique em Apply.

Keyboard Shortcuts
Android Studio includes keyboard shortcuts for many common actions. Table 1 shows the default keyboard
shortcuts by operating system.
Note: In addition to the default keymaps in table 1 below, you can select from a number of preset keymaps or
create a custom keymap. For more about customizing your keyboard shortcuts, see Configure Custom
Keymaps, below.

Table 1. Default keyboard shortcuts for Windows/Linux and Mac operating systems.

Configure Custom Keymaps


You can choose from a number of preset keymaps or modify a preset keymap to create a new custom keymap
in the keymap settings for Android Studio.
To open the keymap settings, click File > Settings > Keymap (on Mac, File > Properties > Keymap).

Figure 1. The Android Studio keymap settings window.

1.

Keymaps dropdown: Delect the desired keymap from this menu to switch between preset keymaps.

2.

Actions list: Right click on an action to modify it. You can add additional keyboard shortcuts for the
action, add mouse shortcuts to associate an action with a mouse click, or remove current shortcuts. If you
are using a preset keymap, modifying an actions shortcuts will automatically create a copy of the keymap
and add your modifications to the copy.

3.

Copy button: Select a keymap from the dropdown menu to use as a starting point, and click Copy to
create a new custom keymap. You can modify the keymap name and shortcuts.

4.

Reset button: Select a keymap from the dropdown menu and click Reset to revert it to its original
configuration.

5.

Search box: Type here to search for a keyboard shortcut by the action name.

6.

Search by Shortcut: Click Find Actions by Shortcut and type a shortcut to search for actions by
shortcut.

Atualizar o IDE e o SDK Tools


Neste documento
1. Atualize o IDE e altere os canais
2. Atualize as ferramentas com o SDK Manager
1. Pacotes recomendados
2. Editar ou adicionar sites de ferramentas do SDK
Aps instalar o Android Studio, fcil manter o IDE do Android Studio e as ferramentas do Android SDK
atualizados com atualizaes automticas e o Android SDK Manager.

Atualize o IDE e altere os canais


O Android Studio usa uma pequena caixa de dilogo em balo para notificar a disponibilidade de atualizaes
para o IDE. No entanto, voc pode verificar manualmente a existncia de atualizaes clicando
em Help > Check for Update (no Mac, Android Studio > Check for Updates).
As atualizaes do Android Studio esto disponveis nos canais de verses a seguir:

Canal Canary: verses de vanguarda absoluta, atualizadas aproximadamente uma vez por semana.
Embora essas compilaes estejam sujeitas a mais erros, elas so testadas e queremos oferecer acesso
antecipado para que voc possa experimentar novos recursos e enviar seus comentrios. Esse canal no
recomendado para desenvolvimento de produo.

Canal do desenvolvedor: compilaes canary, escolhidas individualmente e aprovadas em uma


rodada completa de testes internos.

Canal beta: compilaes candidatas a lanamento baseadas em compilaes canary, lanadas para
obter comentrios antes de serem disponibilizadas no canal estvel.

Canal estvel: a verso estvel oficial disponvel para download em developer.android.com/studio.

Por padro, o Android Studio oferece atualizaes do canal estvel. Se voc quiser tentar uma das outras
verses do Android Studio, conhecidas coletivamente como canais de visualizao, poder optar por receber
atualizaes de um desses canais.
Para alterar o canal de atualizao, faa o seguinte:
1.

Abra a janela Preferences clicando em File > Settings (no Mac, Android Studio > Preferences).

2.

No painel esquerda, clique em Appearance & Behavior > System Settings > Updates.

3.

Verifique se a opo Automatically check for updates est marcada e selecione um canal na lista
suspensa (consulte a figura 1).

4.

Clique em Apply ou OK.

Figura 1. As preferncias de atualizao do Android Studio.

Se voc quiser experimentar um dos canais de visualizao (canary, desenvolvimento ou beta) sem deixar de
usar a compilao estvel para os projetos de produo do Android, poder instalar com segurana uma
segunda verso do Android Studio baixando a verso de visualizao detools.android.com.

Atualize as ferramentas com o SDK Manager


O Android SDK Manager oferece ferramentas, plataformas e outros componentes do SDK necessrios para
desenvolver aplicativos.

Para abrir o SDK Manager, clique em Tools > Android > SDK Manager ou clique em SDK Manager

na barra de ferramentas.
Quando uma atualizao estiver disponvel para um dos seus pacotes, ser exibido um trao

na caixa de

seleo ao lado do pacote.

Para atualizar um item ou instalar um item novo, clique na caixa de seleo para que ela exiba uma
marca de verificao.

Para desinstalar um pacote, clique na caixa de seleo para desmarc-la.

As atualizaes pendentes so indicadas na coluna esquerda com um cone de download


pendentes so indicadas com uma cruz vermelha

. As remoes

Para atualizar os pacotes selecionados, clique em Apply ou OK e concorde com os contratos de licena.

Figura 2. O Android SDK Manager.

Pacotes recomendados
Voc deve considerar cuidadosamente as ferramentas a seguir na guia SDK Tools:
Android SDK Build Tools
Obrigatrio. Inclui ferramentas para compilar aplicativos Android. Consulte as notas da verso do SDK
Build Tools.
Android SDK Platform-tools
Obrigatrio. Inclui diversas ferramentas necessrias para a plataforma Android, incluindo a
ferramenta adb.
Android SDK Tools
Obrigatrio. Inclui ferramentas essenciais como Android Emulator e ProGuard. Consulte as notas da
verso do SDK Tools.
Android Support Repository
Recomendado. Inclui o repositrio Maven local para as bibliotecas de suporte, que oferecem um
conjunto ampliado de APIs compatvel com a maioria das verses do Android. O repositrio
necessrio para produtos como Android Wear, Android TV e Google Cast. Para obter mais informaes,
leia Biblioteca de suporte.
Google Repository
Recomendado. Inclui o repositrio Maven local para as bibliotecas do Google, que oferecem diversos
recursos e servios para aplicativos, incluindo Firebase, Google Maps e conquistas e placares de
lderes de jogos, entre muitos outros.
Na guia SDK Platforms, tambm necessrio instalar pelo menos uma verso
da plataforma Android. Cada verso oferece diversos pacotes diferentes. Para
baixar apenas os pacotes necessrios, clique na caixa de seleo ao lado do
nome da verso.
Para ver todos os pacotes disponveis para cada plataforma Android, clique
em Show Package Details na parte inferior da janela. Em cada verso de
plataforma, voc encontrar os pacotes a seguir:
Android SDK Platform
Obrigatrio. Pelo menos uma plataforma necessria no seu ambiente para que voc possa compilar
o aplicativo. Para fornecer a melhor experincia do usurio nos dispositivos mais recentes, use a ltima

verso de plataforma como alvo de compilao. Ainda ser possvel executar o aplicativo em verses
anteriores. No entanto, para execuo na verso mais recente do Android, ser necessrio compil-lo
com a verso mais recente da plataforma para usar os novos recursos.
Intel ou ARM System Images
Recomendado. A imagem de sistema necessria para executar o Android Emulator. Cada verso de
plataforma contm as imagens de sistema compatveis. Voc tambm pode baixar imagens de sistema
posteriormente durante a criao de Android Virtual Devices (AVDs) no AVD Manager. Selecione Intel
ou ARM de acordo com o processador do computador de desenvolvimento.
Observao: Se voc pretende usar APIs do Google Play Services, deve usar a Google APIs System
Image.
A lista acima no abrangente e voc pode adicionar outros sites para baixar pacotes adicionais de terceiros.
Em alguns casos, um pacote SDK pode exigir uma reviso mnima especfica de outra ferramenta. Nesse caso,
o SDK Manager exibe uma notificao com um aviso e adiciona as dependncias sua lista de downloads.
Dica: voc tambm pode personalizar o arquivo build.gradle para que cada projeto use uma cadeia de
compilao e opes de compilao especficas. Para obter mais informaes, consulte Configurao de
compilaes do Gradle.

Editar ou adicionar sites de ferramentas do SDK


Para gerenciar em que sites de SDK o Android Studio verifica a existncia de atualizaes de ferramentas do
Android e de terceiros, clique na guia SDK Update Sites. Voc pode adicionar outros sites que hospedam
ferramentas prprias e baixar pacotes desses sites.
Por exemplo, uma operadora de celular ou fabricante de dispositivos pode oferecer bibliotecas de API
adicionais que so compatveis com dispositivos prprios que executam Android. Para desenvolver usando
essas bibliotecas, voc pode instalar o pacote do Android SDK desses terceiros adicionando o URL de suas
ferramentas de SDK ao SDK Manager na guia SDK Update Sites.
Se uma operadora ou fabricante de dispositivos hospedar um arquivo repositrio de complementos do SDK em
seu prprio site, siga estas etapas para adicionar esse site ao Android SDK Manager:
1. Clique na guia SDK Update Sites.
2. Clique em Add

na parte inferior da janela.

3. Insira o nome e o URL do site do terceiro e clique em OK.


4. Verifique se a caixa de seleo est marcada na
coluna Enabled.
5. Clique em Apply ou OK.
Os pacotes de SDK disponveis no site aparecero na guia SDK
Platforms ou SDK Tools, conforme o caso.

Basics desenvolvedor de fluxo de trabalho


O fluxo de trabalho para desenvolver um aplicativo para Android conceitualmente o mesmo que outras
plataformas de aplicativos. No entanto, para construir com eficincia um aplicativo bem projetado para o
Android, voc precisa de algumas ferramentas especializadas. A lista a seguir fornece uma viso geral do
processo para criar um aplicativo Android e inclui links para algumas ferramentas Android estdio voc deve
usar durante cada fase de desenvolvimento.

1.

Configure o seu espao de trabalho


Esta a fase que voc provavelmente j terminou: Install Android Studio e criar um projeto.
Para uma explicao passo a passo com o Android Studio que ensina alguns fundamentos de
desenvolvimento do Android, tambm confira o guia para a construo de sua primeira aplicao.

2.

Faa a sua aplicao


Agora voc pode comear a trabalhar. Estdio Android inclui uma variedade de ferramentas e inteligncia
para ajud-lo a trabalhar mais rpido, escrever cdigo de qualidade, projetar uma interface de usurio, e
criar recursos para diferentes tipos de dispositivos. Para mais informaes sobre as ferramentas e recursos
disponveis, consulte Escrever sua App.

3.

Criar e executar
Durante esta fase, voc constri o seu projeto em um pacote APK debuggable que voc pode instalar e
executar no emulador ou um dispositivo Android. Para mais informaes sobre como executar o seu cdigo,
consulte Criar e executar o aplicativo.
Voc tambm pode comear a personalizar a sua construo. Por exemplo, voc pode criar variantes de
construo que produzem diferentes tipos de APKs do mesmo projeto, e encolher seu cdigo e recursos
para tornar o seu arquivo APK menor. Para uma introduo ao personalizar sua compilao, consulte
Configurar a sua construo.

4.

Debug, perfil e teste


Esta a fase iterativa em que voc continuar a escrever o aplicativo, mas com um foco na eliminao de
erros e otimizar o desempenho do aplicativo. claro, os testes criando ir ajud-lo nesses esforos.
Para obter informaes sobre tarefas bsicas de depurao, leia depurao seu aplicativo e escrever e
exibir logs.
Para visualizar e analisar vrias mtricas de desempenho, tais como o uso de memria, o trfego de rede, o
impacto da CPU, e mais, usar o Monitor de Android.
E para uma introduo aos testes de construo, consulte Testar seu aplicativo.
Publicar

Quando estiver pronto para lanar seu aplicativo para usurios, existem apenas mais algumas coisas a
considerar, tais como versionamento sua aplicao e assin-lo com uma chave. Para mais informaes,
consulte a Viso geral Publishing.

projetos Overview
Neste documento
1. mdulos
2. Arquivos do projeto
3. Configuraes de estrutura do projeto
Um projeto no Android Studio contm tudo o que define seu espao de trabalho para uma aplicao, a partir do
cdigo-fonte e ativos, para testar o cdigo e construir configuraes. Quando voc iniciar um novo projeto, o
Studio Android cria a estrutura necessria para todos os seus arquivos e os torna visveis na janela Project no
lado esquerdo do IDE (clique em Exibir> Ferramenta Windows> Projeto). Esta pgina fornece uma viso
geral dos componentes-chave dentro do seu projeto.

mdulos
Um mdulo uma coleo de arquivos de origem e construir configuraes que permitem que voc dividir seu
projeto em unidades discretas de funcionalidade. Seu projeto pode ter um ou vrios mdulos e um mdulo pode
usar outro mdulo como uma dependncia. Cada mdulo pode ser construdo de forma independente, testado,
e depurado.
Os mdulos adicionais so muitas vezes til na criao de bibliotecas de cdigo dentro de seu prprio projeto
ou quando voc quer criar diferentes conjuntos de cdigo e recursos para diferentes tipos de dispositivos, como
telefones e wearables, mas manter todos os arquivos escopo dentro do mesmo projeto e compartilhar algum
cdigo .
Voc pode adicionar um novo mdulo ao seu projeto, clicando em File> New> Module Novo.
Estdio Android oferece alguns tipos distintos de mdulo:
Mdulo app Android
Fornece um continer para o cdigo do seu aplicativo de cdigo, arquivos de recursos e configuraes
de nvel de aplicativo, como o arquivo de construo de nvel de mdulo e arquivo de manifesto
Android. Quando voc cria um novo projeto, o nome do mdulo padro "app".
Na janela Criar Novo Mdulo, Estdio Android oferece os seguintes mdulos de aplicativos:

Celulares e Tablet Mdulo

Mdulo Android Wear

Mdulo Android TV

Mdulo de vidro

Cada um deles fornecer arquivos essenciais e alguns modelos de cdigo que so apropriados para o
aplicativo ou dispositivo tipo correspondente.
Para mais informaes sobre a adio de um mdulo, leia Adicionar um mdulo para um novo
dispositivo .
mdulo de biblioteca
Fornece um continer para o seu cdigo reutilizvel, que pode ser usado como uma dependncia em
outros mdulos de aplicativos ou importar para outros projetos. Estruturalmente, um mdulo de
biblioteca o mesmo que um mdulo de aplicao, mas, quando construdo, que cria um ficheiro de
arquivo de cdigo em vez de um APK, de modo que no pode ser instalado em um dispositivo.
Na janela Criar Novo Mdulo, Estdio Android oferece os seguintes mdulos de biblioteca:

Biblioteca Android: Este tipo de biblioteca pode conter todos os tipos de arquivos suportados em um
projeto Android, incluindo o cdigo fonte, recursos e arquivos de manifesto. O resultado de
compilao um arquivo Android (AAR) que voc pode adicionar como uma dependncia para os
seus mdulos de aplicativos para Android.

Java Library: Este tipo de biblioteca pode conter somente os arquivos de origem Java. O resultado
de compilao um arquivo Java Archive (JAR) que voc pode adicionar como uma dependncia
para os seus mdulos de aplicativos Andriod ou outros projetos Java.
Mdulo Google Cloud

Fornece um continer para o seu cdigo de backend Google Cloud. Este mdulo acrescenta o cdigo e
dependncias necessrias para um backend Motor Java App que usa HTTP simples, Cloud Endpoints e
Cloud Messaging para conectar-se a sua aplicao. Voc pode desenvolver seu backend para fornecer
servios de nuvem suas necessidades de aplicativos.
Usando Android Studio para criar e desenvolver o seu mdulo Google Cloud permite-lhe gerir cdigo do
aplicativo e cdigo de backend no mesmo projeto. Voc tambm pode executar e testar o cdigo do
servidor localmente, e usar Android Studio para implementar seu mdulo Google Cloud.
Para mais informaes sobre a adio de um mdulo Google Cloud, consulte Adicionando um Java
Servlet Mdulo App Engine . Para mais informaes sobre a execuo e implantao de um mdulo
Google Cloud, consulte Correr, testar e implementar o back-end .
Algumas pessoas tambm se referem a mdulos como sub-projectos e que bom, porque
Gradle tambm refere-se a mdulos como projetos. Por exemplo, quando voc cria um
mdulo de biblioteca e deseja adicion-lo como uma dependncia ao seu mdulo app
Android, voc deve declar-lo como segue:

dependncias {
compilar projeto ( ': my-biblioteca de mdulo')
}

Arquivos do projeto

Por padro, o Studio Android exibe seus arquivos de projeto na visualizao Android. Esta
viso no reflete a hierarquia de arquivo real no disco, mas organizada por mdulos e
tipos de arquivo para simplificar a navegao entre os arquivos de origem de seu projeto,
escondendo determinados arquivos ou diretrios que no so comumente usados. Algumas
das alteraes estruturais em relao estrutura no disco incluem o seguinte:

Mostra todos os arquivos de configurao relacionados construo do projeto em um


alto nvel grupo Gradle Script.

Mostra todos os arquivos de manifesto para cada mdulo em um grupo de nvel de


mdulo (quando voc tem diferentes arquivos de manifesto para diferentes sabores de
produtos e tipos de compilao).

Mostra todos os arquivos de recursos alternativos em um nico grupo, em vez de em


pastas separadas por qualifier recurso. Por exemplo, todas as verses de densidade do
seu cone lanador esto lado-a-lado visvel.

Dentro de cada mdulo app Android, os arquivos so mostrados nos seguintes grupos:
manifestos
Contm o AndroidManifest.xml arquivo.
Java
Contm os arquivos de cdigo-fonte Java, separados por nomes de pacotes, incluindo o cdigo de teste
JUnit.
res
Contm todos os recursos no-cdigo, como layouts XML, cordas de interface do usurio, e imagens
bitmap, dividida em sub-diretrios correspondente. Para mais informaes sobre todos os tipos de
recursos possveis, consulte Fornecendo recursos .

O Android Project View

Para ver a estrutura do arquivo real do projeto, incluindo todos os


arquivos escondidos da viso Android, selecione Project a partir do
menu suspenso na parte superior da janela Project.
Ao selecionar exibio Project, voc pode ver muito mais arquivos e
diretrios. O mais importante dos quais so os seguintes:
module-name /
build/

Contm construir sadas.

libs/

Contm bibliotecas particulares.


src/

Contm todos os arquivos de cdigo e de recursos para o mdulo nos seguintes subdiretrios:
androidTest/

Contm cdigo para testes de instrumentao que so executados em um dispositivo Android. Para
mais informaes, consulte a documentao do Teste Android .
main/

Contm os "principais" arquivos sourceset: o cdigo e recursos compartilhados por todos Android
construir variantes (arquivos para outras variantes de compilao residem em diretrios irmos,
como src/debug/ para o tipo de compilao de depurao).
AndroidManifest.xml

Descreve a natureza da aplicao e cada um dos seus componentes. Para mais informaes, consulte
oAndroidManifest.xml documentao.
java/

Contm fontes de cdigo Java.


jni/

Contm cdigo nativo usando o Java Native Interface (JNI). Para mais informaes, consulte
a documentao do NDK Android .
gen/

Contm os arquivos Java gerados pelo Android Studio, tal como o seu R.java arquivo e as interfaces
criadas a partir de arquivos AIDL.
res/

Contm recursos de aplicaes, como arquivos resgatveis, arquivos de layout e seqncia


UI. Veja recursos de aplicativopara obter mais informaes.
assets/

Contm arquivo que deve ser compilado em um .apk arquivo como est. Voc pode navegar este
diretrio da mesma forma como um sistema de arquivos tpico usando URIs e ler arquivos como um

fluxo de bytes usando o AssetManager . Por exemplo, este um bom local para texturas e dados do
jogo.
test/

Contm cdigo para testes locais que funcionam com o seu anfitrio JVM.
build.gradle (mdulo)

Isto define as configuraes de compilao do mdulo-especfico.


build.gradle (projeto)

Isto define a sua configurao de compilao que se aplicam a todos os mdulos. Este arquivo parte
integrante do projeto, para que voc deve mant-los em controle de reviso com todos os outros
cdigo-fonte.
Para obter informaes sobre outros arquivos de compilao, consulte Configurar a sua construo .

Configuraes de estrutura do
projeto
Para alterar diversas configuraes para seu projeto Android
Studio, abrir o dilogo Estrutura do Projeto clicando
em Arquivo> estrutura do projeto. Ele contm as
seguintes sees:

SDK Localizao: Define a localizao do JDK, o


Android SDK e NDK Android que seu projeto usa.

Projeto: Define a verso para Gradle eo plug-in Android


para Gradle , eo nome do local do repositrio.

Desenvolvedores: Contm configuraes para Android


Estdio componentes add-in do Google ou de
terceiros. Veja Servios de Desenvolvedor , abaixo.

Mdulos: Permite editar configuraes de compilao


do mdulo-especfico, incluindo o alvo e SDK mnimo, a
assinatura de aplicativos e dependncias da
biblioteca. Veja mdulos , abaixo.

Servios de Desenvolvedor
A seo de Desenvolvedores da caixa de dilogo Estrutura
do Projeto contm pginas de configurao para vrios

servios que podem ser utilizados com a sua


aplicao. Esta seo contm as seguintes pginas:

AdMob: Permite ligar do Google AdMob componente,


que ajuda a compreender os seus utilizadores e mostrarlhes anncios sob medida.

Analytics: Permite ligar o Google Analytics , o que ajuda


a medir as interaes do usurio com o aplicativo atravs
de vrios dispositivos e ambientes.

Autenticao: Permite que os usurios usem o Google


Sign-In para fazer login no seu aplicativo com as suas
contas do Google.

Cloud: Permite ligar Firebase servios baseados em


nuvem para a sua aplicao.

Notificaes: Permite usar o Google Cloud


Messaging para a comunicao entre o seu aplicativo e
seu servidor.

Ligar qualquer um destes servios pode causar Android


Studio para adicionar dependncias e permisses
necessrias para a sua aplicao. Cada pgina de
configurao lista dessas e de outras aces que o Studio
Android leva se voc habilitar o servio associado.

mdulos
A seo Configuraes Mdulos permite alterar as opes
de configurao para cada um dos mdulos do seu
projeto. pgina de configuraes de cada mdulo dividido
nas seguintes guias:

Propriedades: Especifica as verses do SDK e construir


ferramentas para usar para compilar o mdulo.

Assinatura: Especifica o certificado para usar


para assinar seu APK .

Sabores: Permite criar vrios sabores de construo,


onde cada sabor especifica um conjunto de definies de
configurao, como a verso SDK objectivo mnimo e do
mdulo, eo nome de cdigo e verso . Por exemplo,
voc pode definir um sabor que tem um SDK mnimo de
15 e um SDK alvo de 21, e um outro sabor que tem um
SDK mnimo de 19 e um SDK alvo de 23.

Criar Tipos: Permite criar e modificar configuraes de


compilao, como descrito em Configurando o Gradle
constri . Por padro, cada mdulo
tem depurao e verso construir tipos, mas voc pode
definir mais conforme necessrio.

Dependncias: Lista as bibliotecas, arquivos e


dependncias de mdulo para este mdulo. Voc pode
adicionar, modificar e excluir dependncias a partir deste
painel. Para mais informaes sobre dependncias do
mdulo, consulte Configurando Gradle constri .

Criar um projeto
Neste documento
1. Passo 1: Criar um novo projeto
2. Passo 2: Escolha formatos e API Nvel
3. Passo 3: Adicionar uma Atividade
4. Etapa 4: Configurar a sua actividade
5. Passo 5: Desenvolver seu aplicativo
Um projeto no Android Studio contm um ou mais mdulos que mantm o seu cdigo organizado em unidades
discretas de funcionalidade. Esta pgina mostra como iniciar um novo projeto.
Estdio Android torna mais fcil para criar aplicativos Android para vrios formatos, tais como telefone, tablet,
TV, desgaste e Google Glass. O assistente Novo projeto permite-lhe escolher os fatores de forma para a sua
aplicao e preenche a estrutura do projeto com tudo que voc precisa para comear.
Para mais informaes sobre os tipos de estrutura de projeto e mdulo Android, leia Projetos Viso geral .Para
mais informaes sobre a adio de um mdulo para um novo dispositivo a um projeto existente, leiaAdicionar
um mdulo para um novo dispositivo .

Passo 1: Criar um novo projeto


Se voc no tiver um projeto aberto, Estdio Android mostra a tela de boas-vindas. Para criar um novo projeto,
clique em Iniciar um projeto de estdio novo Android.
Se voc tivesse um projeto aberto, Estdio Android mostra o ambiente de desenvolvimento. Para criar um novo
projeto, clique em File> New> New Project.
A prxima janela permite configurar o nome do seu aplicativo, o nome do pacote, ea localizao do seu projeto.

Figura 1. O Configure sua tela novo projeto.

Digite os valores para o seu projeto, em seguida, clique em Avanar.

Passo 2: Escolha formatos e API Nvel


A prxima janela permite selecionar os formatos suportados pelo seu aplicativo, tais como telefone, tablet, TV,
desgaste e Google Glass. Os fatores de forma selecionados tornam-se os mdulos de aplicativos dentro do
projeto. Para cada fator de forma, voc tambm pode selecionar o nvel de API para essa aplicao. Para obter
mais informaes, clique em Ajuda para escolher.

Figura 2. Grfico das distribuies verso Android actual mostrada quando voc clica em Ajuda para escolher.

A janela Distribution Platform Android mostra a distribuio dos dispositivos mveis com cada verso do
Android, como mostrado na figura 2. Clique em um nvel API para ver uma lista de recursos introduzidos na
verso correspondente do Android. Isso ajuda voc a escolher o nvel mnimo API que tem todas as
caractersticas que seus aplicativos necessrios, para que possa atingir o maior nmero de dispositivos
possvel. Em seguida, clique em OK.

Figura 3. A tela de destino dispositivos Android.

Em seguida, no Alvo dispositivos Android Janela, uma vez que selecionou suas formatos e verses da API,
clique em Avanar.

Passo 3: Adicionar uma Atividade


A prxima tela permite que voc selecione um tipo de atividade para adicionar ao seu aplicativo, como mostrado
na figura 4. Esta tela exibe um conjunto diferente de atividades para cada um dos fatores de forma que voc
selecionou anteriormente.

Figura 4. A Adicionar uma tela de Atividade por um fator de forma mvel.

Escolha um tipo de atividade, em seguida, clique em Avanar.

Nota: Se voc escolher "Adicionar Nenhuma atividade", clique em Concluir para criar o projeto.

Etapa 4: Configurar a sua actividade


A prxima tela permite que voc configure a atividade para adicionar ao seu aplicativo, como mostrado na figura
5.

Figura 5. A personalizar a tela de Atividade.

Digite o nome da atividade, o nome do layout e do ttulo da atividade. Em seguida, clique em Concluir.

Passo 5: Desenvolver seu aplicativo


Estdio Android cria a estrutura padro para o projeto e abre o ambiente de desenvolvimento. Se seu aplicativo
suporta mais de um fator de forma, Estdio Android cria uma pasta mdulo com arquivos-fonte completo para
cada um deles, como mostrado na figura 6.

Figura 6. Estrutura do projeto para um aplicativo recm-criado.

Agora voc est pronto para desenvolver seu aplicativo. Para mais informaes, consulte os seguintes links:

Lies de treinamento

Adicionar um mdulo para um novo dispositivo

Adicionar um mdulo para um novo


dispositivo
Neste documento
1. Criar um novo mdulo
2. Importar um Mdulo
3. Prximos passos
Mdulos fornecem um recipiente para o cdigo do seu aplicativo de cdigo, arquivos de recursos e
configuraes de nvel de aplicativo, como o arquivo de construo de nvel de mdulo e arquivo de manifesto
Android. Cada mdulo pode ser construdo de forma independente, testado, e depurado.
Estdio Android utiliza mdulos para tornar mais fcil para adicionar novos dispositivos ao seu projeto.Seguindo
alguns passos simples no Android Studio, voc pode criar um mdulo para conter cdigo que especfico para
um tipo de dispositivo, como Android Wear ou TV Android. Estdio Android cria automaticamente listas de
mdulos, tais como diretrios de origem e de recursos, e um padrobuild.gradle arquivo apropriado para o tipo
de dispositivo. Alm disso, o Studio Android cria mdulos de dispositivos com configuraes de compilao
recomendadas, tais como o uso da biblioteca Leanback para mdulos Android TV.
Esta pgina descreve como adicionar um novo mdulo para um dispositivo especfico.
Estdio Android tambm torna mais fcil para adicionar uma biblioteca ou mdulo Google Cloud ao seu
projeto. Para obter detalhes sobre a criao de um mdulo de biblioteca, consulte Criar um mdulo de
biblioteca . Para obter detalhes sobre a criao de um mdulo Google Cloud, consulteAdicionando um Java
Servlet Mdulo App Engine .

Criar um novo mdulo


Para adicionar um novo mdulo ao seu projeto para um novo dispositivo, faa o seguinte:
1.

Clique em Arquivo> Novo> New Module.

2.

Na janela Novo Mdulo que aparece, Estdio Android oferece os seguintes mdulos do dispositivo:
o

Celulares e Tablet Mdulo

Mdulo Android Wear

Mdulo Android TV

Mdulo de vidro

Selecione o mdulo para o dispositivo que voc deseja, clique em Avanar.


3.

No Configure seu novo janela do mdulo, insira os seguintes detalhes:


o

Nome do aplicativo: Este nome usado como o ttulo do seu cone iniciador de aplicativos
para o novo mdulo.

Nome do Mdulo: Este texto usado como o nome da pasta onde o seu cdigo-fonte e
recursos arquivos so visveis.

Nome do pacote: Este o namespace Java para o cdigo em seu mdulo e adicionado como
o package atributo no mdulo arquivo de manifesto Android .

SDK mnima exigida: Essa configurao indica o menor verso da plataforma Android que o
mdulo aplicativo suporta. Esse valor define ominSdkVersion atributo no build.gradle arquivo, que voc
pode editar mais tarde.

Em seguida, clique em Avanar.


4.

Dependendo de qual mdulo de dispositivo selecionado, a pgina a seguir mostra uma seleo de
modelos de cdigo apropriadas voc pode selecionar para usar como sua atividade principal. Clique um
modelo de atividade que deseja iniciar com clique em Avanar. Se voc no precisa de uma atividade,
clique em Adicionar Nenhuma atividade, em seguida, clique em Concluir e est feito.

5.

Se voc escolheu um modelo de atividade, a prxima pgina contm vrios campos de entrada
relacionados com o modelo de atividade que voc escolheu, como o nome da classe eo nome do
layout. Preencher o formulrio e clique em Concluir.

Estdio Android cria todos os arquivos necessrios para o novo mdulo, e sincroniza o projeto com os novos
arquivos de mdulo Gradle. Adicionando um mdulo para um novo dispositivo tambm adiciona as
dependncias necessrias para o dispositivo de destino para o arquivo de configurao do mdulo.
Uma vez que o projeto de sincronizao Gradle concluda, o novo mdulo aparece na janela do projeto no lado
esquerdo. Se voc no v a nova pasta mdulo, verifique se ele est exibindo a vista Android .

Importar um Mdulo
Para importar um mdulo existente em seu projeto, faa o seguinte:
1.

Clique em Arquivo> Novo> Mdulo Import.

2.

No diretrio Fonte, digite ou selecione o diretrio do mdulo (s) que deseja importar:
o

Se voc estiver importando um mdulo, indicar o seu diretrio raiz.

Se voc estiver importando vrios mdulos de um projeto, indicar a pasta do projeto. Para cada
mdulo dentro da pasta, uma caixa aparece e indica o local de origem e nome do mdulo. Verifique se
a caixa de importao verificada para cada mdulo que voc deseja importar.

Se seu mdulo (s) tem outras dependncias, eles sero listados para importar sob mdulos adicionais
necessrios.
3.

Digite seu nome de mdulo desejado (s) no campo (s) nome do mdulo.

4.

Clique em Concluir.

Uma vez que o mdulo importado, ele aparece na janela do projeto no lado esquerdo.

Prximos passos
Depois de adicionar um novo mdulo, voc pode modificar o cdigo do mdulo e recursos, configurar as
definies do mdulo de construo, e construir o mdulo. Voc tambm pode executar e depurar o mdulo
como qualquer outro aplicativo.

Para saber mais sobre as configuraes de compilao de um mdulo, consulte O nvel de mdulo
compilao .

Para criar e executar um mdulo especfico, consulte Select e construir um mdulo diferente .

Voc tambm vai querer adicionar o cdigo e recursos para apoiar adequadamente o novo dispositivo. Para
mais informaes sobre como desenvolver mdulos de aplicativos para diferentes tipos de dispositivos,
consulte a documentao correspondente:

Para mdulos Android Wear: Criando e executando um App Wearable

Para os mdulos de TV Android: Comear a usar o Apps TV

Para mdulos de vidro: GDK Quick Start

Como voc desenvolver o seu novo mdulo, voc pode criar um cdigo independente do dispositivo que j
duplicada em um mdulo aplicativo diferente. Em vez de manter o cdigo duplicado, considere mover o cdigo
compartilhado a um mdulo de biblioteca e adicionar a biblioteca como uma dependncia a seus mdulos de
aplicativos. Para mais informaes sobre a criao de um mdulo de biblioteca e adicion-lo como uma
dependncia, consulte Criar uma Biblioteca Android .

Criar uma Biblioteca Android


Neste documento
1. Criar um mdulo de biblioteca
2. Adicionar sua biblioteca como uma dependncia
3. Consideraes de desenvolvimento
Uma biblioteca Android estruturalmente o mesmo como um mdulo do aplicativo para Android. Ele pode
incluir tudo o necessrio para construir um aplicativo, incluindo o cdigo fonte, arquivos de recursos e um
manifesto do Android. No entanto, em vez de compilar em um APK que executado em um dispositivo, uma
biblioteca Android compila em um arquivo Arquivo Android (AAR) que voc pode usar como uma dependncia
para um mdulo app Android.
Um mdulo de biblioteca til nas seguintes situaes:

Quando voc est construindo vrios aplicativos que usam alguns dos mesmos componentes, tais
como atividades, servios ou layouts UI.

Quando voc est construindo um aplicativo que existe em mltiplas variaes APK, como uma verso
gratuita e paga e voc precisa dos mesmos componentes centrais em ambos.

Em ambos os casos, basta mover os arquivos que voc deseja reutilizar em um mdulo de biblioteca, em
seguida, adicionar a biblioteca como uma dependncia para cada mdulo aplicativo. Esta pgina ensina como
fazer as duas coisas.

Criar um mdulo de biblioteca


Para criar um novo mdulo de biblioteca no seu projeto, faa o seguinte:
1.

Clique em Arquivo> Novo> New Module.

2.

No Criar Novo Mdulo janela que aparece, clique em Biblioteca Android, clique em Avanar.
H tambm uma opo para criar uma biblioteca de Java, que constri um arquivo JAR
tradicional. Enquanto um arquivo JAR til para muitos projetos, especialmente quando voc quer
compartilhar cdigo com outras plataformas que no permite que voc inclua recursos Android ou arquivos
de manifesto, que muito til para a reutilizao de cdigo em projetos Android. Portanto, este guia
concentra-se na criao de bibliotecas Android.

3.

D sua biblioteca um nome e selecione uma verso mnima do SDK para o cdigo na biblioteca, em
seguida, clique em Concluir.

Uma vez que o projeto de sincronizao Gradle concluda, o mdulo de biblioteca aparece no painel Project
esquerda. Se voc no v a nova pasta mdulo, verifique se ele est exibindo a vista Android .

Converter um mdulo de aplicativo para um mdulo de biblioteca


Se voc tiver um mdulo de aplicativo existente com todo o cdigo que voc deseja reutilizar, voc pode
transform-lo em um mdulo de biblioteca da seguinte forma:
1.

Abra o build.gradle arquivo para o mdulo de aplicao existente. No topo, voc deve ver o seguinte:
aplicar plugin: 'com.android.application'

2.

Alterar a atribuio plugin como mostrado aqui:


aplicar plugin: 'com.android.library'

3.

Clique em Project sincronizao com arquivos Gradle.

isso a. Toda a estrutura do mdulo permanece o mesmo, mas agora opera como uma biblioteca Android e a
compilao ir agora criar um arquivo AAR em vez de um APK.

Adicionar sua biblioteca como uma dependncia


Para usar o cdigo da sua biblioteca Android em outro mdulo aplicativo, faa o seguinte:
1.

Adicionar a biblioteca para o seu projeto em uma das duas maneiras (se tiver criado o mdulo de
biblioteca dentro do mesmo projeto, ento ele j est l e voc pode pular esta etapa):
Adicione o arquivo AAR compilado (ou JAR):

o
1.

Clique em Arquivo> Novo Mdulo.

2.

Clique em Importar .JAR / .AAR Package, em seguida, clique em Avanar.

3.

Digite o local do TAA ou arquivo JAR, em seguida, clique em Concluir.


Importar o mdulo biblioteca para o seu projeto:

o
1.

Clique em Arquivo> Novo> Mdulo Import.

2.

Digite o local do diretrio de mdulo de biblioteca, em seguida, clique em Concluir.

O mdulo de biblioteca copiado para o seu projeto, assim voc pode realmente editar o cdigo da
biblioteca. Se voc quiser manter uma nica verso do cdigo da biblioteca, ento este no
provavelmente o que voc quer e voc deveria importar o arquivo AAR compilado como descrito acima.
2.

Certifique-se de que a biblioteca listado no topo da sua settings.gradle arquivo, como mostrado aqui
para uma biblioteca denominada "my-biblioteca-module":
incluem ': app', ': my-biblioteca de mdulo'

3.

Abra o mdulo app build.gradle arquivo e adicionar uma nova linha para as dependencies bloquear
como mostrado no seguinte trecho:
dependncias {
compilar projeto ( ": my-biblioteca-mdulo")
}

4.

Clique em Project sincronizao com arquivos Gradle.

Neste exemplo acima, o mdulo de biblioteca Android chamado my-library- module torna-se construir
dependncia para o mdulo no qual obuild.gradle arquivo reside.
Qualquer cdigo e os recursos na biblioteca Android agora est acessvel para o seu mdulo de aplicativo e o
arquivo AAR biblioteca empacotado em seu APK em tempo de compilao.
No entanto, se voc quiser compartilhar seu arquivo AAR separadamente, voc pode encontr-lo no projectname / module-name/build/outputs/aar/ e voc pode regener-lo, clicando em Construir> Faa Project.

Consideraes de desenvolvimento
medida que desenvolve seus mdulos de biblioteca e aplicativos dependentes, estar ciente dos seguintes
comportamentos e limitaes.
Depois de ter adicionado referncias a mdulos de biblioteca para o seu mdulo de aplicativo para Android,
voc pode definir sua prioridade relativa.Em tempo de compilao, as bibliotecas so mesclados com o
aplicativo, um por vez, a partir da prioridade mais baixa para a mais alta.

Conflitos de mesclagem de recursos


As ferramentas de compilao mesclar recursos de um mdulo de biblioteca com os de um mdulo
aplicativo dependente. Se um determinado ID do recurso definida em ambos os mdulos, o recurso do
aplicativo usado.

Se os conflitos ocorrem entre vrias bibliotecas TAA, em seguida, o recurso da biblioteca listada em primeiro
lugar na lista de dependncias (em direo ao topo do dependencies do bloco) usado.
Para evitar conflitos de recursos para IDs de recursos comuns, considere usar um prefixo ou outro esquema
de nomes consistente, que exclusivo para o mdulo (ou exclusivo em todos os mdulos do projeto).

Um mdulo de biblioteca pode incluir uma biblioteca JAR


Voc pode desenvolver um mdulo de biblioteca que se inclui uma biblioteca JAR; no entanto voc precisa
editar manualmente caminho de construo das mdulos de aplicativos dependentes e adicionar um
caminho para o arquivo JAR.

Um mdulo de biblioteca pode depender de uma biblioteca JAR externo


possvel desenvolver um mdulo de biblioteca que depende de uma biblioteca externa. (Por exemplo, os
mapas da biblioteca externa). Neste caso, o aplicativo dependente deve construir contra um alvo que inclui a
biblioteca externa (por exemplo, as APIs do Google Add-On). Note-se tambm que tanto o mdulo de
biblioteca eo aplicativo dependente deve declarar a biblioteca externa em seus arquivos de manifesto, em
um<uses- library> elemento.

Mdulos de biblioteca no pode incluir ativos brutos


As ferramentas no suportam o uso de arquivos de recursos de matrias-(salvo no assets/ diretrio) em um
mdulo biblioteca. Quaisquer recursos de ativos usados por um aplicativo devem ser armazenados
no assets/ directrio do mdulo aplicativo em si.

O mdulo de aplicao minSdkVersion deve ser igual ou maior do que a verso definida pela
biblioteca
Uma biblioteca compilado como parte do mdulo de aplicao dependente, de modo que os APIs usadas
no mdulo de biblioteca devem ser compatveis com a verso da plataforma que suporta o mdulo de
aplicao.

Cada mdulo de biblioteca cria a sua prpria classe R


Quando voc constri os mdulos de aplicativos dependentes, mdulos de biblioteca so compilados em um
arquivo AAR ento adicionado ao mdulo de aplicao. Portanto, cada biblioteca tem seu prprio R classe,
nomeado de acordo com o nome do pacote da biblioteca. O R classe gerada a partir do mdulo principal e o
mdulo de biblioteca criado em todos os pacotes que so necessrios incluindo o pacote principal do
mdulo e pacotes das bibliotecas.

Mdulos de biblioteca pode incluir seu prprio arquivo de configurao ProGuard


Voc pode ativar o cdigo encolhendo na sua biblioteca, adicionando um ProGuard arquivo de configurao
para a sua biblioteca, que inclui as suas directivas ProGuard. As ferramentas de compilao incorporar esse

arquivo dentro do arquivo AAR gerado para o mdulo de biblioteca. Quando voc adiciona a biblioteca a um
mdulo de aplicativo, arquivo ProGuard da biblioteca fica anexado ao arquivo de configurao ProGuard
(proguard.txt ) do mdulo de aplicao.
Ao incorporar um arquivo ProGuard no seu mdulo de biblioteca, voc garante que os mdulos de
aplicativos que dependem de sua biblioteca no tem que atualizar manualmente seus arquivos ProGuard
usar sua biblioteca. Quando ProGuard executado no mdulo app Android, ele usa as directivas, tanto do
mdulo de aplicativo e biblioteca para que voc no deve executar ProGuard na biblioteca sozinho.
Para especificar o nome do arquivo de configurao da sua biblioteca, adicion-lo
consumerProguardFiles mtodo, dentro do defaultConfigbloco de da sua
biblioteca build.gradle arquivo. Por exemplo, o seguinte trecho define lib-proguard-rules.txt como arquivo
de configurao ProGuard da biblioteca:

android {
DefaultConfig {
consumerProguardFiles 'lib-proguard-rules.txt'
}
...
}

Por padro, o mdulo aplicativo usa compilao de lanamento da biblioteca, mesmo quando usando o tipo
de compilao de depurao do mdulo aplicativo. Para usar um tipo de compilao diferente da biblioteca,
selecionar a variante de construo est correcta para o seu mdulo de biblioteca na
janela Variantes da compilao para construir o seu app. Voc tambm pode declarar dependncias dentro
do buildTypes bloco de do aplicativo build.gradle arquivo.
Para garantir que as regras ProGuard da sua biblioteca no se aplicam efeitos colaterais indesejados
encolhimento aos mdulos de aplicativos, incluir apenas regras que desativar recursos ProGuard que no
funcionam com a sua biblioteca. Regras que tentam ajudar os desenvolvedores podem entrar em conflito
com o cdigo existente em um mdulo aplicativo ou suas outras bibliotecas e, portanto, no devem ser
includos. Por exemplo, o arquivo ProGuard da sua biblioteca pode especificar o cdigo precisa ser
mantido durante minification de um mdulo de aplicao.
Nota: O conjunto de ferramentas Jack fornece suporte para apenas algumas opes encolhendo e
ofuscao com ProGuard.

Adicionar Cdigo partir de um


modelo
Neste documento

1. Modelos de aplicao
1. Template BlankActivity
2. Modelo de Atividade tela cheia
3. Template Fluxo Master Detail
2. Modelos de atividade
1. Entre Modelo de Atividade
2. Modelo de Atividade Configuraes
3. outros modelos
Estdio Android fornece modelos de cdigo que ajudam a criar novos projetos com um certo padro de design
ou para adicionar componentes para o seu projeto existente. Os modelos de cdigo seguir as diretrizes de
design e desenvolvimento Android para voc no caminho certo para a criao de um aplicativo bonito, funcional.
Existem vrios tipos de modelos de cdigo do Android, que pode criar qualquer coisa de um aplicativo inteiro
para baixo para componentes de aplicativos especficos. As principais categorias de modelos de cdigo so os
seguintes:

Modelos de aplicao

Modelos de atividade

outros modelos

Os modelos de uso da biblioteca de apoio objetos se esses objetos esto disponveis. Os objetos de biblioteca
suporte fazer novos recursos disponveis na mais ampla gama de plataformas. Por exemplo, uma vez que os
modelos de usar a biblioteca appcompat , aplicativos com base nos modelos de usar material de
concepo princpios de interface de usurio, mesmo se eles esto sendo executados em dispositivos Android
mais antigos que no suportam diretamente concepo material.

Modelos de aplicao
Os modelos de aplicao criar mdulos de aplicativos Android bsicas que voc pode imediatamente executar e
testar no seu dispositivo Android.Estes modelos esto disponveis quando voc criar um novo mdulo Android,
embora voc tambm pode usar esses modelos para adicionar novas atividades para um mdulo existente.
Para usar modelos de aplicativos Android:
1.

Em Android Studio, selecione File> New> Module.

2.

Introduzir as definies para a sua aplicao, incluindo nome do aplicativo, domnio da


empresa, nome do pacote, e SDK mnimo, clique emAvanar.

3.

Escolha um modelo de aplicativo para usar e clique em Avanar. Por exemplo,


o

BlankActivity

FullScreenActivity

MasterDetailFlow

4.

Introduzir as definies para a sua actividade, incluindo nome da atividade, disposio


Nome, Ttulo e Menu Nome do recurso, clique em Concluir.

Nota: As outras opes de modelo atividade tambm criar aplicaes, no entanto, estas aplicaes requerem
modificaes adicionais antes que eles possam ser lanados em um dispositivo Android.

Modelo de Atividade em branco


Exemplo

Descrio
O modelo BlankActivity com o Tipo de Navegao: Nenhum opo cria um
aplicativo simples que segue asProjeto Android orientaes. Use este modelo
para criar um aplicativo bsico, mnimo como ponto de partida para o seu
projeto.
Este modelo inclui:

ActionBar

estouro de ao

layout bsico

O modelo BlankActivity com o Tipo de Navegao:


Tabs ou Tabs opo + Swipe cria um aplicativo com trs sees com
base no Fragment de classe e uma interface de usurio com guias.
Este modelo inclui:

ActionBar para controles de guia

Fragment objetos para contedo da seo

Opcional apoio furto gesto com base na opinio de furto padro de design
que se estendeFragmentPagerAdapter para gerenciar fragmentos seo

O modelo BlankActivity com o Tipo de Navegao:


Swipe Visualizaes + opo Ttulo Faixa cria um aplicativo com trs
Fragment sees, um cabealho tira ttulo compacto (conhecido como

rolagem Tabs noprojeto Android guia) e navegao de furto entre as seces,


com base na opinio de furto padro de design.
Este modelo inclui:

PagerTitleStrip para os ttulos das seces

Fragment objetos para contedo da seo

FragmentPagerAdapter para gerenciar fragmentos seo

O modelo BlankActivity com o tipo de navegao: Opo suspensa cria um


aplicativo que estendeFragmentActivity , contendo trs Fragment sees,
com uma ActionBar usando a navegao modo de lista.
Este modelo inclui:

ActionBar para navegao modo de lista

Fragment objetos para contedo da seo

Modelo de Atividade tela cheia


Exemplo

Descrio

Este modelo fornece uma implementao de uma atividade que alterna


entre uma primria, visualizao em tela cheia e uma exibio com
controles de interface de usurio padro, incluindo a barra de notificao
e barra de ttulo da aplicao. A visualizao de tela cheia o padro e
um usurio pode ativar o modo de exibio padro tocando na tela do
dispositivo.
Este modelo inclui:

SystemUiHider aplicao que gere esconderijo da interface do usu

do sistema usando uma abordagem compatvel com verso

layout bsico

Template Fluxo Master Detail


Exemplo

Descrio
Este modelo cria um layout adaptvel para um conjunto
de itens e detalhes associados. Em um dispositivo tablet,
a lista de itens e item detalhes so exibidos na mesma
tela. Em um dispositivo menor, a lista e os detalhes
so exibidos em telas separadas.
Nota: Este modelo segue as recomendaes do
Designing para Mltiplas Telas de treinamento Android.
Este modelo inclui:

Esquema Adaptive usando recurso alternativo


arquivos XML

FragmentActivity , Fragment e ListFragment

implementaes

Modelos de atividade
modelos de atividade Android fornecer opes para adicionar novas actividades para a sua aplicao existente.

Para usar modelos de atividade Android:


1.

Boto direito do mouse na pasta do projeto do aplicativo Android, onde voc deseja adicionar uma
atividade.

2.

Selecione Novo> Outro ...

3.

Selecione Android> Atividade Android, clique em Avanar.

4.

Escolha um modelo de atividade, em seguida, siga as instrues para adicionar ao seu aplicativo
existente.
o

LoginActivity

SettingsActivity

BlankActivity

FullScreenActivity

MasterDetailFlow

Estes modelos de criar o mesmo tipo de actividade, como o fazem quando utilizado como um modelo de
aplicao, no entanto, os seguintes modelos de criar actividades que so destinados especificamente para ser
utilizado como parte de um pedido existente.

Entre Modelo de Atividade


Exemplo

Descrio
Este modelo de atividade fornece campos de entrada e um exemplo de
implementao de uma AsyncTaskque pede aos usurios para acessar ou
registar-se com as suas credenciais.
Este modelo inclui:

interface de usurio recomendada para solicitar informaes de login

AsyncTask implementao para operaes de rede entregar separadame

do segmento principal interface do usurio

indicador de progresso durante as operaes de rede

Modelo de Atividade Configuraes

Exemplo

Descrio
Este modelo amplia a PreferenceActivity classe e usa um arquivo XML
para criar configuraes de preferncias. Este modelo tambm demonstra
como implementar vrios tipos de dados para configuraes.
Este modelo inclui:

Atividade estendendo PreferenceActivity

Preferncia valores definidos utilizando arquivos XML adicionados


res/xml/ diretrio do seu projeto.

outros modelos
modelos de objetos Android fornecer opes para adicionar novos componentes para sua aplicao existente,
incluindo as actividades mencionadas anteriormente, bem como os seguintes itens adicionais:
Para usar modelos de objetos Android:
1.

Direito do mouse na pasta do mdulo do aplicativo Android em que voc deseja adicionar um
componente de cdigo.

2.

Selecione Novo

3.

Selecione o tipo de objeto e modelo, em seguida, siga as instrues para adicionar ao seu aplicativo
existente.
o

AIDL

Atividade

Pasta

Fragmento

Google

De outros

Servio

Componente UI

Vestem

Ferramenta

XML