facebook/chisel
Chisel
Chisel is a collection of LLDB debugging extensions and tools for inspecting and manipulating the user interface of iOS applications. It provides utilities for tracing responder chains, traversing view hierarchies, and modifying UI elements during runtime.
The toolset distinguishes itself through specialized visual debugging capabilities, including a suite for toggling view visibility and borders to isolate layout issues, as well as a system to export colors and images from a running app to a desktop previewer for asset verification.
The project covers a broad range of UI diagnostic capabilities, including structural hierarchy inspection, coordinate space conversion, and event propagation analysis. It also includes execution control features through symbolic breakpoints and watchpoints, and allows for the automation of inspection tasks via custom debugger commands and Python scripts.
Features
- UI Debugging Extensions - Provides a collection of LLDB tools for inspecting view hierarchies and layouts in iOS applications.
- View Hierarchy Debuggers - Prints recursive descriptions of views and view controllers to analyze the layout of the key window.
- Visual Asset Previewers - Exports colors and images from a running app to a desktop previewer for real-time visual asset verification.
- Custom Debugging Commands - Integrates custom debugging logic directly into the LLDB console using debugger base command classes.
- Event Propagation Analyzers - Traces responder chains and event propagation in iOS apps to debug unhandled inputs.
- Responder Chain Analyzers - Provides a specialized debugger utility to trace the sequence of objects capable of responding to events in an iOS app.
- Visual Layout Overlays - Applies colored overlay masks to specific layers to visually isolate their position and size.
- Runtime Memory Explorers - Reads and modifies live application state by accessing memory addresses of views and responders during execution.
- Hierarchy Traversers - Walks through nested object trees using breadth-first or depth-first searches to locate specific UI components.
- View Hierarchy Inspectors - Traverses and prints recursive descriptions of view controllers and view hierarchies within LLDB.
- Boundary Manipulation Tools - Allows toggling visibility, masks, and borders of views and layers to identify exact positions and boundaries.
- Debugger Automation Scripts - Uses embedded Python scripts to automate repetitive inspection of runtime memory and object properties.
- Runtime Asset Verifiers - Exports colors and images from a running iOS app to a desktop preview for real-time visual inspection.
- Layout Debugging Utilities - Manipulates view visibility and borders in real-time to isolate positioning and sizing issues.
- Runtime View Manipulators - Toggles visibility, adds borders, and modifies layers to isolate specific UI elements during runtime.
- Visual Asset Previewers - Exports colors and images from a running process to a desktop application for real-time asset verification.
- Workflow Automation - Creates custom debugger commands and scripts to automate repetitive inspection tasks during development.
- Visual Debugging Tools - Exports images and colors to a desktop previewer to verify the correctness of visual assets.
- Component Hierarchy Viewers - Includes a search utility to locate specific view and view controller elements within the UI structural tree.
- Testing & Debugging - LLDB command extensions for debugging.
- Code Quality and Debugging - Collection of LLDB commands for iOS debugging.
- Debugging Tools - LLDB commands for assisting iOS debugging.
- LLDB Debugging - Collection of LLDB commands for iOS app debugging.
