C-Sharp Visual Studio Msbuild

Résoudre les échecs de construction sgen.exe dans Visual Studio

Si vous avez rencontré des problèmes avec sgen.exe échouant pendant les processus de construction dans Visual Studio, vous n’êtes pas seul. De nombreux développeurs se battent contre cette erreur, en particulier après avoir modifié le répertoire de sortie de leur projet. Ce guide vous expliquera le problème et vous proposera des solutions pour le résoudre efficacement.

Comprendre le Problème

Modifier le répertoire de sortie de votre projet Visual Studio peut entraîner l’échec de sgen.exe avec l’erreur suivante :

Erreur : Le module spécifié est introuvable. (Exception provenant de HRESULT : 0x8007007E)
C:\WINDOWS\Microsoft.NET\Framework\v2.0.50727\Microsoft.Common.targets(1902,9) : erreur MSB6006 : "sgen.exe" s'est terminé avec le code 1.

Cette erreur survient généralement parce que le chemin passé à sgen.exe dans votre configuration de construction reste inchangé après le changement du répertoire de sortie.

Symptômes du Problème

  • Le processus de construction échoue, générant des erreurs liées à sgen.exe.
  • Même après avoir modifié les paramètres de configuration, l’erreur persiste.
  • Les solutions temporaires peuvent désactiver des fonctionnalités essentielles comme la génération de sérialisation.

Solutions au Problème

Approche 1 : Configuration Manuelle de sgen.exe

Une méthode efficace pour résoudre ce problème consiste à ajuster manuellement les paramètres pour sgen.exe dans votre fichier de projet.

Étapes pour Personnaliser les Options de sgen.exe :

  1. Ouvrir votre Fichier de Projet
    Utilisez un éditeur de texte de votre choix pour ouvrir le fichier .csproj ou .vbproj.

  2. Modifier les Définitions de Cibles
    Vous pouvez ajouter une cible qui indique à sgen.exe de spécifier explicitement les options de génération de sérialiseur. Par exemple :

    <Target Name="GenerateSerializationAssembliesForAllTypes"
  DependsOnTargets="AssignTargetPaths;Compile;ResolveKeySource"
  Inputs="$(MSBuildAllProjects);@(IntermediateAssembly)"
  Outputs="$(OutputPath)$(_SGenDllName)">
    <SGen BuildAssemblyName="$(TargetFileName)"
      BuildAssemblyPath="$(OutputPath)" References="@(ReferencePath)"
      ShouldGenerateSerializer="true" UseProxyTypes="true"
      KeyContainer="$(KeyContainerName)" KeyFile="$(KeyOriginatorFile)"
      DelaySign="$(DelaySign)" ToolPath="$(SGenToolPath)">
        <Output TaskParameter="SerializationAssembly"
          ItemName="SerializationAssembly" />
    </SGen>
</Target>

  3. Verrouiller les Modifications
    Assurez-vous de définir l’attribut UseProxyTypes sur true, ce qui vous permet de contrôler comment les types sont sérialisés.

  4. Reconstruire Votre Projet
    Une fois les modifications enregistrées, reconstruisez votre projet dans Visual Studio pour appliquer les nouvelles configurations.

Approche 2 : Documentation de Référence

Pour une compréhension approfondie et une personnalisation supplémentaire, envisagez de vous référer à la documentation officielle MSDN pour sgen.exe, où vous pouvez trouver des options et des paramètres détaillés disponibles pour l’outil.

Une autre ressource peut être trouvée dans cet article de blog qui discute des nuances de sgen et des conseils pour gérer la sérialisation efficacement.

Recommandations Supplémentaires

  • Supprimer les Anciens .XmlSerializers.dll
    Si vous continuez à rencontrer des problèmes, envisagez de supprimer les fichiers .XmlSerializers.dll dans le répertoire de sortie pour garantir un bon départ.

  • Vérifiez les Références
    Assurez-vous que tous les chemins vers les assemblies dépendants sont toujours valides après avoir changé l’emplacement de sortie.

Conclusion

Faire face à des échecs de sgen.exe peut être frustrant, en particulier au milieu de calendriers de développement serrés. En personnalisant votre fichier de projet et en gérant les configurations avec soin, vous pouvez résoudre ces problèmes efficacement. N’oubliez pas de conserver des sauvegardes de vos fichiers de projet originaux avant d’apporter des modifications importantes.

Avec ces stratégies, vous devriez être équipé pour aborder et prévenir les erreurs de construction futures liées à sgen.exe dans Visual Studio !