Suporte a apps da Web

Um app da Web transforma uma página da Web em um app Android, facilitando a localização e o uso em dispositivos móveis. Um app da Web se parece com um app nativo na tela de início de um dispositivo. Quando o usuário o abre, o navegador Chrome renderiza a página no modo de exibição selecionado (interface mínima, independente ou em tela cheia).

É possível distribuir apps da Web da mesma forma que você faria com os nativos. Isso inclui adicioná-los a coleções na Google Play Store gerenciada e instalá-los remotamente em dispositivos.

Componentes de um app da Web

Para criar um app da Web, é necessário especificar:

  • Um título que é exibido no dispositivo na Play Store gerenciada e na tela de início,
  • um URL de início que os apps da Web abrem
  • um modo de exibição que define como o app da Web é exibido no dispositivo.

Também é possível definir um ícone para o app da Web para ajudar os usuários a identificá-lo. Os ícones são opcionais, mas recomendados.

Título

O título precisa ter menos de 30 caracteres. Dependendo do formato do dispositivo, o título de um app da Web pode ser truncado na Play Store gerenciada e na tela de início do dispositivo. Portanto, recomendamos especificar o título curto.

URL de início

O URL inicial de um app da Web define a página em que ele é aberto. Então, o usuário pode navegar para outros URLs.

O URL inicial precisa ser HTTPS ou HTTP. O URL do app da Web precisa ter o esquema HTTPS quando o modo de exibição é em tela cheia ou independente.

Modo de exibição

O modo de exibição descreve quais elementos da interface do navegador ficam visíveis quando um app da Web é aberto:

  • IU reduzida:a barra de URL é mostrada na parte de cima, e a barra de status do sistema e os botões de navegação estão visíveis. Para URLs HTTP, essa é a única opção disponível.
  • Independente:a barra de URL não é mostrada, e a barra de status do sistema e os botões de navegação ficam visíveis.
  • Tela cheia:a barra de URL não é mostrada, a barra de status do sistema e os botões de navegação ficam ocultos. A interface do site precisa oferecer todos os controles de navegação.
Figura 1. Da esquerda para a direita: modos de exibição de interface mínima, independente e tela cheia.

O modo de exibição só é aplicado a páginas do mesmo domínio que o URL inicial. Se o usuário navegar para um URL de um domínio diferente do URL inicial, essa nova página será aberta em uma guia personalizada do Chrome com o novo URL visível, independente do modo de exibição selecionado. Por exemplo, se o URL inicial redirecionar imediatamente para um URL de um domínio diferente, essa página será exibida em uma guia personalizada do Chrome.

Quando um usuário abre um app da Web pela primeira vez, uma notificação na parte inferior da tela é exibida para informar que ele está em um navegador, e não em um app nativo.

Figura 2. Notificação mostrada a um usuário na primeira vez que ele abre um app da Web.

Icon

Especificar um ícone ajuda o usuário a identificar um app da Web. Para qualquer app da Web que não tenha um ícone especificado, o Google vai inserir e mostrar o mesmo ícone padrão. Para facilitar a diferenciação dos apps pelos usuários, recomendamos que você crie apps da Web com ícones distintos e significativos.

Os administradores de TI podem definir um único ícone para os apps da Web criados no iframe do Google Play gerenciado. Ao usar a API para criar apps da Web, você pode permitir que os administradores de TI definam vários ícones. Esses ícones serão incorporados ao APK do app da Web, e o sistema Android exibirá o ícone mais adequado para a resolução da tela do dispositivo. A Play Store gerenciada sempre mostra o primeiro ícone especificado para um app da Web.

O primeiro ícone deve ser um quadrado de 512 x 512 pixels. PNG e JPEG são formatos aceitáveis, mas não podem ter mais de 1 MB. Os ícones que não aderirem a esse formato serão redimensionados para a entrada da Play Store gerenciada. O ícone também precisa ser "mascarável" para adaptar a própria forma a cada sistema. Consulte Ícones mascaráveis para ver mais detalhes.

