AsmResolver

AsmResolver ist eine Bibliothek zum Lesen, Ändern und Rekonstruieren von Portable-Executable-Dateien (PE-Dateien). Sie unterstützt PE-Images, die nativ unter Windows laufen, sowie Images, die verwaltete (.NET-)Metadaten enthalten.

AsmResolver wird unter der MIT-Lizenz veröffentlicht.

Hauptfunktionen

AsmResolver bietet viele Funktionen. Im Folgenden finden Sie eine nicht abschließende Liste der Highlights:

• PE-Dateien erstellen, lesen, ändern, schreiben und patchen.
  • Voller Zugriff auf Sektionen, Datenverzeichnisse und deren Interpretationen.
  • Rekonstruktion der Import Address Table (IAT) und Trampolining.
  • Volle Kontrolle über das Layout der finalen PE-Datei-Ausgabe.
• Umfangreiche Unterstützung für verschiedene Win32-Ressourcentypen (Icons, VersionInfo usw.).
• Umfangreiche Unterstützung für .NET-Metadaten mit einer intuitiven API ähnlich wie System.Reflection.
  • Unterstützung für verwaltete, native und dynamische Methodentexte.
  • Einfaches Importieren und Klonen von Metadaten.
  • Serialisierer und Deserialisierer für verwaltete Ressourcendateien.
  • Unterstützung für AppHost-/SingleFileHost-Bündel.
  • Unterstützung für ReadyToRun-Binärdateien (R2R).
• Robust gegenüber fehlerhaften/verschleierten Binärdateien.
• Umfangreiche Leseunterstützung für PDB- und PortablePdb-Symbole.
  • Vollständig verwaltete, plattformübergreifende API (keine DIA oder ähnliche Abhängigkeiten erforderlich).
• Plattformübergreifend (Windows und *nix, kompatibel mit .NET Framework 3.5+, .NET Standard 2.0, .NET Core, Mono und NixOS-Paketen).
• Dokumentiert.
• Mit Unit-Tests getestet.

Dokumentation

• Leitfäden
  • Migration von v5.x auf v6.0
• API-Referenz

Support

• Issue-Tracker
• Diskussionsforum
• Discord

Binärdateien

Stabile Builds:

• NuGet-Feed
• GitHub-Releases

Nächtliche Builds:

• Nächtlicher NuGet-Feed (https://nuget.washi.dev/v3/index.json)

Branch	Build-Status
master
development

Kompilieren

Die Projektmappe kann mit dem .NET SDK oder einer damit kompatiblen IDE (z. B. Visual Studio und JetBrains Rider) erstellt werden. Die Hauptpakete zielen auf LTS-Versionen verschiedener .NET-Laufzeiten ab (.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).

Um das Projekt über die Befehlszeile zu erstellen, verwenden Sie:

$ dotnet build

Um alle Tests auszuführen, verwenden Sie:

$ dotnet test

Für eine erfolgreiche Ausführung der Tests müssen zusätzliche Versionen der .NET-Laufzeit installiert sein (einschließlich STS-Versionen oder als EOL deklarierter Versionen), da die Unit-Tests das Lesen von Binärdateien überprüfen, die auf verschiedene .NET-Laufzeiten abzielen. Um die Tests unter MacOS und Linux erfolgreich auszuführen, müssen zusätzlich mono und wine installiert sein.

Mitwirken

• Siehe CONTRIBUTING.md.

Danksagungen

AsmResolver begann als Hobbyprojekt, ist aber zu einem Gemeinschaftsprojekt mit verschiedenen Mitwirkenden herangewachsen. Ohne diese Menschen wäre AsmResolver nicht dort, wo es heute ist!

• Besonderer Dank gilt allen, die direkt mit Code-Beiträgen oder finanziell über GitHub-Sponsoren beigetragen haben.

• Besonderer Dank gilt den Leuten von @MonoMod für ihre Hilfe bei der .NET-Framework-3.5-Kompatibilität.

• Ein weiteres großes Dankeschön an alle, die neue Funktionen vorgeschlagen, Feedback zum API-Design gegeben, umfangreiche Tests durchgeführt und/oder Fehler auf dem Issue-Board, per E-Mail oder über Direktnachrichten gemeldet haben.

Wenn Sie das Gefühl haben, in diesen Danksagungen zu kurz gekommen zu sein, können Sie sich gerne an uns wenden.