Como adotar o Compose no seu app

O Jetpack Compose foi projetado para funcionar com a abordagem estabelecida de IU com base em visualização. Se você estiver criando um app, a melhor opção pode ser implementar toda a IU com o Compose. No entanto, se você estiver modificando um app já existente, talvez não queira migrá-lo totalmente de uma só vez. Em vez disso, você pode combinar o Compose com a implementação de design da IU existente.

Há duas maneiras principais de integrar o Compose com uma IU com base em visualização:

• É possível adicionar elementos do Compose à IU já existente, seja criando uma tela totalmente nova com base no Compose ou adicionando elementos do Compose a uma atividade, fragmento ou layout de visualização existentes.

• É possível adicionar um elemento de IU com base em visualização às funções que podem ser compostas. Isso permite adicionar visualizações do Android a um design baseado no Compose.

Observação: se for preciso compartilhar o estado entre um código do Compose e outro que não seja do Compose, recomendamos que você encapsule o estado compartilhado em uma ou mais classes, como a ViewModel, para que os dois sistemas recebam as atualizações. Essas classes precisam implementar as práticas recomendadas de fluxo de dados unidirecional. Leia mais sobre isso em Como integrar o Compose à sua arquitetura de app já existente.

A migração do app inteiro para o Compose funciona melhor se feita passo a passo, com a granularidade de que o projeto precisa. É possível migrar uma tela ou até mesmo um fragmento ou qualquer outro elemento de IU reutilizável por vez. É possível usar várias abordagens diferentes:

• A abordagem bottom-up começa a migrar os elementos menores da IU na tela, como um Button ou uma TextView, seguidos pelos elementos ViewGroup até que tudo seja convertido em funções que podem ser compostas.

• A abordagem top-down começa a migrar os fragmentos ou contêineres de visualização, como FrameLayout, ConstraintLayout ou RecyclerView, seguidos pelos elementos de IU menores na tela.

Essas abordagens pressupõem que cada tela esteja autônoma, mas também é possível migrar a IU compartilhada, como um sistema de design, para o Jetpack Compose. Para saber mais, consulte Como integrar o Compose à IU atual.

As páginas a seguir fornecem detalhes sobre como integrar o Compose aos seus apps já existentes:

• Como adicionar o Compose ao seu app: aprenda os princípios básicos de como começar a usar o Compose em um app baseado em visualização.
• APIs de interoperabilidade: saiba mais sobre as APIs do Compose para ajudar você a combinar o Compose com IUs baseadas em visualização.
• Compose com a arquitetura já existente: aprenda a combinar IUs baseadas em visualização e no Compose ao adotar o Compose no app.
• Compose na IU já existente: aprenda a compartilhar elementos de IU com base em visualizações entre as partes da IU do app que usam o Compose e as que não o usam.