Dépannage et questions fréquentes concernant Firebase Studio

Pourquoi les cookies tiers doivent-ils être activés pour Firebase Studio ?

Firebase Studio nécessite que les cookies tiers soient activés, car nous affichons un iFrame à partir d'un domaine (un sous-domaine de cloudworkstations.dev) sur un autre domaine (studio.firebase.google.com). Les cookies tiers permettent une communication sécurisée entre les origines.

Comment passer à la dernière version de React ou Next.js ?

Une faille d'exécution de code à distance (RCE) critique affecte les applications créées avec Next.js et les composants serveur React. Pour protéger votre application et vos données, vous devez passer à la dernière version stable.

1. Ouvrez votre projet Firebase Studio, puis passez à la vue Code.
2. Ouvrez le terminal (Shift+Ctrl+C) et exécutez la commande npx fix-react2shell-next.
3. Suivez les instructions du terminal pour continuer et appliquer les correctifs.
4. Une fois le processus terminé, publiez votre application mise à jour.

Lorsque vous ouvrez un espace de travail, le message Impossible de transférer votre demande au backend. Le message "Impossible de se connecter à un serveur sur le port 80" s'affiche.

Patientez environ cinq secondes, puis actualisez la page.

Mon aperçu ne se charge pas, mais je ne trouve aucun problème dans le code. Comment redémarrer Firebase Studio ?

Si Firebase Studio ne s'actualise pas correctement (généralement à la suite de refactorisations majeures ou de modifications apportées à votre fichier d'environnement dev.nix), ouvrez la palette de commandes (Cmd+Shift+P sur Mac ou Ctrl+Shift+P sur ChromeOS, Windows ou Linux), puis exécutez la commande Hard Restart (Redémarrage forcé). Si cela ne fonctionne pas, essayez d'exécuter la commande Rebuild Environment (Reconstruire l'environnement).

Mon espace de travail ne répond pas. Un écran vide s'affiche lors du chargement.

Si votre espace de travail ne répond pas, vous pouvez essayer de redémarrer la VM. Pour ce faire, procédez comme suit :

1. Dans Firebase Studio, cliquez sur le menu Plus ( more_horiz ), puis sélectionnez Redémarrer.

2. Lorsque vous y êtes invité, cliquez à nouveau sur Redémarrer.

3. Rouvrez votre espace de travail.

Lors de la création d'un espace de travail, le message Oups...Nous devons démarrer une nouvelle VM s'affiche et l'UI se bloque.

Firebase Studio gère un pool de VM préchauffées utilisé pour provisionner des espaces de travail à la demande. Lorsque le pool est presque vide, les espaces de travail sont provisionnés après le démarrage d'une nouvelle machine virtuelle. Le processus peut prendre du temps (parfois jusqu'à cinq minutes), mais il finit par aboutir.

[Errno 28] Aucun espace disponible sur l'appareil

Ce message peut s'afficher si le disque est plein. L'espace de travail Firebase Studio offre les avantages suivants :

• 100 Gio d'espace disque total pour les packages Nix et /tmp
• 10 Gio pour votre répertoire /home

Lorsque je crée un espace de travail, le message Une erreur interne s'est produite s'affiche.

Dans la plupart des cas d'erreurs internes lors du provisionnement d'un espace de travail, il suffit d'actualiser la page au bout d'une minute environ pour résoudre le problème et accéder à l'espace de travail.

Combien d'espaces de travail puis-je créer ?

Le forfait Firebase Studio sans frais est limité à trois espaces de travail par utilisateur. Vous pouvez augmenter le nombre d'espaces de travail que vous pouvez créer jusqu'à 10 en rejoignant le programme Google Developers. Pour passer à 30 espaces de travail, abonnez-vous au Google Developer Program Premium.

Comment envoyer une demande de fonctionnalité ou des commentaires sur un problème rencontré ?

Si vous rencontrez un problème lors de l'utilisation de Firebase Studio ou si vous souhaitez demander une fonctionnalité, contactez l'assistance Firebase.

