AsmResolver

AsmResolver est une bibliothèque pour lire, modifier et reconstruire des fichiers Portable Executable (PE). Elle prend en charge les images PE s'exécutant nativement sous Windows, ainsi que les images contenant des métadonnées managées (.NET).

AsmResolver est publié sous la licence MIT.

Fonctionnalités principales

AsmResolver possède de nombreuses fonctionnalités. Voici une liste non exhaustive des points forts :

• Créer, lire, modifier, écrire et patcher des fichiers PE.
  • Accès complet aux sections, aux répertoires de données et à leurs interprétations.
  • Reconstruction de la table d'adresses d'importation (IAT) et trampolinage.
  • Contrôle total sur la disposition du fichier PE final.
• Prise en charge riche de divers types de ressources Win32 (icônes, VersionInfo, etc.).
• Prise en charge riche des métadonnées .NET avec une API intuitive similaire à System.Reflection.
  • Prise en charge des corps de méthodes managés, natifs et dynamiques.
  • Importation et clonage faciles des métadonnées.
  • Sérialiseurs et désérialiseurs de fichiers de ressources managées.
  • Prise en charge des bundles AppHost / SingleFileHost.
  • Prise en charge des binaires ReadyToRun (R2R).
• Conçu pour être robuste face aux binaires malformés/obfusqués.
• Prise en charge riche des symboles PDB et PortablePdb.
  • API entièrement managée et multiplateforme (aucune dépendance DIA ou similaire requise).
• Multiplateforme (Windows et *nix, compatible .NET Framework 3.5+, .NET Standard 2.0, .NET Core, Mono et NixOS).
• Documentée.
• Testée unitairement.

Documentation

• Guides
  • Migration de v5.x vers v6.0
• Référence de l'API

Support

• Suivi des problèmes
• Forum de discussion
• Discord

Binaires

Builds stables :

• Flux NuGet
• Releases GitHub

Builds nocturnes :

• Flux NuGet nocturne (https://nuget.washi.dev/v3/index.json)

Branche	Statut de build
master
development

Compilation

La solution peut être compilée à l'aide du SDK .NET ou d'un IDE compatible (par exemple, Visual Studio et JetBrains Rider). Les principaux packages ciblent les versions LTS de différents runtimes .NET (.NET Framework 3.5, .NET Standard 2.0, .NET Standard 2.1, .NET Core 3.1, .NET 6.0, .NET 8.0, .NET 9.0, .NET 10.0).

Pour compiler le projet à partir de la ligne de commande, utilisez :

$ dotnet build

Pour exécuter tous les tests, utilisez :

$ dotnet test

Pour que les tests s'exécutent correctement, vous devez avoir installé des versions supplémentaires du runtime .NET (y compris les versions STS ou les versions déclarées en fin de vie), car les tests unitaires vérifient la lecture de binaires ciblant différents runtimes .NET. Pour exécuter les tests avec succès sur MacOS et Linux, mono et wine doivent également être installés.

Contribution

• Voir CONTRIBUTING.md.

Remerciements

Le projet AsmResolver a commencé comme un projet de loisir, mais il est devenu un projet communautaire avec de nombreux contributeurs. Sans ces personnes, AsmResolver n'en serait pas là aujourd'hui !

• Merci tout particulier à toutes les personnes qui ont contribué directement par des commits de code ou financièrement via les sponsors GitHub.

• Un merci tout particulier aux personnes de @MonoMod pour leur aide sur la compatibilité .NET Framework 3.5.

• Un autre grand merci à toutes les personnes qui ont suggéré de nouvelles fonctionnalités, fourni des commentaires sur la conception de l'API, effectué des tests approfondis et/ou signalé des bogues sur le tableau des problèmes, par e-mail ou par messages directs.

Si vous estimez que vos contributions ne sont pas suffisamment représentées dans ces remerciements, n'hésitez pas à nous contacter.