lukaswelte/dcintrospect-arc

The cool DCIntrospect Debug Tool ARC ready

#DCIntrospect-ARC

Twitter: @lukaswelte
Website: http://lukaswelte.de

DCIntrospect was originally done by domesticcat and is small set of tools for iOS that aid in debugging user interfaces built with UIKit. It's especially useful for UI layouts that are dynamically created or can change during runtime, or for tuning performance by finding non-opaque views or views that are re-drawing unnecessarily. It's designed for use in the iPhone simulator, but can also be used on a device.

It uses keyboard shortcuts to handle starting, ending and other commands. It can also be invoked via an app-wide UIGestureRecognizer if it is to be used on the device.

Features:

• Simple to setup and use
• Controlled via app-wide keyboard commands
• Highlighting of view frames
• Displays a views origin & size, including distances to edges of main window
• Move and resize view frames during runtime using shortcut keys
• Logging of properties of a view, including subclass properties, actions and targets (see below for an example)
• Logging of accessibility properties — useful for UI automation scripts
• Manually call setNeedsDisplay, setNeedsLayout and reloadData (for UITableView)
• Highlight all view outlines
• Highlight all views that are non-opaque
• Shows warning for views that are positioned on non-integer origins (will cause blurriness when drawn)
• Print a views hierarchy to console (via private method recursiveDescription) to console

Usage

Before you start make sure the DEBUG environment variable is set. DCIntrospect will not run without that set to prevent it being left in for production use.

Add the DCIntrospect class files to your project, add the QuartzCore framework if needed. To start:

[window makeKeyAndDisplay]

// always call after makeKeyAndDisplay.
#if TARGET_IPHONE_SIMULATOR
    [[DCIntrospect sharedIntrospector] start];
#endif

The #if to target the simulator is not required but is a good idea to further prevent leaving it on in production code.

Once setup, simply push the space bar to invoke the introspect or then start clicking on views to get info. You can also tap and drag around the interface.

A a small demo app is included to test it out.

Selected keyboard shortcuts

• Start/Stop: spacebar
• Help: ?
• Print properties and actions of selected view to console: p
• Print accessibility properties and actions of selected view to console: a
• Toggle all view outlines: o
• Toggle highlighting non-opaque views: O
• Nudge view left, right, up & down: 4 6 8 2 (use the numeric pad) or ← → ↑ ↓
• Print out the selected views' new frame to console after nudge/resize: 0
• Print selected views recursive description to console: v

Logging selected views properties

Pushing p will log out the available properties about the selected view. DCIntrospect will try to make sense of the values it can and show more useful info. An example from a UIButton:

** UIRoundedRectButton : UIButton : UIControl : UIView : UIResponder : NSObject **

** UIView properties **
    tag: 1
    frame: {{21, 331}, {278, 37}} | bounds: {{0, 0}, {278, 37}} | center: {160, 349.5}
    transform: [1, 0, 0, 1, 0, 0]
    autoresizingMask: UIViewAutoresizingFlexibleRightMargin | UIViewAutoresizingFlexibleTopMargin
    autoresizesSubviews: YES
    contentMode: UIViewContentModeScaleToFill | contentStretch: {{0, 0}, {1, 1}} backgroundColor: nil
    alpha: 1.00 | opaque: NO | hidden: NO | clips to bounds: NO |
    clearsContextBeforeDrawing: YES
    userInteractionEnabled: YES | multipleTouchEnabled: NO
    gestureRecognizers: nil

** UIRoundedRectButton properties **

** Targets & Actions **
    target: <DCIntrospectDemoViewController: 0x4c8c0e0> action: buttonTapped:

Customizing Key Bindings

Edit the file DCIntrospectSettings.h to change key bindings. You might want to change the key bindings if you're using a laptop/wireless keyboard for development.

License

Made available under the MIT License.

Collaboration

If you have any feature requests/bugfixes etc. feel free to help out and send a pull request, or create a new issue.

dcintrospect-arc's Issues

It is not working on iPhone 6 Simulator

Please look at the picture for more detail. We are very interested in your library. Please help us!

Space not working when showing an UIAlertView

