DotNetBrowser.Chromium.Extraction 1.0.2

DotNetBrowser.Chromium.Extraction

DotNetBrowser.Chromium.Extraction is a NuGet package that extracts DotNetBrowser Chromium binaries during dotnet build and dotnet publish.

It supports direct extraction from platform-specific DotNetBrowser.Chromium*.dll assemblies and can also work with already unpacked binaries directories.

Installation

<ItemGroup>
  <PackageReference Include="DotNetBrowser.Chromium.Extraction" Version="x.y.z" />
</ItemGroup>

Build-Time Extraction

<PropertyGroup>
  <DotNetBrowserExtractionEnabled>true</DotNetBrowserExtractionEnabled>
  <DotNetBrowserExtractionDuringBuild>true</DotNetBrowserExtractionDuringBuild>
</PropertyGroup>

Defaults:

• Source: $(OutputPath)
• Destination: $(TargetDir)unpacked/

Publish-Time Extraction

<PropertyGroup>
  <DotNetBrowserExtractionEnabled>true</DotNetBrowserExtractionEnabled>
  <DotNetBrowserExtractionDuringPublish>true</DotNetBrowserExtractionDuringPublish>
</PropertyGroup>

Defaults:

• Source: $(PublishDir)
• Destination: $(PublishDir)unpacked/

Property Reference

• DotNetBrowserExtractionEnabled Master switch for extraction targets. Default: false.

• DotNetBrowserExtractionDuringBuild Run extraction after Build. Default: false.

• DotNetBrowserExtractionDuringPublish Run extraction after Publish. Default: false.

• DotNetBrowserExtractionSourcePath Optional source file or directory. If not set, package defaults are used.

• DotNetBrowserExtractionDestinationPath Optional destination directory for unpacked Chromium binaries. If relative, it is resolved against $(TargetDir) for build-time extraction and $(PublishDir) for publish-time extraction.

RID and Platform Resolution

When the source path is a directory, the package uses RuntimeIdentifier to select the best matching DotNetBrowser.Chromium*.dll assembly.

If RuntimeIdentifier is not set, it uses the current host OS and process architecture to choose a candidate.

Platform Compatibility

Extraction must run on the same operating system family as the target runtime. This preserves Unix symlinks and executable permissions.

Troubleshooting

• Ensure RuntimeIdentifier matches the binaries you are extracting.
• Ensure source path points to either a Chromium assembly file or a directory that contains one.
• Check MSBuild output for DotNetBrowser.Chromium.Extraction messages.