PeakSWC.RemoteBlazorWebView 9.0.0-preview5

This is a prerelease version of PeakSWC.RemoteBlazorWebView.
There is a newer version of this package available.
See the version list below for details.
dotnet add package PeakSWC.RemoteBlazorWebView --version 9.0.0-preview5                
NuGet\Install-Package PeakSWC.RemoteBlazorWebView -Version 9.0.0-preview5                
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="PeakSWC.RemoteBlazorWebView" Version="9.0.0-preview5" />                
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add PeakSWC.RemoteBlazorWebView --version 9.0.0-preview5                
#r "nuget: PeakSWC.RemoteBlazorWebView, 9.0.0-preview5"                
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
// Install PeakSWC.RemoteBlazorWebView as a Cake Addin
#addin nuget:?package=PeakSWC.RemoteBlazorWebView&version=9.0.0-preview5&prerelease

// Install PeakSWC.RemoteBlazorWebView as a Cake Tool
#tool nuget:?package=PeakSWC.RemoteBlazorWebView&version=9.0.0-preview5&prerelease                

RemoteBlazorWebViewTutorial

Microsoft is currently supporting two Blazor WebView Controls in .NET 9. One control (Microsoft.AspNetCore.Components.WebView.Wpf) targets Windows Presentation Foundation (WPF) apps and the other (Microsoft.AspNetCore.Components.WebView.WindowsForms) targets Windows Form (WinForms) apps. These Microsoft controls enable developers to create user interfaces for desktop apps using Blazor web technology. Desktop apps using Blazor have the full feature set and performance of .NET 9 and are not constrained like a Blazor WebAssembly app.

The Remote versions of the Blazor WebView Controls (PeakSWC.RemoteBlazorWebView.Wpf and PeakSWC.RemoteBlazorWebView.WindowsForms) serve as a drop-in replacements for the Microsoft controls, with the added ability to access the user interface over a secure connection to a public server using a web browser. This is achieved by setting up a secure server (RemoteWebWindowService) in the cloud and pointing your browser to it. With a few minor changes, you can run your app locally or remotely control your application.

The RemoteBlazorWebView package allows developers to create a Blazor UI on Windows, Mac, and Linux. RemoteBlazorWebView is based on Microsoft's WebView control and Photino.Blazor. It shares the same server with the WinForms and Wpf controls (RemoteWebWindowService).

Use Cases

The primary use case is to be able to share a desktop application controlling hardware with an external service technician. Typically, the application is behind a corporate firewall and is not easily accessed by the technician. The Remote Blazor controls enables the desktop application to be started in "Remote" mode which generates a unique Url for the technician to access the user interface.

Another use case is to be able to monitor data that is behind a firewall or on a private network without the cost and complexity to store the data externally. For example, if a brewer wanted to monitor fermentation data such as PH, Gravity, and Pressure they could build an app showing real-time graphical data using Blazor components and, with only a couple of changes, be able to view the user interface with a web browser from outside of the firewall.

How it works

RemoteBlazorWebView.Wpf has two modes of operation. In the first default mode, it works just like the Microsoft BlazorWebView Controls (see BlazorDesktopWPF). In the second mode, a url is specified on the control's properties. In this mode, all GUI interactions are sent to a server that can be accessed with a browser. Hosting the server (RemotableWebViewService.exe) in the cloud allows you to remotely control an application which is behind a firewall or does not have a static IP address.

Demo Video

RemoteBlazorWebView

Download and Run Demo

  • Download the latest Release.zip under the Assets folder from https://github.com/budcribar/RemoteBlazorWebViewTutorial/releases

  • Extract the files

  • Run either the WinForms (RemoteBlazorWebViewTutorial.WinFormsApp.exe) or the Wpf Sample Program (RemoteBlazorWebViewTutorial.WpfApp.exe) which shows the Blazor UI running normally

  • Next start the server and run the sample application through the browser

    • Open a powershell window and execute RemoteWebViewService in the background
    .\RemoteWebViewService &
    
    • Run the sample program with the local server option
    .\RemoteBlazorWebViewTutorial.WpfApp.exe -u=https://localhost:5001
    
    • Click the link in the sample program
  • Finally, Run the sample program and use the secured cloud server

    .\RemoteBlazorWebViewTutorial.WpfApp.exe -u=https://server.remoteblazorwebview.com:443
    
    • Click the link in the sample program
    • Create a new user and sign in

