flutter_rust_bridge 2.12.0

Flutter/Dart <-> Rust binding generator, feature-rich, but seamless and simple
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46

use crate::misc::panic_backtrace::PanicBacktrace;

/// Setup defaults that is usually useful for a new project.
/// Surely, you are free to customize everything.
pub fn setup_default_user_utils() {
    // setup log before others, such that we can see logs in other setup functions
    #[cfg(feature = "log")]
    setup_log_to_console(log::LevelFilter::Trace);
    setup_backtrace();
}

/// Setup backtrace recording, including setting `RUST_BACKTRACE=1` if not already set.
pub fn setup_backtrace() {
    #[cfg(not(target_family = "wasm"))]
    if std::env::var("RUST_BACKTRACE").err() == Some(std::env::VarError::NotPresent) {
        std::env::set_var("RUST_BACKTRACE", "1");
    } else {
        #[cfg(feature = "log")]
        log::debug!("Skip setup RUST_BACKTRACE because there is already environment variable");
    }

    PanicBacktrace::setup();
}

/// Setup platform-specific console logging with the given level filter.
///
/// # Example
///
/// ```rust,no_run
/// flutter_rust_bridge::setup_log_to_console(
///     if cfg!(debug_assertions) { log::LevelFilter::Trace } else { log::LevelFilter::Warn }
/// );
/// ```
#[cfg(feature = "log")]
pub fn setup_log_to_console(#[allow(unused)] level: log::LevelFilter) {
    #[cfg(target_os = "android")]
    let _ = android_logger::init_once(android_logger::Config::default().with_max_level(level));

    #[cfg(any(target_os = "ios", target_os = "macos"))]
    let _ = oslog::OsLogger::new("frb_user").level_filter(level).init();

    #[cfg(target_family = "wasm")]
    let _ = crate::misc::web_utils::WebConsoleLogger::init(level);

    // TODO add more platforms
}