Résolution des problèmes de build et de prévisualisation

Lorsqu’un build échoue ou que votre prévisualisation ne se charge pas, commencez par la première erreur visible et suivez le parcours de récupération correspondant à ce symptôme. Cette page couvre la Visionneuse d'App, la Preview, les erreurs de build et les étapes à suivre avant de signaler un problème.

Commencez ici

Une fois qu’un Agent a terminé une tâche, la Visionneuse d'App charge votre app. Le Terminal affiche l’activité des tâches et les erreurs, tandis que la barre d’outils de la Visionneuse d'App vous donne accès à une commande Reload App Viewer, à un sélecteur de vue d’appareil, à une option pour ouvrir la prévisualisation dans un nouvel onglet et à la Console.

1. Enregistrez la dernière modification et attendez que la tâche ou le build en cours se termine.
2. Sélectionnez Reload App Viewer une fois si la prévisualisation semble obsolète ou reste bloquée sur un écran de chargement.
3. Ouvrez la prévisualisation dans un nouvel onglet si la Visionneuse d'App intégrée est bloquée ou ne répond pas.
4. Ouvrez la Console et copiez la première erreur visible. Conservez le lien du projet et l’heure de l’échec.

Lorsque le build échoue

Essayez d’abord Resolve

Quand Atoms détecte un problème de build, une notification Signaler un problème apparaît dans le coin inférieur gauche. Si la notification inclut Resolve, lancez une tentative de réparation avant d’effectuer une autre action.

1. Sélectionnez Resolve et attendez que la tentative en cours se termine.
2. Ne sélectionnez pas à nouveau Resolve pendant son exécution.
3. Si la tentative ne se termine pas, notez le statut visible et poursuivez avec les étapes de signalement ci-dessous. Ne lancez pas une autre tentative Resolve.
4. Lorsque la tentative est terminée, vérifiez la prévisualisation actualisée. Si elle ne se met pas à jour, actualisez le navigateur une fois.
5. Répétez l’action qui a causé le problème. Si le problème persiste, développez Signaler un problème et poursuivez avec les étapes de signalement ci-dessous.

Erreur de build ou dépendance manquante

Si le panneau Preview affiche une erreur de build, une bannière d’erreur rouge ou un message concernant un package manquant, utilisez le message exact pour préciser l’étape suivante.

1. Ouvrez la Console et copiez le message d’erreur complet qui y est visible.
2. Si Resolve est disponible, utilisez-le une fois et attendez que la tentative se termine.
3. S’il n’y a pas de bouton Resolve, collez l’erreur exacte dans le chat du projet et demandez à l’Agent de corriger cette erreur de build.
4. Si l’erreur a commencé après une modification spécifique, ouvrez History et comparez la version actuelle avec la dernière version fonctionnelle.
5. Si l’erreur est difficile à isoler, faites un Remix à partir de la dernière version stable et réappliquez les modifications progressivement.

Les erreurs qui mentionnent la Visionneuse d'App, le script de démarrage, Publish, un enregistrement de déploiement ou les fichiers internes d’un package tiers peuvent indiquer un problème de plateforme. Incluez le message d’erreur complet lorsque vous contactez le Support.

Le build reste en cours

Vérifiez l’activité de la tâche en cours dans le Terminal avant de réessayer. Si la tâche ou le build est toujours en cours d’exécution, attendez qu’il se termine. S’il reste en cours après la fin de la tentative actuelle, notez le statut, l’horodatage, le lien du projet et tout détail d’erreur visible, puis signalez le problème.

Lorsque la Preview ou la Visionneuse d'App ne se charge pas

Écran de chargement ou prévisualisation qui ne répond pas

Vérifiez d’abord si seule la Visionneuse d'App intégrée est affectée, ou si l’URL de Preview et le site publié le sont également.

1. Confirmez si la tâche ou le build en cours est toujours en cours d’exécution.
2. Sélectionnez Reload App Viewer une fois.
3. Ouvrez la Preview dans un nouvel onglet du navigateur.
4. Testez la même URL dans une fenêtre de navigation privée.
5. Si la dernière version connue comme fonctionnelle se charge, comparez-la avec la modification récente qui a introduit le problème.

Si le produit signale explicitement un solde Cloud & AI insuffisant ou une app suspendue, ouvrez Settings → Cloud & AI et vérifiez ce statut. N’effectuez pas de recharge sur la seule base d’un écran vide.

Prévisualisation vide ou incomplète

Vérifiez si l’écran vide affecte toute l’app ou seulement une page ou un composant. Si une seule zone est affectée, utilisez le sélecteur de page pour ouvrir directement cette page et répétez le plus petit parcours utilisateur qui y mène. Si toute la prévisualisation est vide, revenez au résultat du build et résolvez la première erreur de build ou d’exécution avant de tester à nouveau.

