Tailor

简体中文版说明 >>>

Tailor is a general-purpose hprof cropping and compression tool developed by Xigua video android team. Through it, a mini hprof file can be dump directly during exception handling. There is no sensitive information in the file。More importantly, the file is small but the data is relatively complete, which is very suitable for offline analysis of oom and other exceptions

Apps using Tailor


Xigua Video	Douyin	Huoshan	Kaiyan

Get started

Add to your build.gradle:

implementation 'com.bytedance.tailor:library:1.0.1'

For simple usage:

// Using Tailor to get a mini hprof file in the exception callback
Thread.setDefaultUncaughtExceptionHandler(new Thread.UncaughtExceptionHandler() {
    @Override
    public void uncaughtException(Thread t, Throwable e) {
        String path = Environment.getExternalStorageDirectory().getAbsolutePath() + File.separator + "mini.hprof";
        try {
            Tailor.dumpHprofData(path, true);
        } catch (IOException ex) {
            ex.printStackTrace();
        }
    }
})

// Crop and compress the existing hprof files directly
Tailor.cropHprofData(source, target, true);

Data recovery:

python library/src/main/python/decode.py -i mini.hprof -o target.hprof

Extra

In order to facilitate everyone to understand the file format of the hprof and the details of cropping and compression, we provide three script implementations

// Hprof verify
python library/src/main/python/verify.py -i source.hprof

// Crop and compress
python library/src/main/python/encode.py -i source.hprof -o mini.hprof

// Data recovery
python library/src/main/python/decode.py -i mini.hprof -o target.hprof

Support

Communicate on GitHub issues
Mail: shentianzhou.stz@gmail.com
WeChat: 429013449

License

Copyright (c) 2020 ByteDance 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.

lyric315 / tailor