Ao usar a API, os dados do ícone precisam ser codificados no formato base64url (ou seja, base64, mas todos os sinais "+" são substituídos por "-" e "/" substituídos por "_". Consulte a seção 5 do RFC 4648 para mais detalhes]).

Criar um app da Web

É possível criar apps da Web incorporando o iframe do Google Play gerenciado ao console de EMM ou fazendo a integração com a API. As duas abordagens são intercambiáveis e oferecem a mesma experiência do usuário final em dispositivos. Portanto, cabe a você decidir qual abordagem funciona melhor com sua solução.

Opção 1: incorporar o iframe do Google Play gerenciado

O iframe do Google Play gerenciado inclui uma interface do usuário para que os administradores de TI criem, editem e excluam apps da Web. Se você quiser oferecer suporte a apps da Web com essa opção, siga as instruções para incorporar o iframe do Google Play gerenciado ao seu console de EMM. A interface do app da Web pode ser acessada no menu de navegação à esquerda do iframe.

Depois que um app da Web é criado no iframe, leva alguns minutos para que ele possa ser selecionado na interface. Quando um app da Web é selecionado, um evento onproductselect é acionado com o ID do produto do app da Web transmitido no evento.

Com o ID do produto de um app da Web, é possível distribuí-lo aos usuários.

Opção 2: integrar com a API

Outra forma de oferecer suporte a apps da Web no console de EMM é fazer a integração com a API de apps da Web. Para criar um app da Web, use o método webapps.insert. Há outros métodos disponíveis para

  • Listar todos os apps da Web de uma empresa
  • Recuperar os detalhes de um único app da Web
  • Atualizar apps da Web
  • Excluir apps da Web
Para mais detalhes, consulte a referência da API.

Os apps da Web criados com a API podem ser adicionados à política imediatamente após a criação. No entanto, pode levar alguns minutos até que eles sejam instalados nos dispositivos ou fiquem visíveis para o usuário na Play Store gerenciada.

Distribuir um app da Web

É possível distribuir um app da Web como qualquer outro app, adicionando o ID do produto retornado pelo iframe ou pela API à política de um dispositivo.

Para que um dispositivo seja compatível com o modo de exibição de um app da Web, ele precisa ter o Google Chrome (nome do pacote com.android.chrome) instalado. Para garantir que o Chrome esteja instalado no dispositivo, recomendamos adicioná-lo à política do dispositivo e definir autoInstallMode como forceAutoInstall.

Se o Google Chrome não estiver instalado no dispositivo, uma caixa de diálogo será exibida ao abrir o app da Web indicando que é necessário instalar o Google Chrome.

Atualizar um app da Web

O iframe do Google Play gerenciado permite que os administradores de TI editem os apps da Web publicados. Com a API, é possível atualizar qualquer aspecto de um app da Web chamando webapps.patch. O método usa o nome do app além dos mesmos parâmetros que webapps.insert.

As atualizações levam de alguns minutos a até 24 horas para serem propagadas para todos os dispositivos, dependendo das configurações de atualização do app. Em alguns casos, pode ser necessário que os usuários limpem o cache do app na tela de início do dispositivo antes que as atualizações nos títulos de apps da Web sejam refletidas nessa tela.

O Google também atualiza periodicamente seus apps da Web para atualizar o wrapper do Chrome. Isso não afeta empresas nem os usuários, exceto que os números de versão do app da Web mudam e os apps são atualizados automaticamente pela Play Store no próximo momento conveniente.

Excluir um app da Web

O iframe do Google Play gerenciado permite que os administradores de TI excluam apps da Web. Com a API, você pode chamar webapps.delete para excluir um app da Web. A exclusão de um app da Web o remove da Play Store gerenciada, mas não o desinstala dos dispositivos. Para desinstalar um app da Web de um dispositivo, chame installs.delete.