nextai-translator/nextai-translator · critical

error while building tauri application

Error message

error while building tauri application

What it means

The final .build(tauri::generate_context!()) in main is unwrapped with .expect("error while building tauri application"), so any failure assembling the Tauri app (config parsing, plugin/tray setup errors propagated through setup, asset embedding) panics at startup. It is the catch-all fatal error for application boot.

Source

Thrown at src-tauri/src/main.rs:577

                }
            });
            let handle = app_handle.clone();
            PinnedFromWindowEvent::listen_any(app_handle, move |event| {
                let pinned = event.payload.pinned();
                ALWAYS_ON_TOP.store(*pinned, Ordering::Release);
                tray::create_tray(&handle).unwrap();
            });

            let handle = app_handle.clone();
            ConfigUpdatedEvent::listen_any(app_handle, move |_event| {
                clear_config_cache();
                tray::create_tray(&handle).unwrap();
            });
            Ok(())
        })
        .invoke_handler(invoke_handler)
        .build(tauri::generate_context!())
        .expect("error while building tauri application");

    #[cfg(target_os = "macos")]
    {
        let config = config::get_config_by_app(app.handle()).unwrap_or_default();
        if config.hide_the_icon_in_the_dock.unwrap_or(true) {
            app.set_activation_policy(tauri::ActivationPolicy::Accessory);
        } else {
            app.set_activation_policy(tauri::ActivationPolicy::Regular);
        }
    }

    app.run(|app, event| match event {
        tauri::RunEvent::Exit { .. } => {
            let _ = app.track_event("app_exited", None);
            app.flush_events_blocking();
        }
        tauri::RunEvent::Ready => {
            let _ = app.track_event("app_started", None);

View on GitHub (pinned to f57537ee4a)

Solutions

1. Read the wrapped cause printed with the panic — it names the failing config/setup step
2. Validate tauri.conf.json against the Tauri schema and confirm all icon paths exist
3. Check the setup() closure — tray::create_tray(&handle).unwrap() will poison the result; handle headless/trayless desktops
4. Pin/align tauri plugin versions with the core tauri version after upgrades

Example fix

// before
tray::create_tray(&handle).unwrap();
// after
if let Err(e) = tray::create_tray(&handle) {
    log::warn!("tray unavailable: {e}"); // don't fail app build
}

// shell, before launch:
python3 -c "import json; json.load(open('src-tauri/tauri.conf.json'))" || exit 1
for icon in $(jq -r '.bundle.icon[]' src-tauri/tauri.conf.json 2>/dev/null); do test -f "src-tauri/$icon" || { echo "missing icon $icon"; exit 1; }; done

// Rust: make setup hooks fail-safe
fn setup(app: &mut tauri::App) -> Result<(), Box<dyn std::error::Error>> {
    if let Err(e) = tray::create_tray(app.handle()) {
        log::warn!("tray unavailable: {e}"); // do not propagate
    }
    Ok(())
}

let app = tauri::Builder::default()
    .setup(|app| { if let Err(e) = tray::create_tray(app.handle()) { log::warn!("{e}"); } Ok(()) })
    .build(tauri::generate_context!());
if let Err(e) = app {
    eprintln!("failed to build tauri application: {e}");
    std::process::exit(1);
}

When it happens

Trigger: Invalid tauri.conf.json (schema/missing fields, missing icon files referenced by generate_context!), a setup hook returning Err (e.g. tray::create_tray failing), or plugin initialization errors.

Common situations: Renamed/removed icon files still referenced in config; malformed JSON or unsupported config keys after a Tauri major upgrade; tray creation failing on desktops without system tray support; bad plugin config.

Related errors

• failed to create webview window: {e}
• failed to initialize Tokio runtime
• Failed to export TypeScript bindings

AI-assisted analysis of nextai-translator/nextai-translator@f57537ee4a (2026-08-31). Data as JSON: /api/errors/4d02b34c6271f15e. Report an issue: GitHub.