Notez toute erreur de Console ou de Network sans partager de cookies, de jetons ou de valeurs secrètes. Si le problème persiste, incluez les détails d’erreur nettoyés dans votre signalement.

La Preview affiche une ancienne version

La Preview et le site publié sont des canaux distincts. Assurez-vous que les dernières modifications ont été enregistrées et que le dernier build est terminé avant d’actualiser la prévisualisation. Rouvrez la Preview une fois le build terminé. Si elle affiche toujours un contenu plus ancien, comparez la version actuelle avec la dernière version connue comme fonctionnelle dans History.

Lorsque la prévisualisation semble incorrecte

Les interactions ou la navigation ne fonctionnent pas

Une page qui s’affiche n’est pas la même chose qu’une page qui fonctionne. Ouvrez chaque lien de navigation important, appuyez sur les boutons principaux, soumettez les formulaires clés et suivez le parcours utilisateur principal du début à la fin. Lorsqu’une interaction échoue, notez l’action exacte à laquelle le résultat attendu s’arrête et testez à nouveau ce parcours après chaque correction.

La mise en page mobile est cassée

1. Utilisez le sélecteur d’appareil dans la barre d’outils de la Visionneuse d'App pour passer à la vue mobile.
2. Sélectionnez l’élément cassé en mode Design lorsqu’il est disponible.
3. Décrivez la mise en page mobile attendue et ce qui ne doit pas changer.
4. Appliquez une modification, puis vérifiez les vues desktop et mobile ainsi que les états de chargement, vides, hover et d’erreur.

Des images ou d’autres ressources sont manquantes

1. Ouvrez la section Files et confirmez que le fichier référencé existe.
2. Vérifiez que le chemin, le nom du fichier et le format correspondent à la référence utilisée par l’app.
3. Si la ressource a récemment été déplacée ou renommée, restaurez la référence ou mettez-la à jour délibérément.
4. Sélectionnez Reload App Viewer et testez à nouveau la page affectée.

L’Agent a modifié le mauvais élément ou a cassé une autre zone

1. Ouvrez History et faites un Remix à partir de la dernière version stable.
2. Utilisez le mode Design pour cibler l’élément exact lorsqu’il est disponible.
3. Indiquez ce qui ne doit pas changer et effectuez une seule modification par prompt.
4. Vérifiez le résultat avant de passer à la modification suivante.

Signaler un problème

Signalez le problème lorsque Resolve n’est pas disponible, que le problème persiste après une tentative Resolve terminée, que la Preview ne répond pas mais que le chat du projet fonctionne toujours, ou qu’un comportement inattendu continue après l’investigation de l’Agent.

Ouvrir Feedback depuis le chat du projet

1. Ouvrez le chat du projet concerné et trouvez le dernier message pertinent de l’Agent.
2. Sélectionnez ... (plus d’options), puis sélectionnez Feedback.
3. Dans la messagerie de support, sélectionnez Send us a message et envoyez le signalement dans la conversation existante lorsqu’il en existe déjà une.

Pour le flux complet de Signaler un problème, consultez Report an Issue.

Incluez suffisamment de détails pour reproduire le problème

• Résumé du problème. Décrivez le problème en une ou deux phrases.
• Lien du projet ou du chat. Incluez l’URL où le problème s’est produit.
• Date et heure. Incluez votre fuseau horaire.
• Étapes pour reproduire. Listez les actions exactes dans l’ordre.
• Résultat attendu et résultat réel. Indiquez ce qui aurait dû se passer et ce qui s’est passé à la place.
• Ce que vous avez déjà essayé. Indiquez si Resolve est apparu, ce qui s’est passé après sa fin et si l’actualisation ou Remix a modifié le résultat.
• Navigateur et appareil. Incluez le navigateur, le système d’exploitation et le type d’appareil.
• Preuves. Joignez une capture d’écran ou un enregistrement ainsi que les détails visibles pertinents de Signaler un problème ou de la Console.

Supprimez les mots de passe, les clés API, les jetons d’authentification, les cookies, les détails de paiement et les données personnelles ou confidentielles non pertinentes avant de partager des captures d’écran ou des journaux.

Une fois le problème corrigé

Exécutez le parcours utilisateur principal du début à la fin. Vérifiez la Preview dans les vues desktop et mobile, ouvrez chaque page depuis le sélecteur de page et confirmez que la Console n’affiche aucun message d’erreur rouge. Si l’app est prête à être publiée, remplacez tout contenu d’espace réservé et effectuez les vérifications de publication dans la Visionneuse d'App.

FAQ