Skip to content

DEBUGGING.md

Latest commit

 

History

History
64 lines (50 loc) · 1.97 KB

DEBUGGING.md

File metadata and controls

64 lines (50 loc) · 1.97 KB

Debug Connection Issues - Troubleshooting Guide

Current Issue

Lost connection to debugger on Apple Watch during app launch.

Quick Fixes

1. Reconnect Devices

  • Unlock both iPhone and Apple Watch
  • Keep iPhone near your Mac (within Bluetooth range)
  • Make sure iPhone is connected to Mac via cable or WiFi sync

2. Restart Debug Session

  • In Xcode: Stop the current session (⌘.)
  • Clean build folder (⌘⇧K)
  • Rebuild and run again (⌘R)

3. Reset Connections

# Restart iPhone's developer mode
# On iPhone: Settings → Privacy & Security → Developer Mode → Toggle off/on

# Or restart devices:
# 1. Restart Apple Watch
# 2. Restart iPhone
# 3. Try debugging again

Advanced Troubleshooting

4. Clear Debug Symbol Cache

rm -rf ~/Library/Developer/Xcode/iOS\ DeviceSupport/*
rm -rf ~/Library/Developer/Xcode/watchOS\ DeviceSupport/*

5. Disconnect and Reconnect Watch

  • In Xcode: Window → Devices and Simulators
  • Right-click on your Apple Watch → Unpair
  • Reconnect and trust the device

6. Check Watch Debug Settings

  • On Apple Watch: Settings → Privacy → Analytics & Improvements
  • Ensure Developer Mode is enabled (if available)

7. Verify Network Connection

Since your app uses network features:

  • Ensure Watch and iPhone are on same WiFi network
  • Check if Mac server (mac_server.py) is running and accessible
  • Verify firewall settings aren't blocking connections

Running Without Debugger

If debugging continues to fail, you can run the app without the debugger:

  1. In Xcode: Product → Scheme → Edit Scheme
  2. Select "Run" on left
  3. Under "Info" tab → Debug executable: Uncheck
  4. Run the app (it will launch but won't attach debugger)
  5. View logs in Console.app or Xcode's device logs

Notes

  • The error message mentions "Fetching debug symbols" - this can take time on first launch
  • watchOS 10.x+ requires symbols to be downloaded from device
  • Be patient, sometimes it takes 2-3 minutes on first connection