Contents

tvOS 15 Release Notes

Update your apps to use new features, and test your apps against API changes.

Overview

The tvOS 15 SDK provides support to develop tvOS apps for Apple TV devices running tvOS 15. The SDK comes bundled with Xcode 13, available from the Mac App Store. For information on the compatibility requirements for Xcode 13, see Xcode 13 Release Notes.

App Store

New Features

  • A new type property unfinished is now available on Transaction that returns signed information for any transactions where the app still needs to deliver content to the user. (79620896)

  • A new onStorefrontChange(shouldContinuePurchase:) is available in StoreKit 2. You can use this purchase option to determine whether the transaction continues if the App Store storefront changes during a transaction. The default is true if this option isn’t added. (70757789)

Resolved Issues

  • Fixed an issue where purchases performed in the Sandbox environment returned VerificationResult.unverified(_:_:). (71949674)

Known Issues

  • The unfinished property might return VerificationResult<Transaction> for transactions that have already finished. (81346114)

Logging

Deprecations

  • Support for cleartext HTTP URL schemes for Proxy Automatic Configuration (PAC) is now deprecated. Use only HTTPS URL schemes for PAC. This affects all PAC configurations, including, but not limited to, configurations set via Settings, System Preferences, profiles, and URLSession APIs such as connectionProxyDictionary and CFNetworkExecuteProxyAutoConfigurationURL(_:_:_:_:). If you configure a cleartext HTTP PAC URL, the system may upgrade it to HTTPS during PAC file loads. Web Proxy Auto-Discovery (WPAD) Protocol via DNS isn’t affected. Dynamic Host Configuration Protocol (DHCP) Option 252 WPAD may attempt to upgrade cleartext HTTP URLs to HTTPS during PAC file loads. (61981845)

MapKit

Deprecations

Networking

New Features

  • The default Accept-Language header that URLSession sends has an updated format and corrected values for multiple locales. In addition to the preferred language, the header also includes the current system language as a fallback if it differs from the preferred language. This behavior affects apps that link against macOS 12, iOS 15, tvOS 15, and watchOS 8 SDKs. (38772422)

SharePlay

Deprecations

  • SharePlay development in beta 7 and upcoming beta releases requires the installation of an updated SharePlay Development Profile. This profile enables successful creation and reception of GroupSessions via the Group Activities API in iOS 15, iPadOS 15 and tvOS 15 beta 7, as well as macOS Monterey beta 6. (81816137)

StoreKit

New Features

  • StoreKit 2 introduces a modern Swift-based API that takes advantage of new language features like Swift concurrency. Use this API to load product information, display in-app purchases in your store, allow customers to make purchases, manage access to content and subscriptions, and receive transaction information signed by the App Store in JSON Web Signature (JWS) format. (66587964)

SwiftUI

New Features

  • LocalizedStringKey can now contain Markdown syntax. The system parses Markdown strings when you create a Text view from a LocalizedStringKey, including Text views created with a string literal. The system styles Text according to Markdown constructs. (74515884)

  • You can create Text from an AttributedString structure. Text respects the styles you provide through attributes within the SwiftUI attribute scope; these styles take precedence over styles you provide through view modifiers. (74841755)

  • A TextField provided an Formatter now updates its binding as the user types. NSFormatter formats the text of the field when the user submits the field, or when focus moves away from the field. (67899823)

  • While searching, if you tap a suggestion that uses the searchCompletion(_:) modifier, the suggestion list now disappears rather than displaying the single suggestion you selected. (76965399)

  • Added buttonBorderShape, which can be used to control the shape of bordered buttons. (79456465)

  • Types conforming to the Animatable protocol and also conforming to either the View or ViewModifier protocols now apply animations when their values change. Consequently, the AnimatableModifier protocol is soft-deprecated. Use Animatable directly when targeting the latest OS versions; for example, use struct CustomModifier: ViewModifer, Animatable rather than struct CustomModifier: AnimatableModifier. (76971100)

  • The contentShape(_:eoFill:) modifier now allows fine-grained control over different kinds of shapes. For drag previews, hover effects, and context menus, the matching ContentShapeKinds is required to affect the shape of previews when linked on iOS 15.0 or newer. The default behavior is to set the interaction kind. (60792377)

The openURL environment value can now be set and used to customize URL handling in the view hierarchy, including URL handling in Link views and links embedded in Text views. (78551237)

  • Task allows you to pass the priority to be used when spawning a new Task. (80599258)

  • Text views that contain excessive line height characters now have a larger default size to avoid clipping or overlapping of oversized characters. (80665315)

Deprecations

  • controlProminence is deprecated. Use the new .borderedProminent ButtonStyle instead. (78908460)

Xcode

Known Issues

  • MusicKit functionality, such as loading content with music requests, doesn’t work in simulated devices. (78559381)

    Workaround: Test your app’s MusicKit functionality on a physical device.

See Also

tvOS 15