How does LayoutInspector compare to Xcode's built-in view debugger?

LayoutInspector offers on-device, in-app inspection with 3D visualization and flexible triggers, unlike Xcode's debugger which requires a simulator or connected device. It's more convenient for quick checks but lacks deep integration with Xcode's interface and tools.

How to trigger LayoutInspector on device shake?

Call `LayoutInspector.shared.setAutoTrigger(.shake)` in your app delegate's `didFinishLaunchingWithOptions` method. This enables automatic inspection whenever the device is shaken, as shown in the usage examples.

Does LayoutInspector work with SwiftUI?

No, LayoutInspector is designed for UIKit-based apps and does not support SwiftUI. For SwiftUI projects, you'll need alternative debugging tools or consider that this library might not be compatible.

Can I use LayoutInspector without CocoaPods?

Currently, the README only mentions installation via CocoaPods, so there's no official support for other dependency managers like Swift Package Manager. You might need to manually integrate the source code if avoiding CocoaPods.

How to inspect specific view attributes like fonts and colors?

When LayoutInspector is active, it displays detailed attributes for each visible view, including frames, fonts, and colors, as highlighted in the changelog for version 1.2.1. Trigger it manually or via auto-triggers to see this overlay.

Is LayoutInspector safe for production builds?

Yes, because it only activates in DEBUG builds, as configured in your code. Ensure you don't enable it in release configurations, and it won't affect App Store submissions or production performance.

Open-Awesome

LayoutInspector

MITSwift1.2.0

A tool to debug iOS app layouts directly on devices by inspecting layers in 3D and viewing attributes.

GitHub

515 stars23 forks0 contributors

What is LayoutInspector?

LayoutInspector is an iOS debugging tool that enables developers to inspect and debug UI layouts directly on devices. It provides 3D visualization of view layers and detailed attribute inspection for each visible element, helping identify layout issues during app development. The tool activates only in DEBUG builds to avoid impacting production releases.

Target Audience

iOS developers working with UIKit who need to debug complex view hierarchies, layout constraints, or visual inconsistencies in their apps, particularly those developing for iOS 11.0 and above.

Value Proposition

Developers choose LayoutInspector because it brings powerful layout inspection capabilities directly into the app environment, eliminating the need for external debugging tools. Its conditional activation (DEBUG-only) and multiple trigger options (manual, screenshot, shake) provide flexible, non-intrusive debugging.

Overview

Tool to debug layouts directly on iOS devices: inspect layers in 3D and debug each visible view attributes

Use Cases

Best For

Debugging complex view hierarchies in iOS apps
Identifying layout constraint conflicts on actual devices
Inspecting UI element attributes (frames, fonts, colors) in real-time
Visualizing layer overlaps and z-position issues in 3D
Debugging UI issues that only appear on physical devices
Swift and Objective-C projects needing integrated layout inspection

Not Ideal For

Projects exclusively using SwiftUI for UI development
Teams needing real-time, continuous layout monitoring without manual triggers
Apps targeting iOS versions below 11.0
Environments where CocoaPods dependency management is not preferred

Pros & Cons

Pros

On-Device Inspection

Allows debugging directly on physical devices or simulators, reducing reliance on external tools like Xcode's debugger for device-specific layout issues.

3D Layer Visualization

Provides a 3D perspective of UI hierarchies, making it easier to visualize overlaps and layer orders, which is less intuitive in standard 2D debuggers.

Conditional DEBUG Activation

Restricts functionality to DEBUG builds only, ensuring no impact on release versions and maintaining app performance in production, as emphasized in the README.

Flexible Trigger Options

Supports manual activation, screenshot triggers, and device shake gestures, offering multiple ways to invoke inspection based on developer workflow.

Cons

No SwiftUI Support

Designed primarily for UIKit, so it does not integrate with SwiftUI's declarative framework, limiting its relevance for modern iOS projects adopting SwiftUI.

iOS Version Limitation

Requires iOS 11.0 or higher, excluding support for older iOS versions that legacy apps might still need to target, as stated in the requirements.

Dependency on CocoaPods

Installation is only through CocoaPods, with no mention of alternative methods like Swift Package Manager, which could be a barrier for some projects.

Frequently Asked Questions

Related Projects

DoraemonKit

一款面向泛前端产品研发全生命周期的效率平台。

Stars20,420

Forks3,183

Last commit14 days ago

Flex

An in-app debugging and exploration tool for iOS

Stars14,640

Forks1,793

Last commit3 months ago

chisel

Chisel is a collection of LLDB commands to assist debugging iOS apps.

Stars9,177

Forks788

Last commit6 months ago

PonyDebugger

Remote network and data debugging for your native iOS app using Chrome Developer Tools

Stars5,848

Forks585

Last commit3 years ago

Community-curated · Updated weekly · 100% open source

Found a gem we're missing?

Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.

Submit a project Star on GitHub