Corriger un Crash de Packaging de Plugin UE 5.3 Causé par UnrealBuildTool
15 octobre 20257 minBojan Andrejek

Corriger un Crash de Packaging de Plugin UE 5.3 Causé par UnrealBuildTool

Pendant le développement de notre plugin Unreal Engine personnalisé pour la pipeline de configurateur, nous avons rencontré un crash qui a demandé plus de temps à diagnostiquer qu'à corriger. Le symptôme : le packaging réussit en configuration Development mais échoue silencieusement en Shipping, avec UnrealBuildTool qui se termine avec un code non nul et aucune sortie utile dans le log.

La cause première était un décalage TargetRules. Le fichier .Build.cs de notre plugin référençait une bibliothèque tierce en utilisant PublicAdditionalLibraries avec un chemin construit depuis ModuleDirectory. En Development, l'éditeur résout correctement ce chemin. En Shipping, UBT évalue les règles de module dans un contexte différent, et le chemin se résout vers un emplacement inexistant — UBT échoue silencieusement.

La correction : utiliser Path.Combine(ModuleDirectory, ...) avec une vérification File.Exists explicite avant d'ajouter la bibliothèque. Si la bibliothèque n'est pas trouvée, lancer une exception explicite avec un message clair. Les échecs de chemin silencieux sont la source la plus courante des crashes de packaging UBT.

Le deuxième problème : un conflit de PublicDefinitions. Le plugin définissait un symbole de préprocesseur qui entrait en collision avec une définition déjà définie par le moteur en configuration Shipping. La correction : nommer votre espace de noms pour les définitions de préprocesseur de plugin. Nous préfixons toutes nos définitions avec BLACKCODE_ pour éliminer le risque de collision.

Une troisième classe de crash : les guards de type cible manquants dans les règles de module. Si votre plugin utilise des chemins de code qui ne doivent compiler que pour les cibles Editor, ces chemins doivent être enveloppés dans un guard Target.Type. Sans cela, la cible de jeu Shipping tente de compiler du code editor-only contre un binaire de jeu.

L'approche générale de débogage : toujours construire avec le flag -verbose d'abord. Exécuter le packaging depuis la ligne de commande plutôt que depuis l'éditeur. Reproduire le crash en Development Shipping en premier.

Les crashes de packaging de plugin dans UE 5.3 sont rarement mystérieux une fois qu'on sait où chercher. Les échecs de chemin silencieux, les conflits de préprocesseur et les guards de type cible manquants expliquent la majorité des cas que nous avons rencontrés.

Source Originaledev.epicgames.com/community/learning/tutorials/5E8b/unreal-engine-fixing-a-ue-5-3-plugin-packaging-crash-caused-by-unrealbuildtool
Aller Plus Loin
unreal-enginedebuggingpluginsengineering
Share
Projet Associé

Découvrir Notre Configurateur

Voir le Projet