Perguntas frequentes e solução de problemas

Esta página fornece respostas para perguntas frequentes sobre o App Hosting.

App Hosting FAQ

O App Hosting é compatível com frameworks que não sejam Next.js e Angular?

O App Hosting oferece suporte pré-configurado para build e implantação de Next.js e Angular, em que nos comprometemos a entender esses frameworks e interpretar as configurações nativas deles. Para vários outros frameworks, a comunidade de desenvolvedores oferece suporte a adaptadores de framework App Hosting. Além disso, para qualquer aplicativo Node.js com um script de build e inicialização, o App Hosting tentará fazer builds, mas não poderá garantir o sucesso. Consulte Integração de framework.

Em quais regiões o Firebase App Hosting está disponível?

As regiões para App Hosting provavelmente vão aumentar com o tempo. Consulte Locais do App Hosting para informações atualizadas.

Posso usar o GitLab ou outros provedores do Git além do GitHub para implantações?

No momento, não é possível, mas a compatibilidade com outros provedores está no plano de longo prazo do App Hosting.

Por que não consigo encontrar meu repositório na interface do console do Firebase? 

Se o repositório não aparecer na lista de opções ao criar um novo back-end no console do Firebase, primeiro selecione Atualizar lista. Se o repositório preferido ainda não estiver disponível, talvez seja necessário adicioná-lo usando a opção Conceder acesso a um novo repositório no GitHub.

Além disso, é possível gerenciar repositórios com o aplicativo Firebase App Hosting do GitHub. Para isso, acesse seu perfil do GitHub, selecione Configurações e depois Aplicativos. Na linha da tabela do aplicativo Firebase App Hosting, clique em Configurar para gerenciar repositórios.

Por que meu site não aparece normalmente na WebView do app Android para dispositivos móveis? 

Os apps que configuraram um domínio personalizado com o console do Firebase antes do terceiro trimestre de 2025 podem notar que o site não é exibido corretamente na WebView do Android. Isso acontece porque os registros CNAME usados durante esse período não eram compatíveis com o Android WebView.

Para resolver esse problema, remova o domínio personalizado do back-end App Hosting e adicione-o novamente. A interface atualizada do console vai fornecer três novos registros: um A e um TXT para o domínio, além de um CNAME para o subdomínio de desafio ACME (para certificados). Use esses registros no lugar do registro CNAME anterior.

Como faço para mudar o repositório associado ao meu projeto App Hosting?

No momento, não é possível mudar o repositório. No entanto, você pode criar um novo back-end associado ao repositório preferido no mesmo projeto ou criar um novo back-end em um projeto separado.

Como posso definir cabeçalhos para meu site App Hosting?

Os cabeçalhos dependem da estrutura. Faça o que você normalmente faria com seu framework.

Existe um emulador para desenvolvimento local com App Hosting?

Sim, é possível realizar testes locais do app antes da implantação do App Hosting usando o emulador App Hosting, que faz parte do Pacote de emuladores locais do Firebase. Consulte Testar localmente a implantação do app .

Por que vejo erros em App Hosting, mas não no Cloud Build?

Nesses casos, é possível que o erro tenha vindo do Cloud Run. Verifique o status do lançamento para ter certeza.

Como faço para mudar ou remover uma conta do GitHub vinculada?

Para remover a conta do GitHub vinculada, abra o Developer Connect, verifique se o projeto está selecionado e exclua a conexão firebase-app-hosting-github-oath e a conexão que começa com apphosting-github-conn-. Ao abrir App Hosting no console Firebase, você poderá configurar uma nova conexão com o GitHub.

Como posso definir cookies para meu site App Hosting?

Embora não estivesse disponível no lançamento da prévia do App Hosting, o cabeçalho de resposta HTTP Set-Cookie agora funciona conforme o esperado.

Limitações e solução de problemas gerais do App Hosting

• A CDN do App Hosting só pode incluir um conjunto específico de cabeçalhos de solicitação nas chaves de cache. Essa lista inclui os cabeçalhos RSC, Next-Router-State-Tree, Next-Router-Prefetch, Next-Router-Segment-Prefetch e Next-Url do NextJS, além dos cabeçalhos padrão do Cloud CDN Accept, Accept-Encoding, Access-Control-Request-Headers, Access-Control-Request-Method, Origin, Sec-Fetch-Dest, Sec-Fetch-Mode, Sec-Fetch-Site, X-Goog-Allowed-Resources e X-Origin. Se uma resposta contiver um cabeçalho Vary com um valor não listado aqui, nossa CDN não vai armazená-la em cache.
• Os arquivos estáticos sem cache são veiculados de Cloud Run. Em uma versão posterior, eles serão armazenados e veiculados da origem App Hosting para melhorar o desempenho.
• O console Firebase pode mostrar intermitentemente um erro "build was not found and is invalid" (build não encontrado e inválido) na criação do back-end.
• Todos os back-ends no mesmo projeto compartilham uma organização/conta do GitHub. Elas podem estar conectadas a repositórios diferentes na mesma organização/conta. Para criar back-ends conectados a contas diferentes do GitHub, coloque-os em projetos separados.

Limitações e solução de problemas do app Angular

Embora o suporte do App Hosting para Angular esteja em desenvolvimento e expansão, ele tem as seguintes limitações:

• I18n: embora a funcionalidade principal do I18n funcione, a navegação direta para páginas SSR pode resultar em erros.
• Localização: não é possível criar versões para diferentes localidades.
• Builders: no momento, apenas o Application builder é compatível.
• Ambientes e ferramentas de monorepo: projetos do Angular com mais de um destino de aplicativo vão falhar. Para uma compatibilidade mais completa com monorepos, use o Nx.

Limitações e solução de problemas do Next.js

• Por padrão, a otimização de imagens integrada do NextJS fica desativada no App Hosting, a menos que você defina explicitamente images.unoptimized como "false" ou use um carregador de imagens personalizado. Consulte Otimizar o carregamento de imagens no Next.js.
• Os caminhos de URL que contêm caracteres codificados por porcentagem são decodificados por Cloud Run. Isso pode causar problemas com recursos que esperam apenas caminhos de URL codificados, como o roteamento paralelo do Next.js.
• No momento, o App Hosting limita o armazenamento em cache para apps NextJS usando middleware. Com o tempo, as taxas de ocorrência em cache vão melhorar.
• Os caminhos de URL que contêm caracteres codificados por porcentagem são decodificados pelo Cloud Run. Isso pode causar problemas com recursos que esperam apenas caminhos de URL codificados, como o roteamento paralelo do Next.js.