tvOS SDK Release Notes for tvOS 10.2



The 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 10.2 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.

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.

About tvOS 10.2

tvOS 10.2 includes includes new features, bug fixes, and improvements in the OS and SDK including:

Bug Reporting

For issues not mentioned in the Notes and Known Issues section, please file bugs through the Apple Developer website ( Additionally, you may discuss these issues and tvOS SDK 10.2 in the Apple Developer Forums:

Autosubmission of Diagnostic and Usage Data

By default, tvOS 10.2 automatically sends anonymous diagnostic and usage data back to Apple. This includes information about crashes, freezes, kernel panics, and information about how you use Apple and third-party software, hardware, and services. This information is used to help Apple improve the quality and performance of its products and services. You can stop autosubmission of diagnostics and usage data by going to Settings > Privacy > Diagnostics and Usage > Don’t Send.

Notes and Known Issues

Accelerated Scrolling

Scroll views with a lot of content now have a behavior that allows users to scroll through them much more quickly. Several large swipes of the Siri remote will automatically switch into this mode. Additionally, users can swipe on the far right side of the remote to navigate specific indexes. If you see any unexpected behavior in your applications from this feature, please file a bug report.

Device Enrollment Program (DEP) / Mobile Device Management (MDM)

Self-signed certificates installed on unsupervised devices are not trusted.

Workaround: Supervise the device and include the entire certificate trust chain in the enrollment profile, or use a certificate on your MDM server that is signed by a certificate authority in the default trust store for tvOS.

File System

When you update to tvOS 10.2, your Apple TV will update its file system to Apple File System (APFS). This conversion preserves existing data on your device.

Top Shelf App Extension

tvOS apps with a deployment target of tvOS 10.0 or greater that use a Top Shelf extension will now require a “Top Shelf Image Wide” (2320x720) image in the asset catalog when submitting to the App Store.

tvOS apps with a deployment target of tvOS 9.0 or greater that use a Top Shelf extension now require both a "Top Shelf Image Wide” (2320x720) and "Top Shelf Image” (1920x720) image in the asset catalog when submitting to the App Store.


For layered images retrieved from a content server at runtime, only the .lcr image format is supported; .lsr images are not supported.

For more information, please refer to the “Runtime Layered Images” section at