Os ícones com máscara são um novo formato que garante que o ícone do PWA fique ótimo em todos os dispositivos Android. Em dispositivos Android mais recentes, os ícones de PWA que não seguem o formato de ícone mascarado têm um plano de fundo branco. Quando você usa um ícone mascarável, ele ocupa todo o espaço fornecido pelo Android.
Como a auditoria de ícone mascarado do Lighthouse falha
O Lighthouse sinaliza páginas que não têm suporte a ícones mascaráveis:
Para passar na auditoria:
- Um manifesto de app da Web precisa existir.
- O manifesto do app da Web precisa ter uma matriz
icons
. - A matriz
icons
precisa conter um objeto com uma propriedadepurpose
, e o valor dessa propriedadepurpose
precisa incluirmaskable
.
Como adicionar suporte a ícones mascarados ao seu PWA
- Use o Editor Maskable.app para converter um ícone em um ícone com máscara.
Adicione a propriedade
purpose
a um dos objetosicons
no manifesto do app da Web. Defina o valor depurpose
comomaskable
. Consulte Valores.{ … "icons": [ … { "src": "path/to/maskable_icon.png", "sizes": "196x196", "type": "image/png", "purpose": "maskable" } ] … }
Use o Chrome DevTools para verificar se o ícone mascarado está sendo exibido corretamente. Consulte Meus ícones atuais estão prontos?