--- title: tvOS 15 Release Notes framework: tvos-release-notes role: article role_heading: Article path: tvos-release-notes/tvos-15-release-notes --- # tvOS 15 Release Notes Update your apps to use new features, and test your apps against API changes. ## Overview 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 The request(with:) type method on Product is now renamed to products(for:). (79410910) The Transaction listener type properties on Product.SubscriptionInfo.Status and Storefront are now updates and updates, respectively. The nested AsyncSequence conforming structures are now Transaction.Transactions, Product.SubscriptionInfo.Status.Statuses, and Storefront.Storefronts. Both TransactionSequence and TransactionListener are now Transaction.Transactions. (79034347) StoreKitError.userDidNotAuthenticate is no longer available; use StoreKitError.userCancelled instead. (78270199) You can now access Product raw JSON data for custom decoding: Multiple Product.PurchaseOption methods are now allowed. .custom(_:) is replaced with several new type methods, namely custom(key:value:), custom(key:value:), custom(key:value:), and custom(key:value:). Subscript operators on Product, Transaction, and renewalInfo are removed, along with the nested Key enumerations. BackingValue and extensions adding initializers from BackingValue are removed. (79101606) 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) VerificationResult.unverified(SignedType) is now VerificationResult.unverified(SignedType, VerificationError) to provide a reason for unverified signed values. jsonRepresentation is available on Transaction and jsonRepresentation is available on renewalInfo; both properties provide the payload JSON as Data. payloadValue and unsafePayloadValue properties are available on VerificationResult as a convenience to access the signed value. (80701792) Resolved Issues Fixed an issue where purchases performed in the Sandbox environment returned VerificationResult.unverified(_:_:). (71949674) Known Issues The unfinished property might return VerificationResult 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 MKPinAnnotationView and MapPin are deprecated in this beta. (78536295) 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) Specific kinds of animations now execute off the main thread, so there are new thread-safety requirements. (70524799) Ensure the following functions and types are thread-safe: All methods and accessors of types conforming to these protocols: AlignmentID, Animatable, EnvironmentKey, EnvironmentValues, Equatable, GeometryEffect, Hashable, Identifiable, PreferenceKey, Shape, VectorArithmetic. Any closures you pass to the following types and functions, but only if the views that created them don’t have references to ObservableObject types: ForEach, GeometryReader, backgroundPreferenceValue(_:_:), overlayPreferenceValue(_:_:), transformPreference(_:_:), anchorPreference(key:value:transform:), transformAnchorPreference(key:value:transform:), transformEnvironment(_:transform:), transaction(_:). 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) You can now initialize Text with a FormatStyle. (72159423) 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) New AttributedString attributes underlineStyle and strikethroughStyle were added to AttributeScopes.SwiftUIAttributes. (78437803) 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 - [tvOS 15.6 Release Notes](tvos-release-notes/tvos-15_6-release-notes.md) - [tvOS 15.5 Release Notes](tvos-release-notes/tvos-15_5-release-notes.md) - [tvOS 15.4 Release Notes](tvos-release-notes/tvos-15_4-release-notes.md) - [tvOS 15.3 Release Notes](tvos-release-notes/tvos-15_3-release-notes.md) - [tvOS 15.2 Release Notes](tvos-release-notes/tvos-15_2-release-notes.md) - [tvOS 15.1 Release Notes](tvos-release-notes/tvos-15_1-release-notes.md)