Apple Release Notes

App Store Connect updates

• You can now upload apps built with Xcode 27.1 using the SDK for iOS 27.1, iPadOS 27.0, macOS 27.0, tvOS 27.0, visionOS 27.0, and watchOS 27.0 for the App Store, and for internal and external testing through TestFlight.
• Submit your iPhone Duo optimized apps and games in App Store Connect today. Starting April 2027, any apps or games submitted will need to include screenshots for iPhone Duo.

Learn how to prepare and submit your apps for iPhone Duo >

Screenshot specifications >

App Store Connect update

You can now use creative assets to highlight your brand identity, promote seasonal updates, and showcase new app or game across the App Store—including product page headers, search results, and in-app events.

The new Asset Library brings together your app previews, screenshots, and creative assets into one central hub to manage and submit media across platforms, sizes, and placements. You can also preview your assets in real time to see exactly how they look on the product page and in search results.

Manage your App Store assets >

Showcase your apps with new assets on the App Store >

Creative assets specifications >

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

Xcode 27.1 beta includes Swift 6.4 and SDKs for iOS 27.1, iPadOS 27.1, tvOS 27, watchOS 27, macOS 27, and visionOS 27. Xcode 27.1 beta supports on-device debugging in iOS 17 and later, tvOS 17 and later, watchOS 10 and later, and visionOS. Xcode 27.1 beta requires a Mac running macOS Tahoe 26.6 or later.

See Xcode Support to learn more about compatible platforms and deployment targets.

Known Issues:

• Projects that use APIs specific to iOS 27.1 show compile errors when building for Mac Catalyst (“undeclared identifier”, “not found”, “has no member”, “cannot find”, etc). (185924957)
  Workaround: Use build-time conditionals like #if !targetEnvironment(macCatalyst) (Swift) or #if !TARGET_OS_MACCATALYST (ObjC) to isolate affected code.
• Projects that target iOS 27.1 show no Mac Catalyst run destination available. (187046347)
  Workaround: Add a Mac Catalyst 27.0 minimum deployment in target settings.

New Features:

• The canvas overrides picker now includes a Display group for previewing content on a device’s alternative display. (182598534)

Simulator Known Issues:

• Initial Simulator launch can take several minutes. (187708500)
• StandBy is unavailable in the iPhone Duo Simulator runtime. (187708663)
• Running and debugging most app extensions is unavailable in the iPhone Duo Simulator runtime. (187708767)

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

Overview

Xcode 27.2 beta includes Swift 6.4 and SDKs for iOS 27.2, iPadOS 27.2, tvOS 27.2, watchOS 27.2, macOS 27.2, and visionOS 27.2. Xcode 27.2 beta supports on-device debugging in iOS 17 and later, tvOS 17 and later, watchOS 10 and later, and visionOS. Xcode 27.2 beta requires a Mac running macOS Tahoe 26.6 or later.

Important

The iOS SDK and simulator support for iPhone Duo will be available later this month in an upcoming release of Xcode 27.1.

See Xcode Support to learn more about compatible platforms and deployment targets.

General

Known Issues

• Xcode may crash when using code completion on macOS 27.2 beta. (186939138)
  Workaround: Turn off enhanced code completion ranking with the following preference:
  defaults write com.apple.dt.Xcode Code Completion Assets To Load /dev/null

Device Hub

Known Issues

• Keyboard and mouse inputs to simulators for OS versions before iOS 18.0, tvOS 18.0, watchOS 11.0, and visionOS 2.0 are not accepted. (181945323)
• After disconnecting a physical device from Device Hub when “Simulate Hardware Keyboard” was in use, the device may remain in “hardware keyboard” mode for up to 2 minutes. This will cause the software keyboard to not appear when selecting a text field. (182553164)
  Workaround: Wait 2 minutes for the condition to clear.

Previews

Resolved Issues

• Fixed an occasional issue where selecting a preview from a preview group’s thumbnail grid on macOS would fail to 1-up the right preview. (183475595)
• Fixed: A clearer error is now shown when the selected platform does not support a preview’s content. (185436582)
• Fixed: The RenderPreview MCP tool now returns the list of available render destinations, and lets the caller specify which destination to use for rendering. (186442676)

Previews & Playgrounds

Resolved Issues

• Fixed: A clearer error with recovery steps is now shown when previews fail because another user account on this Mac owns the Previews JIT directory. (184564292)

Project Format

New Features

• Xcode now supports a JSON-based project format (.xcproj) that’s more readable, merge-friendly, and easier for coding agents to edit. Enable it in the file inspector. Projects using .xcproj also open in earlier versions of Xcode 27. Learn more in Updating your Xcode project configuration file format. (184661114)

SDK

Known Issues

• macOS, watchOS, tvOS, and visionOS SDKs in Xcode 27.2 incorrectly report 27.1 as a valid deployment target. Builds and other functionality may have unexpected behavior if this deployment target is used. Mac Catalyst builds with a 27.1 or 27.2 deployment target may be unable to use newly introduced API. (187160501)

Simulator

Known Issues

• Some simulator runtimes are not completely deleted when removed, re-appearing after a reboot. (141290052) (FB16083602)

See Also

Xcode 27

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

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

Overview

