Struct Config 

pub struct Config { /* private fields */ }

Filter for android logger.

Implementations

impl Config

pub fn with_max_level(self, level: LevelFilter) -> Self

Changes the maximum log level.

Note, that Trace is the maximum level, because it provides the maximum amount of detail in the emitted logs.

If Off level is provided, then nothing is logged at all.

log::max_level() is considered as the default level.

Examples found in repository

examples/system_log_level_overrides.rs (line 76)

fn main() {
    android_logger::init_once(
        android_logger::Config::default()
            .with_tag("log_test")
            // If set, this is the highest level to log unless overriddeby by the system.
            // Note the verbosity can be *increased* through system properties.
            .with_max_level(log::LevelFilter::Info),
    );
    // The log crate applies its filtering before we even get to android_logger.
    // Pass everything down so that Android's liblog can determine the log level instead.
    log::set_max_level(log::LevelFilter::Trace);

    log::trace!("trace");
    log::debug!("debug");
    log::info!("info");
    log::warn!("warn");
    log::error!("error");
}

pub fn with_log_buffer(self, buf_id: LogId) -> Self

Changes the Android logging system buffer to be used.

By default, logs are sent to the Main log. Other logging buffers may only be accessible to certain processes.

pub fn with_filter(self, filter: Filter) -> Self

pub fn with_tag<S: Into<Vec<u8>>>(self, tag: S) -> Self

Examples found in repository

examples/system_log_level_overrides.rs (line 73)

fn main() {
    android_logger::init_once(
        android_logger::Config::default()
            .with_tag("log_test")
            // If set, this is the highest level to log unless overriddeby by the system.
            // Note the verbosity can be *increased* through system properties.
            .with_max_level(log::LevelFilter::Info),
    );
    // The log crate applies its filtering before we even get to android_logger.
    // Pass everything down so that Android's liblog can determine the log level instead.
    log::set_max_level(log::LevelFilter::Trace);

    log::trace!("trace");
    log::debug!("debug");
    log::info!("info");
    log::warn!("warn");
    log::error!("error");
}

pub fn format<F>(self, format: F) -> Self

where F: Fn(&mut dyn Write, &Record<'_>) -> Result + Sync + Send + 'static,

Sets the format function for formatting the log output.

android_logger::init_once(
    Config::default()
        .with_max_level(log::LevelFilter::Trace)
        .format(|f, record| write!(f, "my_app: {}", record.args()))
)

Trait Implementations

impl Debug for Config

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for Config

fn default() -> Config

Returns the “default value” for a type.