A transparent ui-block detection library for Android, app only needs one-line-code to setup.
The naming is to pay respect to the great library LeakCanary, ui-related codes are modified from leakcanary's ui part.
- 1.3.0 Add white-list and concern-package feature.
- 1.3.1 Enable configuration of label and icon.
You may choose how to assemble them as you like.
dependencies {
// most often used way, enable notification to notify block event
compile 'com.github.moduth:blockcanary-android:1.3.1'// this way you only enable BlockCanary in debug package// debugCompile 'com.github.moduth:blockcanary-android:1.3.1'// releaseCompile 'com.github.moduth:blockcanary-no-op:1.3.0'
}As this library uses getMainLooper().setMessageLogging(), please check if you set it in your app (related issue markzhai#27)
Maximum log count is set to 500, you can rewrite it in your app int.xml.
<integername="block_canary_max_stored_count">1000</integer>Monitor app's label and icon can be configured by placing a block_canary_icon drawable in your xhdpi drawable directory and in strings.xml:
<stringname="block_canary_display_activity_label">Blocks</string>publicclassDemoApplicationextendsApplication {
@OverridepublicvoidonCreate() {
// ...// Do it on main processBlockCanary.install(this, newAppBlockCanaryContext()).start();
}
}Implement your application BlockCanaryContext context (strongly recommend you to check all these configs)：
publicclassAppBlockCanaryContextextendsBlockCanaryContext {
/** * Implement in your project. * * @return Qualifier which can specify this installation, like version + flavor. */publicStringprovideQualifier() {
return"unknown";
}
/** * Implement in your project. * * @return user id */publicStringprovideUid() {
return"uid";
}
/** * Network type * * @return {@link String} like 2G, 3G, 4G, wifi, etc. */publicStringprovideNetworkType() {
return"unknown";
}
/** * Config monitor duration, after this time BlockCanary will stop, use * with {@code BlockCanary}'s isMonitorDurationEnd * * @return monitor last duration (in hour) */publicintprovideMonitorDuration() {
return -1;
}
/** * Config block threshold (in millis), dispatch over this duration is regarded as a BLOCK. You may set it * from performance of device. * * @return threshold in mills */publicintprovideBlockThreshold() {
return1000;
}
/** * Thread stack dump interval, use when block happens, BlockCanary will dump on main thread * stack according to current sample cycle. * <p> * Because the implementation mechanism of Looper, real dump interval would be longer than * the period specified here (especially when cpu is busier). * </p> * * @return dump interval (in millis) */publicintprovideDumpInterval() {
returnprovideBlockThreshold();
}
/** * Path to save log, like "/blockcanary/", will save to sdcard if can. * * @return path of log files */publicStringprovidePath() {
return"/blockcanary/";
}
/** * If need notification to notice block. * * @return true if need, else if not need. */publicbooleandisplayNotification() {
returntrue;
}
/** * Implement in your project, bundle files into a zip file. * * @param src files before compress * @param dest files compressed * @return true if compression is successful */publicbooleanzip(File[] src, Filedest) {
returnfalse;
}
/** * Implement in your project, bundled log files. * * @param zippedFile zipped file */publicvoidupload(FilezippedFile) {
thrownewUnsupportedOperationException();
}
/** * Packages that developer concern, by default it uses process name, * put high priority one in pre-order. * * @return null if simply concern only package with process name. */publicList<String> concernPackages() {
returnnull;
}
/** * Filter stack without any in concern package, used with @{code concernPackages}. * * @return true if filter, false it not. */publicbooleanfilterNonConcernStack() {
returnfalse;
}
/** * Provide white list, entry in white list will not be shown in ui list. * * @return return null if you don't need white-list filter. */publicList<String> provideWhiteList() {
LinkedList<String> whiteList = newLinkedList<>();
whiteList.add("org.chromium");
returnwhiteList;
}
/** * Whether to delete files whose stack is in white list, used with white-list. * * @return true if delete, false it not. */publicbooleandeleteFilesInWhiteList() {
returntrue;
}
}Blog in Chinese: BlockCanary.
Principle flow picture:
This library is initially created by markzhai, and maintained under the organization moduth with nimengbo and zzz40500.
Special thanks to android-cjj, Mr.Bao, chiahaolu to contribute.
Check CHANGELOG
If you would like to contribute code to BlockCanary you can do so through GitHub by forking the repository and sending a pull request.
Copyright (C) 2016 MarkZhai (http://zhaiyifan.cn).
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.