Suporte a várias janelas

O Android 7.0 é compatível com a exibição de mais de um app ao mesmo tempo. Em dispositivos portáteis, dois apps podem ser executados lado a lado ou um acima do outro no modo de tela dividida. Em dispositivos de TV, os apps podem usar o modo picture-in-picture para continuar a reprodução de um vídeo enquanto os usuários interagem com outro app.

Caso seu app segmente o Android 7.0 (API de nível 24) ou versão mais recente, é possível configurar como ele lidará com a exibição em várias janelas. Por exemplo, você pode especificar as dimensões mínimas permitidas para a atividade. Você também pode desativar a exibição em várias janelas para o app, garantindo que o sistema o exiba somente em modo de tela cheia.

Geral

O Android permite que diversos apps compartilhem a tela ao mesmo tempo. Por exemplo, um usuário pode dividir a tela para visualizar uma página da Web no lado esquerdo e escrever um e-mail no lado direito. A experiência do usuário depende da versão do SO do Android e do tipo de dispositivo:

  • Os dispositivos portáteis com o Android 7.0 oferecem o modo de tela dividida. Nesse modo, o sistema preenche a tela com dois apps, exibindo um ao lado ou acima do outro. O usuário pode arrastar a linha divisória que separa os dois para que um app fique maior, e o outro, menor.
  • A partir do Android 8.0, os apps podem ser exibidos no modo picture-in-picture, o que permite que continuem mostrando conteúdo enquanto o usuário navega ou interage com outros apps.
  • Fabricantes de dispositivos maiores podem optar pelo modo de forma livre, em que o usuário pode redimensionar livremente cada atividade. Se o fabricante ativar esse recurso, o dispositivo oferecerá o modo de forma livre e o modo de tela dividida.

Figura 1. Dois apps executados lado a lado em modo de tela dividida.

O usuário pode mudar para o modo de várias janelas das seguintes maneiras:

  • Se o usuário abrir a tela "Visão Geral", tocar em um título de atividade e o mantiver pressionado, poderá arrastar a atividade para uma parte destacada da tela para colocá-la no modo de várias janelas.
  • Se o usuário tocar no botão "Visão geral" e o mantiver pressionado, o dispositivo colocará a atividade atual no modo de várias janelas e abrirá a tela "Visão geral" para que o usuário escolha outra atividade para compartilhar a tela.

Os usuários podem arrastar e soltar dados de uma atividade para outra enquanto as atividades compartilham a tela.

Ciclo de vida do modo de várias janelas

O modo de várias janelas não altera o ciclo de vida da atividade.

Nesse modo, somente a atividade com que o usuário interagiu mais recentemente fica ativa em um determinado momento. Essa atividade é considerada a atividade mais importante e é a única no estado RESUMED. Todas as outras atividades visíveis ficam no estado STARTED, mas não em RESUMED. No entanto, o sistema atribui a essas atividades pausadas, mas visíveis, uma prioridade maior que a das atividades não visíveis. Se o usuário interagir com uma das atividades visíveis, ela será retomada, e a atividade que antes era a mais importante entrará no estado STARTED.

Observação: no modo de várias janelas, um app pode não estar no estado RESUMED, mesmo que esteja visível para o usuário. Pode ser que um app precise continuar a operação, mesmo que não seja considerado a atividade principal. Por exemplo, um app de player vídeo e que está nesse estado continuará a exibir o vídeo. Por esse motivo, recomendamos que atividades que reproduzem vídeo não pausem a reprodução em resposta ao evento de ciclo de vida ON_PAUSE. Em vez disso, a atividade precisa começar a reprodução em resposta a ON_START e pausá-la em resposta a ON_STOP. Caso você processe eventos de ciclo de vida diretamente, em vez de usar o pacote Lifecycle, pause a reprodução do vídeo no seu gerenciador onStop() e retome a reprodução em onStart().

