Context

Base issue: #11225
Reference package path: microsoft.build
Roslyn-based GenAPI location: https://github.com/dotnet/sdk/tree/main/src/GenAPI/

Usage:

/repos/source-build-reference-packages]# ./generate.sh --pkg microsoft.extensions.logging,2.1.1 --genapi-backend roslyn --dest /repos/source-build-reference-packages/src/referencePackages/roslyn/

Steps:

1. Generate SBRP package using SBRP generator with the roslyn-based backend
2. Compare cci-based <-> roslyn-based reference assemblies
3. Build the SBRP generated with the roslyn-based backend
4. Collect issues, their occurrence, create bugs for each.
5. Run the sdk/ApiCompat tool to compare generated API with original

How to compile project in SBRP

Use a docker or a VM and from root folder of source-build-reference-packages run:

/repos/source-build-reference-packages]# ./build.sh --projects ./build.sh --projects /repos/source-build-reference-packages/src/referencePackages/roslyn/system.memory/4.5.1/System.Memory.4.5.1.csproj

How to use the ApiCompat tool

sdk\artifacts\bin\Microsoft.DotNet.ApiCompat.Tool\Debug\net6.0> .\Microsoft.DotNet.ApiCompat.Tool.exe --strict-mode true --enable-rule-attributes-must-match true --enable-rule-cannot-change-parameter-name true --lref ... --rref ... -l ... -r ...

Found Issues:

Microsoft.Build:

• Add support for a generation of a finalizer in the SyntaxGenerator #11938

Occurrence: 1

System.Collections.Immutable:

• The SyntaxGenerator does not generate this and params keywords in methods #11853

Occurrence: 83

• For a compile-time compat add synthesized private fields for a value type (struct) #11347

Occurrence: 9

• The SyntaxGenerator omits ref, readonly, new keywords for return types. #11881

Occurrence: 10

Microsoft.Win32.SystemEvents:

• The SyntaxGenerator adds sealed keyword for delegate types. #11937

Occurrence: 7

System.Globalization, 4.3.0:

• The SyntaxGenerator adds redundant static keyword to constant fields #11934

Occurrence: 1

System.Runtime:

• Add support for a generation of a finalizer in the SyntaxGenerator #11938

Occurrence: 4

• The SyntaxGenerator omits in, out keywords for generic types #11884

Occurrence: 31

• The SyntaxGenerator adds sealed keyword for delegate types. #11937

Occurrence: 41

• The SyntaxGenerator does not generate this and params keywords in methods #11853

Occurrence: 10

• Add support for an explicit interface implementation method in SyntaxGenerator #11895

Occurrence: 5

• Add support for an explicit interface implementation method in SyntaxGenerator #11895

Occurrence: 26

• The SyntaxGenerator adds redundant static keyword to constant fields #11934

Occurrence: 42

• Generate a call of a base class constructor if the default constructor does not exist. #11254

Occurrence: 2

System.Threading

• Generate a call of a base class constructor if the default constructor does not exist. #11254

Occurrence: 2

• The SyntaxGenerator adds sealed keyword for delegate types. #11937

Occurrence: 2

• Add support for a generation of a finalizer in the SyntaxGenerator #11938

Occurrence: 1