J'utilisais une fonctionnalité spécifique dans Firebase Studio, mais je ne la trouve plus. Pourquoi a-t-il été supprimé ?

Certaines fonctionnalités de Firebase Studio sont expérimentales. Nous accordons de l'importance à vos commentaires et les utilisons activement pour définir l'ensemble des fonctionnalités actuelles et prévues. Nous supprimons régulièrement celles qui ne répondent pas à vos attentes ou aux nôtres. Si vous souhaitez voir certaines fonctionnalités dans votre version idéale de Firebase Studio, envoyez-nous vos commentaires. Votre avis nous intéresse !

Mon espace de travail se charge, mais l'émulateur est vide.

Nous nous efforçons d'améliorer la fiabilité de nos émulateurs basés sur le cloud. Si l'actualisation de la page ne résout pas le problème, signalez-le à l'assistance Firebase.

Les espaces de travail Firebase Studio ont une version de Flutter incompatible avec mon projet.

Vous pouvez mettre à niveau ou rétrograder la version de presque tous les logiciels préinstallés dans un espace de travail, comme vous le feriez sur votre ordinateur local (à l'aide d'apt-get ou de brew). Vous pouvez mettre à niveau ou rétrograder les logiciels dans votre espace de travail, mais les logiciels installés ne sont pas persistants d'une session à l'autre. Nous vous recommandons d'inclure tous les packages requis dans votre fichier dev.nix.

Nous mettons tout en œuvre pour améliorer la gestion des versions de Flutter dans Firebase Studio.

J'ai partagé l'URL de mon poste de travail avec quelqu'un, mais il ne peut pas la voir.

Vous ne pouvez partager l'URL d'un espace de travail qu'avec les utilisateurs qui y ont accès. Les utilisateurs qui n'y sont pas autorisés voient un message d'erreur lorsqu'ils tentent d'accéder à l'URL. Veillez à partager explicitement l'espace de travail avec eux.

Lorsque je partage ma station de travail, que peut voir mon collaborateur ?

Les utilisateurs ajoutés à votre espace de travail ont un accès complet à l'ensemble du système de fichiers de la VM, qui peut contenir des fichiers sensibles tels que des clés privées et des jetons d'accès stockés sur le disque. Ne partagez votre espace de travail qu'avec des personnes de confiance. Cette approche permet aux autres utilisateurs de voir l'état exact de votre espace de travail, mais cela signifie qu'ils voient tout ce qui s'y trouve.

J'ai partagé mon espace de travail. Pourquoi mon collaborateur ne peut-il pas publier ni surveiller mon application ?

Il est possible que les utilisateurs ajoutés à votre espace de travail n'aient pas l'autorisation d'accéder au projet Firebase sous-jacent qui alimente les fonctionnalités de publication et de surveillance de la "Présentation de l'application". Pour lui accorder l'autorisation d'accéder à votre projet Firebase, consultez Autorisations et accès aux projets Firebase.

Puis-je utiliser des frameworks pour lesquels Firebase Studio ne propose pas de modèle pour créer mon application ?

Oui. Vous pouvez personnaliser votre environnement pour qu'il fonctionne avec pratiquement n'importe quel framework ou langage dans Firebase Studio.

Quel répertoire cible dois-je sélectionner lorsque je publie une application Flutter sur Firebase Hosting ?

Sélectionnez le répertoire build/web. Ce répertoire doit contenir un index.html et tous les éléments statiques nécessaires pour afficher votre application Web une fois qu'elle a été créée (via flutter build web).

Comment configurer le backend de mon application dans mon espace de travail pour que mon frontend puisse communiquer avec lui ?

Vous pouvez ouvrir temporairement le port TCP sur lequel votre serveur de backend s'exécute pour faciliter le développement séparé de votre frontend et de votre backend, dans différents espaces de travail :

1. Démarrez votre backend ou votre serveur d'API manuellement dans un terminal, ou dans le cadre de la configuration de prévisualisation de votre fichier dev.nix ou du crochet de cycle de vie onStart.

