tag | 63a040e039410216f0ea838283b9c0f7d6af0660 | |
---|---|---|
tagger | The Android Open Source Project <initial-contribution@android.com> | Mon Aug 22 14:00:09 2022 -0700 |
object | fee6875e2ce6bc390121bf4f1b4c27f2bab7e47f |
Platform Tools Release 33.0.2 (8557947)
commit | fee6875e2ce6bc390121bf4f1b4c27f2bab7e47f | [log] [tgz] |
---|---|---|
author | Android Build Coastguard Worker <android-build-coastguard-worker@google.com> | Sun May 08 04:33:16 2022 +0000 |
committer | Android Build Coastguard Worker <android-build-coastguard-worker@google.com> | Sun May 08 04:33:16 2022 +0000 |
tree | 23605f728d6720a7f4685618635e382fba497575 | |
parent | 080a618ecf40826104e33d367dfe9255fb0cda66 [diff] | |
parent | 97855c248094e59917838f3e069f327a5a42b1e8 [diff] |
Snap for 8554636 from 97855c248094e59917838f3e069f327a5a42b1e8 to sdk-release Change-Id: I03da89e8d6e39e29d48c8ad8ee0e3b8260437caa
This library is a drop-in replacement for env_logger
. Instead, it outputs messages to android's logcat.
This only works on Android and requires linking to log
which is only available under android. With Cargo, it is possible to conditionally require this library:
[target.'cfg(target_os = "android")'.dependencies] android_logger = "0.11"
Example of initialization on activity creation, with log configuration:
#[macro_use] extern crate log; extern crate android_logger; use log::Level; use android_logger::{Config,FilterBuilder}; fn native_activity_create() { android_logger::init_once( Config::default() .with_min_level(Level::Trace) // limit log level .with_tag("mytag") // logs will show under mytag tag .with_filter( // configure messages for specific crate FilterBuilder::new() .parse("debug,hello::crate=error") .build()) ); trace!("this is a verbose {}", "message"); error!("this is printed by default"); }
To allow all logs, use the default configuration with min level Trace:
#[macro_use] extern crate log; extern crate android_logger; use log::Level; use android_logger::Config; fn native_activity_create() { android_logger::init_once( Config::default().with_min_level(Level::Trace)); }
There is a caveat that this library can only be initialized once (hence the init_once
function name). However, Android native activity can be re-created every time the screen is rotated, resulting in multiple initialization calls. Therefore this library will only log a warning for subsequent init_once
calls.
This library ensures that logged messages do not overflow Android log message limits by efficiently splitting messages into chunks.
Licensed under either of
at your option.
Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.