https://github.com/nullean/assembly-rewriter
Rewrite .NET assemblies to allow referencing of two different versions
https://github.com/nullean/assembly-rewriter
assembly csharp dll dotnet il-rewriting mono-cecil rewriting
Last synced: 7 months ago
JSON representation
Rewrite .NET assemblies to allow referencing of two different versions
- Host: GitHub
- URL: https://github.com/nullean/assembly-rewriter
- Owner: nullean
- License: mit
- Created: 2018-05-23T14:30:53.000Z (about 7 years ago)
- Default Branch: master
- Last Pushed: 2023-06-30T10:17:33.000Z (almost 2 years ago)
- Last Synced: 2024-11-01T10:46:37.902Z (8 months ago)
- Topics: assembly, csharp, dll, dotnet, il-rewriting, mono-cecil, rewriting
- Language: C#
- Homepage:
- Size: 53.7 KB
- Stars: 24
- Watchers: 3
- Forks: 5
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# assembly-rewriter
Rewrites .NET assemblies with [Mono.Cecil](https://www.mono-project.com/docs/tools+libraries/libraries/Mono.Cecil/), to allow two different versions of the same assembly to be referenced within an application.
It assumes that the assembly DLL name is the top level namespace and rewrites
1. the top level namespace for all types within the assembly
2. assemblies in the order of dependencies first
3. IL `ldstr` op codes if they start with the namespace
4. compiler generated backing fields
This small program was written to allow different versions [Elasticsearch .NET clients](https://github.com/elastic/elasticsearch-net) to be rewritten for benchmark comparisons.
Your mileage may vary rewriting other assemblies :)
## Installation
Distributed as a .NET tool so install using the following
```
dotnet tool install assembly-rewriter
```
## Run
```bat
dotnet assembly-rewriter
```
You can omit `dotnet` if you install this as a global tool
## Examples
Rewrite [NEST, the Elasticsearch .NET high level client](https://github.com/elastic/elasticsearch-net), version 6.2.0
```c#
assembly-rewriter -i C:/Nest.dll -o C:/Nest620.dll
```
Now, `Nest620.dll` and another version of `Nest.dll` can be referenced in the same project.
There's _a small issue here_ however; both versions of NEST rely on `Elasticsearch.Net.dll`, so we should also rewrite
this dependency at the same time, and update the references to Elasticsearch.Net within NEST to reference the new rewritten assembly
```c#
assembly-rewriter -i C:/Nest.dll -o C:/Nest620.dll -i C:/Elasticsearch.Net.dll -o C:/Elasticsearch.Net620.dll
```
Great! Now we can reference both in the same project.
If there are other direct dependencies that may version clash, these can be passed as well
```c#
assembly-rewriter -i C:/Nest.dll -o C:/Nest620.dll -i C:/Elasticsearch.Net.dll -o C:/Elasticsearch.Net620.dll -i C:/Newtonsoft.Json.dll -o C:/Newtonsoft.Json620.dll
```
## Rewrite validation
You can check to see if everything expected has been rewritten using [IL Disassembler](https://docs.microsoft.com/en-us/dotnet/framework/tools/ildasm-exe-il-disassembler)
```powershell
ildasm .dll /OUT=.il /NOBAR
Select-String -Path .il -Pattern '\.' -AllMatches | ft LineNumber,Line
```
## License
[Apache 2.0](License.txt)