2. Cliquez sur l'icône Firebase Studio dans la barre d'activité (à gauche par défaut) pour ouvrir le panneau Firebase Studio.

3. 

   Développez la section Ports de backend pour afficher la liste des serveurs en cours d'exécution, y compris leur numéro de port et leur ID de processus (PID).

4. Cliquez sur l'icône Rendre public (un cadenas) à gauche du numéro de port.

5. Cliquez sur l'icône Copier l'URL à droite du numéro de port pour copier son URL complète.

6. Vous pouvez désormais faire directement référence à cette URL (par exemple, avec un appel fetch) depuis votre interface utilisateur.

J'ai fermé l'onglet d'aperçu. Comment le récupérer ?

Ouvrez la palette de commandes à l'aide de Ctrl+Shift+P (ou Cmd-Shift-P sur macOS), puis sélectionnez Firebase Studio : Afficher l'aperçu Android ou Firebase Studio : Afficher l'aperçu Web.

Qu'est-ce que Code OSS ?

Code-Open Source Software (Code-OSS) est un projet Open Source qui constitue la couche principale de VS Code. Code-OSS est disponible sur GitHub sous la licence MIT standard. C'est là que Microsoft développe le produit VS Code.

Comment empêcher que mes suggestions de saisie de code et mes requêtes de chat Gemini soient utilisées comme données d'entraînement ?

Votre utilisation de Firebase Studio est régie par les Conditions d'utilisation de Google.

Toutefois, veuillez noter que votre utilisation des fonctionnalités d'IA générative dans Firebase Studio est régie par le Règlement sur les utilisations interdites de l'IA générative et les Conditions d'utilisation supplémentaires de Gemini API (plus précisément par les Conditions d'utilisation supplémentaires de Gemini API : Services non payants).

Pour empêcher l'utilisation de vos requêtes et réponses pour l'entraînement des modèles, n'utilisez pas App Prototyping agent ni Gemini dans Firebase au sein de Firebase Studio. Pour bloquer l'utilisation de votre code pour l'entraînement de modèles, désactivez la saisie du code et l'indexation du code dans vos paramètres Firebase Studio.

Comment afficher le quota de demandes par minute pour ma clé API Gemini générée automatiquement ?

Vous pouvez consulter les quotas associés à votre clé API générée automatiquement sur la page Quotas et limites du système de l'API Generative Language de la console Google Cloud.

J'ai reçu un message d'erreur indiquant que j'avais dépassé le nombre maximal de jetons autorisé.

La quantité de données (représentée par des "jetons") dans votre projet est supérieure à la limite maximale que le modèle peut accepter. Pour résoudre cette erreur, indiquez les fichiers de votre codebase qui doivent être masqués dans Gemini :

1. Dans votre espace de travail, passez à la vue Code.

2. Créez un fichier .aiexclude.

3. Incluez les fichiers ou répertoires que Gemini doit ignorer pour réduire la quantité de données dans votre projet. Par exemple, vous pouvez ajouter .next/ et tous les sous-répertoires. Le chemin d'accès doit être spécifié par rapport au dossier dans lequel se trouve le fichier .aiexclude :

    .next/
   

4. Réessayez d'utiliser Gemini. Si vous recevez toujours un message d'erreur indiquant que vous avez dépassé le nombre maximal de jetons, essayez d'ajouter d'autres fichiers ou répertoires volumineux au fichier .aiexclude.

Je n'ai pas pu créer de projet

Lorsque vous provisionnez des ressources telles qu'une clé Gemini API ou que vous déployez sur Firebase App Hosting, un projet est automatiquement provisionné pour vous, en fonction du nom de votre espace de travail Firebase Studio.

Si le message d'erreur "Échec de la création du projet" s'affiche :

• Si votre compte Google fait partie d'une organisation, il est possible que vous n'ayez pas l'autorisation de créer des projets Google Cloud ou que vous ayez atteint la limite de quota de projets. Contactez votre administrateur pour obtenir de l'aide ou consultez Créer et gérer des projets.