Space not working when showing an UIAlertView. Do you have the same problem?

Xcode 6 build errors

Doesn't build when trying to target ARM64.

Initial setup help

I'm having a bit of trouble getting this setup.

I downloaded the zip from Git and added the files to my project. In my AppDelegate, I imported "DCIntrospect.h", then set the introspector to start:

 [_window makeKeyAndVisible];
 [[DCIntrospect sharedIntrospector] start];

The app launches in the Simulator, but pressing Spacebar does nothing.
Thanks for any help!

cannot work on xcode 6.1

when press space bar, cannot work

ARM64: unknown register name 'eax' in asm

When building DCIntrospect under ARM64:

DCIntrospect.m:621:4: error: unknown register name 'eax' in asm
                        DEBUGGER;
                        ^
DCIntrospect-ARC/DCIntrospect.m:56:225: note: expanded from macro 'DEBUGGER'
#define DEBUGGER do { int trapSignal = AmIBeingDebugged () ? SIGINT : SIGSTOP; __asm__ __volatile__ ("pushl %0\npushl %1\npush $0\nmovl %2, %%eax\nint $0x80\nadd $12, %%esp" : : "g" (trapSignal), "g" (getpid ()), "n" (37) : "eax", "cc"); } while (false);
                                                                                                                                                                                                                                ^
1 error generated.

Not sure how to fix it or what this code actually does.

Keyboard input dead after closing help

When closing the help screen using the "Close" link DCIntrospect does not react to keyboard input anymore and thus can't be dismissed.

Claim Pod for the new CocoaPod Trunk Webservice

CocoaPods is launching a new web service ('Trunk') for storing Podspecs. Podspecs can be 'claimed' within the next few days. Please read more here:

http://blog.cocoapods.org/CocoaPods-Trunk/#trunk
http://blog.cocoapods.org/Claim-Your-Pods/

Hide Introspect Help View when pressing space before disabling Introspect

The Help View should be dismissed before DCIntrospect-ARC terminates. Otherwise the Help screen will stay on top and you have to restart the program.

Updated release and CocoaPod?

The latest CocoaPod release has deprecation warnings for sizeWithFont:, etc... When will there be a new release?

DC not working in modally presented view

It seems that if you present a view modally, nothing happens when you press space (iOS 7).

Stack overflow calling method UITextInputTraits_valueForKey

I am using a project called HTAutocompleteTextField to autofill the user email domain name. When i go to any form which uses this control DCIntrospect goes into an infinite by calling this method UITextInputTraits_valueForKey. This issue is reproducible 100% of the time.

Infinite loop in setInvokeGestureRecognizer:

• (void)setInvokeGestureRecognizer:(UIGestureRecognizer *)newGestureRecognizer
  {
  UIWindow *mainWindow = [self mainWindow];
  [mainWindow removeGestureRecognizer:self.invokeGestureRecognizer];

  self.invokeGestureRecognizer = nil;

"X" key doesn't work

see domesticcatsoftware/DCIntrospect#60 (comment)

Add the ability to tag and display tags of views.

To make it easier to read debug logs, add this category and make it so that when you tap on a view, it displays the tag name along with the class name. Also, the debug output should display these tags.

e.g.

[myview setNametag:@"My main view"]

when you tap on it, DCIntrospect should display "UIView - My main view {{0,0},{320,568}}" on the top status bar. Without this, you would only see "UIView" which is not helpful when you have many views and subviews!

Category code:

@interface UIView (NameTags)

• (NSString *)nametag;
• (void)setNametag:(NSString *)theNametag;
• (NSString *)objectIdentifier;
  @EnD

@implementation UIView (NameTags)

• (NSString *)nametag {
  return (NSString *)objc_getAssociatedObject(self, @selector(nametag));
  }

// Nametag setter

• (void)setNametag:(NSString *)theNametag {
  objc_setAssociatedObject(self, @selector(nametag), theNametag, OBJC_ASSOCIATION_RETAIN_NONATOMIC);
  }

// Return 'Class description : hex memory address'

• (NSString *)objectIdentifier {
  return [NSString stringWithFormat:@"%@:0x%0x", self.class.description, (int) self];
  }

@EnD