watchOS 4 SDK Release Notes
watchOS 4 SDK provides support for developing watchOS apps. It is packaged with a complete set of Xcode tools, compilers, and frameworks for creating apps for watchOS. These tools include the Xcode IDE and the Instruments analysis tool, among many others.
With this software you can develop apps for Apple Watch running watchOS 4. You can also test your apps using the included watchOS Simulator, which supports watchOS 4. watchOS 4 SDK requires a Mac computer running macOS Sierra 10.12.6 or later.
This version of watchOS is intended for installation only on devices registered with the Apple Developer Program. Attempting to install this version of watchOS in an unauthorized manner could put your device in an unusable state.
Tools and Developer Resources
You obtain Xcode 9 from the Mac App Store. It is a free download that installs directly into the Applications folder. By default, Xcode downloads developer documentation in the background for offline reading; it also automatically downloads documentation updates. This behavior can be changed after installation using the Downloads preferences pane.
The Apple Developer Program provides access to the App Store, Mac App Store, and Apple TV App Store, additional support and documentation, and signing resources for testing and deployment on Apple TV, Apple Watch, iPad, iPhone, and iPod touch devices. For more information, visit the Apple Developer Program website.
Apple provides the following web resources to support development in watchOS:
Apple Developer Forums. Participate in discussions about developing for Apple platforms and using developer tools.
Bug Reporter. Report issues, enhancement requests, and feedback to Apple. Provide detailed information, including the system and developer tools version information, and any relevant crash logs or console messages.
Apple Developer website. Get the latest development in formation as well as technical documentation for Xcode.
watchOS homepage. Get high-level information about the latest release of Xcode. Download current and beta Xcode releases.
For help with using Xcode, choose Help > Xcode Help.
For issues not mentioned in Notes and Known Issues, please file bugs through the Apple Developer website https://developer.apple.com/bug-reporting/.
When filing a bug, please include the full version number in the bug title and in the description. To find the version number, on iPhone open Apple Watch and navigate to My Watch > General > About. The version number is next to Version and looks like 4.0 (15Rxxxxx).
Additionally, you may discuss these issues and watchOS 4 SDK in the Apple Developer Forums at https://forums.developer.apple.com/welcome.
Release Notes Updates
watchOS Release Notes is sometimes updated after a release is distributed. You can check for the most up-to-date version of watchOS Release Notes at the Apple Developer website by checking http://developer.apple.com/go/?id=watchos-sdk-release-notes.
Revision: watchOS400 - WRN1
Notes and Known Issues
The following items relate to using watchOS 4 SDK to develop code.
CloudKit doesn't support
unsigned long longvalues with the high-order bit set. (30567424)
Applications that use
CKModifyRecordsOperationshould specify an appropriate value for
CKModifyRecordsOperation.isAtomic. If your client is compiled against watchOS 4, operations enqueued against the default
CKRecordZonehave new behavior because
trueby default. If the operation hits a "preflight" failure (most commonly, a network issue uploading a
CKAsset, or a malformed
CKRecord), the entire operation is canceled. (30838858)
CoreBluetooth is not supported on original Apple Watch or Apple Watch Series 1. (34049299)
To track location in the background while a user is in a workout session, add
Automatic display of attachments in default WatchKit Notification interfaces do not work. (31589086)
Crashlogs may take a few minutes to sync and be visible in Xcode. (31156191)