SteveSandersonMS/WebWindow
.NET Core library to open native OS windows containing web UI on Windows, Mac, and Linux. Experimental.
repo name | SteveSandersonMS/WebWindow |
repo link | https://github.com/SteveSandersonMS/WebWindow |
homepage | |
language | TypeScript |
size (curr.) | 613 kB |
stars (curr.) | 1300 |
created | 2019-11-17 |
license | Apache License 2.0 |
WebWindow
For information, see this blog post.
Usage instructions
Unless you want to change the WebWindow
library itself, you do not need to build this repo yourself. If you just want to use it in an app, grab the prebuilt NuGet package or follow these ‘hello world’ example steps.
Samples
For samples, open the WebWindow.Samples.sln
solution
These projects reference the prebuilt NuGet package so can be built without building the native code in this repo.
How to build this repo
If you want to build the WebWindow
library itself, you will need:
- Windows, Mac, or Linux
- Node.js (because
WebWindow.Blazor.JS
includes TypeScript code, so the build process involves calling Node to perform a Webpack build) - If you’re on Windows:
- Use Visual Studio with C++ support enabled. You must build in x64 configuration (not AnyCPU, which is the default).
- If things don’t seem to be updating, try right-clicking one of the
testassets
projects and choose Rebuild to force it to rebuild the native assets.
- If you’re on macOS:
- Install Xcode so that you have the whole
gcc
toolchain available on the command line. - From the repo root, run
dotnet build src/WebWindow/WebWindow.csproj
- Then you can
cd testassets/HelloWorldApp
anddotnet run
- Install Xcode so that you have the whole
- If you’re on Linux (tested with Ubuntu 18.04):
- Install dependencies:
sudo apt-get update && sudo apt-get install libgtk-3-dev libwebkit2gtk-4.0-dev
- From the repo root, run
dotnet build src/WebWindow/WebWindow.csproj
- Then you can
cd testassets/HelloWorldApp
anddotnet run
- Install dependencies:
- If you’re on Windows Subsystem for Linux (WSL), then as well as the above, you will need a local X server (example setup).