Como Exportar um APK do VULK

Atualizado a 17 de julho de 2026 — refrescado com a exportação de AAB, os requisitos de plano atuais e dados verificados da plataforma.

Como se exporta um APK do VULK?

A resposta completa: abre o teu projeto Flutter no editor do VULK, confirma que corre sem erros na pré-visualização e clica em Export APK na barra de ferramentas. O VULK resolve as dependências do teu pubspec.yaml, compila o teu código Dart ahead-of-time para código máquina ARM nativo, empacota os assets, monta e assina o APK em modo debug — tipicamente em 30 a 90 segundos — e entrega-te um .apk que podes instalar em qualquer dispositivo Android. A exportação de AAB (o formato que a Google Play exige) está disponível da mesma forma. Precisas de um projeto Flutter e de um plano pago: a exportação de APK/AAB está incluída no Builder ($19.99/mês), Pro, Team, Max e Business. O VULK não tem free tier — todos os planos começam com um intro de 3 dias de acesso completo desde $3.99, creditado no teu primeiro mês.

Este é o passo que a maioria dos construtores de apps com IA não consegue dar: geram código mobile, mas tens de montar uma toolchain local para obter um binário. No VULK, o Flutter é a plataforma #2 (5,6% dos projetos com stack detetável) e a plataforma mais pedida nos prompts (dados da plataforma VULK, julho de 2026) — e o prompt-até-APK-instalável é a razão.

O que precisas antes de exportar?

Antes de exportar, garante que o teu projeto cumpre estes requisitos:

• O projeto tem de ser um projeto Flutter. A exportação de APK só está disponível para apps Flutter, não para projetos React, PHP ou Shopify. Se tiveres dúvidas, verifica a árvore de ficheiros — os projetos Flutter têm uma pasta lib/ com ficheiros .dart e um pubspec.yaml.
• A app tem de compilar na pré-visualização. Se a pré-visualização mostra erros, o build do APK também vai falhar. Corrige primeiro qualquer problema de compilação pedindo ao VULK para o resolver no chat.
• Precisas de um plano pago com exportação. A exportação de APK/AAB está disponível nos planos Builder, Pro, Team, Max e Business.

Passo 1: Como verificas a app na pré-visualização?

Abre o teu projeto Flutter no editor do VULK. O painel direito mostra a pré-visualização da tua app — uma compilação real server-side de flutter build web do teu código Dart. Navega por todos os ecrãs e testa as interações principais:

• Todas as rotas de navegação funcionam? Percorre a barra de navegação inferior, o menu drawer ou a barra de separadores.
• Os formulários validam corretamente? Tenta submeter campos vazios.
• As listas renderizam com os dados esperados?
• Há falhas visuais — erros de overflow, elementos desalinhados ou imagens em falta?

Corrige os problemas antes de exportar. É muito mais rápido iterar na pré-visualização do browser do que reconstruir um APK a cada correção. Usa prompts de seguimento como:

O ecrã de perfil tem um erro de overflow de texto em nomes de utilizador longos. Corrige-o adicionando ellipsis de overflow e uma restrição de largura máxima.

Os ícones da barra de navegação inferior não ficam destacados quando mudo de separador. Garante que o selectedIndex é atualizado corretamente.

Passo 2: O que acontece quando clicas em Export APK?

Quando a tua app estiver estável na pré-visualização, localiza o botão Export APK na barra de ferramentas do editor. Fica na barra de ações superior, ao lado do botão Deploy. Clica para iniciar o processo de build.

O que acontece nos bastidores:

1. Resolução de dependências. O VULK corre o equivalente a flutter pub get para instalar todos os packages listados no teu pubspec.yaml.
2. Compilação Dart. O teu código-fonte Dart é compilado para código máquina ARM nativo com o compilador ahead-of-time (AOT) do Flutter. Isto é diferente da pré-visualização web, que usa um alvo de compilação JavaScript.
3. Empacotamento de recursos. Assets como fontes, imagens e ficheiros JSON referenciados no teu pubspec.yaml são empacotados no APK.
4. Montagem do APK. O código compilado, os recursos, o manifest Android e o motor do Flutter são montados num único ficheiro .apk.
5. Assinatura debug. O APK é assinado com uma chave de debug para poder ser instalado em qualquer dispositivo Android sem distribuição pela Play Store.

O build demora tipicamente 30 a 90 segundos, dependendo da complexidade do projeto e do número de dependências.

Passo 3: Como fazes o download do APK?

Quando o build termina, aparece um diálogo de download com o teu ficheiro .apk. O ficheiro tem o nome do teu projeto — por exemplo, workout-tracker.apk. Clica para o descarregar para o teu computador.

