Connection problems between Xcode and Apple Watch

Question

Created Jun ’26

Replies 6

Boosts 2

Participants 4

This post is from the WWDC26 watchOS Q&A.

Hello! As I try to use Xcode (has happened in versions 16 and 26) and my Apple Watch (has happened with Series 6 and 10), the Devices and Simulators window reports problems connecting to the Watch. Messages vary from "Connecting to Apple Watch" to "Waiting to reconnect: Previous preparation error: the tunnel connection failed while the system tried to connect to the device; client unable to receive tunnel handshake response", or "Apple Watch may need to be unlocked to recover from previously reported preparation errors. Ensure the device is unlocked and near this Mac for better connection quality." The Watch was operational, and on my wrist, so it was unlocked. Any suggestions on how to move beyond this? Thank you!

Answer 1

Frameworks Engineer OP

Apple

Jun ’26

This seems like a bug — please file Feedback and post the number here!

Answer 2

m2martin8 OP

Jun ’26

Thank you for your reply! This was first reported in August 4, 2025 (FB19367415). No resolution has been found.

Answer 3

Frameworks Engineer OP

Apple

Jun ’26

Can you try with the first Xcode 27 beta?

Answer 4

RyanFerrell OP

Jun ’26

I find toggling Bluetooth and sometimes restarting or physically connecting the paired iPhone helps to restore communication.

Anecdotal: Xcode 27 has had zero errors, although apparently my 3 year old Ultra 1 is now relegated to past OS testing only.

Answer 5

m2martin8 OP

Jun ’26

Thank you for the suggestion. I will download Xcode 27 beta and see what happens. I want to add that, after eight months of not being able to connect, Xcode 26.4 started to connect with my Watch in April '26. I still receive the error, but the communication is established after a few minutes. Current versions of software involved: Xcode 26.4 running from an M4 Mac mini running macOS Tahoe 26.2.1. Watch Series 10 (running watchOS 26.4) paired to an iPhone 16 Pro running iOS 26.5.

Answer 6

PGX OP

2w

I had this issue in Xcode 26 too. I've since downloaded the Xcode 27 beta 3 and still have the same issue.

iPhone connected via USB C cable
Watch has development mode enabled
Every device on same WiFi network
No VPN connected

90% of the time it's the same error, on rare occasions it does actually work. Very strange.

Domain: com.apple.dt.CoreDeviceError
Code: 4000
User Info: {
    DVTErrorCreationDateKey = "2026-07-14 16:08:25 +0000";
    DVTRadarComponentKey = 985505;
    IDERunOperationFailingWorker = IDEInstallCoreDeviceWorker;
    "com.apple.dt.DVTCoreDevice.operationName" = connect;
}
--
Timed out while attempting to establish tunnel using negotiated network parameters.
Domain: com.apple.dt.RemotePairingError
Code: 1001
Recovery Suggestion: Ensure the device is accessible from this machine over an infrastructure network, or ensure WiFi is enabled on both machines.
--

Event Metadata: com.apple.dt.IDERunOperationWorkerFinished : {
    "device_identifier" = "00008301-088D1C383AFBC02E";
    "device_isCoreDevice" = 1;
    "device_model" = "Watch6,18";
    "device_osBuild" = "26.5 (23T570)";
    "device_osBuild_monotonic" = 23019570000000000;
    "device_os_variant" = 1;
    "device_platform" = "com.apple.platform.watchos";
    "device_platform_family" = 3;
    "device_reality" = 0;
    "device_thinningType" = "Watch6,18";
    "device_transport" = 2;
    "launchSession_schemeCommand" = Run;
    "launchSession_schemeCommand_enum" = 1;
    "launchSession_targetArch" = "arm64_32";
    "launchSession_targetArch_enum" = 5;
    "operation_duration_ms" = 11793;
    "operation_errorCode" = 1001;
    "operation_errorDomain" = "com.apple.dt.CoreDeviceError.4000.com.apple.dt.RemotePairingError";
    "operation_errorWorker" = IDEInstallCoreDeviceWorker;
    "operation_error_reportable" = 1;
    "operation_name" = IDERunOperationWorkerGroup;
    "param_consoleMode" = 1;
    "param_debugger_attachToExtensions" = 0;
    "param_debugger_attachToXPC" = 1;
    "param_debugger_type" = 3;
    "param_destination_isProxy" = 0;
    "param_destination_platform" = "com.apple.platform.watchos";
    "param_diag_MTE_enable" = 0;
    "param_diag_MainThreadChecker_stopOnIssue" = 0;
    "param_diag_MallocStackLogging_enableDuringAttach" = 0;
    "param_diag_MallocStackLogging_enableForXPC" = 1;
    "param_diag_allowLocationSimulation" = 1;
    "param_diag_checker_mtc_enable" = 1;
    "param_diag_checker_tpc_enable" = 1;
    "param_diag_gpu_frameCapture_enable" = 0;
    "param_diag_gpu_shaderValidation_enable" = 0;
    "param_diag_gpu_validation_enable" = 0;
    "param_diag_guardMalloc_enable" = 0;
    "param_diag_memoryGraphOnResourceException" = 0;
    "param_diag_queueDebugging_enable" = 0;
    "param_diag_runtimeProfile_generate" = 0;
    "param_diag_sanitizer_asan_enable" = 0;
    "param_diag_sanitizer_mtasan_enable" = 0;
    "param_diag_sanitizer_tsan_enable" = 0;
    "param_diag_sanitizer_tsan_stopOnIssue" = 0;
    "param_diag_sanitizer_ubsan_enable" = 0;
    "param_diag_sanitizer_ubsan_stopOnIssue" = 0;
    "param_diag_showNonLocalizedStrings" = 0;
    "param_diag_viewDebugging_enabled" = 1;
    "param_diag_viewDebugging_insertDylibOnLaunch" = 1;
    "param_install_style" = 2;
    "param_launcher_UID" = 2;
    "param_launcher_allowDeviceSensorReplayData" = 0;
    "param_launcher_kind" = 0;
    "param_launcher_style" = 99;
    "param_launcher_substyle" = 0;
    "param_lldbVersion_component_idx_1" = 0;
    "param_lldbVersion_monotonic" = 210300260101;
    "param_runnable_appExtensionHostRunMode" = 0;
    "param_runnable_productType" = "com.apple.product-type.application";
    "param_testing_launchedForTesting" = 0;
    "param_testing_suppressSimulatorApp" = 0;
    "param_testing_usingCLI" = 0;
    "sdk_canonicalName" = "watchos27.0";
    "sdk_osVersion" = "27.0";
    "sdk_platformID" = 4;
    "sdk_variant" = watchos;
    "sdk_version_monotonic" = 24017315005000008;
}
--


System Information

macOS Version 26.5.2 (Build 25F84)
Xcode 27.0 (25183.54.10) (Build 27A5218g)
Timestamp: 2026-07-14T18:08:25+02:00