#tauri #webview #cross-platform #linux #desktop

wry

Cross-platform WebView rendering library

25 releases (10 breaking)

0.11.0 Jul 15, 2021
0.9.4 May 18, 2021
0.6.1 Mar 21, 2021

#27 in GUI

Download history 940/week @ 2021-04-07 1177/week @ 2021-04-14 2351/week @ 2021-04-21 1810/week @ 2021-04-28 1295/week @ 2021-05-05 2210/week @ 2021-05-12 1203/week @ 2021-05-19 1289/week @ 2021-05-26 1090/week @ 2021-06-02 1080/week @ 2021-06-09 814/week @ 2021-06-16 1782/week @ 2021-06-23 1308/week @ 2021-06-30 1226/week @ 2021-07-07 1862/week @ 2021-07-14 1496/week @ 2021-07-21

6,142 downloads per month
Used in 2 crates

Apache-2.0 OR MIT and maybe LGPL-2.1/LGPL-3.0

145KB
2.5K SLoC

WRY (Webview Rendering librarY)

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

[dependencies]
wry = "0.9"

Overview

Wry connects the web engine on each platform and provides easy to use and unified interface to render WebView. It also re-exports tao as a module for event loop and window creation.

Usage

The minimum example to create a Window and browse a website looks like following:

fn main() -> wry::Result<()> {
  use wry::{
    application::{
      event::{Event, StartCause, WindowEvent},
      event_loop::{ControlFlow, EventLoop},
      window::WindowBuilder,
    },
    webview::WebViewBuilder,
  };

  let event_loop = EventLoop::new();
  let window = WindowBuilder::new()
    .with_title("Hello World")
    .build(&event_loop)?;
  let _webview = WebViewBuilder::new(window)?
    .with_url("https://tauri.studio")?
    .build()?;

  event_loop.run(move |event, _, control_flow| {
    *control_flow = ControlFlow::Wait;

    match event {
      Event::NewEvents(StartCause::Init) => println!("Wry has started!"),
      Event::WindowEvent {
        event: WindowEvent::CloseRequested,
        ..
      } => *control_flow = ControlFlow::Exit,
      _ => (),
    }
  });
}

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

cargo run --example multi_window

For more information, please read the documentation below.

Documentation

Platform-specific notes

All platforms uses tao to build the window, and wry re-export it as application module. Here are the underlying web engine each platform uses, and some dependencies you might need to install.

Linux

Tao uses gtk-rs and its related libraries for window creation and wry also needs WebKitGTK for WebView. So please make sure following packages are installed:

Arch Linux / Manjaro:

sudo pacman -S webkit2gtk gtksourceview3 libappindicator-gtk3 clang

Debian / Ubuntu:

sudo apt install libwebkit2gtk-4.0-dev libgtksourceview-3.0-dev libappindicator3-dev clang

Fedora

sudo dnf install gtk3-devel webkit2gtk3-devel gtksourceview3-devel libappindicator-gtk3-devel clang

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

Dependencies

~4–11MB
~235K SLoC