The macOS 27.2 SDK provides support to develop apps for Mac computers running macOS 27.2 Golden Gate beta. The SDK comes bundled with Xcode 27.2, available from the Mac App Store. For information on the compatibility requirements for Xcode 27.2, see Xcode 27.2 Release Notes.

Notifications

Known Issues

• Mac computers with a clean install of this build might not prompt you to allow notifications for some apps, such as Calendar, Maps, Find My, Home, and Weather. (187312007)
  Workaround: Go to System Settings > Notifications to manually turn on notifications for the affected apps.

Shortcuts

Known Issues

• Describe a Shortcut might fail with the error “Something went wrong. Try again later.” (187499433)

StoreKit Testing in Xcode

Resolved Issues

• Fixed: Intro offer eligibility does not reset immediately after calling SKTestSession.clearTransactions(). (183933307) (FB24137836)
• Fixed: Changing the storefront or locale using SKTestSession doesn’t propagate through Storefront.updates. (184155259)
• Fixed: Failed purchases using SKTestSession might display error dialogs even when dialogsDisabled is set to true. (184255116)

Known Issues

• Making a purchase in-app for a subscription that is a member of a subscription bundle incorrectly allows the user to unbundle instead of throwing an error. (186018916)

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

The iOS & iPadOS 27.2 SDK provides support to develop apps for iPhone and iPad running iOS & iPadOS 27.2 beta. The SDK comes bundled with Xcode 27.2, available from the Mac App Store. For information on the compatibility requirements for Xcode 27.2, see Xcode 27.2 Release Notes.

• App Tracking Transparency (ATT) now supports an alternative expanded prompt and re-prompting on a yearly basis for EU users. The alternative prompt is required for users in France, Germany, Italy, Poland, and Romania. (179504171)

• Personalized summaries may not generate as expected in the Insights tab. (186964423)

• Describe a Shortcut might fail with the error “Something went wrong. Try again later.” (187499433)

• Fixed: Intro offer eligibility does not reset immediately after calling SKTestSession.clearTransactions(). (183933307) (FB24137836)

• Fixed: Changing the storefront or locale using SKTestSession doesn’t propagate through Storefront.updates. (184155259)

• Fixed: Failed purchases using SKTestSession might display error dialogs even when dialogsDisabled is set to true. (184255116)

• Making a purchase in-app for a subscription that is a member of a subscription bundle incorrectly allows the user to unbundle instead of throwing an error. (186018916)

Safari 27.2 beta is available for iOS 27.2 beta, iPadOS 27.2 beta, visionOS 27.2 beta, macOS 27.2 beta, macOS 26, and macOS Sequoia.

Accessibility

• Fixed list, table, tree, and canvas content being omitted from the accessible name or description when the containing element is referenced by aria-labelledby or aria-describedby. (186015032)
• Fixed VoiceOver repeating text it had already announced when a page streams content by re-rendering an aria-live region instead of appending to it. (186766347)

Animations

• Fixed animation-range-start and animation-range-end resolving incorrectly when zoom is applied, including when the value is inherited from an element with a different zoom factor. (185760120)

CSS

Deprecations

• Renamed the flow-tolerance property to fit-tolerance for display: grid-lanes, keeping flow-tolerance as a deprecated alias that Web Inspector now flags. (185816680)

Forms

New Features

• Added support for safe and unsafe overflow alignment with normal, and for safe alignment on fixed position boxes so they stay in view even when that means overflowing their position-area. Also, applied safe alignment to ::picker(select), which keeps base appearance pickers fully in view. (186812035)

Resolved Issues

• Fixed: Updated the default styling for appearance: base-select to center-align items, use lh units for padding, and reset all font properties on ::picker-icon and ::checkmark. (184843832)

HTML

Resolved Issues

• Fixed the window load event never being dispatched when a readystatechange handler starts a new load. (186475302)

JavaScript

Resolved Issues

• Fixed for await...of over an async generator skipping the Promise.prototype.constructor lookup required by PromiseResolve when that property is replaced. (183960626)

Media

Resolved Issues

• Fixed AudioContext.decodeAudioData() failing with an EncodingError for valid AAC and M4A files whose file brand is not mp4. (183474728)
• Fixed video showing a black screen while audio continued to play after the video decoder was invalidated. (184041554)
• Fixed ManagedMediaSource not firing the startstreaming event when seeking to a time that is not buffered, which could stall playback. (185166787)

Networking

Resolved Issues

• Fixed cookies set by a top-level navigation’s own response being capped to a seven day lifetime when the site’s hostname is CNAMEd to a different registrable domain. (183787115)

SVG

Resolved Issues

• Fixed dynamic changes to a element’s x and y values having no effect. (184273832)

Safari MCP

Resolved Issues

• Fixed Safari taking keyboard focus from other apps when creating tabs or capturing screenshots under Safari MCP control. (182558329)

Web Extensions

Resolved Issues

• Fixed a significant delay before web extension content is injected when Safari is cold launched. (185268822)

WebGPU

Resolved Issues

• Fixed a severe frame rate drop when calling executeBundles() with render bundles that contain drawIndirect() or drawIndexedIndirect(). (186099290)

WebRTC

Resolved Issues

• Fixed an issue where getUserMedia() requests for audio permanently failed with NotAllowedError after the system audio service was reset. (186939802)