tvOS 11 SDK Release Notes



tvOS SDK leverages many of the same frameworks and technologies that you’re already using for iOS development. However, please note that all libraries and frameworks used in your tvOS apps must be built for tvOS, including any 3rd-party libraries. Do not link your tvOS app against frameworks or libraries that are not built with tvOS. Attempting to do so will result in a build failure. Furthermore, bitcode is required for all tvOS apps. All apps and frameworks in the app bundle must include bitcode.

tvOS 11 SDK provides support for developing tvOS apps. It’s packaged with a complete set of Xcode tools, compilers, and frameworks for creating apps for tvOS. These tools include the Xcode IDE and the Instruments analysis tool, among many others.

With this software you can develop apps for Apple TV running tvOS 11. You can also test your apps using the included tvOS Simulator, which supports tvOS 11. tvOS 11 SDK requires a Mac computer running macOS Sierra 10.12.6 or later.

This version of tvOS is intended for installation only on devices registered with the Apple Developer Program. Attempting to install this version of tvOS 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 iOS:

Bug Reporting

For issues not mentioned in the Notes and Known Issues section, please file bugs through the Apple Developer website (

When filing a bug, please include the full version number in the bug title and in the description. To find the version number, open Settings > General > About. The version number is shown next to Version and looks like 11.0 (15Jxxxxx).

Additionally, you may discuss these issues and tvOS 11 SDK in the Apple Developer Forums:

Release Notes Updates

tvOS Release Notes is sometimes updated after a release is distributed. You can check for the most up-to-date version of tvOS Release Notes at the Apple Developer website by checking

Revision: tvOS1100 - TRN1

Notes and Known Issues

The following items relate to using tvOS 11 SDK to develop code.


Known Issues

  • CloudKit doesn't support unsigned long long values with the high-order bit set. (30567424)

  • Applications that use CKModifyRecordsOperation should specify an appropriate value for CKModifyRecordsOperation.isAtomic. If your client is compiled against tvOS 11, operations enqueued against the default CKRecordZone have new behavior because atomic is true by 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)


Known Issues

  • Clients of NSURLSessionStreamTask that use a non-secure connection fail to connect when an error occurs during PAC file evaluation and the system is configured for either Web Proxy Auto Discovery (WPAD) or Proxy Automatic Configuration (PAC). A PAC evaluation failure can occur when the PAC file contains invalid JavaScript or the HTTP host serving the PAC file is unreachable. (33609198)

    Workaround: Use startSecureConnection to establish a secure connection.


Known Issues

  • VNFaceLandmarkRegion2D is currently unavailable in Swift. (33191123)