Quando o usuário coloca um app no modo de várias janelas, o sistema notifica a atividade sobre uma mudança na configuração, como especificado em Como processar alterações na configuração. Isso também acontece quando o usuário redimensiona o app ou o coloca novamente no modo de tela cheia. Essencialmente, essa mudança afeta o ciclo de vida da atividade igual da mesma forma que ocorre quando o sistema notifica o app sobre a mudança do modo retrato para paisagem no dispositivo, exceto que as dimensões do dispositivo são alteradas, em vez de simplesmente trocadas. Conforme discutido em Gerenciar alterações de configuração, sua atividade pode processar a mudança de configuração por conta própria ou permitir que o sistema destrua a atividade e a recrie com as novas dimensões.

Se o usuário redimensionar uma janela e aumentar uma de suas dimensões, o sistema redimensionará a atividade para corresponder à ação do usuário e emitirá mudanças de configuração conforme necessário. Se o app demorar a desenhar nas áreas recém-expostas, o sistema preencherá temporariamente essas áreas com a cor especificada pelo atributo windowBackground ou pelo atributo padrão de estilo windowBackgroundFallback.

Quando o app está no modo de várias janelas, o estado retomado depende da versão do Android do dispositivo.

  • No Android 9 (API de nível 28) e versões anteriores, somente a atividade com foco está no estado RESUMED todos os outros são PAUSED. Quando há várias atividades em um único processo de app, a atividade com a ordem Z mais alta é RESUMED e as outras são PAUSED.
  • No Android 10 (API de nível 29) e versões mais recentes, todas as atividades visíveis e com foco principal são RESUMED.

Consulte a documentação sobre retomada múltipla para ver mais informações.

Como configurar seu app para o modo de várias janelas

Se o app for direcionado à API de nível 24 ou mais recente, você pode configurar como e se as atividades dele são compatíveis com a exibição em várias janelas. Você pode definir atributos no manifesto para controlar o tamanho e o layout. As configurações de atributos de uma atividade raiz se aplicam a todas as atividades na pilha de tarefas. Por exemplo, se a atividade raiz tiver android:resizeableActivity definido como “verdadeiro”, todas as atividades na pilha de tarefas serão redimensionáveis.

Observação: se você criar um app com várias orientações que segmenta a API de nível 23 ou anterior, e o usuário usá-lo no modo de várias janelas, o sistema forçará o redimensionamento do app. O sistema exibe uma caixa de diálogo avisando o usuário de que o app pode se comportar de forma inesperada. O sistema não redimensiona apps de orientação fixa. Se o usuário tentar abrir um app desse tipo no modo de várias janelas, ele ocupará toda a tela.

Em alguns dispositivos maiores, como os Chromebooks, seu app pode ser executado em uma janela redimensionável, mesmo se você especificar android:resizeableActivity=”false”. Se isso corromper seu app, é possível usar filtros para restringir a disponibilidade do seu app nesses dispositivos.

android:resizeableActivity

Defina esse atributo no elemento <activity> ou <application> do seu manifesto para ativar ou desativar a exibição em várias janelas:

android:resizeableActivity=["true" | "false"]

Se esse atributo for definido como “verdadeiro”, a atividade poderá ser inicializada nos modos de tela dividida e forma livre. Se o atributo for definido como “falso”, a atividade não será compatível com o modo de várias janelas. Se o valor for "falso", e o usuário tentar iniciar a atividade no modo de várias janelas, a atividade usará o modo de tela cheia.

Se o app segmentar uma API de nível 24, mas o valor desse atributo não for especificado, o atributo assumirá o valor padrão “verdadeiro”.

android:supportsPictureInPicture

Defina esse atributo no nó <activity> do manifesto para indicar se a atividade é compatível com a exibição no modo picture-in-picture. Esse atributo será ignorado se android:resizeableActivity for “falso”.

android:supportsPictureInPicture=["true" | "false"]

Atributos de layout

No Android 7.0, o elemento de manifesto <layout> é compatível com diversos atributos que afetam o comportamento da atividade no modo de várias janelas:

