Popularity
5.0
Growing
Activity
5.7
-
421
11
18

Description

This tool allows to debug your app views directly on the iOS device like we do in view debugger in Xcode. LayoutInspector API allows to trigger view debugging automatically on taking screenshot or whenever you want by calling it manually. To run the example project, clone the repo, and run pod install from the Example directory first.

Programming language: Swift
License: MIT
Tags: Swift     iOS     Xcode     Debugging     Ios Development    
Latest version: v1.1.0

LayoutInspector alternatives and similar libraries

Based on the "Debugging" category

Do you think we are missing an alternative of LayoutInspector or a related project?

Add another 'Debugging' Library

README

Introduction

CI Status Version License Platform

Features

  • [x] Inspect layouts directly on iOS devices
  • [x] Inspection could be triggered only if app is running under DEBUG build configuration, so it won't affect any other kind of the app builds (i.e. RELEASE)
  • [x] Objective-C compatible
  • [x] Works on all devices with iOS 11.0+

Example

To run the example project, clone the repo, and run pod install from the Example directory first.

Requirements

  • iOS 11.0 and higher
  • Xcode 10.3 and higher
  • Swift 5.0 and higher

Installation

LayoutInspector is available through CocoaPods. To install it, simply add the following line to your Podfile:

pod 'LayoutInspector'

Usage

Layout inspection could be trigger:

  • manually whenever you want (on some actions, events, notifications etc)

    LayoutInspector.shared.showLayout()
    
  • automatically when taking app screenshot

    LayoutInspector.shared.setAutoTrigger(.screenshot)
    
  • automatically on device shaking

    LayoutInspector.shared.setAutoTrigger(.shake)
    

Swift

import LayoutInspector

@UIApplicationMain
class AppDelegate: UIResponder, UIApplicationDelegate {

    func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
        LayoutInspector.shared.setAutoTrigger(.screenshot)
        return true
    }
}

Objective-C

@import LayoutInspector;

@implementation AppDelegate

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
    [LayoutInspector.shared setAutoTrigger:AutoTriggerScreenshot];
    return YES;
}

@end

Changelog

Version Description
1.1.0 Release: Swift version upgraded to 5.0
1.0.0 Release: test coverage added
0.2.0 Pre-release: Objective-C compatibility
0.1.1 Pre-release: fixed Lint warnings
0.1.0 Pre-release: initial version

Author

Ihor Savynskyi\ ✉️ wadedunk08@gmail.com\ 🌎 Twitter, LinkedIn

License

LayoutInspector is available under the MIT license. See the LICENSE file for more info.


*Note that all licence references and agreements mentioned in the LayoutInspector README section above are relevant to that project's source code only.