Build and Run Demo

  • Install the RemoteWebViewService
dotnet tool update -g PeakSWC.RemoteWebViewService --version 8.*-* 
  • Start the server
RemoteWebViewService
  • Open the RemoteBlazorWebViewTutorial.sln with Visual Studio

  • Select the Local Profile from the dropdown next to the Run button and click on run

  • Make sure the RemoteBlazorWebViewTutorial.WpfApp is set as Startup Project

  • Next we will run the application remotely

  • Select the Remote Profile from the dropdown next to the Run button and click on run

  • A main window will come up with a URL. Click on it

  • At this point the sample blazor app will be running in a web browser served from RemoteWebViewService!

  • Finally, we will run the application from a cloud server (https://server.remoteblazorwebview.com/)

  • Select the Cloud Profile from the dropdown next to the Run button and click on run

  • A main window will come up with a URL. Click on it

  • At this point the sample blazor app will be running in a web browser served from https://server.remoteblazorwebview.com. Accessing the server will require that you set up a login. The server is setup for demo purposes only. Contact me at budcribar@msn.com if you would like help setting up a production server.

Security

Each time a client application starts it attaches to the server with a unique Guid. This Guid needs to be specified on the Url in order to access the application and provides the first layer of security. The application is locked once a browser attaches to the server at a given Guid and no other browser instance has access.

The demo version of the RemoteWebViewService does not include authentication but it can be built and configured with Azure AD B2C. When built with Azure AD B2C authentication, the server requires that users are authenticated in order to access the endpoints which serve up the demo application user interface. The server code is hosted in the RemoteBlazorWebView github repository and includes a Visual Studio project to build the server. This added layer of security should be sufficient for most use cases but the server can be further locked down with firewall rules if needed.

Changing the default server port

Create an appsettings.json file with the contents: (Replace 5002 with the desired port)

{
  "Kestrel": {
    "Endpoints": {
      "Https": {
        "Url": "https://localhost:5002"
      }
    }
  }
}

  • Copy the appsettings.json into the directory
cd %USERPROFILE%\.dotnet\tools

Convert To Remote

Converting a WPF Blazor Application to a Remote WPF Blazor Application

Product Compatible and additional computed target framework versions.
.NET net9.0 is compatible. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
9.0.0 90 11/14/2024
9.0.0-rc2 51 10/26/2024
9.0.0-preview7 149 8/19/2024
9.0.0-preview6 45 7/29/2024
9.0.0-preview5 65 6/23/2024
8.0.11 83 11/14/2024
8.0.10 110 10/10/2024
8.0.8 147 8/20/2024
8.0.7 89 7/29/2024
8.0.6 131 6/19/2024
8.0.4 128 6/19/2024
8.0.3 142 4/20/2024
8.0.2 147 2/24/2024
8.0.1 153 2/16/2024
8.0.0-rc2 107 10/14/2023
8.0.0-preview5 113 6/15/2023
8.0.0-preview4 102 5/24/2023
8.0.0-preview3 116 4/21/2023
8.0.0-preview2 114 3/29/2023
7.0.16 144 2/25/2024
7.0.12 319 10/14/2023
7.0.9 208 8/15/2023
7.0.7 202 6/14/2023
7.0.5 216 4/20/2023
7.0.4 295 3/24/2023
7.0.3 280 3/17/2023
7.0.2 363 1/29/2023
7.0.0 396 11/13/2022
7.0.0-rc1 119 10/9/2022
7.0.0-pre6 132 7/14/2022
7.0.0-pre5 149 7/2/2022
7.0.0-pre4 151 5/11/2022
6.3.9 297 2/11/2023
6.3.8 330 2/1/2023
6.3.7 317 1/31/2023
6.3.6 369 11/13/2022
6.3.5 451 10/11/2022
6.3.4 486 7/13/2022
6.3.3 478 7/3/2022
6.3.2 475 6/15/2022
6.3.1 462 5/25/2022
6.3.0 466 5/21/2022
6.2.0 193 5/8/2022
6.1.2-pre 160 4/7/2022
6.1.1-pre 139 2/19/2022
6.1.0-pre 138 2/7/2022
6.0.38-pre 154 2/1/2022
6.0.37-pre 150 1/25/2022

Based on maui 8.0.60