• Si votre compte Google ne fait pas partie d'une organisation, vous avez peut-être atteint la limite de quota de projets Google Cloud. Demandez une augmentation de quota.

  Pour en savoir plus sur les quotas de projet, consultez Gérer les quotas de projets.

Pour en savoir plus sur Firebase et les projets Google Cloud, consultez Comprendre les projets Firebase.

Échec de la création du compte Cloud Billing

Lorsque vous provisionnez des ressources, par exemple en déployant sur Firebase App Hosting, vous pouvez choisir ou créer un compte Cloud Billing.

Si le message d'erreur "Échec de la création d'un compte Cloud Billing" s'affiche :

• Assurez-vous d'être autorisé à créer des comptes Cloud Billing. Vérifiez vos autorisations ou contactez votre administrateur pour obtenir de l'aide.

Si le message d'erreur "Trop de projets avec ce compte de facturation" s'affiche :

• Vous avez peut-être atteint la limite de projets pour votre compte Cloud Billing. Vous pouvez demander une augmentation de quota. En savoir plus sur les quotas de compte Cloud Billing

Pour savoir comment créer un compte Cloud Billing, consultez Créer un compte de facturation en libre-service.

Si aucune de ces options ne résout votre problème, contactez l'assistance Cloud Billing.

Comment faire pour que App Prototyping agent ajoute automatiquement Cloud Firestore et Firebase Authentication à mon application ?

Demandez à App Prototyping agent d'ajouter une base de données ou une authentification lorsque vous travaillez sur une application existante. Lorsque vous demandez d'ajouter une base de données ou une authentification, App Prototyping agent vous demande une confirmation. Si vous acceptez, App Prototyping agent configure un projet Firebase avec les services de backend demandés pour vous.

Pourquoi App Prototyping agent ne me propose-t-il pas de résoudre mon problème ?

L'agent de prototypage d'applications détecte les erreurs Next.js et propose de les corriger. Si vous recevez un message d'erreur et qu'aucune option de correction n'est proposée, copiez le texte du problème et collez-le dans le chat.

Pour obtenir les meilleurs résultats, fournissez plus d'informations sur la nature du problème, si vous en avez.

Par exemple, si vous voyez une erreur Firebase comme Property access is undefined on object. for 'list' @ L6, qui indique un problème avec les règles Cloud Firestore, commencez votre requête par "Pouvez-vous m'aider à résoudre ce problème de règles Cloud Firestore ?"

J'ai reçu le message d'erreur "Échec de la publication de l'application" après la publication

Les échecs de publication enregistrent généralement des erreurs exploitables dans les journaux Cloud Build. Pour déboguer et résoudre les échecs de publication :

1. Sur la page Détails de l'application (si elle est réduite, cliquez sur Publier pour l'afficher), cliquez sur Afficher les détails. App Hosting s'ouvre dans la console Firebase.

2. Sur la page Firebase console App Hosting, cliquez sur Afficher les journaux Cloud Build.

   La console Firebase s'ouvre, dans laquelle vous pouvez consulter les journaux de compilation et localiser l'erreur.

3. Copiez l'erreur et collez-la dans le chat App Prototyping agent ou Gemini dans Firebase de votre espace de travail, puis demandez à Gemini de la corriger.

4. Pour vérifier le correctif, passez à la vue Code, ouvrez le terminal et exécutez npm run build. Si une autre erreur s'affiche, réessayez. Si vous voyez un FirebaseError, consultez Pourquoi l'App Prototyping agent ne propose-t-il pas de résoudre mon problème ?

5. Une fois la compilation réussie, cliquez sur npm run start, ouvrez le lien localhost fourni et testez les fonctionnalités de votre application. Vous pouvez vérifier si le terminal contient des erreurs d'exécution.

6. Si tout se passe bien, saisissez Ctrl-C dans le terminal pour arrêter la compilation de production en cours d'exécution dans votre espace de travail, puis réessayez le flux de publication App Hosting.

