Crate wry[][src]

Expand description

Wry is a Cross-platform WebView rendering library.

To build a Window with WebView embedded, we could use application module to create EventLoop and the window. It’s a module that re-exports APIs from tao. Then use webview module to create the WebView from the Window. Here’s a minimum example showing how to create a hello world window and load the url to Tauri website.

fn main() -> wry::Result<()> {
  use wry::{
      event::{Event, StartCause, WindowEvent},
      event_loop::{ControlFlow, EventLoop},
  let event_loop = EventLoop::new();
  let window = WindowBuilder::new()
    .with_title("Hello World")
  let _webview = WebViewBuilder::new(window)?
    .build()?; |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,
      _ => (),

Feature flags

Wry uses a set of feature flags to toggle several advanced features. file-drop, protocol, and tray are enabled by default.

  • file-drop: Enables with_file_drop_handler to control the behaviour when there are files interacting with the window.
  • protocol: Enables with_custom_protocol to define custom URL scheme for handling tasks like loading assets.
  • tray: Enables system tray and more menu item variants on Linux. You can still create those types if you disable it. They just don’t create the actual objects. We set this flag because some implementations require more installed packages. Disable this if you don’t want to install libappindicator package.
  • dox: Enables this in section to skip linking some Linux libraries and prevent from building documentation on fails.

Debug build

Debug profile enables tools like inspector for development or debug usage. Note this will call private APIs on macOS.


Re-exported Tao APIs

HTTP types used by wry protocol.

WebView struct and associated types.


Errors returned by wry.

Represents any valid JSON value.

Type Definitions

Convenient type alias of Result type for wry.