BlazorWebView - GitLite

KO | EN

gitlite — search

#hacktoberfest #react #ai #llm #machine-learning #docker #macos #nodejs #windows #cli #kubernetes #awesome-list #vue #pytorch

BlazorWebView

(★ 139)

A WebKitGtk WebView for running Blazor Hybrid applications on Linux.

파일 탐색기

최종 버전 다운로드 (.zip)

- launch.json
- settings.json
- tasks.json
- screenshot.png
- BlazorWebView.cs
- BlazorWebViewOptions.cs
- ServiceCollectionExtensions.cs
- WebKitGtk.csproj
- - WeatherForecast.cs
  - WeatherForecastService.cs
- - Counter.razor
  - FetchData.razor
  - Index.razor
- - launchSettings.json
- - MainLayout.razor
  - MainLayout.razor.css
  - NavMenu.razor
  - NavMenu.razor.css
  - SurveyPrompt.razor
- - index.html
- _Imports.razor
- App.razor
- Program.cs
- WebKitGtk.Test.csproj
.gitignore
BlazorHybridLinux.sln
LICENSE
README.md
WSL2.md

# 설치 가이드

1. 코드 내려받기

git clone https://github.com/JinShil/BlazorWebView

깃허브에서 프로젝트 코드 전체를 내 컴퓨터로 내려받습니다.

cd BlazorWebView

방금 내려받은 프로젝트 폴더 안으로 이동합니다.

2. .NET

보통 추천

사전 준비물

Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
.NET SDK dotnet 명령어를 쓰기 위한 SDK입니다.

dotnet run

프로젝트를 빌드하고 바로 실행합니다.

✅ dotnet run 실행 후 터미널에 나타나는 안내 메시지나 주소를 확인하세요.

이 레포의 README에 적힌 실제 명령어를 그대로 가져왔습니다.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# BlazorWebView
A [WebKitGTK](https://webkitgtk.org/) WebView, utilizing [Gir.Core](https://gircore.github.io/), for running [Blazor Hybrid](https://learn.microsoft.com/en-us/aspnet/core/blazor/hybrid/) applications on Linux without the need to compile a native library.  It is analagous to the [Winforms BlazorWebView](https://learn.microsoft.com/en-us/dotnet/api/microsoft.aspnetcore.components.webview.windowsforms.blazorwebview) or the [WPF BlazorWebView](https://learn.microsoft.com/en-us/dotnet/api/microsoft.aspnetcore.components.webview.wpf), but for Linux instead of Windows.

Blazor Hybrid apps allow one to create Blazor desktop applications that uses the local machine's .NET runtime (not Blazor WASM), has full access to local resources (not sandboxed), and does not require hosting through a web server (e.g. Blazor server). It is just like any other desktop application written in C#, but uses Blazor and web technologies to implement the user interface.

## Why?
Microsoft has decided to not support Maui on Linux, so there is currently no way to create Blazor Hybrid apps on Linux using *only* C#.

## How?
BlazorWebView uses some of the same code as [Steve Sanderson's WebWindow](https://github.com/SteveSandersonMS/WebWindow) and leverages [Microsoft's WebView infrastructure](https://github.com/dotnet/aspnetcore/tree/main/src/Components/WebView) to get Blazor Hybrid working.  However, it differs from WebWindow in that it doesn't require one to compile a native shared library in C++, instead utilizing [Gir.Core](https://gircore.github.io/) to call into the native libraries.   This has the benefit that, as long as the native libraries are installed on the Linux system, one only needs to use the `dotnet` CLI to build and run BlazorWebView.

## Screenshot
![Screenshot](https://raw.githubusercontent.com/JinShil/BlazorWebView/main/Screens/screenshot.png "Screenshot")

## Demonstration

### Using a Linux terminal
```
git clone https://github.com/JinShil/BlazorWebView.git
cd BlazorWebView/WebKitGtk.Test
dotnet run
```

### Using Visual Studio Code
On a Linux computer, simply open this repository in Visual Studio Code and press F5 to start a debug session.

### Debugging a Remote ARM Linux Instance from Visual Studio
This repository's solution has a "Remote ARM Linux" debug configuration that can be used to deploy and debug an instance of the test application on a Remote ARM Linux device.  Install the [Remote .NET Debugger Extension](http://www.comfilewiki.co.kr/en/doku.php?id=comfilepi:dotnet_core_development:remote_debugger:index), and follow the instructions there to utilize it.  Upvote [this issue](https://developercommunity.visualstudio.com/t/Convenient-way-to-add-a-remote-debug-con/917516) if you'd like Microsoft to add this capability to Visual Studio.

### Ubuntu 24.04 bwrap error fix
Running the demo project may fail with the following error on ubuntu 24.04:

bwrap: setting up uid map: Permission denied

This is due to the Ubuntu developers' decision to use AppArmor to restrict the creation of user namespaces. Below are the steps for applying a new AppArmor profile to enable user namespace restriction:

```sh
# Download the new profile:

sudo wget -O /etc/apparmor.d/bwrap-userns-restrict "https://gitlab.com/apparmor/apparmor/-/raw/master/profiles/apparmor/profiles/extras/bwrap-userns-restrict?ref_type=heads&inline=false"

# Load the new profile into AppArmor:
sudo apparmor_parser -r /etc/apparmor.d/bwrap-userns-restrict

# Restart the AppArmor service:
sudo systemctl restart apparmor
```

## Usage
See the project in [WebKitGtk.Test](https://github.com/JinShil/BlazorWebView/tree/main/WebKitGtk.Test) for an example illustrating how to create a Blazor Hybrid application using the BlazorWebView.

You may need to install the following packages:
* libadwaita-1-0
* libwebkitgtk-6.0-4

## Status
This project was tested on:
- Windows Subsystem for Linux. Detailed setup instructions are available [here](./WSL2.md).
- Raspberry Pi Bullseye 64-bit
- Debian Bullseye 64-bit.
- Ubuntu 24.04 LTS desktop amd64

The root .vscode directory has the necessary configuration files to build, deploy, and debug a Raspberry Pi from a Debian Bullseyse 64-bit workstation PC.

## Nuget Package

For a Nuget package derived from this project, See [WebKit.BlazorWebView.GirCore](https://www.nuget.org/packages/WebKit.BlazorWebView.GirCore/).