android:defaultWidth
Largura padrão da atividade quando iniciada no modo de forma livre.
android:defaultHeight
Altura padrão da atividade quando iniciada no modo de forma livre.
android:gravity
Posicionamento inicial da atividade quando iniciada no modo de forma livre. Consulte a referência de Gravity para verificar os valores adequados.
android:minHeight, android:minWidth
Indicam a altura e largura mínimas para a atividade nos modos de tela dividida e forma livre. Se o usuário mover o divisor no modo de tela dividida para tornar uma atividade menor que o mínimo especificado, o sistema recortará a atividade para o tamanho solicitado pelo usuário.

Por exemplo, o código a seguir mostra como especificar um tamanho e um local padrão para a atividade, bem como o tamanho mínimo, quando a atividade é exibida no modo de forma livre.

<activity android:name=".MyActivity">
    <layout android:defaultHeight="500dp"
          android:defaultWidth="600dp"
          android:gravity="top|end"
          android:minHeight="450dp"
          android:minWidth="300dp" />
</activity>

Processar mudanças de configuração corretamente

Se você estiver processando mudanças de configuração de várias janelas, por exemplo, o que acontece quando um usuário redimensiona uma janela, adicione o atributo android:configChanges ao seu manifesto com pelo menos os seguintes valores:

<activity
  android:name=".MyActivity"
  android:configChanges="screenSize|smallestScreenSize
      |screenLayout|orientation"
/>

Após a adição de android:configChanges, sua atividade e seus fragmentos recebem um callback para onConfigurationChanged() em vez de serem destruídos e recriados. É possível, então, atualizar manualmente suas visualizações, recarregar recursos e executar outras operações, conforme o necessário.

Como executar seu app no modo de várias janelas

A partir do Android 7.0, o sistema oferece funcionalidade de compatibilidade com apps que podem ser executados no modo de várias janelas.

Recursos desativados no modo de várias janelas

Alguns recursos são desativados ou ignorados quando um dispositivo está no modo de várias janelas, porque não fazem sentido para uma atividade que pode estar compartilhando a tela do dispositivo com outras atividades ou apps. Esses recursos incluem o seguinte:

  • Algumas opções de personalização de IU do sistema são desativadas. Por exemplo, os apps não poderão ocultar a barra de status se não estiverem sendo executados no modo de tela cheia.
  • O sistema ignora as mudanças no atributo android:screenOrientation.

Notificações e consultas de mudança no modo de várias janelas

Activity oferece os métodos a seguir para compatibilidade com exibição em várias janelas.

isInMultiWindowMode()
Chame para descobrir se a atividade está no modo de várias janelas.
isInPictureInPictureMode()
Chame para descobrir se a atividade está no modo picture-in-picture.

Observação: o modo picture-in-picture é um caso especial do modo de várias janelas. Se myActivity.isInPictureInPictureMode() retornar “verdadeiro”, myActivity.isInMultiWindowMode() também retornará “verdadeiro”.

onMultiWindowModeChanged()
O sistema chama esse método sempre que a atividade entra ou sai do modo de várias janelas. O sistema transmitirá o valor “verdadeiro” ao método, se a atividade entrar no modo de várias janelas, e “falso”, se a atividade sair desse modo.
onPictureInPictureModeChanged()
O sistema chama esse método sempre que a atividade entra ou sai do modo picture-in-picture. O sistema transmitirá o valor “verdadeiro” ao método, se a atividade entrar no modo picture-in-picture, e “falso”, se a atividade sair desse modo.

A classe Fragment expõe versões de muitos desses métodos. Por exemplo: Fragment.onMultiWindowModeChanged().

Como entrar no modo picture-in-picture

Para colocar uma atividade no modo picture-in-picture, chame Activity.enterPictureInPictureMode(). Esse método não terá efeito se o dispositivo não for compatível com o modo picture-in-picture. Para ver mais informações, consulte a documentação do modo picture-in-picture.

Iniciar novas atividades no modo de várias janelas

