Hi everyone,
I am developing an iOS companion app with an integrated watchOS component (a golf swing tracking tool using CoreMotion).
I have run into an issue where the watchOS app gets stuck indefinitely in the "Installing..." state and never finishes installing on the physical Apple Watch.
Environment (All on latest public releases):
- Xcode Version: Latest release (Xcode 18.x)
- macOS Version: Latest release (macOS Sequoia / latest version)
- iOS Version: Latest release (iOS 20.x)
- watchOS Version: Latest release (watchOS 13.x on Apple Watch Ultra 2)
- Deployment Target: Matched to latest minimum deployments
- Signing: "Automatically manage signing" enabled with an active Apple Developer Program account
Steps to Reproduce:
- Connect the iPhone to the Mac via a physical cable.
- Select the iOS target in Xcode and successfully run/install the companion app onto the iPhone.
- Launch the stock Watch app on the paired iPhone.
- Scroll down to the "Available Apps" section, locate the development app, and tap "Install".
- The circular progress indicator starts spinning with the status "Installing...", but it remains in this state indefinitely (waited over 2 hours) without ever completing, timing out, or surfacing an error alert on either the iPhone or the Apple Watch.
Troubleshooting Already Verified:
- Bundle ID Hierarchy:
- iOS App:
com.company.appname - Watch App:
com.company.appname.watchkitapp - Both targets share the exact same Development Team, signing certificate, and provisioning profiles.
- iOS App:
- Developer Mode:
- Explicitly enabled and rebooted on the Apple Watch (
Settings -> Privacy & Security -> Developer Mode). - Also verified as enabled on the host iPhone.
- Explicitly enabled and rebooted on the Apple Watch (
- Connectivity & Cache:
- Cleared Xcode DerivedData (
rm -rf ~/Library/Developer/Xcode/DerivedData). - Performed hard reboots on both the iPhone and the Apple Watch to terminate any hung background sync daemons (
installd/CoreDevice). - Ensured both devices and the Mac are on the same Wi-Fi network with Bluetooth turned on.
- Cleared Xcode DerivedData (
Questions:
- Under the current CoreDevice architecture, is installing local debug builds via the iPhone's stock Watch app still supported, or does it silently fail because the physical Apple Watch's UDID is not directly provisioned during an iOS-only build?
- Which subsystem in macOS Console.app (e.g.,
com.apple.dt.CoreDevice,com.apple.StreamingExtractor, orinstalld) is best for tracking the exact error/timeout code when the watch installation hangs? - What is the currently recommended workflow to deploy and debug a paired watchOS target directly onto physical hardware?
Any insights from the team or community would be greatly appreciated!