Struct tauri::Builder

pub struct Builder<E, L, MID, TID, A, R> where
    E: Tag,
    L: Tag,
    MID: MenuId,
    TID: MenuId,
    A: Assets,
    R: Runtime,  { /* fields omitted */ }

Builds a Tauri application.

Implementations

impl<E, L, MID, TID, A, R> Builder<E, L, MID, TID, A, R> where
    E: Tag,
    L: Tag,
    MID: MenuId,
    TID: MenuId,
    A: Assets,
    R: Runtime, 

pub fn new() -> Self

Creates a new App builder.

pub fn invoke_handler<F>(self, invoke_handler: F) -> Self where
    F: Fn(Invoke<Args<E, L, MID, TID, A, R>>) + Send + Sync + 'static, 

Defines the JS message handler callback.

pub fn setup<F>(self, setup: F) -> Self where
    F: Fn(&mut App<Args<E, L, MID, TID, A, R>>) -> Result<(), Box<dyn Error + Send>> + Send + 'static, 

Defines the setup hook.

pub fn on_page_load<F>(self, on_page_load: F) -> Self where
    F: Fn(Window<Args<E, L, MID, TID, A, R>>, PageLoadPayload) + Send + Sync + 'static, 

Defines the page load hook.

pub fn plugin<P: Plugin<Args<E, L, MID, TID, A, R>> + 'static>(
    self,
    plugin: P
) -> Self

Adds a plugin to the runtime.

pub fn manage<T>(self, state: T) -> Self where
    T: Send + Sync + 'static, 

Add state to the state managed by the application.

This method can be called any number of times as long as each call refers to a different T.

Managed state can be retrieved by any request handler via the State request guard. In particular, if a value of type T is managed by Tauri, adding State<T> to the list of arguments in a request handler instructs Tauri to retrieve the managed value.

Panics

Panics if state of type T is already being managed.

Example

use tauri::State;

struct MyInt(isize);
struct MyString(String);

#[tauri::command]
fn int_command(state: State<'_, MyInt>) -> String {
    format!("The stateful int is: {}", state.0)
}

#[tauri::command]
fn string_command<'r>(state: State<'r, MyString>) {
    println!("state: {}", state.inner().0);
}

fn main() {
    tauri::Builder::default()
        .manage(MyInt(10))
        .manage(MyString("Hello, managed state!".to_string()))
        .run(tauri::generate_context!())
        .expect("error while running tauri application");
}

pub fn create_window<F>(self, label: L, url: WindowUrl, setup: F) -> Self where
    F: FnOnce(<R::Dispatcher as Dispatch>::WindowBuilder, WebviewAttributes) -> (<R::Dispatcher as Dispatch>::WindowBuilder, WebviewAttributes), 

Creates a new webview window.

pub fn system_tray(self, items: Vec<SystemTrayMenuItem<TID>>) -> Self

This is supported on crate feature system-tray only.

Adds the icon configured on tauri.conf.json to the system tray with the specified menu items.

pub fn menu(self, menu: Vec<Menu<MID>>) -> Self

This is supported on crate feature menu only.

Sets the menu to use on all windows.

pub fn on_menu_event<F: Fn(WindowMenuEvent<Args<E, L, MID, TID, A, R>>) + Send + Sync + 'static>(
    self,
    handler: F
) -> Self

This is supported on crate feature menu only.

Registers a menu event handler for all windows.

pub fn on_window_event<F: Fn(GlobalWindowEvent<Args<E, L, MID, TID, A, R>>) + Send + Sync + 'static>(
    self,
    handler: F
) -> Self

Registers a window event handler for all windows.

pub fn on_system_tray_event<F: Fn(&AppHandle<Args<E, L, MID, TID, A, R>>, SystemTrayEvent<TID>) + Send + Sync + 'static>(
    self,
    handler: F
) -> Self

This is supported on crate feature system-tray only.

Registers a system tray event handler.

pub fn register_global_uri_scheme_protocol<N: Into<String>, H: Fn(&str) -> Result<Vec<u8>, Box<dyn Error>> + Send + Sync + 'static>(
    self,
    uri_scheme: N,
    protocol: H
) -> Self

Registers a URI scheme protocol available to all webviews. Leverages setURLSchemeHandler on macOS, AddWebResourceRequestedFilter on Windows and webkit-web-context-register-uri-scheme on Linux.

Arguments

• uri_scheme The URI scheme to register, such as example.
• protocol the protocol associated with the given URI scheme. It’s a function that takes an URL such as example://localhost/asset.css.

pub fn run(self, context: Context<A>) -> Result<()>

Runs the configured Tauri application.

Trait Implementations

impl<A: Assets> Default for Builder<String, String, String, String, A, Wry>

Make Wry the default Runtime for Builder

fn default() -> Self

Returns the “default value” for a type.