Desenvolvimento de código iterativo

Como desenvolvedor para dispositivos móveis, você tem o hábito de desenvolver a interface do seu app etapa por etapa e não de uma só vez. O Android Studio usa essa abordagem com o Jetpack Compose, oferecendo ferramentas que não exigem um build completo para inspecionar, modificar valores e verificar o resultado final.

Edição em tempo real

Importante: esse recurso está em desenvolvimento ativo. Por isso, pode ocorrer algum comportamento instável. No Android Studio Giraffe e versões mais recentes, ele exige o Jetpack Compose Runtime 1.3.0 ou mais recente e o AGP 8.1.0-alpha05 ou mais recente. Estamos sempre trabalhando para melhorar esse recurso e agradecemos seu feedback. Se você encontrar um problema, informe-o. Inclua informações do Logcat e uma descrição da mudança de código que você estava fazendo. Consulte também a lista de problemas em aberto.

A Edição em tempo real é um recurso que permite atualizar elementos combináveis em emuladores e dispositivos físicos em tempo real. Essa funcionalidade minimiza as mudanças de contexto entre a gravação e a criação do app, permitindo que você se concentre na programação do código por mais tempo, sem interrupções.

Importante: o atalho do modo manual foi atualizado para Control+' (Command+' no macOS) no lançamento do recurso Koala. As versões anteriores do Android Studio usavam Control+\ (Command+\ no macOS) como o atalho do modo manual.

A Edição em tempo real tem três modos:

• Manual: as mudanças de código são aplicadas quando são enviadas manualmente usando Ctrl+' (Command+' no macOS).
• Manual no salvamento: as mudanças de código são aplicadas quando salvas manualmente usando Ctrl + S (Command + S no macOS).
• Automático: as mudanças são aplicadas no dispositivo ou emulador quando você atualiza uma função combinável.

O recurso de Edição em tempo real se concentra em mudanças no código relacionadas a IU e UX. Ele não oferece suporte a mudanças como atualizações de assinatura de método, adição de novos métodos ou mudanças na hierarquia de classes. Para saber mais, consulte a lista de Limitações do recurso Edição em tempo real.

Esse recurso não substitui a criação e execução do app ou o recurso Aplicar mudanças. Em vez disso, ele foi projetado para otimizar o fluxo de trabalho durante a criação, implantação e iteração para desenvolver a interface do Compose.

Confira as práticas recomendadas de fluxo de trabalho:

1. Configure o aplicativo para que ele possa ser executado.
2. Use a Edição em tempo real o máximo possível, até que seja necessário fazer uma mudança sem suporte desse recurso. Por exemplo: adicionar novos métodos enquanto o app estiver em execução.
3. Depois de fazer uma mudança sem suporte, clique em Run para reiniciar o app e retomar a Edição em tempo real.

Como fazer a Edição em tempo real

Para começar, siga estas etapas para criar uma atividade vazia do Compose, ativar a Edição em tempo real no projeto e fazer mudanças.

Configurar o novo projeto

1. Antes de começar, confira se você tem o Android Studio Giraffe ou uma versão mais recente instalada e se o nível da API do dispositivo ou emulador físico é de pelo menos 30.

2. Abra o Android Studio e selecione New Project no pop-up Welcome to Android Studio. Se você já tem um projeto aberto, pode criar um novo em File > New > New Project.

3. Escolha o modelo Empty Compose Activity para Phone and Tablet e clique em Next.

   

   Figura 1. Modelos disponíveis. Para a Edição em tempo real, escolha Empty Compose Activity.

4. Preencha a caixa de diálogo New Project com as informações necessárias: nome, nome do pacote, local para salvar, SDK mínimo e idioma de configuração do build.

   

   Figura 2. Exemplo de configurações do projeto.

5. Clique em Finish.

Ativar o recurso Edição em tempo real

1. Acesse as configurações para ativar a Edição em tempo real.

   • No Windows ou no Linux, acesse File > Settings > Editor > Live Edit.
   • No macOS, acesse Android Studio > Settings > Editor > Live Edit.

2. Selecione a opção Live Edit e o modo que você quer executar nas configurações.

   No modo manual, as mudanças de código são enviadas sempre que você pressiona Ctrl+' (Command+' no macOS). No modo manual de salvamento, as mudanças de código são aplicadas sempre que você salva manualmente, usando Ctrl + S (Command + S no macOS). No modo automático, as mudanças de código são aplicadas no dispositivo ou emulador conforme você faz as mudanças.

   

   Figura 3. Configurações da Edição em tempo real

   .

3. No editor, abra o arquivo MainActivity, que é o ponto de entrada do app.

4. Clique em Run para implantar o app.

5. Depois de ativar a Edição em tempo real, a marca de seleção verde Up-to-date vai aparecer no canto superior direito da janela de ferramentas Running Devices:

   

Fazer e revisar mudanças

Quando você faz mudanças com suporte no editor, o dispositivo de teste virtual ou físico é atualizado automaticamente.

Por exemplo, edite o método Greeting em MainActivity para o seguinte:

@Composable
fun Greeting(name: String) {
    Text(
        text = "Hello $name!",
        Modifier
            .padding(80.dp) // Outer padding; outside background
            .background(color = Color.Cyan) // Solid element background color
            .padding(16.dp) // Inner padding; inside background, around text)
    )
}
IterativeDevelopmentSnippets.kt

As mudanças feitas aparecem instantaneamente no dispositivo de teste, conforme mostrado na Figura 4.

Figura 4. O dispositivo de teste mostra a Edição em tempo real muda para o método Greeting.

Resolver problemas do recurso Edição em tempo real

