Skip to content

iOS Hierarchy Viewer allows developers to debug their user interfaces. If there are problems with layout calculations, it will catch them by giving a real time preview of the UIViews hierarchy.

License

Notifications You must be signed in to change notification settings

Dayananda87/iOS-Hierarchy-Viewer

 
 

Repository files navigation

iOS-Hierarchy-Viewer

iOS Hierarchy Viewer allows developers to debug their user interfaces. If there are problems with layout calculations, it will catch them by giving a real time preview of the UIViews hierarchy.

Features

  • the client is implemented in HTML/JS/CSS. Additional software is not required
  • preview of device/simulator screen. Can be scaled and/or rotated on demand
  • debug frames shows the exact UIViews frames
  • property list shows obj-c properties and their values for selected UIView

Installation

  • download newest version of library avaiable here: Lib
  • add these files to your project (drag&drop into xCode project)
  • make sure that you have added “-ObjC -all_load” to “other linker flags” (click at project root element, select “Build settings” tab, search for “other linker flags”)
  • if you already have JSONKit.m file in your project, please remove it because of linker conflict
  • launch hierarchy viewer in your code by calling [iOSHierarchyViewer start];. The best place for it is AppDelegate::applicationDidBecomeActive callback
  • find or get from logs device/simulator ip address and go to ‘http://[ip_address]:9449′ address (Chrome/Firefox only)
- (void)applicationDidBecomeActive:(UIApplication *)application
{
    // your stuff
    [iOSHierarchyViewer start];    
}

You can always look at sample project, there is only 1 line of code needed for iOSHierarchyViewer to work with your project. We really like PrettyKit ( https://github.com/vicpenap/PrettyKit ), so we just enabled our hierarchy viewer in their sample project. If you don't know what PrettyKit is you need to check it out!

Changelog:

Version 1.3:

  • fixed crashes at UITextView:
  • some properties can be read only from UI thread
  • some properties ( like 'autocapitalizationType' ) are not KVC compliant.

Version 1.4:

  • Accesibility labels are used when set, making it easier to read hierarchy
  • All scaning now takes place on main thread.

Roadmap:

Version 1.5:

  • Coloring non-opaque and misaligned view's similar to CoreAnimation instruments
  • Selected views from HTML side highlight in tree navigator

Version 1.6:

  • Support for cocos2d nodes visualisation and debugging

Contributing:

Did you find a bug ? Do you have feature request ? Do you want to merge a feature ? Send us a pull request or add an issue in the tracker!

About

iOS Hierarchy Viewer allows developers to debug their user interfaces. If there are problems with layout calculations, it will catch them by giving a real time preview of the UIViews hierarchy.

Resources

License

Stars

Watchers

Forks

Packages

No packages published