Je ne parviens pas à apporter des modifications à l'aide de App Prototyping agent

Si App Prototyping agent n'effectue pas les modifications de code demandées, revient à l'étape "Plan de l'application" ou renvoie à plusieurs reprises une erreur indiquant qu'il a rencontré un problème :

1. Redémarrez la VM.

2. Si le problème persiste lorsque vous rouvrez votre espace de travail, saisissez /clear dans le chat App Prototyping agent.

3. Si le problème persiste, vous pouvez essayer de créer une branche à partir d'une version précédente de votre application :

   1. Passez à la vue  > Code.

   2. Ouvrez l'onglet Source Control (Contrôle de code source).

   3. Dans le graphique de contrôle du code source, effectuez un clic droit sur une version antérieure > Créer une branche. Saisissez un nom pour votre branche.

   4. Revenir à Prototyper mode. If the agent still doesn't respond or returns an error, try branching from an even earlier version of your app.

   5. Pour passer d'une branche que vous avez créée à une autre (ou revenir à la branche principale), cliquez sur le nom de la branche en bas à gauche de la vue Code, puis sélectionnez la branche que vous souhaitez utiliser.

Je ne parviens pas à demander à App Prototyping agent d'intégrer les services Firebase.

Nous nous efforçons d'améliorer le processus d'intégration des services Firebase à l'aide de App Prototyping agent. En attendant, voici quelques problèmes courants et conseils.

• Le fichier de configuration n'a pas été mis à jour : dans votre requête, incluez la valeur spécifique que vous souhaitez modifier. Vous trouverez ces valeurs sur la page Paramètres du projet de la console Firebase. Par exemple, vous pouvez demander : "Mets à jour le measurementId dans ma configuration avec G-1234567890."
• L'authentification ne fonctionne pas lorsque je prévisualise mon application : vous devrez peut-être inclure l'URL de prévisualisation en tant que domaine autorisé :
  1. En mode Prototyper, cliquez sur open_in_new Ouvrir dans une nouvelle fenêtre.
  2. Dans la nouvelle fenêtre d'aperçu qui s'ouvre, copiez l'URL. Notez que l'URL doit commencer par 6000. Si elle commence par 9000, mettez-la à jour avant de passer à l'étape suivante.
  3. Sur la page Paramètres d'authentification de la console Firebase, ajoutez l'URL que vous avez copiée à l'étape précédente à la section Domaines autorisés. Remarque : Cette méthode n'active que l'aperçu par défaut affiché dans Prototyper mode. The preview within Code view and the preview pop-out might not allow you to authenticate..
• Aucune règle de sécurité Firebase n'a été créée : Gemini peut vous aider à rédiger des règles de sécurité, mais ne peut pas encore les ajouter automatiquement à votre projet Firebase. Pour publier vos règles Firebase, vous devez les copier dans la console Firebase.
• Interaction inattendue avec le serveur MCP Firebase : si vous configurez le serveur MCP Firebase, vous pouvez rencontrer un comportement inattendu lorsque vous utilisez Prototyper for Firebase integrations. If this occurs, switch to Code view and prompt Gemini in Firebase to integrate Firebase services. .

Comment modifier le favicon de mon application ?

Vous pouvez modifier l'icône dans Firebase Studio :

1. Passez à la vue Code.

2. Si l'explorateur n'est pas déjà actif, cliquez sur Explorer (Ctrl+Shift+E ou Cmd+Shift+E sur Mac) pour afficher tous vos fichiers.

3. Développez src, effectuez un clic droit sur le répertoire app, puis sélectionnez Importer….

4. Lorsque vous y êtes invité, accédez à votre fichier favicon.ico et sélectionnez-le dans votre système de fichiers local.

5. Lorsque vous êtes invité à remplacer le fichier favicon existant, cliquez sur Remplacer.

6. Redéployez votre application ou videz le cache de votre navigateur pour voir la modification.