Load the Reveal Server via an Xcode Breakpoint
The method described below only works for apps running in the iOS or tvOS Simulator.
Loading the Reveal Server framework via an Xcode Debugger Breakpoint is a great way to let you introspect any project you happen to be working on without needing to change anything in the project's files. It also means you don't need to worry about accidentally shipping a release build of your app linked with the Reveal library.
- Open your iOS or tvOS project in Xcode, and select View → Navigators → Show Breakpoint Navigator.
In the bottom left of the pane, click the + button and select Add Symbolic Breakpoint.
Enter
UIApplicationMaininto the Symbol field.- Click the Add Action button, and ensure that Action is set to Debugger Command.
Copy and paste the following text into the field below:
For iOS targets:
expr (Class)NSClassFromString(@"IBARevealLoader") == nil ? (void *)dlopen("/Applications/Reveal.app/Contents/SharedSupport/iOS-Libraries/RevealServer.framework/RevealServer", 0x2) : ((void*)0)For tvOS targets:
expr (Class)NSClassFromString(@"IBARevealLoader") == nil ? (void *)dlopen("/Applications/Reveal.app/Contents/SharedSupport/tvOS-Libraries/RevealServer.framework/RevealServer", 0x2) : ((void*)0)Note: If necessary, update the path to Reveal.app above to the correct location for your Mac.
Check Automatically continue after evaluating actions.
Right click the newly created breakpoint and select Move Breakpoint To → User.
You can enable and disable the breakpoint as you would any other. User breakpoints are available across all Xcode projects.
In Xcode, build and run your application under the iOS or tvOS Simulator.
If everything worked, you should be able to switch to Reveal and see your iOS or tvOS application listed in Reveal. Select your app and verify that you can see a snapshot of the app matching what you see in the simulator.
Getting Help
If you have any problems or questions about integrating Reveal into your app, head over to our support site.