Introduction
What is RocketSim Connect and how does it work?
RocketSim Connect creates a connection between your running application and RocketSim. A dynamic library gets injected at runtime and opens a network connection which allows RocketSim to capture events.
How can I setup RocketSim Connect?
RocketSim Connect works by implementing a small piece of code into your application. The app will guide you and provides a Copy Code
button.
![Notion image](https://www.notion.so/image/https%3A%2F%2Fprod-files-secure.s3.us-west-2.amazonaws.com%2F260ca35b-4083-41d1-bf7b-93bbc395ee7f%2Fa0230dc3-d0f0-42c4-a9e9-3a755013a7fa%2FCleanShot202024-07-0120at2014.42.062x.png?table=block&id=7083802c-6103-444e-84c6-65fa9f96bdec&cache=v2)
Where do I find this onboarding?
![Notion image](https://www.notion.so/image/https%3A%2F%2Fprod-files-secure.s3.us-west-2.amazonaws.com%2F260ca35b-4083-41d1-bf7b-93bbc395ee7f%2F4b960e3f-ba26-421f-bb99-b01602f23d30%2FCleanShot_2024-07-04_at_10.22.322x.png?table=block&id=ad2c3db5-9fe9-43b3-ba96-d3aeb588947c&cache=v2)
You can find the onboarding by following these steps:
- Select the Recent Builds tab
- Select the Networking tab
- Press the Setup RocketSim Connect button
Can I integrate RocketSim Connect using a breakpoint?
Yes, you can!
![Notion image](https://www.notion.so/image/https%3A%2F%2Fprod-files-secure.s3.us-west-2.amazonaws.com%2F260ca35b-4083-41d1-bf7b-93bbc395ee7f%2Fbd360b31-ba37-446a-923b-2c0dbc3e0514%2FIMG_7335.png?table=block&id=3efc0c39-0772-4e86-bf00-a8530894e43d&cache=v2)
- Define a symbolic breakpoint for
UIApplicationMain
- Add a debugger command action using
expr (void *)dlopen("/Applications/RocketSim.app/Contents/Frameworks/RocketSimConnectLinker.nocache.framework/RocketSimConnectLinker", 0x2)
Note: make sure to point to RocketSim’s .app path correctly.
- Enable “Automatically continue after evalutating actions”
- Move the breakpoint to “User” using the right-click menu to make it apply on all your Xcode projects
Does this work with React Native?
Not officially supported, but from the community, we’ve been told it’s working by using this gist.
Will RocketSim’s code end up in my release builds?
Absolutely not. RocketSim’s setup code ensures it’s only running in debug builds using the #if DEBUG
checks.
What kind of code are you injecting in my app?
Injecting sounds scary, but it really is not. RocketSim will never harm your app’s performance, influence it’s data, and will never perform any privacy impacting actions. All communication finds place locally on a local network and will never leave your machine.