_    __  __ _               _        _____ _           _
    / \  |  \/  | |    ___  __ _| | _____|  ___(_)_ __   __| | ___ _ __
   / _ \ | |\/| | |   / _ \/ _` | |/ / __| |_  | | '_ \ / _` |/ _ \ '__|
  / ___ \| |  | | |__|  __/ (_| |   <\__ \  _| | | | | | (_| |  __/ |
 /_/   \_\_|  |_|_____\___|\__,_|_|\_\___/_|   |_|_| |_|\__,_|\___|_|

介绍

本项目是一款用于自动检测 iOS 项目中【 UIView 和 UIViewController 内存泄漏 】的工具，只需 pod 'AMLeaksFinder' 即可 0 行代码实现自动监控，效果如下，推荐使用 Cocoapods 导入，和 MLeakFinder 的区别可参考 对比 MLeakFinder 。

English 📔

功能介绍

• 自动监控 Controller 的泄漏；
• 自动监控 View 的泄漏；
• 借助 FBRetainCycleDetector 快速排查泄漏原因 【 ⚠️ 只在 ObjC 上有效 】；
• 监控到泄漏时支持快速查看泄漏的视图【 View，Controller View，View 的 root View 等】；
• 更多功能欢迎补充。

Cocoapods

pod 'AMLeaksFinder', '2.2.8',  :configurations => ['Debug']

• 如果想查看控制器的强引用链，可导入：Facebook 的 FBRetainCycleDetector 框架即可。

pod 'FBRetainCycleDetector', :git => 'https://github.com/facebook/FBRetainCycleDetector.git', :branch => 'main', :configurations => ['Debug']

直接使用

• 请拖拽 AMLeaksFinder/AMLeaksFinder 文件夹的全部内容到项目

• 启用 & 关闭 AMLeaksFinder

  • 打开 __AUTO_MEMORY_LEAKS_FINDER_ENABLED__ 宏表示启用
  • 注释 __AUTO_MEMORY_LEAKS_FINDER_ENABLED__ 宏表示关闭

• 显示/隐藏 AMLeaksFinder 视图

  • 发送通知

    if (显示UI) {
       [NSNotificationCenter.defaultCenter postNotificationName:@"AMLeaksFinderShowUINotification" object:nil];
    } else {
       [NSNotificationCenter.defaultCenter postNotificationName:@"AMLeaksFinderHideUINotification" object:nil];
    }

数据收集

若想收集泄漏相关数据可使用如下 API:

• https://github.com/liangdahong/AMLeaksFinder/blob/master/AMLeaksFinder/AMLeaksFinder.h

控制器路径变化 AMLeaksFinder.ViewHasLeakVC viewDidDisappear: 2022-04-04 04:21:06 +0000
控制器路径变化 AMHomeVC viewDidAppear: 2022-04-04 04:21:06 +0000
控制器路径变化 AMPresentHasLeakVC viewDidLoad: 2022-04-04 04:21:07 +0000
控制器路径变化 AMPresentHasLeakVC viewDidAppear: 2022-04-04 04:21:07 +0000
控制器路径变化 AMTabBarController viewDidDisappear: 2022-04-04 04:21:07 +0000
控制器路径变化 BMNavigationController viewDidDisappear: 2022-04-04 04:21:07 +0000
控制器路径变化 AMHomeVC viewDidDisappear: 2022-04-04 04:21:07 +0000
控制器路径变化 AMTabBarController viewDidAppear: 2022-04-04 04:21:08 +0000
控制器路径变化 BMNavigationController viewDidAppear: 2022-04-04 04:21:08 +0000
控制器路径变化 AMHomeVC viewDidAppear: 2022-04-04 04:21:08 +0000
控制器路径变化 AMPresentHasLeakVC viewDidDisappear: 2022-04-04 04:21:08 +0000
⚠️👇🏻
视图泄漏: <UIView: 0x7f9849a214d0; frame = (65 176; 294 348); autoresize = RM+BM; layer = <CALayer: 0x60000090ed00>> 
视图所在控制器 AMLeaksFinder.ViewHasLeakVC 
操作路径:
BMNavigationController(viewDidLoad:) -> 
AMTabBarController(viewDidLoad:) -> 
AMHomeVC(viewDidLoad:) -> 
AMTabBarController(viewDidAppear:) -> 
BMNavigationController(viewDidAppear:) -> 
AMHomeVC(viewDidAppear:) -> 
AMPresentHasLeakVC(viewDidLoad:) -> 
AMPresentHasLeakVC(viewDidAppear:) -> 
AMTabBarController(viewDidDisappear:) -> 
BMNavigationController(viewDidDisappear:) -> 
AMHomeVC(viewDidDisappear:) -> 
AMTabBarController(viewDidAppear:) -> 
BMNavigationController(viewDidAppear:) -> 
AMHomeVC(viewDidAppear:) -> 
AMPresentHasLeakVC(viewDidDisappear:) -> 
AMPresentHasLeakVC(viewDidLoad:) -> 
AMPresentHasLeakVC(viewDidAppear:) -> 
AMTabBarController(viewDidDisappear:) -> 
BMNavigationController(viewDidDisappear:) -> 
AMHomeVC(viewDidDisappear:) -> 
AMTabBarController(viewDidAppear:) -> 
BMNavigationController(viewDidAppear:) -> 
AMHomeVC(viewDidAppear:) -> 
AMPresentHasLeakVC(viewDidDisappear:) -> 
_UIAlertControllerTextFieldViewController(viewDidLoad:) -> 
UIAlertController(viewDidLoad:) -> 
UIAlertController(viewDidAppear:) -> 
UIAlertController(viewDidDisappear:) -> 
AMLeaksFinder.ViewHasLeakVC(viewDidLoad:) -> 
AMHomeVC(viewDidDisappear:) -> 
AMLeaksFinder.ViewHasLeakVC(viewDidAppear:) -> 
AMLeaksFinder.ViewHasLeakVC(viewDidDisappear:) -> 
AMHomeVC(viewDidAppear:) -> 
AMPresentHasLeakVC(viewDidLoad:) -> 
AMPresentHasLeakVC(viewDidAppear:) -> 
AMTabBarController(viewDidDisappear:) -> 
BMNavigationController(viewDidDisappear:) -> 
AMHomeVC(viewDidDisappear:) -> 
AMTabBarController(viewDidAppear:) -> 
BMNavigationController(viewDidAppear:) -> 
AMHomeVC(viewDidAppear:) -> 
AMPresentHasLeakVC(viewDidDisappear:) -> 
⚠️👆🏻

原理分析

• 原理分析

• 数据结构图

• 

• 项目文件结构

├── AMLeaksFinder
│   ├── AMLeaksFinder.h
│   ├── AMLeaksFinder.m
│   ├── AMLeaksFinder.bundle
│   │   ├── all@2x.png
│   │   ├── all@3x.png
│   │   ├── leaks@2x.png
│   │   └── leaks@3x.png
│   ├── Objects
│   │   ├── Controllers
│   │   │   ├── Model
│   │   │   │   ├── AMMemoryLeakDeallocModel.h
│   │   │   │   ├── AMMemoryLeakDeallocModel.m
│   │   │   │   ├── AMMemoryLeakModel.h
│   │   │   │   └── AMMemoryLeakModel.m
│   │   │   ├── NeedDealloc
│   │   │   │   ├── UINavigationController+AMLeaksFinderSwizzleDealloc.m
│   │   │   │   ├── UIPageViewController+AMLeaksFinderSwizzleDealloc.m
│   │   │   │   ├── UISplitViewController+AMLeaksFinderSwizzleDealloc.m
│   │   │   │   ├── UITabBarController+AMLeaksFinderSwizzleDealloc.m
│   │   │   │   ├── UIViewController+AMLeaksFinderSwizzleDealloc.m
│   │   │   │   ├── UIWindow+AMLeaksFinderSwizzleDealloc.m
│   │   │   └── ViewDidLoad
│   │   │       ├── UIViewController+AMLeaksFinderSwizzleViewDidLoad.m
│   │   └── View
│   │       └── Model
│   │           ├── AMViewMemoryLeakDeallocModel.h
│   │           ├── AMViewMemoryLeakDeallocModel.m
│   │           ├── AMViewMemoryLeakModel.h
│   │           └── AMViewMemoryLeakModel.m
│   ├── UI
│   │   ├── AMLeakDataModel.h
│   │   ├── AMLeakDataModel.m
│   │   ├── AMLeakOverviewView.h
│   │   ├── AMLeakOverviewView.m
│   │   ├── AMMemoryLeakView.h
│   │   ├── AMMemoryLeakView.m
│   │   ├── AMMemoryLeakView.xib
│   │   ├── AMSnapedViewViewController.h
│   │   ├── AMSnapedViewViewController.m
│   │   ├── UIViewController+AMLeaksFinderUI.h
│   │   └── UIViewController+AMLeaksFinderUI.m
│   └── Uitis
│       ├── Controller
│       │   ├── UIViewController+AMLeaksFinderTools.h
│       │   └── UIViewController+AMLeaksFinderTools.m
│       └── View
│           ├── UIView+AMLeaksFinderTools.h
│           └── UIView+AMLeaksFinderTools.m

联系

• 欢迎 Issues 和 Pull Requests
• 也可以添加微信 进群吹水。