TouchInspector - a lightweight package that helps you visualize and debug touches on iOS and iPadOS

Last update: Jan 3, 2023

Overview

TouchInspector

TouchInspector is a lightweight package that helps you visualize and debug touches on iOS and iPadOS.

Showing touches is super useful when recording and sharing demos from a device or Simulator.

TouchInspector can optionally also show hit-testing information (i.e. which view a touch is hitting). This is great when trying to identify the type of some view, or debug where a touch is actually going.

Installation

Add TouchInspector to your app's Package.swift file, or selecting File -> Add Packages in Xcode:

.package(url: "https://github.com/jtrivedi/TouchInspector", from: "0.1.0"))

Usage

You'll need to change the type of your application/scene's window to TouchInspectorWindow, which you can do conditionally when developing:

import TouchInspector

func scene(_ scene: UIScene, willConnectTo session: UISceneSession, options connectionOptions: UIScene.ConnectionOptions) {
    guard let windowScene = (scene as? UIWindowScene) else {
        return
    }
    
    #if DEBUG
    window = TouchInspectorWindow(windowScene: windowScene)
    #else
    window = UIWindow(windowScene: windowScene)
    #endif
    
    window?.rootViewController = ViewController()
    window?.makeKeyAndVisible()
}

Touch and hit-testing visualization is enabled by default when creating a TouchInspectorWindow. You can change that with the following properties:

// Show the touch indicator, but not the hit-testing overlay.
window.showTouches = true
window.showHitTesting = false

You might also like...

Set of easy to use debugging tools for iOS developers & QA engineers.

Automaticly display Log,Crash,Network,ANR,Leak,CPU,RAM,FPS,NetFlow,Folder and etc with one line of code based on Swift. Just like God opened his eyes

GodEye Automaticly display Log,Crash,Network,ANR,Leak,CPU,RAM,FPS,NetFlow,Folder and etc with one line of code based on Swift. Just like God opened hi

3.7k Dec 23, 2022

Comments

Small README Clarifications
A couple of small clarifications in README.md:

I wasn't clear what you were referring to with ViewController(), so I made it more explicit

I missed that hit testing is also on by default, so I made that marginally more clear.
opened by cliss 1
Fix Incorrect Name on Example Variable

Somehow I accomplished messing up a two-line PR (#2). 🤦

When I was originally revamping the README, I was using initialViewController as the example variable name, but then changed it to rootViewController... in only one of two places.

This fixes that.

opened by cliss 0