Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/Tencent/OOMDetector
OOMDetector is a memory monitoring component for iOS which provides you with OOM monitoring, memory allocation monitoring, memory leak detection and other functions.
https://github.com/Tencent/OOMDetector
ios leak oom
Last synced: about 1 month ago
JSON representation
OOMDetector is a memory monitoring component for iOS which provides you with OOM monitoring, memory allocation monitoring, memory leak detection and other functions.
- Host: GitHub
- URL: https://github.com/Tencent/OOMDetector
- Owner: Tencent
- License: other
- Created: 2017-12-22T02:37:52.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2023-02-21T02:31:59.000Z (over 1 year ago)
- Last Synced: 2024-07-31T12:14:52.540Z (about 2 months ago)
- Topics: ios, leak, oom
- Language: Objective-C++
- Homepage:
- Size: 7.55 MB
- Stars: 2,312
- Watchers: 65
- Forks: 354
- Open Issues: 37
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-made-by-chinese - OOMDetector
README
## 简介
OOMDetector是一个iOS内存监控组件，应用此组件可以帮助你轻松实现OOM监控、大内存分配监控、内存泄漏检测等功能。
## 特性
- 1.OOM监控：监控OOM，Dump引起爆内存的堆栈
- 2.大内存分配监控：监控单次大块内存分配，提供分配堆栈信息
- 3.内存泄漏检测：可检测OC对象、Malloc堆内存泄漏，提供泄漏堆栈信息
## 演示
## 支持CocoaPods
在Podfile中添加如下文本
```
pod 'OOMDetector', '1.3'
```
然后在命令行中运行
```
pod install
```
需要注意的是OOMDetector使用了fishhook （0.2）
如果你的工程中也使用了fishhook，建议移除，并统一使用CocoaPods管理
```
pod 'fishhook', '0.2'
```
## 堆栈翻译
```
translate_oom.py dsym_file oom_file
```
dsym_file app的符号表路径，如OOMDetector.app.dSYM
oom_file Library/OOMDetector路径下的爆内存日志，如normal_malloc20180125_211259558.log
## 使用方法
### 初始化
// 初始化，6s以下机型内存触顶阈值默认设置为300M，6s及以上机型内存触顶阈值默认设置为800M。
\- (void)setupWithDefaultConfig;
### OOM监控
// 开启OOM监控，默认在setupWithDefaultConfig方法中已经开启
\-(void)startMaxMemoryStatistic:(double)overFlowLimit;
### 大内存分配监控
// 开启单次大内存分配监控
\-(BOOL)startSingleChunkMallocDetector:(size_t)threshholdInBytes callback:(ChunkMallocBlock)callback;
### 内存泄漏检测
// 初始化内存泄漏监控器，记录所有堆对象
\- (void)setupLeakChecker;
// 执行一次泄露检测，建议在主线程调用，该操作会挂起所有子线程进行泄露检测（该操作较耗时，平均耗时在1s以上，请限制调用频率）
\-(void)executeLeakCheck:(QQLeakCheckCallback)callback;
### 其它功能
// 开启堆内存堆栈监控，开启后会实时记录所有的内存分配堆栈，并将多次重复调用的相同堆栈合并，如果合并后的size大于threshHoldInbytes，该分配堆栈将被输出到log用于分析，log路径Library/OOMDetector
\-(BOOL)startMallocStackMonitor:(size_t)threshholdInBytes needAutoDumpWhenOverflow:(BOOL)needAutoDump dumpLimit:(double)dumpLimit sampleInterval:(NSTimeInterval)sampleInterval;
// 开启VMStackMonitor用以监控非直接通过malloc方式分配的内存因为startVMStackMonitor:方法用到了私有API __syscall_logger会带来app store审核不通过的风险，此方法默认只在DEBUG模式下生效，如果需要在RELEASE模式下也可用，请打开USE_VM_LOGGER_FORCEDLY宏，但是切记在提交appstore前将此宏关闭，否则可能会审核不通过
\-(BOOL)startVMStackMonitor:(size_t)threshHoldInbytes;
### 设置代理
@protocol QQOOMPerformanceDataDelegate
// 在调用startMaxMemoryStatistic:开启内存触顶监控后会触发此回调，返回前一次app运行时单次生命周期内的最大物理内存数据
\-(void)performanceData:(NSDictionary *)data completionHandler:(void (^)(BOOL))completionHandler;
@end
@protocol QQOOMFileDataDelegate
// 在出现单次大块内存分配、检查到内存泄漏且时、调用uploadAllStack方法时触发此回调
\-(void)fileData:(NSData *)data extra:(NSDictionary *)extra type:(QQStackReportType)type completionHandler:(void (^)(BOOL))completionHandler;
@end
## PS
如果你遇到类似"Undefined symbols for architecture arm64:
"std::__1::__next_prime(unsigned long)""的链接问题, 你可以做如下设置:
Build Settings -> Linking -> Other Linker Flags -> -lc++
## 变更记录
暂无
## 帮助
暂无
## 许可证
OOMDetector适用MIT协议，详见[LICENSE](/LICENSE)。
****
## Introduction
OOMDetector is a memory monitoring component for iOS which provides you with OOM monitoring, memory allocation monitoring, memory leak detection and other functions.
## Features
- OOM Monitoring : Monitoring OOM then dump stacks which cause OOM problems.
- Large Memory Allocation Monitoring : Monitoring large memory allocation then provides memory allocation stacks for you.
- Memory Leak Detecting : Detecting memory leak for both OC objects and c heap memory then provides memory allocation stacks for you.
## Demo
## Usage
### Initialization
// 初始化，6s以下机型内存触顶阈值默认设置为300M，6s及以上机型内存触顶阈值默认设置为800M。
\- (void)setupWithDefaultConfig;
### OOM Monitoring
// 开启OOM监控，默认在setupWithDefaultConfig方法中已经开启
\-(void)startMaxMemoryStatistic:(double)overFlowLimit;
### Large Memory Allocation Monitoring
// 开启单次大内存分配监控
\-(BOOL)startSingleChunkMallocDetector:(size_t)threshholdInBytes callback:(ChunkMallocBlock)callback;
### Memory Leak Detecting
// 初始化内存泄漏监控器，记录所有堆对象
\- (void)setupLeakChecker;
// 执行一次泄露检测，建议在主线程调用，该操作会挂起所有子线程进行泄露检测（该操作较耗时，平均耗时在1s以上，请限制调用频率）
\-(void)executeLeakCheck:(QQLeakCheckCallback)callback;
### Other Functions
// 开启堆内存堆栈监控，开启后会实时记录所有的内存分配堆栈，并将多次重复调用的相同堆栈合并，如果合并后的size大于threshHoldInbytes，该分配堆栈将被输出到log用于分析，log路径Library/OOMDetector
\-(BOOL)startMallocStackMonitor:(size_t)threshholdInBytes needAutoDumpWhenOverflow:(BOOL)needAutoDump dumpLimit:(double)dumpLimit sampleInterval:(NSTimeInterval)sampleInterval;
// 开启VMStackMonitor用以监控非直接通过malloc方式分配的内存因为startVMStackMonitor:方法用到了私有API __syscall_logger会带来app store审核不通过的风险，此方法默认只在DEBUG模式下生效，如果需要在RELEASE模式下也可用，请打开USE_VM_LOGGER_FORCEDLY宏，但是切记在提交appstore前将此宏关闭，否则可能会审核不通过
\-(BOOL)startVMStackMonitor:(size_t)threshHoldInbytes;
### Delegate
@protocol QQOOMPerformanceDataDelegate
// 在调用startMaxMemoryStatistic:开启内存触顶监控后会触发此回调，返回前一次app运行时单次生命周期内的最大物理内存数据
\-(void)performanceData:(NSDictionary *)data completionHandler:(void (^)(BOOL))completionHandler;
@end
@protocol QQOOMFileDataDelegate
// 在出现单次大块内存分配、检查到内存泄漏且时、调用uploadAllStack方法时触发此回调
\-(void)fileData:(NSData *)data extra:(NSDictionary *)extra type:(QQStackReportType)type completionHandler:(void (^)(BOOL))completionHandler;
@end
## PS
If you come across link errors like "Undefined symbols for architecture arm64:
"std::__1::__next_prime(unsigned long)"", do as follows:
Build Settings -> Linking -> Other Linker Flags -> -lc++
## Known Issues
### Conflict with fishhook
现在已知Podfile中有FBRetainCycleDetector时会有编译错误，原因是FBRetainCycleDetector中包含了fishhook，目前遇到这种情况，请先移除FBRetainCycleDetector，然后再pod install试试
## Changes Log
## Help
## License
OOMDetector is under the MIT license. See the [LICENSE](/LICENSE) file for details.