# tailor

**Repository Path**: ByteDance/tailor

## Basic Information

- **Project Name**: tailor
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2022-08-26
- **Last Updated**: 2026-11-06

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Tailor

[简体中文版说明 >>>](/README_cn.md)

[![GitHub license](https://img.shields.io/badge/license-Apache--2.0-brightgreen.svg)](https://github.com/bytedance/tailor/blob/master/LICENSE)
[![Platform](https://img.shields.io/badge/Platform-Android-brightgreen.svg)](https://developer.android.com)
[![API](https://img.shields.io/badge/api-14%2B-green)](https://developer.android.com/about/dashboards)

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
<img src="docs/xigua.png" width="100"/><img src="docs/douyin.png" width="100"/><img src="docs/huoshan.png" width="100"/><img src="docs/kaiyan.png" width="100"/>

## Get started
Step 1: Add the JitPack repository to your build file
```gradle
allprojects {
    repositories {
        maven { url 'https://jitpack.io' }
    }
}
```

Step 2: Add the dependency
```gradle
dependencies {
    implementation 'com.github.bytedance:tailor:1.1.6'
}
```

Step 3: Add code for simple usage
```Java
if (e instanceof java.lang.OutOfMemoryError) {
    String path = Environment.getExternalStorageDirectory().getAbsolutePath() + File.separator + "mini.hprof";
    try {
        Tailor.dumpHprofData(path, true);
    } catch (IOException ex) {
        ex.printStackTrace();
    }
}
```

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

Step 4: Upload data
```shell
## !!! App needs to implement upload logic by itself
```

Step 5: Process data (Python version >= 3.5)
```shell
## Data recovery
python3 library/src/main/python/decode.py -i mini.hprof -o target.hprof
```

```shell
## Hprof verify
python3 library/src/main/python/verify.py -i source.hprof
```

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

## Extra
1. [Android Camera内存问题剖析](https://mp.weixin.qq.com/s/-oaN-bOqHDjN30UP1FMpgA)
2. [西瓜视频稳定性治理体系建设一：Tailor 原理及实践](https://mp.weixin.qq.com/s/DWOQ9MSTkKSCBFQjPswPIQ)
3. [西瓜视频稳定性治理体系建设二：Raphael 原理及实践](https://mp.weixin.qq.com/s/RF3m9_v5bYTYbwY-d1RloQ)

## Support
1. Communicate on [GitHub issues](https://github.com/bytedance/tailor/issues)
2. Mail: <a href="mailto:shentianzhou.stz@gmail.com">shentianzhou.stz@gmail.com</a>
3. WeChat: 429013449
4. QQ Group
<p align="left"><img src="docs/qqgroup.jpg" alt="QQ Group" width="320px"></p>

## 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.
~~~