square / haha Goto Github PK

View Code? Open in Web Editor NEW

1.4K 73.0 177.0 13.98 MB

DEPRECATED Java library to automate the analysis of Android heap dumps.

License: Apache License 2.0

Java 100.00%

deprecated

haha's Introduction

Headless Android Heap Analyzer

“Ha Ha!” - Nelson

This repository is DEPRECATED

This project was created to provide a heap dump parser for LeakCanary by repackaging heap dump parsers from other repositories.
LeakCanary now has its own heap dump parser.
That parser is available on Maven Central as com.squareup.leakcanary:leakcanary-haha:2.0-alpha-1.

Introduction

HAHA is a Java library to automate the analysis of Android heap dumps.

This project is essentially a repackaging of the work of others to make it available as a small footprint Maven dependency.

Usage

To learn how to dump the heap, read the Android documentation. Here's an example:

File heapDumpFile = ...
Debug.dumpHprofData(heapDumpFile.getAbsolutePath());

After dumping the heap, use HAHA to parse and analyze it.

DataBuffer buffer = new MemoryMappedFileBuffer(heapDumpFile);
Snapshot snapshot = Snapshot.createSnapshot(buffer);

// The rest is up to you.
ClassObj someClass = snapshot.findClass("com.example.SomeClass");

Gradle config

dependencies {
  compile 'com.squareup.haha:haha:2.1'
}

Versions

HAHA 2.1

This release updates perflib to the bc5c698efaf970f599e877a8b26de16736db4272 SHA of the android_platform_tool_base repo.
It also overlays a patched version of HprofParser.java to fix https://issuetracker.google.com/issues/122713143.

HAHA 2.0.4

This release separates out Trove4j from HAHA since Trove4j is available under LGPL 2.1 and HAHA is available under Apache 2.

This library contains parts of perflib and is available under the same license, Apache v2.
It contains a repackaged version of Guava
It has an artifact dependency on a fork of Trove4j ("1.1 with patches from JetBrains") which is available in jcenter under the LGPL 2.1 license.
The result is merged in an uber-jar (perflib + guava) proguarded to remove unused code and reduce the footprint.

HAHA 2.0, 2.0.1, 2.0.2, 2.0.3

This library contains parts of perflib and is available under the same license, Apache v2.
It contains a repackaged version of Guava and Trove4j "1.1 with patches from JetBrains"
Trove4j is available under the LGPL 2.1 license.
The result is merged in an uber-jar proguarded to remove unused code and reduce the footprint.

HAHA 1.1, 1.2 and 1.3

The first versions of HAHA were the result of a series of forks:
Eclipse Memory Analyzer (MAT) is a Java heap analyzer. It's a standalone GUI built with Eclipse RCP that embeds an engine to parse and analyze heap dumps.
vshor/mat is a fork of Eclipse Memory Analyzer. It removed a lot of code and changed some of it to make a headless version (no GUI), as well as ignore weak references when finding paths to GC Roots.
AndroMAT is a fork of vshor/mat and changed the heap dump parsing to support Android specific heap dump format.
HAHA was originally a fork of AndroMAT. We recreated the lost Git history, kept the bare minimum needed code and packaged it to be releasable on Maven Central.
MAT is available under the Eclipse Public License v1.0 so HAHA was initially released under that same license.

Releasing

mvn release:prepare && mvn release:perform

haha's People

Contributors

Stargazers

Watchers

Forkers

msoftware shwenzhang huangtao123 xiaobi625 zhuhui xclouded afleshel matrixy brittneyforbish devenlu home201448 bineanzhou blank0ken cjfbox suryann semicoder hhcola echiquillo-zynga alphayang jesselianzhang linbercsu cstsinghua deveshmittal lpj0017 londonxue ryanyou wlrhnh-david foolishgao qunintus tangdadou codota pangbao sangkyoonnam jiyuren b2b2244424 team-supercharge yanglangfei neven7 zorosteven is00hcw zacsweers kennethnickles fifa0329 yuhongzhi yamingpeng100 zhqh99 sexiong306 bigfool shangguansb teczgirish shaynec oyk0928 anlegor louisrenweiwei ouyangpeng ryanfu feichangaihu runt18 redbirdinc wurq jacklongway newcomerbh popfisher supengchao loghanfeng yuxiangzhao mugad hkingz omakoto zeratel binioter mapleskip stormdzh sfcecy7i nozberkaryaindonesia suclike hiwong ly20050516 appsecai-test soucrecodestudy asherali offend aping-fo zhaguitao luciferaaa brianentropage hudawei996 chaozhouzhang vimmyvacon bertlk eggfly zhonghanwen yangjian92 yimigao raphael20735 ximotian morristech yanghongkjxy xianglijiaxing xdcs100

haha's Issues

Add correct sources to maven's source jar

The current source jar contains classes under their original packages, not the renamespaced one (e.g. com/android/tools/perflib/heap/ArrayInstance.java instead of com/squareup/haha/perflib/ArrayInstance.java).

This means that IntelliJ shows decompiled classes instead of real sources, and people who want to make source modifications can't rebuild from the source jar.

