FAQ et dépannage

Vous trouverez sur cette page des réponses aux questions fréquentes sur App Hosting.

App Hosting Questions fréquentes

App Hosting est-il compatible avec d'autres frameworks que Next.js et Angular ?

App Hosting fournit une assistance préconfigurée pour la compilation et le déploiement de Next.js et Angular, pour lesquels nous nous sommes engagés à comprendre ces frameworks et à interpréter leurs configurations natives. Pour un certain nombre d' autres frameworks, la communauté des développeurs prend en charge les adaptateurs de framework App Hosting. De plus, pour toute application Node.js avec un script de compilation et de démarrage, App Hosting tentera de compiler, mais ne peut pas garantir le succès de l'opération. Consultez Intégration du framework.

Quelles sont les régions compatibles avec Firebase App Hosting ?

Les régions pour App Hosting devraient s'étendre au fil du temps. Pour obtenir les dernières informations, consultez les emplacements App Hosting.

Puis-je utiliser GitLab ou d'autres fournisseurs Git que GitHub pour les déploiements ?

Pour le moment, vous ne pouvez pas, mais la prise en charge d'autres fournisseurs est prévue à long terme pour App Hosting.

Pourquoi ne puis-je pas trouver mon dépôt dans l'interface utilisateur de la console Firebase ? 

Si votre dépôt n'apparaît pas dans la liste des options lorsque vous créez un backend dans la console Firebase, commencez par sélectionner Actualiser la liste. Si le dépôt de votre choix n'est toujours pas disponible, vous devrez peut-être l'ajouter à l'aide de l'option Accorder l'accès à un nouveau dépôt dans GitHub.

Vous pouvez également gérer les dépôts avec l'application GitHub Firebase App Hosting. Pour ce faire, accédez à votre profil GitHub, puis sélectionnez Settings (Paramètres), puis Applications. Dans la ligne du tableau correspondant à l'application Firebase App Hosting, cliquez sur Configurer pour gérer les dépôts.

Pourquoi mon site ne s'affiche-t-il pas normalement dans WebView de l'application mobile Android ? 

Il est possible que les applications ayant configuré un domaine personnalisé avec la console Firebase avant le troisième trimestre 2025 constatent que le site ne s'affiche pas correctement dans Android WebView. Cela se produit, car les enregistrements CNAME utilisés pendant cette période n'étaient pas compatibles avec Android WebView.

Pour résoudre ce problème, supprimez le domaine personnalisé du backend App Hosting, puis ajoutez-le à nouveau. L'interface utilisateur de la console mise à jour fournira trois nouveaux enregistrements : un enregistrement A et un enregistrement TXT pour le domaine, ainsi qu'un enregistrement CNAME pour le sous-domaine du défi ACME (pour les certificats). Utilisez ces enregistrements à la place de l'enregistrement CNAME précédent.

Comment modifier le dépôt associé à mon projet App Hosting ?

Il n'est pas possible de modifier le dépôt pour le moment. Toutefois, vous pouvez créer un backend associé au dépôt de votre choix dans le même projet ou dans un projet distinct.

Comment définir des en-têtes pour mon site App Hosting ?

Les en-têtes dépendent du framework. Faites ce que vous feriez normalement pour votre framework.

Existe-t-il un émulateur pour le développement local avec App Hosting ?

Oui, vous pouvez effectuer des tests locaux de votre application avant le déploiement de App Hosting à l'aide de l'émulateur App Hosting, qui fait partie de la suite d'émulateurs locaux Firebase. Consultez Tester le déploiement de votre application en local .

Pourquoi des erreurs s'affichent-elles dans App Hosting, mais pas dans Cloud Build ?

Dans ce cas, il est possible que l'erreur provienne de Cloud Run. Vérifiez l'état du déploiement pour en être sûr.

Comment modifier ou supprimer un compte GitHub associé ?

Pour supprimer le compte GitHub associé, ouvrez Developer Connect, assurez-vous que votre projet est sélectionné, puis supprimez la connexion firebase-app-hosting-github-oath et celle qui commence par apphosting-github-conn-. Lorsque vous ouvrez App Hosting dans la console Firebase, vous devriez maintenant pouvoir configurer une nouvelle connexion GitHub.

Comment puis-je définir des cookies pour mon site App Hosting ?

Bien qu'il n'ait pas été disponible lors du lancement de l'aperçu App Hosting, l'en-tête de réponse HTTP Set-Cookie fonctionne désormais comme prévu.

Limites et dépannage généraux App Hosting

• Le CDN de App Hosting ne peut inclure qu'un ensemble spécifique d'en-têtes de requête dans ses clés de cache. Cette liste inclut les en-têtes RSC, Next-Router-State-Tree, Next-Router-Prefetch, Next-Router-Segment-Prefetch et Next-Url de NextJS, ainsi que les en-têtes standards 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 et X-Origin de Cloud CDN. Si une réponse contient un en-tête Vary avec une valeur qui ne figure pas dans la liste ci-dessus, notre CDN ne la mettra pas en cache.
• Les fichiers statiques non mis en cache sont diffusés à partir de Cloud Run. Dans une version ultérieure, ils seront stockés et diffusés à partir de l'origine App Hosting pour de meilleures performances.
• La console Firebase peut afficher par intermittence une erreur "build was not found and is invalid" (compilation introuvable et non valide) lors de la création du backend.
• Tous les backends d'un même projet partagent une organisation ou un compte GitHub. Ils peuvent être associés à différents dépôts de cette organisation ou de ce compte. Pour créer des backends connectés à différents comptes GitHub, placez-les dans des projets distincts.

Limites et dépannage des applications Angular

Bien que la compatibilité de App Hosting avec Angular soit en cours de développement et d'expansion, elle présente les limites suivantes :

• I18n : bien que la fonctionnalité I18n de base fonctionne, la navigation directe vers les pages SSR peut entraîner des erreurs.
• Localisation : la création de versions pour différentes langues n'est pas prise en charge.
• Builders : seul le générateur d'applications est actuellement compatible.
• Environnements et outils Monorepo : les projets Angular comportant plusieurs cibles d'application échoueront. Pour une prise en charge plus complète des monorepos, utilisez Nx.

Limites et dépannage de Next.js

• Par défaut, l'optimisation d'image NextJS intégrée est désactivée sur App Hosting, sauf si vous définissez explicitement images.unoptimized sur "false" ou si vous utilisez un chargeur d'image personnalisé. Consultez Optimiser le chargement des images sur Next.js.
• Les chemins d'URL contenant des caractères encodés en pourcentage sont décodés par Cloud Run. Cela peut entraîner des problèmes avec les fonctionnalités qui n'attendent que des chemins d'URL encodés, comme le routage parallèle Next.js.
• Actuellement, App Hosting limite la mise en cache des applications NextJS à l'aide du middleware. Au fil du temps, les taux de succès de cache devraient s'améliorer.
• Les chemins d'URL contenant des caractères encodés en pourcentage sont décodés par Cloud Run. Cela peut entraîner des problèmes avec les fonctionnalités qui n'attendent que des chemins d'URL encodés, comme le routage parallèle Next.js.