Apple Release Notes

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)

Safari 26.6 is available for iOS 26.6, iPadOS 26.6, visionOS 26.6, macOS 26.6, macOS Sequoia, and macOS Sonoma.

Safari 26.6

• Fixed an issue where the ic length unit scaled incorrectly with page zoom, causing it to no longer equal 1em as expected by the CSS specification. (174857144)

• Fixed an issue where fixed-positioned elements using position-area did not fall back properly when the body was scrollable. (175544079)

• Fixed an issue where CSS zoom interacted incorrectly with font-size, font-weight, font-variant, and font-style on iPad when requesting the desktop website. (176647969)

• Fixed an issue where partitioned cookies could not be deleted using WKHTTPCookie Store. (176097960)

• Fixed an issue where service worker registrations with missing main scripts were not automatically unregistered, preventing pages from re-registering new service workers. (175522651)

• Fixed an issue where service worker registrations with missing imported scripts were not automatically unregistered. (175522816)

• Fixed an issue where web extension service worker registration database files accumulated on each Safari launch, causing performance degradation. (175810627)

• Added compileOptions parameter to WebAssembly.compileStreaming and WebAssembly.instantiateStreaming for JS String Builtins support. (174858653)

• Fixed an issue where RTCPeerConnection configured with iceTransportPolicy: "relay" failed to gather any ICE candidates on macOS Sequoia. (175009190)