aschey / wry

Tiny cross-platform WebView library in Rust for Tauri. [WIP]

WRY (Webview Rendering librarY)

Cross-platfrom WebView rendering library in Rust that supports all major desktop platforms like Windows 10, macOS, and Linux.

[dependencies]
wry = "0.6"

Overview

Wry connects the web engine on each platform and provides easy to use and unified interface to render WebView. It uses winit on most platforms and gtk-rs on Linux for windows creation.

Usage

The minimum example looks like following:

use wry::{Application, Result};

fn main() -> Result<()> {
    let mut app = Application::new()?;
    app.add_window(Default::default())?;
    app.run();
    Ok(())
}

There are also more samples under examples, you can enter commands like following to try them:

cargo run --example multiwindow

For more information, please read the documentation below.

Documentation

Platform-specific notes

All platforms uses winit to build the window except Linux. Here are the underlying web engine each platfrom uses and some dependencies you might need to install.

Linux

Unlike other platforms, gtk-rs is used to build the window instead of winit. Because wry needs WebKitGTK and winit provides lower level of interface like x11 or wayland. Please make sure WebKitGTK is installed. If not, run the following command:

Arch Linux / Manjaro:

sudo pacman -S webkit2gtk

Debian / Ubuntu:

sudo apt install libwebkit2gtk-4.0-dev

macOS

WebKit is native on macOS so everything should be fine.

If you are cross-compiling for macOS using osxcross and encounter a runtime panic like Class with name WKWebViewConfiguration could not be found it's possible that WebKit.framework has not been linked correctly, to fix this set the RUSTFLAGS environment variable:

RUSTFLAGS="-l framework=WebKit" cargo build --target=x86_64-apple-darwin --release

Windows

WebView2 provided by Microsoft Edge Chromium is used. So wry supports Windows 7, 8, and 10.

License

Apache-2.0/MIT