com.squareup.haha.trove.THashMap

when I use 2.0.4, I got a error , can't find class com.squareup.haha.trove.THashMap.
use 2.0.3 is OK。

Joiner Guava Class Compiler Error

When using 'com.squareup.leakcanary:leakcanary-android:1.4-beta2' I get the following errors each time I build the app. The app still builds just fine, but the errors do appear each time I build:

Error:warning: Ignoring InnerClasses attribute for an anonymous inner class
Error:(com.squareup.haha.guava.base.Joiner$1) that doesn't come with an
Error:associated EnclosingMethod attribute. This class was probably produced by a
Error:compiler that did not target the modern .class file format. The recommended
Error:solution is to recompile the class from source, using an up-to-date compiler
Error:and without specifying any "-target" type options. The consequence of ignoring
Error:this warning is that reflective operations on this class will incorrectly
Error:indicate that it is *not* an inner class.
Error:warning: Ignoring InnerClasses attribute for an anonymous inner class
Error:(com.squareup.haha.guava.collect.Iterables$2) that doesn't come with an
Error:associated EnclosingMethod attribute. This class was probably produced by a
Error:compiler that did not target the modern .class file format. The recommended
Error:solution is to recompile the class from source, using an up-to-date compiler
Error:and without specifying any "-target" type options. The consequence of ignoring
Error:this warning is that reflective operations on this class will incorrectly
Error:indicate that it is *not* an inner class.
Error:warning: Ignoring InnerClasses attribute for an anonymous inner class
Error:(com.squareup.haha.guava.collect.Iterables$3) that doesn't come with an
Error:associated EnclosingMethod attribute. This class was probably produced by a
Error:compiler that did not target the modern .class file format. The recommended
Error:solution is to recompile the class from source, using an up-to-date compiler
Error:and without specifying any "-target" type options. The consequence of ignoring
Error:this warning is that reflective operations on this class will incorrectly
Error:indicate that it is *not* an inner class.

OOM when trying to compute the dominators

LeakCanary 1.4-beta is showing this "Leak analysis failed" that seems to come from haha

See square/leakcanary#423

[Question] Where could I find the design doc for haha

Hi @pyricau , Where could I find the design doc for haha?
There were not many comments in source code, which is a little difficult for a beginner to read

Why haha 2.0.4 includes an old version of perflib

@pyricau Appologies first as this might be a beginner's question.

I saw Snapshot.computeDominators method in haha 2.0.4 is a very old version(the old version had a TODO: "Break dominator computation into fixed chunks, because it can be unbounded/expensive.").

this code snippets is from haha 2.0.4

Actually AOSP perflib had already a fix in 2015, see this: https://android.googlesource.com/platform/tools/base/+/72b27494b12ef02e0a9435a9b6451c0e61461074%5E%21/#F6

Upgrade compiler version to 1.7

Hi I'm getting an missing EnclosingMethod warning when I compile leak canary and I believe its caused by HAHA having an outdated compiler version. Can you upgrade the compiler version to 1.7?

Error:warning: Ignoring InnerClasses attribute for an anonymous inner class
Error:(com.squareup.haha.guava.base.Joiner$1) that doesn't come with an
Error:associated EnclosingMethod attribute. This class was probably produced by a
Error:compiler that did not target the modern .class file format. The recommended
Error:solution is to recompile the class from source, using an up-to-date compiler
Error:and without specifying any "-target" type options. The consequence of ignoring
Error:this warning is that reflective operations on this class will incorrectly
Error:indicate that it is *not* an inner class.
Error:warning: Ignoring InnerClasses attribute for an anonymous inner class
Error:(com.squareup.haha.guava.collect.Iterables$3) that doesn't come with an
Error:associated EnclosingMethod attribute. This class was probably produced by a
Error:compiler that did not target the modern .class file format. The recommended
Error:solution is to recompile the class from source, using an up-to-date compiler
Error:and without specifying any "-target" type options. The consequence of ignoring
Error:this warning is that reflective operations on this class will incorrectly
Error:indicate that it is *not* an inner class.
Error:warning: Ignoring InnerClasses attribute for an anonymous inner class
Error:(com.squareup.haha.guava.collect.Iterables$2) that doesn't come with an
Error:associated EnclosingMethod attribute. This class was probably produced by a
Error:compiler that did not target the modern .class file format. The recommended
Error:solution is to recompile the class from source, using an up-to-date compiler
Error:and without specifying any "-target" type options. The consequence of ignoring
Error:this warning is that reflective operations on this class will incorrectly
Error:indicate that it is *not* an inner class.

Can haha get native heap size of a bitmap instance?

The retained size of an instance is different from the one showed in Android studio profiler, as native heap size is missing. Is it possible to achieve it from the android hprof file?

Incorrect retain size and native size

After dump hprof file:
snapshot = Snapshot.createSnapshot(buffer);
snapshot.computeDomintors();
The param values shallowSize, instanceCount are correct; but totalRetainedSize, nativeSize are incorrect compare to hprof(which show in Android Studio).