Guides

Contents

Introduction

Installation

Guides

Troubleshooting

Migration

Installing from NuGet

This guide describes how to add DotNetBrowser to your .NET project from NuGet.

To add DotNetBrowser to project, install the appropriate NuGet packages listed below.

DotNetBrowser itself depends on protobuf-net. The corresponding package is automatically fetched while installing DotNetBrowser NuGet packages.

Cross-platform

If you need DotNetBrowser to work on all supported platforms, you can install the appropriate packages listed below.

DotNetBrowser.CrossPlatform
DotNetBrowser.Chromium.Win-x86.NetStandard20
DotNetBrowser.Chromium.Win-x64.NetStandard20
DotNetBrowser.Chromium.Win-arm64.NetStandard20
DotNetBrowser.Chromium.Linux-x64
DotNetBrowser.Chromium.Linux-arm64
DotNetBrowser.Chromium.macOS-x64
DotNetBrowser.Chromium.macOS-arm64

Installing DotNetBrowser.CrossPlatform fetches the rest required packages.

Platform-specific

If you need DotNetBrowser to work only on a specific platform, you can install the appropriate packages listed below.

Windows AnyCPU

DotNetBrowser
DotNetBrowser.Chromium.Win-x86.Net45 / DotNetBrowser.Chromium.Win-x86.NetStandard20
DotNetBrowser.Chromium.Win-x64.Net45 / DotNetBrowser.Chromium.Win-x64.NetStandard20
DotNetBrowser.Chromium.Win-arm64.Net45 / DotNetBrowser.Chromium.Win-arm64.NetStandard20

Installing DotNetBrowser fetches the required Chromium binaries depending on the target platform automatically.

UI framework

If you develop a desktop application where you want to display some web content, install one more package depending on the UI framework you use.

WPF

Installing DotNetBrowser.Wpf fetches the rest required packages.

If your WPF application runs on 64-bit platforms, and 32-bit platforms are not supported, you can install DotNetBrowser.Wpf.x64 package. DotNetBrowser.x64, DotNetBrowser.Chromium.Win-x64.Net45 or DotNetBrowser.Chromium.Win-x64.NetStandard20 (depending on the target framework) packages are fetched and installed automatically.

If your WPF application runs on ARM64 platforms, you can install DotNetBrowser.Wpf.arm64 package. DotNetBrowser.Win-arm64, DotNetBrowser.Chromium.Win-arm64.Net45 or DotNetBrowser.Chromium.Win-arm64.NetStandard20 (depending on the target framework) packages are fetched and installed automatically.

WinForms

Installing DotNetBrowser.WinForms fetches the rest required packages.

If your WinForms application runs on 32-bit platforms, and 64-bit platforms are not supported, you can install DotNetBrowser.WinForms.x86 package. DotNetBrowser.x86, DotNetBrowser.Chromium.Win-x86.Net45 or DotNetBrowser.Chromium.Win-x86.NetStandard20 (depending on the target framework) packages are fetched and installed automatically.

If your WinForms application runs on ARM64 platforms, you can install DotNetBrowser.WinForms.arm64 package. DotNetBrowser.Win-arm64, DotNetBrowser.Chromium.Win-arm64.Net45 or DotNetBrowser.Chromium.Win-arm64.NetStandard20 (depending on the target framework) packages are fetched and installed automatically.

Avalonia UI

Installing DotNetBrowser.AvaloniaUi fetches the rest required packages.

If your Avalonia UI application runs on a certain subset of the platforms only, and the other platforms are not supported, you can later exclude the corresponding DotNetBrowser.Chromium.Xxx DLLs when preparing your application for deployment.

NuGet Package Manager in Visual Studio

To install the required NuGet packages, follow the below instructions:

In Solution Explorer, right-click References and choose Manage NuGet Packages:
Choose “nuget.org” as the Package source, select the Browse tab, search for “DotNetBrowser”, select the required package and hit Install:
Accept the prompted license agreement to continue installation.

Install NuGet Packages using the dotnet CLI

To install the required NuGet packages, follow the below instructions:

Open a command line and switch to the directory that contains your project file.
Run the following command to install the needed package:
```
dotnet add package <DotNetBrowser_package_name>
```
After the command completes, the package reference will appear in the .csproj file.

For additional information visit the following link

Go Top

Introduction

Installation

Guides

Troubleshooting

Migration

Installing from NuGet

Cross-platform

Platform-specific

Windows AnyCPU

Windows x86

Windows x64

Windows ARM64

Linux x64

Linux ARM64

macOS x64

macOS ARM64

UI framework

WPF

WinForms

Avalonia UI

NuGet Package Manager in Visual Studio

Install NuGet Packages using the dotnet CLI