Se as mudanças não aparecerem no dispositivo de teste, é possível que o Android Studio não tenha atualizado as edições. Verifique se o indicador "Live Edit" mostra Out Of Date (desatualizado), como na Figura 5, que indica um erro de compilação. Para saber mais sobre o erro e receber sugestões para resolvê-lo, clique no indicador.

Figura 5. Indicador de status da Edição em tempo real.

Limitações do recurso Edição em tempo real

Veja abaixo uma lista das limitações atuais.

• [Apenas para o Android Studio Giraffe e versões mais recentes] A Edição em tempo real requer o ambiente de execução do Compose 1.3.0 ou mais recente. Se o projeto usar uma versão mais antiga do Compose, a Edição em tempo real será desativada.

• [Apenas para o Android Studio Giraffe e versões mais recentes] A Edição em tempo real requer o AGP 8.1.0-alpha05 ou mais recente. Se o projeto usar uma versão mais antiga do AGP, a Edição em tempo real será desativada.

• A Edição em tempo real requer um dispositivo físico ou emulador com o nível 30 da API ou mais recente.

• A Edição em tempo real só oferece suporte à edição de um corpo de função, ou seja, não é possível mudar o nome ou a assinatura da função, adicionar ou remover uma função ou mudar campos que não sejam de função.

• A Edição em tempo real redefine o estado do app na primeira vez que você muda uma função do Compose em um arquivo. Isso só acontece após a primeira mudança de código. O estado do app não é redefinido pelas próximas mudanças de código feitas nas funções do Compose nesse arquivo.

• As classes modificadas na Edição em tempo real podem ter problemas de performance. Execute o app e use um build de lançamento limpo se estiver avaliando a performance dele.

• Faça uma execução completa para que o depurador funcione nas classes que você modificou com a Edição em tempo real.

• Um app em execução pode falhar quando você usa a Edição em tempo real. Se isso acontecer, você pode reimplantar o app com o botão Run .

• A Edição em tempo real não faz nenhuma manipulação de bytecode definida no arquivo de build do projeto. Por exemplo, as manipulações de bytecode que seriam aplicadas na criação do projeto usando as opções no menu Build ou clicando nos botões Build ou Run.

• As funções não combináveis são atualizadas em tempo real no dispositivo ou emulador, e uma recomposição completa é acionada. A recomposição completa pode não invocar a função atualizada. Para funções não combináveis, é necessário acionar as funções recém-atualizadas ou executar o app novamente.

• A Edição em tempo real não é retomada após a reinicialização do app. Execute o app novamente.

• A Edição em tempo real só oferece suporte a processos depuráveis.

• A Edição em tempo real não oferece suporte a projetos que usam valores personalizados para moduleName em kotlinOptions na configuração do build.

• A Edição em tempo real não funciona com implantações múltiplas. Isso significa que não é possível implantar em um dispositivo e depois em outro. A Edição em tempo real só fica ativa no último conjunto de dispositivos em que o app foi implantado.

• A Edição em tempo real funciona com implantações em vários dispositivos que foram criados com a opção Select multiple devices no menu suspenso do dispositivo de destino. No entanto, ela não tem suporte oficial e pode apresentar problemas. Se você tiver problemas, informe-os.

• A opção "Apply Changes/Apply Code Changes" não é compatível com a Edição em tempo real e exige que o app em execução seja reiniciado.

• No momento, a Edição em tempo real não oferece suporte a projetos do Android Automotive.

Perguntas frequentes sobre o recurso Edição em tempo real

• Qual é o status atual da Edição em tempo real?

  A Edição em tempo real está disponível no Android Studio Giraffe. Para ativar esse recurso, acesse File > Settings > Editor > Live Edit (Android Studio > Settings > Editor > Live Edit no macOS).

• Quando usar a Edição em tempo real?

  Use a Edição em tempo real quando quiser conferir rapidamente o efeito de atualizações de elementos de UX, como atualizações de modificadores e animações, na experiência geral do app.

• Quando devo evitar a Edição em tempo real?

  O recurso de Edição em tempo real se concentra em mudanças no código relacionadas a IU e UX. Ele não oferece suporte a mudanças como atualizações de assinatura de método, adição de novos métodos ou mudanças na hierarquia de classes. Para saber mais, consulte Limitações do recurso Edição em tempo real.

• Quando devo usar a Visualização do Compose?

  Use a Visualização do Compose ao desenvolver elementos combináveis. A visualização mostra os elementos do Compose e é atualizada automaticamente para mostrar o efeito das mudanças de código. A visualização também oferece suporte à exibição de elementos da interface em diferentes configurações e estados, como tema escuro, localidades e escala da fonte.

Edição em tempo real de literais (descontinuado)

Descontinuado: a Edição em tempo real de literais, uma versão anterior dela limitada a apenas alguns tipos com suporte, foi descontinuada. Recomendamos usar a Edição em tempo real.

O Android Studio pode atualizar, em tempo real, literais constantes usados em elementos combináveis nas visualizações, no emulador e no dispositivo físico. Veja alguns tipos compatíveis:

• Int
• String
• Color
• Dp
• Boolean

É possível ativar as decorações de literais no recurso "Live Edit" do indicador de literais da interface para acessar literais constantes que acionam atualizações em tempo real, sem a etapa de compilação:

Observação: o indicador da Edição em tempo real da interface para literais é mostrado ao lado de Code/Split/Design, desde que haja uma conexão ativa com o app em execução em um emulador ou dispositivo físico.

Apply Changes

Apply Changes permite atualizar o código e os recursos sem precisar implantar o app novamente em um emulador ou dispositivo físico, com algumas limitações.

Para atualizar sem precisar implantar seu app novamente sempre que você adicionar, modificar ou excluir elementos combináveis, clique no botão Aplicar mudanças de código: