Merge pull request #730 from Washi1337/development

6.0.0-rc.1

Author: Washi1337

.github/workflows/test-and-publish.yml

@@ -30,7 +30,7 @@ jobs:
     runs-on: ubuntu-24.04
     steps:
       - name: Upload event file
-        uses: actions/upload-artifact@v6
+        uses: actions/upload-artifact@v7
         with:
           name: test-event-file
           path: ${{ github.event_path }}
@@ -107,7 +107,7 @@ jobs:
             --property:CheckEolTargetFramework=false
 
       - name: Upload Build Artifacts
-        uses: actions/upload-artifact@v6
+        uses: actions/upload-artifact@v7
         with:
           name: build-artifacts
           path: artifacts/
@@ -187,7 +187,7 @@ jobs:
 
 
       - name: Download Build Artifacts
-        uses: actions/download-artifact@v7
+        uses: actions/download-artifact@v8
         with:
           name: build-artifacts
           path: artifacts/
@@ -220,7 +220,7 @@ jobs:
 
       # Collect all trx files and upload them.
       - name: Upload Test Results
-        uses: actions/upload-artifact@v6
+        uses: actions/upload-artifact@v7
         if: always()
         with:
           name: test-results-${{matrix.runner.image}}-${{matrix.runner.arch}}
@@ -245,7 +245,7 @@ jobs:
         dotnet-version: 10.0.x
 
     - name: Download Build Artifacts
-      uses: actions/download-artifact@v7
+      uses: actions/download-artifact@v8
       with:
         name: build-artifacts
         path: artifacts/

.github/workflows/test-results-publish.yml

@@ -25,15 +25,15 @@ jobs:
       - uses: actions/checkout@v6
 
       - name: Download Event File
-        uses: actions/download-artifact@v7
+        uses: actions/download-artifact@v8
         with:
           run-id: ${{ github.event.workflow_run.id }}
           github-token: ${{ github.token }}
           name: test-event-file
           merge-multiple: false
 
       - name: Download Test Results
-        uses: actions/download-artifact@v7
+        uses: actions/download-artifact@v8
         with:
           run-id: ${{ github.event.workflow_run.id }}
           github-token: ${{ github.token }}

Directory.Build.props

@@ -9,10 +9,12 @@
         <AllowedOutputExtensionsInPackageBuildOutputFolder>$(AllowedOutputExtensionsInPackageBuildOutputFolder);.pdb</AllowedOutputExtensionsInPackageBuildOutputFolder>
         <LangVersion>14</LangVersion>
         <VersionPrefix>6.0.0</VersionPrefix>
-        <VersionSuffix>beta.6</VersionSuffix>
+        <VersionSuffix>rc.1</VersionSuffix>
         <Deterministic>true</Deterministic>
         <UseArtifactsOutput>true</UseArtifactsOutput>
         <CheckEolTargetFramework>false</CheckEolTargetFramework>
+        <TreatWarningsAsErrors>true</TreatWarningsAsErrors>
+        <Nullable>enable</Nullable>
     </PropertyGroup>
 
     <PropertyGroup Condition="'$(GITHUB_ACTIONS)' == 'true'">

docs/api/toc.yml

@@ -8,5 +8,7 @@
   href: win32resources/toc.yml
 - name: AsmResolver.DotNet.dll
   href: dotnet/toc.yml
+- name: AsmResolver.DotNet.Dynamic.dll
+  href: dotnet-dynamic/toc.yml
 - name: AsmResolver.Symbols.Pdb.dll
-  href: symbols/toc.yml
+  href: symbols/toc.yml

docs/guides/dotnet/dynamic-methods.md

@@ -67,6 +67,6 @@ contextModule.GetOrCreateModuleType().Methods.Add(definition);
 contextModule.Write("Program.patched.dll");
 ```
 
-See [Obtaining methods and fields](metadata-definitions.md#obtaining-methods-and-fields)
+See [Metadata Definitions - Methods](metadata-definitions.md#methods)
 and [CIL Method Bodies](managed-method-bodies.md) for more
 information on how to use `MethodDefinition` objects.

docs/guides/dotnet/managed-method-bodies.md

@@ -229,7 +229,10 @@ Below an example on how emit a call to `Console::WriteLine(string)`:
 ``` csharp
 var writeLine = targetModule.CorLibTypeFactory.CorLibScope
     .CreateTypeReference("System", "Console")
-    .CreateMemberReference("WriteLine", MethodSignature.CreateStatic(targetModule.CorLibTypeFactory.Void, targetModule.CorLibTypeFactory.String));
+    .CreateMemberReference("WriteLine", MethodSignature.CreateStatic(
+        returnType: targetModule.CorLibTypeFactory.Void,
+        parameterTypes: [targetModule.CorLibTypeFactory.String]
+    ));
 
 body.Instructions.Add(CilOpCodes.Ldstr, "Hello, world!");
 body.Instructions.Add(CilOpCodes.Call, writeLine);

docs/guides/dotnet/metadata-definitions.md

@@ -94,7 +94,8 @@ var newType = new TypeDefinition(
     "Namespace",
     "Name",
     TypeAttributes.Public,
-    module.CorLibTypeFactory.Object);
+    module.CorLibTypeFactory.Object
+);
 ```
 
 > [!WARNING]
@@ -109,8 +110,7 @@ var newType = new TypeDefinition(
     "Namespace",
     "Name",
     TypeAttributes.Public,
-    module.CorLibTypeFactory.CorLibScope
-        .CreateTypeReference("System", "ValueType")
+    module.CorLibTypeFactory.CorLibScope.CreateTypeReference("System", "ValueType")
 );
 ```
 
@@ -122,7 +122,8 @@ ModuleDefinition module = ...
 var newType = new TypeDefinition(
     "Namespace",
     "IName",
-    TypeAttributes.Public | TypeAttributes.Interface);
+    TypeAttributes.Public | TypeAttributes.Interface
+);
 ```
 
 Once a type has been constructed, it can be added to either a `ModuleDefinition`
@@ -193,7 +194,8 @@ ModuleDefinition module = ...;
 var field = new FieldDefinition(
     "MyField",
     FieldAttributes.Public,
-    module.CorLibTypeFactory.Int32);"
+    module.CorLibTypeFactory.Int32
+);"
 ```
 
 Fields can be added to a type:
@@ -294,10 +296,10 @@ var method = new MethodDefinition(
     "MyMethod",
     MethodAttributes.Public | MethodAttributes.Static,
     MethodSignature.CreateStatic(
-        module.CorLibTypeFactory.Void,   // Return type
-        module.CorLibTypeFactory.Int32,  // Parameter 1
-        module.CorLibTypeFactory.String // Parameter 2
-    ));
+        returnType: module.CorLibTypeFactory.Void,
+        parameterTypes: [module.CorLibTypeFactory.Int32, module.CorLibTypeFactory.String]
+    )
+);
 ```
 
 Similarly, for instance methods, use the `MethodSignature.CreateInstance` to create the signature:
@@ -308,10 +310,10 @@ var method = new MethodDefinition(
     "MyMethod",
     MethodAttributes.Public,
     MethodSignature.CreateInstance(
-        module.CorLibTypeFactory.Void,   // Return type
-        module.CorLibTypeFactory.Int32,  // Parameter 1
-        module.CorLibTypeFactory.String // Parameter 2
-    ));
+        returnType: module.CorLibTypeFactory.Void,
+        parameterTypes: [module.CorLibTypeFactory.Int32, module.CorLibTypeFactory.String]
+    )
+);
 ```
 
 See also [Metadata Signatures](metadata-signatures.md) for more information on type and method signatures.

docs/guides/dotnet/metadata-references.md

@@ -82,7 +82,9 @@ Below is an example of how to create a fully imported reference to `void System.
 var method = factory.CorLibScope
     .CreateTypeReference("System", "Console")
     .CreateMemberReference("WriteLine", MethodSignature.CreateStatic(
-        factory.Void, factory.String));
+        returnType: factory.Void,
+        parameterTypes: [factory.String]
+    ));
 
 // importedMethod now references "void System.Console.WriteLine(string)"
 ```
@@ -93,7 +95,7 @@ var method = factory.CorLibScope
 > ```csharp
 > var method = factory.CorLibScope
 >    .CreateTypeReference("System", "Console")
->    .CreateMemberReference("WriteLine", MethodSignature.CreateStatic(factory.Void, factory.String))
+>    .CreateMemberReference("WriteLine", MethodSignature.CreateStatic(factory.Void, [factory.String]))
 >    .ImportWith(module.DefaultImporter); // Explicitly import the reference.
 > ```
 
@@ -108,8 +110,9 @@ var importedMethod = factory.CorLibScope
     .MakeGenericInstanceType(factory.Int32)
     .ToTypeDefOrRef()
     .CreateMemberReference("Add", MethodSignature.CreateInstance(
-        factory.Void,
-        new GenericParameterSignature(GenericParameterType.Type, 0)));
+        returnType: factory.Void,
+        parameterTypes: [new GenericParameterSignature(GenericParameterType.Type, 0)]
+    ));
 
 // importedMethod now references "System.Collections.Generic.List`1<System.Int32>.Add(!0)"
 ```
@@ -123,7 +126,9 @@ var factory = module.CorLibTypeFactory;
 var importedMethod = factory.CorLibScope
     .CreateTypeReference("System", "Array")
     .CreateMemberReference("Empty", MethodSignature.CreateStatic(
-        new GenericParameterSignature(GenericParameterType.Method, 0).MakeSzArrayType(), 1))
+        returnType: new GenericParameterSignature(GenericParameterType.Method, 0).MakeSzArrayType(), 
+        genericParameterCount: 1, 
+        parameterTypes: []))
     .MakeGenericInstanceMethod(factory.String);
 
 // importedMethod now references "!0[] System.Array.Empty<System.String>()"

docs/guides/dotnet/metadata-signatures.md

@@ -123,7 +123,8 @@ This can also be created by manually instantiating a `GenericInstanceTypeSignatu
 ``` csharp
 var listTypeRef = new TypeReference(corlibScope, "System.Collections.Generic", "List`1");
 
-var listOfString = new GenericInstanceTypeSignature(listTypeRef, 
+var listOfString = new GenericInstanceTypeSignature(
+    listTypeRef, 
     isValueType: false, 
     typeArguments: [module.CorLibTypeFactory.String]
 );
@@ -140,9 +141,9 @@ In AsmResolver, they are represented by wrapping a `MethodSignature` into a `Fun
 ``` csharp
 var factory = module.CorLibTypeFactory;
 var type = MethodSignature.CreateStatic(
-        factory.Void,
-        factory.Int32, factory.Int32)
-    .MakeFunctionPointerType();
+    returnType: factory.Void,
+    parameterTypes: [factory.Int32, factory.Int32]
+).MakeFunctionPointerType();
 
 // type now contains a reference to `method void *(int32, int32)`.
 ```
@@ -152,8 +153,8 @@ Alternatively, a `FunctionPointerTypeSignature` can be created manually as well:
 ``` csharp
 var factory = module.CorLibTypeFactory;
 var signature = MethodSignature.CreateStatic(
-    factory.Void,
-    factory.Int32, factory.Int32
+    returnType: factory.Void,
+    parameterTypes: [factory.Int32, factory.Int32]
 );
 
 var type = new FunctionPointerTypeSignature(signature);
@@ -323,7 +324,10 @@ Method signatures can be created using the factory methods `MethodSiganture.Crea
 var method = new MethodDefinition(
     name: "Foo", 
     attributes: MethodAttributes.Static,
-    signature: MethodSignature.CreateStatic(module.CorLibTypeFactory.Void, module.CorLibTypeFactory.Int32)
+    signature: MethodSignature.CreateStatic(
+        returnType: module.CorLibTypeFactory.Void,
+        parameterTypes: [module.CorLibTypeFactory.Int32]
+    )
 );
 ```
 

docs/guides/dotnet/runtime-contexts.md

@@ -23,6 +23,11 @@ You can also explicitly create a new (empty) runtime context, targeting a specif
 var context = new RuntimeContext(DotNetRuntimeInfo.NetCoreApp(3, 1));
 ```
 ```csharp
+// Create based on the original target runtime of an existing assembly.
+var assembly = AssemblyDefinition.FromFile(@"C:\Path\To\File.exe", createRuntimeContext: false);
+var context = new RuntimeContext(assembly.ManifestModule.OriginalTargetRuntime);
+```
+```csharp
 // Create based on the contents of a runtime config JSON file.
 var config = RuntimeConfiguration.FromFile(@"C:\Path\To\File.runtimeconfig.json");
 var context = new RuntimeContext(config);
@@ -43,6 +48,7 @@ BundleManifest bundle = ...
 var context = new RuntimeContext(bundle);
 ```
 
+
 A `RuntimeContext` can also be configured with a custom assembly resolver (e.g., for cases where assemblies are embedded in a module or located at unconventional file paths):
 ```csharp
 class MyAssemblyResolver : IAssemblyResolver