strictmode-notifier
Origins
Forked from original repo because it was no longer maintained
An Android library that improves the StrictMode reporting.
- Head-up Notification of StrictMode violations.
- Ignoring Specific Violations
- Custom Actions that called when StrictMode violations is happend.
-
Violation History Viewer that automatically installed.
Screenshots
Sample App
About StrictMode
Getting started
In your build.gradle
:
repositories {
jcenter()
}
dependencies {
implementation 'io.github.juanimoli.strictmode.notifier:notifier:2.0.0'
}
In your Application
class:
public class ExampleApplication extends Application {
@Override
public void onCreate() {
super.onCreate();
if (BuildConfig.DEBUG) {
// setup this library
StrictModeNotifier.install(this);
// setup StrictMode.
// penaltyLog() should be called for strictmode-notifier
new Handler().post((Runnable) () -> {
StrictMode.ThreadPolicy threadPolicy = new StrictMode.ThreadPolicy.Builder()
.detectAll()
.permitDiskReads()
.permitDiskWrites()
.penaltyLog() // Must!
.build();
StrictMode.setThreadPolicy(threadPolicy);
StrictMode.VmPolicy vmPolicy = new StrictMode.VmPolicy.Builder()
.detectAll()
.penaltyLog() // Must!
.build();
StrictMode.setVmPolicy(vmPolicy);
});
}
}
}
How does it work?
-
notifier
startslogcat
command in backgound thread, and infinitely reads the log fromlogcat
. - If StrictMode violation is happend, error logs is outputed.
-
notifier
reads that log vialogcat
, and shows a notification of the violation.
Customizing
How to ignore specific violations
StrictModeNotifier
.install(context)
.setIgnoreAction(new IgnoreAction() {
@Override public boolean ignore(StrictModeViolation violation) {
// ex) ignore LEAKED_CLOSABLE_OBJECTS that contains android.foo.bar in stacktrace.
return violation.violationType == ViolationType.LEAKED_CLOSABLE_OBJECTS
&& violation.getStacktraceText().contains("android.foo.bar");
}
});
How to add custom actions
StrictModeNotifier
.install(context)
.addCustomAction(new CustomAction() {
@Override public void onViolation(StrictModeViolation violation) {
//ex) Send messages into Slack
}
});
How to disable Headup Notification
StrictModeNotifier
.install(context)
.setHeadupEnabled(false);
How to enable debug mode of strictmode-notifier
StrictModeNotifier
.install(context)
.setDebugMode(true);
Todo
Parsing following violations
- ActivityLeaks
- LeakedRegistrationObjects
- LeakedSqlLiteObjects
Thanks
Inspired by square/leakcanary
License
Copyright (C) 2016 nshmura
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.