O tamanho do ficheiro depende da complexidade da tua app. Um APK Flutter típico gerado no VULK varia entre 15 MB e 40 MB. Isto inclui o motor do Flutter (~10 MB), o teu código Dart compilado e os assets empacotados. APKs otimizados para produção compilados localmente com flutter build apk --release seriam mais pequenos, mas a exportação do VULK fornece um build totalmente funcional para testes e demonstração.

Passo 4: Como instalas o APK no teu dispositivo Android?

Há duas formas de levar o APK até ao teu telemóvel.

Opção A: Transferência direta

1. Liga o teu dispositivo Android ao computador via USB.
2. Copia o ficheiro .apk para a pasta Downloads do dispositivo.
3. No telemóvel, abre uma app de gestão de ficheiros e navega até Downloads.
4. Toca no ficheiro .apk.
5. O Android vai pedir-te para permitir a instalação de origens desconhecidas (já que não vem da Play Store). Ativa-a para a tua app de gestão de ficheiros.
6. Toca em Instalar.

Opção B: Autoenvio

1. Carrega o ficheiro .apk para o Google Drive ou Dropbox, ou envia-o a ti próprio por email ou app de mensagens.
2. No dispositivo Android, abre o ficheiro a partir do serviço cloud ou da mensagem.
3. Segue os mesmos passos de instalação da Opção A.

Após a instalação, a tua app aparece na gaveta de apps como qualquer outra app Android. Tem o ícone predefinido do Flutter, a menos que tenhas especificado um ícone de launcher personalizado no teu prompt.

O que contém o APK exportado — e o que não contém?

Para a Google Play, exporta antes um AAB (App Bundle), ou descarrega o código-fonte e compila localmente um release assinado com flutter build appbundle --release.

Quais são os problemas comuns e como se resolvem?

O build falha com erros de dependências

Alguns packages Flutter exigem versões específicas do SDK ou têm dependências específicas de plataforma que entram em conflito. O VULK fixa as versões das dependências durante a geração para manter os builds server-side verdes, mas se o build falhar, verifica a mensagem de erro no diálogo de exportação e pede:

O build falhou por causa de um conflito de dependências. Atualiza o package http para a versão mais recente e garante que todas as dependências são compatíveis.

A app crasha ao arrancar

Isto normalmente significa um erro de runtime no teu código Dart que não apareceu na pré-visualização web. Causas comuns incluem chamadas a platform channels (tentar aceder a uma API nativa que funciona de forma diferente em Android vs web) ou erros de referência nula no tratamento de dados. Verifica a pré-visualização com atenção e corrige os problemas antes de reexportar.

A app fica diferente no telemóvel vs pré-visualização

A pré-visualização web usa o rendering do Flutter Web, enquanto o APK usa o renderer nativo baseado em Skia. Pequenas diferenças no rendering de texto, na qualidade das sombras e no antialiasing são esperadas. Se o layout estiver significativamente diferente, é provavelmente um problema de responsividade — o iframe da pré-visualização pode ter uma largura diferente do ecrã do teu telemóvel. Adiciona verificações responsivas:

Faz o layout do ecrã inicial adaptar-se a diferentes larguras de ecrã. Em ecrãs com menos de 360dp, usa um layout de coluna única em vez da grelha de duas colunas.

O APK é grande demais

Os APKs Flutter incluem o motor, que acrescenta aproximadamente 10 MB. Se a tua app incluir assets grandes (imagens de alta resolução, datasets JSON empacotados), o tamanho aumenta. Para reduzir, usa imagens carregadas por rede em vez de assets empacotados, e considera descarregar o código-fonte para compilar um APK de release com --split-per-abi, que produz builds específicos por arquitetura (~8 MB para arm64).

O que vem depois do APK?

O APK exportado é ideal para testes, demos e partilha com stakeholders. Para distribuição em produção, vais querer:

1. Exportar um AAB do VULK, ou descarregar o código-fonte (exportação ZIP).
2. Montar um ambiente Flutter local com Android Studio ou VS Code.
3. Configurar a assinatura da app com um keystore de release.
4. Personalizar o ícone da app com o package flutter_launcher_icons.
5. Compilar um App Bundle de release com flutter build appbundle --release.
6. Submeter à Google Play Console para distribuição.

O VULK leva-te da ideia a uma app Android funcional em minutos — em toda a plataforma, o tempo mediano do registo à primeira app gerada é de 47 segundos (dados da plataforma VULK, julho de 2026). A exportação de APK permite-te segurar essa app na mão e mostrá-la a utilizadores reais. O caminho daí até à Play Store é um workflow de publicação Flutter standard — o teu código é Dart limpo e standard, pronto para ferramentas de produção.