Source Generator to help multi-targeting projects.
Get Started
$ dotnet add package Meziantou.PolyfillReadme
Meziantou.Polyfill
Source Generator that adds polyfill methods and types. This helps working with multi-targeted projects.
Read more about the project: Polyfills in .NET to ease multi-targeting
Installation
dotnet add package Meziantou.Polyfill
Then, you should see the generated types in the solution explorer
Customization
By default, all needed polyfills are generated. You can configure which polyfills should be generated by editing the .csproj file and adding the following properties:
<PropertyGroup>
<!-- Opt-in: semicolon-separated or pipe-separated list of name prefixes to include (allowlist) -->
<!-- When set, ONLY polyfills matching these prefixes will be generated -->
<!-- Tip: The name of the generated polyfills are available in the generated "Debug.g.cs" file -->
<MeziantouPolyfill_IncludedPolyfills>T:Type1|T:Type2|M:Member1</MeziantouPolyfill_IncludedPolyfills>
<!-- Opt-out: semicolon-separated or pipe-separated list of name prefixes to exclude (blocklist) -->
<!-- Polyfills matching these prefixes will NOT be generated -->
<MeziantouPolyfill_ExcludedPolyfills>M:System.Diagnostics.</MeziantouPolyfill_ExcludedPolyfills>
<!-- Optional: Output the generated files to the obj\GeneratedFiles folder -->
<EmitCompilerGeneratedFiles>True</EmitCompilerGeneratedFiles>
<CompilerGeneratedFilesOutputPath>$(BaseIntermediateOutputPath)\GeneratedFiles</CompilerGeneratedFilesOutputPath>
</PropertyGroup>
<!-- begin_polyfills -->
<!-- end_polyfills -->