Professional Documents
Culture Documents
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 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
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
Mdulos de bibliotecas
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:
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.
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.
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
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.
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
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.
Descrio
Windows e Linux
Conclus
Control+Space
o bsica
Conclus
inteligente
Control+Shift+Space
o de
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.
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).
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
Criar diversos APKs para o aplicativo, com diferentes recursos, usando o mesmo projeto e os mesmos
mdulos.
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.
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 dicas
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.
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.
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.
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.
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.
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.
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.
5.
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
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.
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.
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.
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.
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.
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.
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.
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.
No menu principal, selecione File > Settings > Appearance & Behavior -- System Settings -- HTTP
Proxy.
2.
No Windows e no Linux, selecione File > Settings > IDE Setting -- HTTP Proxy.
No Mac, selecione Android Studio > Preferences > IDE Setting -- HTTP Proxy.
4.
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
Add to favorites
Alt + Shift + F
Option + Shift + F
Alt + Shift + I
Option + Shift + I
Control + ` (backquote)
Control + ` (backquote)
Control + Alt + S
Command + , (comma)
Command + ; (semicolon)
Control + Tab
Control + Tab
Find
Control + F
Command + F
Find next
F3
Command + G
Find previous
Shift + F3
Command + Shift + G
Replace
Control + R
Command + R
General
Find action
Control + Shift + A
Command + Shift + A
Command + Option + O
Find class
Control + N
Command + O
Control + Shift + N
Command + Shift + O
Find in path
Control + Shift + F
Command + Shift + F
Control + F12
Command + F12
Jump to source
F4 / Control + Enter
Shift + F4
Shift + F4
Control + E
Command + E
Control + Shift + E
Command + Shift + E
Control + Shift +
Backspace
Control + F4
Command + W
Esc
Esc
Shift + Esc
Shift + Esc
Go to line
Control + G
Command + L
Control + H
Control + H
Control + Shift + H
Command + Shift + H
Control + Alt + H
Control + Option + H
Alt + Insert
Command + N
Override methods
Control + O
Control + O
Implement methods
Control + I
Control + I
Control + Alt + T
Command + Option + T
Control + Y
Command + Backspace
Control + minus/plus
Command + minus/plus
Control + Shift +
Writing Code
minus/plus
Control + D
Command + D
Control + Space
Control + Space
Complete statement
Control + Q
Control + J
Control + P
Command + P
Go to declaration (directly)
Control + B or Control +
Click
Go to implementations
Control + Alt + B
Command + Alt + B
Go to super-method/super-class
Control + U
Command + U
Control + Shift + I
Command + Y
Alt + 1
Command + 1
Toggle bookmark
F11
F3
Control + F11
Option + F3
Control + /
Command + /
Control + Shift + /
Command + Shift + /
Control + W
Option + Up
Control + Shift + W
Option + Down
Control + [
Option + Command + [
Control + ]
Option + Command + ]
Control + Shift + [
Control + Shift + ]
Control + Delete
Option + Delete
Control + Backspace
Option + Backspace
Optimize imports
Control + Alt + O
Control + Option + O
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
Control + Shift + J
Control + Shift + J
Control + Enter
Command + Enter
Shift + Enter
Shift + Enter
F2 / Shift + F2
F2 / Shift + F2
Build
Control + F9
Command + F9
Shift + F10
Control + R
Debug
Shift + F9
Control + D
Step over
F8
F8
Step into
F7
F7
quick fixes)
Debugging
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
Control + K
Command + K
Control + T
Command + T
Alt + Shift + C
Option + Shift + C
Alt + ` (backquote)
Control + V
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.
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.
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.
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 beta: compilaes candidatas a lanamento baseadas em compilaes canary, lanadas para
obter comentrios antes de serem disponibilizadas no canal estvel.
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.
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.
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
Para atualizar um item ou instalar um item novo, clique na caixa de seleo para que ela exiba uma
marca de verificao.
. As remoes
Para atualizar os pacotes selecionados, clique em Apply ou OK e concorde com os contratos de licena.
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.
1.
2.
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.
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:
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:
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 .
libs/
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 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 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 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:
Servios de Desenvolvedor
A seo de Desenvolvedores da caixa de dilogo Estrutura
do Projeto contm pginas de configurao para vrios
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:
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 .
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.
Em seguida, no Alvo dispositivos Android Janela, uma vez que selecionou suas formatos e verses da API,
clique em Avanar.
Nota: Se voc escolher "Adicionar Nenhuma atividade", clique em Concluir para criar o projeto.
Digite o nome da atividade, o nome do layout e do ttulo da atividade. Em seguida, clique em Concluir.
Agora voc est pronto para desenvolver seu aplicativo. Para mais informaes, consulte os seguintes links:
Lies de treinamento
2.
Na janela Novo Mdulo que aparece, Estdio Android oferece os seguintes mdulos do dispositivo:
o
Mdulo Android TV
Mdulo de vidro
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.
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.
2.
No diretrio Fonte, digite ou selecione o diretrio do mdulo (s) que deseja importar:
o
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:
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 .
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.
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 .
Abra o build.gradle arquivo para o mdulo de aplicao existente. No topo, voc deve ver o seguinte:
aplicar plugin: 'com.android.application'
2.
3.
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 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.
2.
3.
o
1.
2.
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.
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.
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).
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.
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.
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.
2.
3.
BlankActivity
FullScreenActivity
MasterDetailFlow
4.
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.
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
Opcional apoio furto gesto com base na opinio de furto padro de design
que se estendeFragmentPagerAdapter para gerenciar fragmentos seo
Descrio
layout bsico
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:
implementaes
Modelos de atividade
modelos de atividade Android fornecer opes para adicionar novas actividades para a sua aplicao existente.
Boto direito do mouse na pasta do projeto do aplicativo Android, onde voc deseja adicionar uma
atividade.
2.
3.
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.
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:
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:
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
De outros
Servio
Componente UI
Vestem
Ferramenta
XML