Clone this repo:
  1. 6ec890e Merge pull request #830 from colinmadere/fix-readme-code-827 by Jake Wharton · 3 hours ago master
  2. 04c7707 README code sample fix when using Robolectric by Colin Madere · 3 hours ago
  3. 2dfdb0b Merge pull request #820 from square/update-scripts by Jake Wharton · 5 days ago
  4. 246de72 Fix new checkstyle failures by John Rodriguez · 6 days ago
  5. 6116372 Fix checkstyle script by John Rodriguez · 6 days ago

LeakCanary

A memory leak detection library for Android and Java.

“A small leak will sink a great ship.” - Benjamin Franklin

Getting started

In your build.gradle:

 dependencies {
   debugCompile 'com.squareup.leakcanary:leakcanary-android:1.5.2'
   releaseCompile 'com.squareup.leakcanary:leakcanary-android-no-op:1.5.2'
 }

In your Application class:

public class ExampleApplication extends Application {

  @Override public void onCreate() {
    super.onCreate();
    if (LeakCanary.isInAnalyzerProcess(this)) {
      // This process is dedicated to LeakCanary for heap analysis.
      // You should not init your app in this process.
      return;
    }
    LeakCanary.install(this);
    // Normal app init code...
  }
}

For Robolectric users:

public class ExampleApplication extends Application {

  @Override public void onCreate() {
    super.onCreate();
    setupLeakCanary();
  }
 
  protected RefWatcher setupLeakCanary() {
    if (LeakCanary.isInAnalyzerProcess(this)) {
      return RefWatcher.DISABLED;
    }
    return LeakCanary.install(this);
  }
}
 
// in src/test/java
public class TestExampleApplication extends ExampleApplication {
  @Override protected RefWatcher setupLeakCanary() {
    // No leakcanary in unit tests.
    return RefWatcher.DISABLED;
  }
}

You're good to go! LeakCanary will automatically show a notification when an activity memory leak is detected in your debug build.

Questions? Check out the FAQ!

License

Copyright 2015 Square, Inc.

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.