io.github.juanimoli.strictmode.notifier:notifier

An Android library that report notification of StrictMode violation


License
ClArtistic

Documentation

strictmode-notifier

Android Weekly Android Arsenal

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

strictmode-notifier/testapp


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?

  1. notifier starts logcat command in backgound thread, and infinitely reads the log from logcat.
  2. If StrictMode violation is happend, error logs is outputed.
  3. notifier reads that log via logcat, 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.