Partager via


Afficher la journalisation d'Unreal Engine dans Visual Studio

Utilisez Visual Studio Tools pour Unreal Engine (UE) pour afficher la journalisation UE dans Visual Studio. Cela est utile, car vous pouvez voir la journalisation UE sans avoir à basculer entre l’éditeur Unreal et Visual Studio.

Conditions préalables

Les éléments suivants doivent être installés :

Ajouter la journalisation Unreal Engine à un exemple et voir les résultats dans Visual Studio

Après avoir terminé le guide de démarrage rapide : Visual Studio Tools pour Unreal Engine pour télécharger et générer le jeu Lyra, procédez comme suit pour ajouter la journalisation d’Unreal Engine à l’exemple de jeu Lyra et voir les messages de journal dans Visual Studio :

  1. Dans Visual Studio, ouvrez LyraGameplayAbility_RangedWeapon.cpp. Recherchez ce fichier dans le volet Rechercher dans l’Explorateur de solutions , ou recherchez-le sous Games>LyraStarterGame>Source>LyraGame>Armes>LyraGameplayAbility_RangedWeapon.cpp.

  2. Dans LyraGameplayAbility_RangedWeapon.cpp, accédez à la ligne 477. Cette fonction doit s’afficher : void ULyraGameplayAbility_RangedWeapon::OnTargetDataReadyCallback

  3. Insérez le code suivant au début de la fonction : UE_LOG(LogLyra, Log, TEXT("shot fired")); Cela crée une entrée de journal, associée à la catégorie LogLyra, qui journalise shot fired lorsque cette fonction est appelée.

  4. Exécutez l’exemple de jeu dans Visual Studio en choisissant Déboguer>Démarrer le débogage. Donnez à l’Éditeur Unreal quelques instants pour charger le jeu Lyra.

  5. Dans Visual Studio, ouvrez la fenêtre de journalisation UE en choisissant Affichage>Autres>Journal Unreal Engine dans le menu principal de Visual Studio. Vous pouvez également utiliser le bouton de barre d’outils UE pour afficher le journal. Pour plus d’informations sur la barre d’outils, consultez barre d’outils Unreal Engine.

  6. Dans l’éditeur Unreal, choisissez le bouton Play dans la barre d’outils (ou Alt+p) pour démarrer le jeu.

  7. Dans le jeu Lyra, utilisez les touches w, a, s, d pour déplacer le joueur vers le portail d'élimination . Positionnez le joueur sur le portail d’entrée pour charger le jeu.

  8. Une fois le jeu en cours d’exécution, cliquez sur le bouton de la souris pour l’activer. Ceci crée des entrées de journal dans la catégorie LogLyra. À présent, LogLyra s’affiche dans le filtre Catégories pour l’étape suivante.

  9. Réduisez le bruit du journal en filtrant tous les événements sauf ceux de la catégorie LogLyra dans la fenêtre de journalisation UE de la manière suivante : choisissez la liste déroulante Catégories. Choisissez (Tout sélectionner) en haut de la liste pour effacer toutes les sources de journal. Sélectionnez ensuite logLyra. Dans la fenêtre de journalisation UE, le message de journalisation doit s’afficher : shot fired:

    Capture d’écran de la fenêtre de journal d’Unreal Engine montrant les événements « shot fired » et la liste déroulante Catégories avec LogLyra sélectionné.

    Les événements sont dans le bas du journal : il peut donc être nécessaire de faire défiler vers le bas pour les voir. Vous pouvez aussi choisir le bouton Effacer pour effacer le journal, puis tirer à nouveau pour voir le message de journal.

Si vous trouvez la couleur de police difficile à lire, vous pouvez l’ajuster sous Outils>Options>Environnement>Polices et couleurs. Changez la liste déroulante Afficher les paramètres pour : en Journal Unreal Engine. Dans Afficher les éléments : sélectionnez Journal et changez la couleur de Premier plan de l’élément en choisissant quelque chose de plus facile à lire.

Avoir la fenêtre de journalisation UE ouverte pendant le débogage peut être pratique, car cela vous permet de ne pas avoir à basculer vers l’éditeur Unreal pour voir les journaux.

Options de journalisation Unreal Engine

À compter de Visual Studio 2022 17.12, vous pouvez configurer la fenêtre de journalisation Du moteur Unreal. Choisissez Outils>Options>Unreal Engine>Fenêtre d’outils de journalisation pour afficher les options suivantes :

Capture d’écran des options de la fenêtre de journalisation Unreal Engine.

  • Mémoriser les filtres: n’oubliez pas les filtres que vous définissez dans la fenêtre de journal lorsque vous fermez Visual Studio.
  • Effacer lors du lancement : effacez la fenêtre de journal lorsque le jeu est lancé.
  • Demander des messages JSON: demander des entrées de journal au format JSON. JSON fournit un format structuré qui est facile à analyser et à traiter par programmation. Cela simplifie l’extraction d’informations spécifiques à partir de messages de journal, telles que les détails d’erreur, les horodatages et d’autres métadonnées.
  • Afficher automatiquement: Afficher automatiquement la fenêtre de journalisation lorsque le jeu est lancé dans Visual Studio.

Visual Studio Tools pour Unreal Engine
Ajouter des classes, modules et plug-ins unreal Engine dans Visual Studio
Afficher les Blueprints du moteur Unreal dans Visual Studio
Afficher les logs Unreal Engine dans Visual Studio
Afficher les macros unreal Engine dans Visual Studio