AsmResolver

AsmResolver — это библиотека для чтения, изменения и восстановления файлов Portable Executable (PE). Она поддерживает PE-образы, работающие в Windows нативно, а также образы, содержащие управляемые (.NET) метаданные.

AsmResolver распространяется под лицензией MIT.

Основные возможности

AsmResolver обладает множеством возможностей. Ниже приведён неисчерпывающий список основных из них:

• Создание, чтение, изменение, запись и исправление PE-файлов.
  • Полный доступ к секциям, каталогам данных и их интерпретациям.
  • Восстановление и трамплининг таблицы адресов импорта (IAT).
  • Полный контроль над компоновкой итогового PE-файла.
• Богатая поддержка различных типов ресурсов Win32 (значки, VersionInfo и т.д.).
• Богатая поддержка метаданных .NET с интуитивно понятным API, аналогичным System.Reflection.
  • Поддержка управляемых, нативных и динамических тел методов.
  • Простое импортирование и клонирование метаданных.
  • Сериализаторы и десериализаторы управляемых файлов ресурсов.
  • Поддержка пакетов AppHost / SingleFileHost.
  • Поддержка бинарных файлов ReadyToRun (R2R).
• Разработан для устойчивости к повреждённым/обфусцированным бинарным файлам.
• Богатая поддержка чтения символов PDB и PortablePdb.
  • Полностью управляемый кроссплатформенный API (не требует DIA или аналогичных зависимостей).
• Кроссплатформенность (Windows и *nix, совместим с .NET Framework 3.5+, .NET Standard 2.0, .NET Core, Mono и пакетами NixOS).
• Документирован.
• Покрыт модульными тестами.

Документация

• Руководства
  • Миграция с v5.x на v6.0
• Справочник по API

Поддержка

• Трекер проблем
• Дискуссионный форум
• Discord

Бинарные файлы

Стабильные сборки:

• NuGet Feed
• Релизы на GitHub

Ночные сборки:

• Ночной Nuget Feed (https://nuget.washi.dev/v3/index.json)

Ветка	Статус сборки
master
development

Компиляция

Решение можно собрать с помощью .NET SDK или IDE, которая с ним работает (например, Visual Studio и JetBrains Rider). Основные пакеты нацелены на LTS-версии различных сред выполнения .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).

Чтобы собрать проект из командной строки, используйте:

$ dotnet build

Чтобы запустить все тесты, используйте:

$ dotnet test

Для успешного запуска тестов вам потребуется установить дополнительные версии среды выполнения .NET (включая версии STS или версии, объявленные EOL), поскольку модульные тесты проверяют чтение бинарных файлов, нацеленных на различные среды выполнения .NET. Для успешного запуска тестов на MacOS и Linux также ожидается установка mono и wine.

Участие в разработке

• См. CONTRIBUTING.md.

Благодарности

AsmResolver начинался как хобби-проект, но превратился в общественный проект с различными участниками. Без этих людей AsmResolver не был бы там, где он находится сегодня!

• Особая благодарность всем людям, которые внесли вклад непосредственно коммитами кода или материально через GitHub-спонсоров.

• Особая благодарность людям из @MonoMod за помощь с совместимостью с .NET Framework 3.5.

• Ещё одно большое спасибо всем людям, которые предлагали новые функции, давали обратную связь по дизайну API, проводили обширное тестирование и/или сообщали об ошибках на форуме проблем, по электронной почте или в личных сообщениях.

Если вы считаете, что вы недостаточно представлены в этих благодарностях, не стесняйтесь связаться с нами.