Quando você inicia uma nova atividade, pode indicar que ela será exibida adjacente à atual, se possível. Para fazer isso, use a sinalização de intent FLAG_ACTIVITY_LAUNCH_ADJACENT. Essa sinalização diz ao sistema para tentar criar a nova atividade ao lado da atividade que a iniciou para que as duas atividades compartilhem a tela. O sistema faz o possível para fazer isso, mas não é garantido que isso aconteça.

Se um dispositivo estiver no modo de forma livre e você iniciar uma nova atividade, poderá especificar as dimensões e o local na tela da nova atividade chamando ActivityOptions.setLaunchBounds(). Esse método não terá efeito se o dispositivo não estiver no modo de várias janelas.

Observação: se você iniciar uma atividade em uma pilha de tarefas, essa atividade substituirá a atividade na tela, herdando todas as propriedades de várias janelas dela. Se você quiser iniciar a nova atividade como uma janela separada no modo de várias janelas, inicie-a em uma nova pilha de tarefas.

Compatibilidade com o recurso de arrastar e soltar

Os usuários podem arrastar e soltar dados de uma atividade para outra enquanto as duas atividades compartilharem a tela. Antes do Android 7.0, os usuários só podiam arrastar e soltar dados em uma única atividade. Para adicionar rapidamente compatibilidade com conteúdo que foi arrastado e solto em widgets TextView editáveis, consulte OnReceiveContentListener no Jetpack. Para oferecer compatibilidade abrangente com o recurso de arrastar e soltar, como ativar o recurso de arrastar do conteúdo do app, consulte o tópico arrastar e soltar.

DragAndDropPermissions
É o objeto token responsável por especificar as permissões concedidas ao app que recebe uma ação de soltar.
View.startDragAndDrop()
É o alias para View.startDrag(). Para ativar o recurso de arrastar e soltar entre atividades, transmita a sinalização DRAG_FLAG_GLOBAL. Se você precisar conceder permissões de URI à atividade de destino, transmita as sinalizações DRAG_FLAG_GLOBAL_URI_READ ou DRAG_FLAG_GLOBAL_URI_WRITE, conforme o caso.
View.cancelDragAndDrop()
Cancela uma operação de arrastar em andamento. Só pode ser chamado pelo app que originou a operação de arrastar.
View.updateDragShadow()
Substitui a ação de arrastar para uma operação de arrastar em andamento. Só pode ser chamado pelo app que originou a operação de arrastar.
Activity.requestDragAndDropPermissions()
Solicita as permissões dos URIs de conteúdo transmitidos com o ClipData contido em um DragEvent.
DragAndDropPermissions.release()
Libera as permissões necessárias para acessar os dados no URI de conteúdo fornecido no ClipData. Se você não chamar esse método, as permissões serão liberadas automaticamente quando a atividade contida for destruída.

Várias instâncias

Cada atividade raiz tem a própria tarefa, que é executada em um processo separado e exibida na própria janela. Para iniciar uma nova instância do seu app em uma janela separada, inicie novas atividades com a sinalização FLAG_ACTIVITY_NEW_TASK. Você pode combinar isso com alguns dos atributos de várias janelas para solicitar um local específico para a nova janela. Por exemplo, um aplicativo de compras pode exibir várias janelas para comparar produtos.

Não confunda várias instâncias com um layout de vários painéis, como um layout de lista/detalhes que usa SlidingPaneLayout. Isso é executado em uma única janela.

Quando várias instâncias estão em execução em janelas separadas em um dispositivo dobrável, uma ou mais instâncias podem ser enviadas para o segundo plano se a posição mudar. Por exemplo, suponha que um dispositivo não esteja dobrado e tenha duas instâncias de app em execução em duas janelas em ambos os lados. Se o dispositivo estiver dobrado, uma das instâncias poderá ser encerrada em vez de tentar encaixar as janelas em ambas as instâncias em uma tela menor.

Como testar a compatibilidade do seu app com o modo de várias janelas

