AsmResolver

O AsmResolver é uma biblioteca para ler, modificar e reconstruir arquivos Portable Executable (PE). Ele suporta imagens PE executadas nativamente no Windows, bem como imagens contendo metadados gerenciados (.NET).

O AsmResolver é distribuído sob a licença MIT.

Principais Recursos

O AsmResolver tem muitos recursos. Abaixo está uma lista não exaustiva dos destaques:

• Criar, ler, modificar, gravar e corrigir arquivos PE.
  • Acesso completo a seções, diretórios de dados e suas interpretações.
  • Reconstrução da Import Address Table (IAT) e criação de trampolins.
  • Controle total sobre o layout da saída final do arquivo PE.
• Suporte robusto para vários tipos de recursos Win32 (Ícones, VersionInfo, etc.).
• Suporte abrangente para metadados .NET com uma API intuitiva semelhante ao System.Reflection.
  • Suporte a corpos de método gerenciados, nativos e dinâmicos.
  • Importação e clonagem fáceis de metadados.
  • Serializadores e desserializadores de arquivos de recursos gerenciados.
  • Suporte a pacotes AppHost / SingleFileHost.
  • Suporte a binários ReadyToRun (R2R).
• Projetado para ser robusto contra binários malformados/ofuscados.
• Suporte robusto de leitura para símbolos PDB e PortablePdb.
  • API multiplataforma totalmente gerenciada (sem necessidade de DIA ou dependências similares).
• Multiplataforma (Windows e *nix, .NET Framework 3.5+, .NET standard 2.0, .NET Core, Mono e compatível com pacotes NixOS).
• Documentado.
• Coberto por testes unitários.

Documentação

• Guias
  • Migrando da v5.x para v6.0
• Referência da API

Suporte

• Rastreador de Problemas
• Fórum de Discussões
• Discord

Binários

Builds Estáveis:

• Feed NuGet
• Lançamentos no GitHub

Builds Noturnos:

• Feed NuGet Noturno (https://nuget.washi.dev/v3/index.json)

Branch	Status da compilação
master
development

Compilação

A solução pode ser compilada usando o .NET SDK ou um IDE compatível (por exemplo, Visual Studio e JetBrains Rider). Os pacotes principais têm como alvo versões LTS de vários 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).

Para compilar o projeto pela linha de comando, use:

$ dotnet build

Para executar todos os testes, use:

$ dotnet test

Para que os testes sejam executados com sucesso, você precisará ter versões adicionais do runtime .NET instaladas (incluindo versões STS ou versões declaradas EOL), pois os testes unitários verificam a leitura de binários direcionados a vários runtimes .NET. Para executar os testes com sucesso no MacOS e no Linux, espera-se que mono e wine também estejam instalados.

Contribuindo

• Consulte CONTRIBUTING.md.

Agradecimentos

O AsmResolver começou como um projeto de hobby, mas cresceu e se tornou um projeto comunitário com vários contribuidores. Sem essas pessoas, o AsmResolver não estaria onde está hoje!

• Um agradecimento especial a todas as pessoas que contribuíram diretamente com commits de código ou financeiramente por meio dos patrocinadores do GitHub.

• Um agradecimento especial às pessoas do @MonoMod por ajudarem com a compatibilidade com o .NET Framework 3.5.

• Outro grande agradecimento a todas as pessoas que sugeriram novos recursos, forneceram feedback sobre o design da API, realizaram testes extensivos e/ou relataram bugs no quadro de problemas, por e-mail ou por mensagens diretas.

Se você sentir que foi sub-representado nestes agradecimentos, sinta-se à vontade para entrar em contato.