DOCUMENTATION / TROUBLESHOOTING

iOS Simulator

Tapscope finds booted simulators through Xcode’s command line tools and connects to Safari and inspectable WebViews inside them. No device or cable needed.

Xcode not available

Shown in Tapscope Xcode not available

Tapscope needs Xcode and its simctl tool to list and control simulators.

  1. Install Xcode from the Mac App Store and open it once so it can finish installing its components.
  2. Add an iOS simulator runtime under Xcode › Settings › Components if none is installed.
  3. If you have more than one Xcode, select the right one with the first command below.
  4. Check with xcrun simctl help. Tapscope picks the change up on its own.
sudo xcode-select -s /Applications/Xcode.app
xcrun simctl help

No simulator running

Shown in Tapscope No Booted Simulator

Tapscope shows simulators only while they are booted.

  1. Start one from Xcode (Open Developer Tool › Simulator) or list your simulators and boot one from Terminal.
  2. Open Safari in the simulator. The tabs appear in the Tapscope sidebar.
xcrun simctl list devices available
tapscope devices boot <udid>

Web Inspector not reachable

Shown in Tapscope Web Inspector not reachable

The simulator is running, but its Web Inspector service did not answer.

  1. Wait a few seconds after booting; the service starts with the simulator.
  2. Quit Safari in the simulator with the command below and open it again.
  3. Still nothing: shut the simulator down and boot it again.
  4. WebViews in your own app need isInspectable, just like on a device.
xcrun simctl terminate booted com.apple.mobilesafari

Still stuck?

Run the diagnosis in Terminal. It checks every connection Tapscope needs and prints the next step for each problem.

tapscope doctor

Send us its output and we will help: support@tapscope.ch

Chat with Tapscope

The chat loads only after you choose “Start chat”. Your IP address, browser data and messages are then sent to tawk.to. The service may set cookies and process data in the United States.

Privacy information from tawk.to ↗