Mesmo que você não segmente seu app para a API de nível 24 ou mais recente, é importante verificar como ele se comporta no modo de várias janelas, porque um usuário pode tentar iniciá-lo nesse modo em um dispositivo com o Android 7.0 ou versão mais recente.

Como configurar um dispositivo de teste

Se um dispositivo usar o Android 7.0 ou versão mais recente, ele será automaticamente compatível com o modo de tela dividida.

Caso seu app trabalhe com API de nível 23 ou anterior

Se o app segmentar a API de nível 23 ou anterior, e o usuário tentar usá-lo no modo de várias janelas, o sistema forçará o redimensionamento dele, a menos que seja declarada uma orientação fixa.

Se o app não declarar uma orientação fixa, inicie ele em um dispositivo com o Android 7.0 ou mais recente e tente colocar o app no modo de tela dividida. Verifique se a experiência do usuário é aceitável quando o redimensionamento do app é forçado.

Se o app declarar uma orientação fixa, tente colocá-lo no modo de várias janelas. Ao fazer isso, verifique se ele continua no modo de tela cheia.

Se você oferecer suporte ao modo de várias janelas

Se o app segmenta a API de nível 24 ou mais recente e não desativa a compatibilidade com várias janelas, verifique o comportamento a seguir nos modos de tela dividida e forma livre.

  • Mantenha o botão "Visão geral" pressionado para iniciar o app no modo de tela cheia e mudar para o modo de várias janelas. Verifique se o app alterna corretamente.
  • Inicie o app diretamente no modo de várias janelas e verifique se a inicialização ocorre corretamente. Você pode iniciar um app no modo de várias janelas pressionando o botão "Overview" e, em seguida, mantendo pressionada a barra de título do app e arrastando-o a uma das áreas destacadas na tela.
  • Redimensione o app no modo de tela dividida, arrastando a linha divisória. Verifique se o app é redimensionado sem falhar e se os elementos de IU necessários estão visíveis.
  • Se você especificou dimensões mínimas para o app, tente redimensioná-lo abaixo dessas dimensões. Verifique se não é possível redimensionar o app para um tamanho menor que o mínimo especificado.
  • Em todos os testes, verifique se o desempenho do app é aceitável. Por exemplo, verifique se há uma demora muito grande para atualizar a IU após o redimensionamento do app.

Lista de verificação de teste

Para verificar o desempenho do app no modo de várias janelas, tente as operações a seguir. Tente estas operações nos modos de tela dividida e várias janelas, exceto onde houver instruções diferentes.

  • Entre e saia do modo de várias janelas.
  • Alterne do seu app para outro e verifique se ele se comporta corretamente enquanto visível, mas não ativo. Por exemplo, se o app estiver reproduzindo vídeo, verifique se a reprodução não é interrompida quando o usuário interage com outro app.
  • No modo de tela dividida, tente mover a barra divisória para aumentar e reduzir o tamanho do app. Tente essas operações nas configurações lado a lado e um acima do outro. Verifique se o app não falha, se a funcionalidade essencial fica visível e se a operação de redimensionamento não demora demais.
  • Execute várias operações de redimensionamento em rápida sucessão. Verifique se o app não falha nem apresenta vazamentos de memória. Para ver informações sobre como verificar o uso da memória do app, use o Memory Profiler do Android Studio.
  • Use o app normalmente em configurações diferentes de janela e verifique se ele se comporta corretamente. Verifique se o texto é legível e se os elementos da IU não ficam pequenos demais para a interação.

Se você desativou a compatibilidade com o modo de várias janelas

Se você desativou a compatibilidade com várias janelas definindo android:resizeableActivity="false", inicie o app em um dispositivo com o Android 7.0 ou versão mais recente e tente colocá-lo nos modos de forma livre e tela dividida. Ao fazer isso, verifique se ele continua no modo de tela cheia.

Para ver mais informações sobre a compatibilidade com o modo de várias janelas no Android, consulte Cinco dicas para preparar o modo de várias janelas no Android N e o app de amostra Playground de várias janelas.