commit	30e2082cdffec35832ea1c3e4da2c2139343caf1	[log] [tgz]
author	Pierre-Yves Ricau <py@squareup.com>	Tue May 12 14:48:43 2015
committer	Pierre-Yves Ricau <py@squareup.com>	Tue May 12 14:48:43 2015
tree	ac12769dee3dd95dd96a1c90c78da9faff0afcfb
parent	dd768a9f7e0a86d4d06c65386ce0cad8abcb0296 [diff]

tree: ac12769dee3dd95dd96a1c90c78da9faff0afcfb

README.md

Headless Android Heap Analyzer

“Ha Ha!” - Nelson

Introduction

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

This project is the result of a series of forks, and we have done very little work apart from making it available as a Maven dependency. Here's the fork history:

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 is 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.

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. The closest thing to documentation would probably be the Eclipse Memory Analyzer API, or simply reading the sources.

SnapshotFactory factory = new SnapshotFactory();
Map<String, String> args = Collections.emptyMap();
VoidProgressListener listener = new VoidProgressListener();
ISnapshot snapshot = factory.openSnapshot(heapDumpFile, args, listener);

// The rest is up to you.
Collection<IClass> refClasses = snapshot.getClassesByName("com.example.SomeClass", false);

Gradle config

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

Contributing

We aren't accepting external contributions at this time.