Se você tentou exibir um PDF no Adalo e acabou frustrado, este é o artigo que eu desejava que existisse quando comecei.
O Problema Que Todo Desenvolvedor Adalo Enfrenta
Você está construindo um aplicativo Adalo. Os usuários precisam visualizar um PDF — um contrato, um relatório, um certificado, um e-book, um manual. Você abre o editor do Adalo esperando uma solução simples.
Não há nenhuma.
O que geralmente acontece é uma hora (ou várias) de tentar cada contorno, cada um com seu próprio defeito fatal.
Por Que as Abordagens Existentes Não Conseguiam Resolver o Problema
Abordagem 1: Componente Web View + URL Mágica de Texto
A sugestão mais comum no fórum do Adalo. Você adiciona um componente Web View, conecta-o a um campo de Arquivo via texto mágico e espera que o PDF seja renderizado na linha.
O que realmente acontece: No preview web do Adalo às vezes funciona. Em uma versão real instalada em iOS ou Android, geralmente aparece uma caixa branca vazia ou abre o PDF no navegador externo do dispositivo — completamente fora do seu aplicativo. A URL de seu arquivo também é exposta na barra de endereços do navegador.
Abordagem 2: Ação de Link Externo
Você adiciona um botão com uma ação de link externo apontando para o URL do PDF.
O que realmente acontece: Isso abre o navegador do sistema (Safari em iOS, Chrome no Android). O usuário sai completamente do seu aplicativo. Não há botão voltar. A experiência está quebrada, a URL é visível e você perdeu o controle da interface.
Abordagem 3: Navegador Interno
O navegador interno do Adalo mantém o usuário dentro da capa do aplicativo enquanto carrega uma URL.
O que realmente acontece: Ainda usa um motor web por trás. PDFs renderizados através de um motor web em dispositivos móveis são inconsistentes — alguns dispositivos os renderizam, outros não. O zoom com dois dedos nem sempre funciona. Não há capacidade nativa de compartilhar ou baixar.
Abordagem 4: Componentes do Mercado Terceirizado
Há alguns componentes PDF terceiros no Adalo Marketplace. Até 2025, a experiência da comunidade com esses foi:
- Um não é mais mantido ativamente
- O outro tem problemas de estabilidade em builds iOS
- A resposta do suporte demora quando as coisas quebram
O Que um Visualizador PDF Nativo Realmente Precisa Fazer
Depois de passar por tudo isso, aqui está o que significa "funcionar corretamente" para um visualizador PDF em um aplicativo móvel sem código:
- Rendere na linha — o PDF abre dentro do aplicativo, não em um navegador externo.
- Use o motor PDF nativo — no iOS isso é PDFKit, no Android é PdfRenderer. Esses são testados em batalha, rápidos e lidam corretamente com casos de borda.
- Suporte ao zoom com dois dedos — gesto padrão, deve funcionar.
- Exponha compartilhamento e download — os usuários devem ser capazes de AirDrop, enviar por e-mail ou salvar o PDF via a folha nativa de compartilhamento.
- Funcione com URLs dinâmicas — conecte-se a um campo de arquivo do banco de dados ou texto mágico, não apenas URLs codificadas.
- Funcione na Web também — os aplicativos Adalo geralmente funcionam na web; o componente deve lidar com esse contexto elegantemente.
Nenhuma das soluções atuais verifica todas as seis caixas.
A Solução: Um Visualizador PDF Nativo Especializado para Adalo
Um componente de visualizador nativo PDF está sendo construído especificamente para o Mercado do Adalo para abordar todas essas lacunas.
O que ele faz:
- Abre PDFs totalmente inline — os usuários nunca deixam o aplicativo
- Usa PDFKit no iOS e PdfRenderer no Android — a própria engine nativa da plataforma
- Funciona na versão web do Adalo também, usando uma biblioteca de renderização PDF incorporada
- Suporta zoom com dois dedos, rolagem suave e navegação entre páginas
- Inclui uma barra de pesquisa flutuante para busca completa de texto dentro do documento
- Exibe a folha de compartilhamento nativa — os usuários podem AirDrop, salvar em Arquivos ou enviar por e-mail o PDF
- Requer apenas um único URL property — conecte-o a qualquer campo de arquivo, texto mágico ou URL externa
- Faz integração direta com campos de arquivo do banco de dados Adalo
Você é quem?
- Desenvolvedores Adalo construindo aplicativos pesados em documentos (contratos, certificados, relatórios, manuais, e-books)
- Aplições onde os usuários precisam visualizar PDFs específicos do usuário de um banco de dados
- Equipes que já tentaram a abordagem WebView e encontraram o problema da caixa em branco nas builds iOS
Como Configurar
A configuração leva menos de 5 minutos:
- Instale o componente PDF Viewer no Adalo Marketplace
- Sobrescreva-o na tela como qualquer outro componente
- Defina a propriedade PDF URL — seja um URL estático ou texto mágico apontando para um campo de arquivo
- Fim. Ele renderiza inline em iOS, Android e Web.
Nenhuma parte traseira necessária. Nenhum serviço externo. Sem chave de API. Apenas uma URL.
Perguntas Frequentes
Pode exibir PDFs armazenados no meu banco de dados Adalo?
Sim. Se você tiver um campo de arquivo em uma coleção, conecte-o via texto mágico e ele carregará o documento específico do usuário.
Funciona na versão web do Adalo?
Sim. O componente lida com o contexto da web separadamente e renderiza corretamente no output de web do Adalo.
E PDFs armazenados no Google Drive ou Dropbox?
Qualquer URL pública de PDF funciona — links diretos de download do Google Drive, Dropbox, AWS S3 ou sua própria CDN.
Funciona o zoom com dois dedos?
Sim. Porque usa a engine nativa de PDF (não um WebView), gestos padrão funcionam exatamente como no Arquivos ou leitor de PDF do Safari.
O usuário pode baixar ou compartilhar o PDF?
Sim. Um botão de compartilhamento abre a folha de compartilhamento nativa iOS ou intenção de compartilhamento Android — os usuários podem AirDrop, salvar em Arquivos, enviar por e-mail ou imprimir.
A URL do PDF é exposta aos usuários?
Não. A URL nunca aparece na barra de endereço do navegador.
É um WebView sob o capô?
Não. No iOS, usa a Apple's PDFKit. No Android, usa o PdfRenderer API. Nenhum é uma camada sobre WebView.
Receba Notificações Quando Lançar
O componente está atualmente sob revisão para o Adalo Marketplace. Inscreva-se para ser o primeiro a saber:
👉 https://adalo-pdfviewer.pages.dev
Resumo
| Abordagem | Inline? | Motor nativo? | Zoom? | Compartilhar? | Funciona em builds iOS? |
|---|---|---|---|---|---|
| WebView + Texto mágico | ❌ | ❌ | ❌ | ❌ | ❌ |
| Ligação externa | ❌ | — | — | — | ✅ (deixa o aplicativo) |
| Navegador interno | Parcial | ❌ | Inconsistente | ❌ | Parcial |
| Mercado de terceiros | Parcial | ❌ | Parcial | ❌ | Inestável |
| Visionador PDF nativo (em breve) | ✅ | ✅ | ✅ | ✅ | ✅ |
Criado por um desenvolvedor Adalo que bateu em todas essas paredes. Perguntas ou feedback são bem-vindos.