FLEX 开源项目使用教程

FLEX 开源项目使用教程

FLEX An in-app debugging and exploration tool for iOS 项目地址: https://gitcode.com/gh_mirrors/fle/FLEX

1. 项目介绍

FLEX（Flipboard Explorer）是一个用于 iOS 开发的内部调试和探索工具。它提供了一个工具栏，可以在应用程序运行时查看和修改几乎所有的状态。FLEX 的主要功能包括：

• 检查和修改视图层次结构
• 查看和修改对象的属性和实例变量
• 动态调用实例和类方法
• 查看详细的网络请求历史记录
• 访问系统日志消息
• 通过堆扫描访问任何实时对象
• 浏览应用程序沙盒中的文件系统
• 浏览 SQLite/Realm 数据库
• 在模拟器中触发 3D Touch
• 探索应用程序和链接系统框架中的所有类
• 动态查看和修改 NSUserDefaults 值

FLEX 运行在应用程序内部，因此不需要连接到 LLDB/Xcode 或其他远程调试服务器。它适用于模拟器和物理设备。

2. 项目快速启动

安装 FLEX

使用 CocoaPods 安装

在 Podfile 中添加以下内容：

pod 'FLEX', :configurations => ['Debug']

然后运行 pod install。

使用 Carthage 安装

在 Cartfile 中添加以下内容：

github "flipboard/FLEX"

然后运行 carthage update。

手动安装

将 Classes/ 目录中的文件手动添加到 Xcode 项目中，或者直接拖动整个 FLEX/ 文件夹。确保在发布版本中排除 FLEX。

启动 FLEX

在 iOS 模拟器中，可以使用键盘快捷键激活 FLEX。按下 f 键可以切换 FLEX 工具栏。按下 \ 键可以查看所有快捷键。

你也可以通过代码启动 FLEX：

#if DEBUG
#import "FLEXManager.h"
#endif

- (void)handleSixFingerQuadrupleTap:(UITapGestureRecognizer *)tapRecognizer {
    #if DEBUG
    if (tapRecognizer.state == UIGestureRecognizerStateRecognized) {
        // 这也可以放在键盘快捷键、调试菜单项等处理程序中
        [[FLEXManager sharedManager] showExplorer];
    }
    #endif
}

3. 应用案例和最佳实践

修改视图

选择一个视图后，可以点击工具栏下方的信息栏以查看更多视图的详细信息。在这里，你可以修改属性和调用方法。

网络历史记录

启用网络调试后，可以查看使用 NSURLConnection 或 NSURLSession 进行的所有请求。设置允许你调整缓存的响应体类型和最大缓存大小。你可以选择在应用程序启动时自动启用网络调试。

堆中的所有对象

FLEX 查询 malloc 以获取所有实时分配的内存块，并搜索看起来像对象的块。你可以从这里查看所有内容。

文件浏览器

浏览应用程序包或沙盒容器中的文件系统。FLEX 显示文件大小、图像预览，并漂亮地打印 JSON 和 plist 文件。你可以重命名和删除文件和文件夹，也可以“共享”任何文件以在应用程序外部检查它们。

SQLite 浏览器

SQLite 数据库文件（具有 .db 或 .sqlite 扩展名）或 Realm 数据库文件可以使用 FLEX 进行浏览。数据库浏览器允许你查看所有表，并且可以通过点击列标题对单个表进行排序。

4. 典型生态项目

FLEX 是一个独立的调试工具，但它可以与其他 iOS 开发工具和库结合使用，以增强调试和开发体验。以下是一些典型的生态项目：

• CocoaPods: 用于管理 iOS 项目的依赖关系。
• Carthage: 另一个依赖管理工具，支持更灵活的集成方式。
• LLDB: Xcode 的调试器，可以与 FLEX 结合使用以进行更深入的调试。
• Reveal: 一个用于实时查看和调试 iOS 应用程序 UI 的工具。

通过结合这些工具，开发者可以更高效地进行 iOS 应用程序的调试和优化。

FLEX An in-app debugging and exploration tool for iOS 项目地址: https://gitcode.com/gh_mirrors/fle/FLEX