What do I need to do to port my workout app from watchOS to iOS?
Asked on 06/15/2025
1 search
To port your workout app from watchOS to iOS, you can leverage the HealthKit APIs available on iOS and iPadOS. Here are some steps and considerations based on the WWDC sessions:
-
Use the Same Codebase: If you already have a workout app on Apple Watch, you can use the same code on iPhone and iPad with minimal changes. The workout session APIs are consistent across platforms, allowing you to track activities and save workouts in HealthKit.
-
Workout Session Setup: Begin by creating a workout configuration that reflects the activity type (e.g., running) and location (e.g., outdoor). Then, create an
HKWorkoutSession
and attach a data source to collect health metrics during the workout. -
Handle Device Lock: Unlike the Apple Watch, the iPhone may lock during a workout. Health data is not available when the device is locked, but the system will prompt the user to allow workout data to be available even when locked. This is an opportunity to use live activities to display crucial metrics on the lock screen.
-
Siri Intents and Live Activities: Implement Siri Intents to handle workout commands from the lock screen and use live activities to keep users updated with real-time metrics.
-
Best Practices: Ensure your app only requests authorization for necessary data types to avoid confusing users. Use the Workout Builder API to create and save workouts, ensuring activity rings are updated correctly.
For more detailed guidance, you can refer to the session Track workouts with HealthKit on iOS and iPadOS (00:56) which covers running a workout session and best practices.

What’s new in watchOS 26
Discover the new features in watchOS 26 and learn how to integrate them into your watchOS and iOS apps. Explore the ARM64 architecture, and dive into the new design system. We’ll also share updates for widgets and insights on how to bring controls to Apple Watch.

Track workouts with HealthKit on iOS and iPadOS
Learn best practices for building a great workout experience for iOS. Review the life cycle of a workout session, explore the differences between workouts on Apple Watch and iPhone, and find out how to use Live Activities and Siri to pump up your app’s Lock Screen experience.

Build custom swimming workouts with WorkoutKit
Check out the latest in creating, customizing, and scheduling workouts using WorkoutKit. Sprint through the latest in pace and power alerts and expanded support for distance goals. And keep the momentum going with the benefits of custom step names.