APK Master Pro - Guia de Implementação

Bem-vindo ao APK Master Pro

Este guia detalha cada requisito necessário para que seu site PWA seja convertido em um aplicativo nativo de alta performance (Android/Windows) com validação total de domínio.

Manifest.json Ocorrências

Seu site DEVE possuir um arquivo manifest.json linkado no <head>. Este arquivo define como o app se comporta.

Copiar

{
  "name": "Nome do Seu App",
  "short_name": "App",
  "start_url": "/",
  "display": "standalone",
  "background_color": "#ffffff",
  "theme_color": "#3b82f6",
  "icons": [
    { "src": "/icon-192.png", "sizes": "192x192", "type": "image/png" },
    { "src": "/icon-512.png", "sizes": "512x512", "type": "image/png" }
  ]
}
                

✅ display: Deve ser "standalone" para remover a interface do navegador.
✅ start_url: URL inicial relativa ou absoluta.

Digital Asset Links (Remover Barra)

Para que o Android oculte a barra de endereço "Powered by Chrome", você precisa hospedar o arquivo de validação.

Caminho do arquivo:

https://seudominio.com/.well-known/assetlinks.json

Passos Críticos:

Crie uma pasta chamada .well-known no root do servidor.
Coloque o arquivo assetlinks.json dentro dela.
Configure o servidor para servir como application/json.
Certifique-se de que o SSL (HTTPS) está ativo e válido.

⚠️ Erro Comum: Se o arquivo retornar 404 ou o MIME type for text/plain, a barra de URL continuará aparecendo no APK.

Service Worker & Offline

O Service Worker é obrigatório para que o Google considere seu site um PWA instalável. Ele gerencia o cache offline e as notificações push.

Copiar

// Registro no main.js
if ('serviceWorker' in navigator) {
  navigator.serviceWorker.register('/sw.js');
}
                

Dica: Use bibliotecas como Workbox para facilitar o gerenciamento de cache.

Fluxo de Criação (Passo a Passo)

1. Análise de URL

Insira a URL do seu site. Nosso motor irá varrer o domínio em busca do manifest.json e ícones automáticos.

2. Identidade Visual

No plano PRO, você pode enviar ícones de alta resolução e telas de splash personalizadas que substituem o padrão do navegador.

3. Configurações de APK

Defina o Package Name (ex: com.seu.app). Atenção: Se você já tem um app na Play Store, use o MESMO Package Name.

4. Geração e Build

Nossos servidores Android Pro iniciam a compilação. Isso leva de 1 a 3 minutos dependendo da carga do sistema.

Certificados (Keystores)

A Keystore é a "assinatura digital" do seu app. Sem ela, você não consegue atualizar o app na Google Play.

Assinatura Padrão: Usamos nosso certificado global. Recomendado para testes e uso privado.
Assinatura Customizada: No plano PRO, você faz upload da sua própria .jks ou .keystore. Essencial para publicação profissional.

Copiar

🤖 Manual para Outras IAs / Prompt Dev

"Atue como um Engenheiro de PWA. Configure meu site para ser compatível com o sistema APK Master Pro. Requisitos: 1. Crie um manifest.json com start_url: '/' e display: 'standalone'. 2. Configure uma rota estática para servir '.well-known/assetlinks.json' com o cabeçalho 'Content-Type: application/json'. 3. O JSON deve conter a relação 'delegate_permission/common.handle_all_urls'. 4. Implemente um Service Worker (sw.js) funcional para suporte offline e push notifications."

❓ Solução de Problemas

A barra de URL ainda aparece no Android. ▼

Geralmente é erro no JSON do AssetLinks ou o SHA256 não bate com a chave usada no build. Verifique no Passo 2 do nosso gerador se o JSON que você copiou é o atual.

O app crasha ao abrir no Windows. ▼

Certifique-se de que a URL informada é HTTPS. O WebView2 do Windows exige conexões seguras para a maioria das funcionalidades nativas.

As notificações push não chegam. ▼

O usuário deve aceitar a permissão de notificação. Além disso, o token de inscrição deve ser enviado via API no momento do registro do Service Worker.

Manual de Engenharia v3.0