Apple Release Notes

Xcode 26.6 RC includes Swift 6.3 and SDKs for iOS 26.5, iPadOS 26.5, tvOS 26.5, macOS 26.5, and visionOS 26.5. Xcode 26.6 RC supports on-device debugging in iOS 15 and later, tvOS 15 and later, watchOS 8 and later, and visionOS. Xcode 26.6 RC requires a Mac running macOS Tahoe 26.2 or later.

New Features

• Google Gemini is now available as a coding agent. (171990272)
• The Preview Snapshot MCP tool can now render variants such as light/dark appearance, portrait/landscape orientation, and various type size overrides. It also supports specifying timelines for Widgets and toggle states for Live Activities. Taken together, this gives agents more flexibility in how they render previews in your codebase. (172961797)
• Coding Intelligence settings now lets you add any ACP compliant agent. (178294840)

Resolved Issues

• Fixed an issue where the buttons in the Coding Tools popovers would not work. (168956652)
• Fixed a crash when closing a window during an active agent turn. (174186260)
• Fixed a crash during agent file operations involving non-absolute paths. (174752919)
• Fixed: Buttons in the Coding Assistant’s prompt area now use more accessible labels and descriptions. (177462284)
• Fixed VoiceOver getting trapped in the Coding Assistant prompt area. (177462397)
• Fixed: Buttons in the Coding Assistant’s prompt area now use more accessible labels and descriptions. (177462492)
• Fixed a bug that could cause Xcode to hang indefinitely when an agent asked the user a question. (177989242)

Organizer New Features

• Launch Time similar-app goals have been refined for improved accuracy, establishing new baselines. (177355331)

Original source

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

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

Accessory Access
Known Issues
• Accessory Access does not work inside App Sandbox. (176815987)
• The Accessory Access framework is not supported within a macOS virtual machine. (177390971)

AirPods Max 2
Known Issues
• You cannot update AirPods Max 2 firmware beta in iOS 27 Beta 1 and macOS 27 Beta 1. AirPods Max 2 firmware beta updates are supported in iOS 27 Beta 2 and macOS 27 Beta 2. (178280323)

App Intents
Known Issues
• Default values from schemas might not be applied for parameters that are of “Set” type. (175534195)
Workaround: Provide a default value explicitly using @Parameter, such as an empty set.
• If you adopt the Audio App Schema domain, you might have trouble playing your content using Siri. (177198033)
Workaround: Adopt an IntentValueQuery that takes the AudioSearch input, or index your entities in Spotlight.

AppKit
New Features
• The Recents list in the open and save panels can be accessed with the keyboard shortcut cmd-shift-f. (120442314)
• Window > Move & Resize and Window > Full Screen Tile menus can be used to move, resize, open and save panels that are not displayed as a sheet. (150791154)
• In macOS 27.0, AppKit adds NSRefreshController, providing pull-to-refresh functionality for NSScrollView. You can set it with NSScrollView.refreshController, configure a target or action to handle user-initiated refreshes, and call endRefreshing when the refresh completes or beginRefreshing to start one programmatically. (160867808)
• NSToolbarItemGroup adds the role property and the NSToolbarItemGroupRole enum, allowing toolbar item groups to be tagged with a semantic role. NSSegmentedControl similarly adds a role property and the NSSegmentedControlRole enum, including a tabs role for controls that represent tab-based navigation and content selection. With this role, controls are read by VoiceOver as “tabs” and have a distinct visual appearance. This distinguishes the segmented control from others that represent value selection — for example, a text alignment control in an inspector. (162577742)
• NSTextSelectionManager provides common text selection interactions (click, drag, shift-click, double/triple-click word/line/paragraph selection) to a NSView with a set of NSGestureRecognizers rather than overriding NSEvent mouse methods. NSTextView now uses NSTextSelectionManager and provides its own set of NSGestureRecognizers to provide additional features in addition to text selection. Existing NSTextView subclasses that override mouseDown: continue to work through a binary-compatible fallback path. (163365571)
• In macOS 27.0, menu bar and context menus present a reduced set of menu item images, similar to the behavior prior to macOS 26.0. By default, NSMenu hides all menu item symbol images — non-symbol images remain visible. For menu items created from a xib file, NSMenu also observes the value of the “macOS 26.0 only” checkbox in the menu item inspector. If this checkbox is unchecked, the menu item image remains visible; if checked, it is hidden. These changes in menu item image visibility apply to applications linked on macOS 26.0 and later. Review the updated Human Interface Guidelines to determine which menu items in your app should still display images. Use the new preferredImageVisibility property on NSMenuItem to customize the image visibility for your menu items. As in macOS 26.0, NSMenu automatically provides default visible menu item images for certain common system-wide menu items, such as Settings, Share, and Print. (170477566)

Resolved Issues
• Fixed: In apps built with the macOS 27.0 SDK, setting allowedContentTypes and treatsFilePackagesAsDirectories on NSOpenPane updates can Choose Files and can Choose Directories based on whether the requested types are file or directory types. (6938919)
• Fixed: Keyboard focus and tab order in expanded and collapsed open/save panels might not traverse all fields and controls — including the accessory view — in the expected order. (43112307)
• Fixed: The Web Safe Colors list displays incorrectly in right-to-left layout. (107870015)
• Fixed: Subclasses of NSTextContentManager cannot be instantiated due to internal class-cluster initialization assumptions, preventing apps from defining custom content managers. (115247760) (FB13146578)
• Fixed: An NSTextField configured as selectable but not editable draws its text outside the field’s bounds when text truncation is enabled. (118196071) (FB13354582)
• Fixed: NSAlert buttons erroneously allow bezel Color customization. (132024038)
• Fixed: When an allowed file type has multiple valid extensions — for example, .htm and .html — NSSavePanel appends additional file extensions to the saved filename. (140307283)
• Fixed: NSScrollView displays the system scroll edge effect when the scroll view has no visible scrollers. (159019809) (FB19853927)
• Fixed: An NSSegmentedCell draws incorrectly under the Liquid Glass appearance, with the control rendering at the wrong location. (168066807) (FB21616308)
• Fixed: A subclass of NSSegmentedCell that overrides label drawing does not take charge of drawing labels, with the system drawing the default labels instead. (169126818) (FB21791717)
• Fixed: When full keyboard navigation is off, the keyboard loop might not traverse the correct fields and controls. (169837566)
• Fixed: An NSTextField whose text Color is set to nil displays inconsistent text colors while in editing mode. (175095850) (FB22546245)
• Fixed: -[NSFilePromiseReceiver receivePromisedFilesAtDestination:options:operationQueue:reader:] asserts that it is called during -prepareForDragOperation:, -performDragOperation:, or -concludeDragOperation:. If receivePromisedFilesAtDestination... is called at other times, your application will throw an exception and terminate. (176048351)
• Fixed: The base NSGestureRecognizer implementation of locationInView: previously returned the current mouse location converted into the view’s coordinate system, which is incorrect for touch-driven gestures. It now returns NSZeroPoint and logs an error pointing the developer at the missing override. Custom NSGestureRecognizer subclasses must provide their own locationInView: implementation. (176395420)

Known Issues
• NSClickGestureRecognizers with a click count greater than 1 might improperly allow NSClickGestureRecognizers with a click count of 1 in an ancestor view to send an action before their multi-click timeout has elapsed. (173975472)

Apple Intelligence Report
Known Issues
• When you view Apple Intelligence Report entries for Home Intelligence, some data that was sent to Private Cloud Compute won’t appear in the report. (176056930)

Apple Unified Logging System
New Features
• Unified Logging System archives generated on 27.0 releases cannot be read on macOS 26.1 or earlier due to an updated archive format. macOS 26.2 or later is required to read these archives. (160567675)

Automatic Assessment Configuration
New Features
• You can now use a more flexible and granular Automatic Assessment Configuration in macOS 27, giving you greater control over your testing environment with controls for the Dock, Menu Bar, and accessibility settings, plus built-in system pre-checks and app launch restrictions. (158132137)

Background Assets
New Features
• You can reduce your app’s storage usage with localized asset packs. The system delivers the appropriately localized asset packs based on the user’s preferred languages. (163944365)

Core AI
Known Issues
• AIModel Cache entries might not honor the cache policy you provide, causing re-specialization to occur more often than expected. (169746264)
• When inference runs on the GPU, InferenceFunction.encode blocks until all compute is complete instead of returning as soon as encoding is done, unless the model is specialized with a preferred compute device of GPU. (175789258)
• Certain weight and activation configurations may not run on the Neural Engine, such as FP8-quantized weights and activations, palettized weights with quantized (non-Float16) values, and sparse weights. Affected models may run on the CPU or GPU instead. (176210080)
• When you run InferenceFunction.run on functions with both state arguments and outputs with dynamic shapes, the framework might be unable to infer the shape of the outputs and throw an error. (176807213)
Workaround: If you know what the output shape will be, pre-allocate the output and provide it through the outputViews arguments on InferenceFunction.run.
• Inference might fail or crash for models with control flow over dynamic-shape tensors (for example, linear-attention LLMs such as Qwen3.5/3.6). (177354777)
• Ahead-of-time (AOT) compilation might fail unexpectedly for certain models. (177729331)
• When Metal API Validation is enabled, CoreAI models might fail to execute. (177991751)
Workaround: In Xcode, disable Metal API Validation. From the command line, ensure the MTL_DEBUG_LAYER environment variable is not set.
• Models with custom Metal kernels will fail to load. (178056451)

CoreStorage
Deprecations
• Encrypted HFS+ (CoreStorage) is deprecated and will not be supported in a future version of macOS. If you use Encrypted HFS+ backups on external drives, begin backing up to encrypted APFS-formatted external drives instead. (175892420)

Deprecation Information

New Features
• Intel-based applications that will no longer run in macOS 28.0 now display a treatment in Get Info. (169548657)

Disk Images
New Features
• The new DiskImageKit framework provides Swift APIs for creating and managing standalone and stacked disk images in the Apple Sparse Image Format (ASIF) and raw disk image formats, for use with the Virtualization framework via VZDiskImageStorageDeviceAttachment. See DiskImageKit for more information. (177868758)

Dock
Known Issues
• While using an app in full screen, the Dock might persist when entering and exiting Mission Control. (174992242)

Drag and Drop
Resolved Issues
• Fixed: When you call enumerateDraggingItemsWithOptions:... during draggingSession: willBeginAtPoint:, the returned NSDraggingItem might have an incorrect draggingFrame value. (177839494)

EcosystemUI
New Features
• Settings > General now lists Intel-based apps that will be incompatible with macOS 28.0. The list also identifies unused Intel-based software discovered on the system. The system might suggest a website where an Apple silicon native version can be found for a listed app. (175697313)

Known Issues
• The Intel-based apps view might unexpectedly display “Additional components” when the primary app is not native. (175781938)
• Intel-based apps might appear erroneously in the unsupported apps list with the entry “Steam Game”. Games should not appear in this list, and the “Steam Game” entry can be safely ignored. (177192993)

Finder
Known Issues
• Suggested names for a file or folder might be more generic than its contents. For example, a folder containing only bird photos might receive suggestions like “Wildlife” or “Animal Photos” rather than bird-specific names. (178093786)

First-Party App Search
Known Issues
• Search assets might download slowly for languages and regions other than English and the United States, causing degraded search experiences for first-party apps up to a few hours after you install or upgrade to the latest OS, change your device language, or region. (178186226)

Foundation
Resolved Issues
• Fixed: +[NSURL URLWithString:] no longer double-encodes the % of valid percent-escape sequences when encoding other invalid characters. (161588649) (FB20439045)

Foundation Models
Known Issues
• When using the on-device Apple Foundation Model for both tool calling and guided generation, some prompts might cause the model to call tools excessively. (177748926)
Workaround: Adjust your instructions, prompts, and attachment labels.
• @Generable on an enum produces a deprecation warning about GenerationError that cannot be silenced. (177899620)
• Truncating transcript history in the onPrompt modifier might cause an unexpected runtime error. (177901494)
• onPrompt might not be called when applied to a Profile without instructions. (177902488)
Workaround: Always specify instructions in a Profile.
• Private Cloud Compute Language Model always uses greedy decoding. (178181782)
• Passing an any Language Model to the model(_:) modifier will lead to a compiler error. (178545978)
Workaround: Import the Foundation Models framework utilities package, which contains a built-in workaround that will compile your code.

Game Center
Resolved Issues
• Fixed: When you trigger the Access Point, it’s completion handler is never invoked. (172683368)

Game Controller
New Features
• The PlayStation® Access™ controller is now supported on macOS, iPadOS, and iOS. You can create custom input profiles in game controller settings and save them to your Apple device. (168071382)

Resolved Issues
• Fixed: Modifications to the game controller lightbar (GCController.light) may persist after your application no longer has focus. (163514369) (FB20846101)

Gaming
New Features
• A new command line tool lets you enable support for legacy Intel-based games during beta releases. To enable it, run the following command in Terminal:
sudo game-test-tool enable
. Restart your Mac computer for the change to take effect. Once enabled, games run transparently through the new underlying system behavior. Note that enabling legacy game support disables Rosetta, non-game processes might crash or behave unexpectedly, and this feature is intended only for playing legacy Intel-based games and is not available outside of macOS beta releases. (166398727)

HomeKit
New Features
• When Apple Intelligence in the Home app is enabled, your HomeKit Secure Video recordings are processed on-device and through Private Cloud Compute for video descriptions and search. (178858470)

Image Playground
Known Issues
• When you try to generate an image using ChatGPT in the Messages extension on macOS, the image fails to generate. (174413381)
Workaround: Use ChatGPT within the Image Playground app
• In the Image Playground photo picker, the All and Suggested tabs are missing, which might limit the number of photos available for you to choose from. (178256174)

Launch Daemons and Agents
Known Issues
• launchd no longer supports loading launchd property list files with the quarantine extended attribute. (166415497)
Workaround: Remove the quarantine extended attribute from your launchd property list file. You can do this by obtaining a URL instance of the file by its path, retrieving the URL’s quarantine URLResourceValues by calling “resourceValues = url.resourceValues(forKeys: [.quarantinePropertiesKey])”, setting resourceValues.quarantineProperties = nil, and then updating the URL’s resource values by calling “url.setResourceValues(resourceValues)”

Mac Catalyst
Resolved Issues
• Fixed: Mac-Idiom Catalyst apps could not use UIStepper. (57819435)

Known Issues
• For some apps, the show/hide sidebar toolbar buttons are missing. (176879915)

Mail
Known Issues
• Smart Mailboxes might not update while you’re using Mail. (177768221)
Workaround: Smart Mailboxes will update while the device is locked and idle.

Mail Banners
Known Issues
• Mail banners for early flights will show the flight status as delayed. (173869986)
Workaround: Confirm flight status through the track flight action, flight change email communication, or the flight provider website.

Media Playback
Known Issues
• In apps like TV, Podcasts, and Music, the window controls may become unresponsive after dragging the playhead to adjust the playback position. (177984877)
Workaround: Use keyboard shortcuts or the menu bar to close, minimize, or enter full screen mode.

Messages
Known Issues
• GIFs and pasted images might render as the incorrect size. (177657977)
Workaround: Scroll until that message is offscreen, leave the conversation, or force-quit Messages.

Metal
New Features
• Metal 4.1 is now supported. See Metal for additional details. (176468465)

Known Issues
• When you use a sampler to read from a texture with clamp-to-edge addressing mode, the result might be clamped to zero. (172520325)
• On devices in the Apple 10 GPU family, using a sampler to read from a texture with clamp-to-edge addressing mode might produce results that are clamped to zero. (177318505)

Music | macOS
Known Issues
• Music Visualizer shows a black screen in both full screen and window mode. (177480780)

Network Security
New Features
• Starting in 27.0 operating systems, select system processes now enforce stricter network security (TLS) requirements. These new requirements might cause connections to fail if the server does not meet them. The affected processes are those involved in MDM, DDM, Automated Device Enrollment, configuration profile installation, app installation, and software updates. Servers must support TLS 1.2 at minimum, using cipher suites and certificates that meet App Transport Security (ATS) requirements.
For additional details on affected processes, requirements, and how to audit and diagnose failures in managed environments please reference Prepare your network environment for stricter security requirements. For additional details on ATS and the new requirements please reference Preventing Insecure Network Connections and NSRequiresNIAPTLSPackageVersion. (176055825)

News
Known Issues
• The News app crashes on launch when configuration profiles are installed. (177972625)
Workaround: Remove configuration profiles from your Mac. If you can’t remove a configuration profile, ask for help from the person who provided the profile.

NSApplication
New Features
• NSApplication.presentationOptions now includes the .disableScreenCornerInteractions option, which you can use to disable Hot Corners. (168692527)

NSGestureRecognizer
New Features
• A new cancellableByScrollGesture property on NSGestureRecognizer allows gesture recognizers to be automatically cancelled when the enclosing scroll view is panned. (165650612)
• Only the initial hit-tested view hierarchy will activate gesture recognizers until all gestures terminate. A new exclusiveGestureBehavior property on NSView allows you to opt-out of this exclusive behavior on a per-view-hierarchy basis. Further, the Info.plist key NSViewGestureRecognizerIsExclusive allows you to opt-out for the entire app. Additionally, a new Info.plist key NSGestureRecognizerSuppressesMainMenuActions allows main menu actions to be invoked while gesture recognizers are active. (173551081)
• To prevent exclusive gestures from making apps unresponsive, stuck gestures are automatically cancelled after user input has ended for a few seconds. A new user default, NSCrashOnStuckGestureTimeout, allows you to crash your app when this condition occurs, to aid in debugging. (175705302)
• A new diagnostic user default NSGestureRecognizerCrashOnMissingOverrides is provided to help developers find NSGestureRecognizer subclasses that are missing required overrides to ensure that they always reach a terminal state. Even without this gesture set, AppKit will produce error messages in the console to alert developers when such cases are found. (176396492)

NSScrollView
New Features
• New properties on NSScrollView allow you to constrain the number of touches needed to scroll. The new scrollGestureForFailureRelationship property allows you to set up gesture relationships against scrolling gestures. (164924201)

Photos Edit
Known Issues
• A thin white line might be visible in photos that have had Spatial Reframing applied. (178183850)

Physical surroundings light
Resolved Issues
• Fixed: An App might crash if the Surroundings Light component is added to more than 8 light entities. (178092354)

Preview & Spatial Preview
Known Issues
• When spatial previewing USDZ assets larger than 75MB in Preview or using the Spatial Preview API, edits made on Mac or Apple Vision Pro might not sync to other devices. (178168374)
Workaround: Extract the USDZ asset into a directory and spatial preview the root USDA or USDC file. Alternatively, decimate the asset to 75 MB or smaller.

Preview & Spatial Preview Adopters
Known Issues
• When Device Discovery UI is invoked via the Spatial Preview API, it might show nearby Apple Vision Pro devices running an older release. Selecting a device running an older release causes Spatial Preview to fail. (156180612)
Workaround: Update both macOS and visionOS to the latest beta version on all devices.

Preview and Quick Look
New Features
• Preview and Quick Look have added support for RealityKit as the scene renderer for USD and other 3D scenes that were previously rendered by Storm. (176839273)

Previews
Known Issues
• When you drag an annotation in a 3D document, such as a USD file, and release the mouse button, the cursor might remain in the open-hand state instead of returning to the arrow cursor. (177754200)
Workaround: Move the cursor outside the 3D viewport — for example, over the sidebar, inspector, toolbar, or outside the window — to reset it to the arrow cursor. Pressing the keyboard shortcuts Option-W, Option-E, or Option-R to change the active 3D tool also resets the cursor.

RealityKit
New Features
• The Gaussian Splat Component API in RealityKit will be available in an upcoming release. (178061856)

Resolved Issues
• Fixed: When Opacity Component is applied to an entity with opaque materials, Reality Renderer renders the opaque materials with transparency, revealing interior surfaces. Only the frontmost surface should appear with partial transparency. (177976245)

Known Issues
• Some MaterialX 1.39 nodes are not supported. (172875414)
• Compute Graph Components stored in a Reality file do not render when loaded. (177674901)

Rosetta
Deprecations
• If Rosetta was previously installed, it is not automatically restored after upgrading to macOS 27.0. (163213094)
• Installer packages which specify no host Architecture will now default to arm64. Ensure any pre and post install scripts behave as intended under arm64. Additionally, audit any remaining installer plugins to ensure compatibility on Apple silicon. (171187112)
• Intel-based plugins and loaders may not appear in Settings or trigger notifications of their incompatibility. All Intel-based software will no longer be compatible with macOS 28.0, excluding legacy games.
Check common plugin locations for VSTs, HAL, ARA, PDEs, Color Pickers, Quicklook & Spotlight plugins/extensions/components, such as: ~/Library/Audio/Plug-Ins/* ~/Library/Printers/ ~/Library/ColorPickers/ (176042635)

Safari
Known Issues
• Selecting “Rename” or “Edit Address…” from the context menu in the sidebar has no effect. (177470803)
Workaround: To edit bookmarks, use the bookmarks view by choosing Bookmarks > Edit Bookmarks.
• Safari Intelligence features might appear as available before assets are fully downloaded. If you use the feature before assets are available, it won’t function correctly. (178099724)
Workaround: Wait for assets to finish downloading. You can check download progress in Settings > Apple Intelligence & Siri.

Setup Assistant
Known Issues
• Setup Assistant might remain on screen after you configure a new user account. (175787760)
Workaround: Restart Mac and log back in.

ShaderGraph
Known Issues
• The realitykit_hair_surfaceshader node does not support Diffuse Light Probe Group Component. Materials built with this node might not respond to diffuse light probe group lighting. (177976666)

Shortcuts
Known Issues
• If an app intent uses Duration or LPLinkMetadata, creating a shortcut with that intent and then attempting to edit it with “Describe a change” might fail. (166068090)
Workaround: If the model discards the action, press “Undo” to recover the unsupported intent.
• When an app intent defines a Union Value parameter with two number-related types (for example, both Int and Double), the number option appears twice in the parameter picker menu and shows as double-selected. (168315587)
Workaround: Define only one number-related type in the Union Value parameter (for example, use only Int or only Double, not both).

Siri
Known Issues
• After Siri returns photo search results and you select photos, Siri might not detect which photos are selected on screen. Commands like “Send these” might apply to all photos returned from the search rather than only the selected ones. (171728298)
Workaround: Open Photos, select the photos you want to act on, then perform the action using Siri — for example, “Send these photos to Bob”.
• Siri cannot find albums in Photos on macOS. (172713904)
• When you ask Siri to start navigation using AMap, Tencent Maps, or Baidu Maps on Mac, navigation might not start. (174911042)
• Siri ignores custom values for navigation preferences, transport, and incident types in apps that use maps.startNavigation or maps.reportIncident intent schemas. (175230813)
• When location data is unavailable or only coarse-accuracy location data is available, Maps searches initiated through Siri might return empty or imprecise results. (175380461)
Workaround: Grant Siri access to your location in Settings.
• When you turn off Siri, some photo-related questions might return web search results instead of prompting you to share the photo with ChatGPT. (175884006)
• “Ask Siri” might appear in context menus on macOS even when Siri is disabled in System Settings or the system is in a region that does not currently support Siri. (176299524)
• When you ask Siri to work with reminder lists, you might need to use the exact list name. Siri might not recognize similar or partial list names. (176400964)
Workaround: Use the exact name of your reminder list when speaking or typing to Siri.
• Siri doesn’t support voice commands to interact with specific photos. For example, you can’t refer to photos by number, such as “photo one” or “photo four.” (176812955)
Workaround: Use the photo picker to select the photo you want, or tap to select photos directly.
• App Intents with @Union Value types that accept a Place Descriptor Entity and a String always receive String values instead of Place Descriptor Entity entities. (176844035)
Workaround: Include a String case in your @Union Value enum and manually convert the String to a Place Descriptor Entity when needed.
• When you ask Siri for Maps information, the response snippets might appear incomplete or display formatting issues. (177116121)
Workaround: Ask Siri to repeat the information, or open Maps directly for complete details.
• Starting a call with Siri might fail with an error in apps that adopt CallKit and the phone.startCall AppSchema. (177190637)
• When you ask Siri to send a message to a contact that doesn’t exist on your device, Siri might draft a message to an unrelated contact. (177356158)
• When you ask Siri to add photos to an album, the confirmation prompt and spoken response might report or display more photos than will actually be added. (177376984)
Workaround: Add photos to the album manually in the Photos app: tap Select, tap the photos you want to add, tap the Share button, tap Add to Album, then tap the album.
• You might not see names and images of email senders in the Siri email list UI. (177416168)
• Siri might not resolve some entity types when your app has provided only an Entity String Query for the entity type. (177464215)
Workaround: Index the entity in Spotlight, or provide an Intent Value Query if applicable.
• Siri functionality during software updates is limited, including calls to emergency services. (177476889)
• Asking Siri to call short phone numbers, such as “Call 17”, might fail. (177545828)
Workaround: When calling for emergency services, ask Siri to explicitly “call emergency services.”
• Cannot click on Notes in Siri responses on MacOS. (177634308)
• Disabling Siri might not delete your Siri and Dictation interaction history from your device. (177649865)
• Siri might not find app-specific contacts that are only indexed in Spotlight and do not appear in the Contacts app. (177679168)
Workaround: Add the contact to the Contacts app.
• Siri cannot create a recurring reminder or update an existing reminder to be reoccurring. (177722240)
• When you use ChatGPT with Apple Intelligence, some responses used in follow-up queries or when you resume a chat might be logged by Apple. (177755742)
• When you ask Siri to find, search, or read reminders, Siri might list or read the reminders instead of showing a snippet. When reminder lists are displayed, the list color might not appear correctly. (177762533)
• Non-SF Symbol custom images for entities might not appear in Siri results for third-party apps. (177984074)
• Siri might run the incorrect Open Intent or system.open intent when multiple intents targeting different entity types are available in your app. (177992979)
• When you tap the Send button in the Siri message confirmation flow, the message might fail to send. (178025056)
Workaround: Use your voice to confirm sending the message instead of tapping the Send button.
• When asking Siri to call, message, or email a contact, Siri might fail to resolve the correct person — particularly when multiple contacts share the same name, when group names contain emoji or special characters, or when relationship labels (e.g., “my brother”) are ambiguous. In some cases, Siri might pick the wrong contact, fail to present a disambiguation prompt, or freeze during the disambiguation UI. (178379209)
Workaround: If Siri selects the wrong contact, try using the person’s full name (first and last) or specifying the contact handle directly.
• Businesses with overnight hours might display as “Closed till [next day]” even during open hours. (178384054)
• Siri might not respond to your voice correctly. (178489724)
Workaround: Force quit the Siri app and relaunch it.
• In the Siri app, conversations might be deleted a few minutes after receiving streaming responses. (178560562)

Software Update
Known Issues
• Background Security Improvements cannot be installed when your startup disk is an external storage device. (174428921)
• Devices configured with Reduced Security mode might fail to install macOS 27 beta 1. Devices in this mode might also be prevented from allowing kernel extensions or disabling System Integrity Protection. (178942816)
Workaround: Restore the device’s security mode to Full Security via Recovery OS and retry the update. See this page for details.

Spatial Preview
Known Issues
• Some large 3D models with poor mesh connectivity of approximately 750,000 to 3.75 million triangles might not appear when previewing on Apple Vision Pro. (174366004)
Workaround: Use a simpler version of the asset with reduced triangle count and material complexity.

Startup Disk
Known Issues
• When a Mac is running macOS 11.0, you might not be able to select the boot volume of macOS 27.0 or later as the startup disk in System Settings. (166640903)
Workaround: Shut down your Mac, press and hold the power button until “Loading startup options” appears, then select the boot volume of macOS 27.0 or later.

StoreKit
New Features
• Offer code redemption APIs now return a VerificationResult when redemption completes. If a redemption succeeds, your app receives a VerificationResult that contains a Transaction object. If a redemption fails, your app receives an error that describes what caused the redemption to fail. (141012819)
• StoreKit now includes the Transaction.OwnershipType.assigned and Transaction.RevocationType.assignmentRevoked enum values to support volume purchases. Transaction query methods now additionally return transactions assigned to the Managed Apple Account. (156749517)
• New Product.ProductType APIs represent subscription Bundles and subscription Suites. New APIs in Product.SubscriptionInfo.BundledSubscription let you fetch merchandising data about subscriptions contained in a Bundle. Transaction and RenewalInfo contain new fields that provide information about purchases and customer status regarding Bundles and Suites. (160501742)
• partnerName and partnerId properties for Advanced Commerce API are available in Transaction.AdvancedCommerceInfo and RenewalInfo.AdvancedCommerceInfo. (167808780)

StoreKit Testing in Xcode
Resolved Issues
• Fixed: The unified app receipt is not updated after forcing a subscription expiration with SKTestSession. (102093015) (FB11767567)
• Fixed: The SKTestSession disableDialogs setting is not always respected for all system dialogs. (154390284) (FB18403150)
• Fixed: Subscription upgrades performed with the Xcode Transaction Manager are not reported in Transaction.updates. (160698598) (FB20269723)
• Fixed: The renewal behavior preference is not respected when using the purchaseDate(_:renewalBehavior:) purchase option to make purchases using SKTestSession. (162014134) (FB20537538)

Known Issues
• When using StoreKit Testing in Xcode on Mac, calls to Transaction.requestRefund() fail, and AppStore.presentOfferCodeRedeemSheet(from:options:) targets the sandbox environment instead of StoreKit Testing. (173406202)
• When using StoreKit Testing in Xcode, pricingTerms.commitmentInfo.price returns an incorrect price for monthly subscriptions billed as a 12-month commitment. (177942756)

Swift Charts
Known Issues
• When your project has a minimum deployment target lower than 27.0, using conditionals inside a Chart closure produces the warning “Conformance of ‘_ConditionalContent<TrueContent, FalseContent>’ to ‘ChartContent’ is only available in 27.0 or newer,” and the app might crash at runtime when that content is loaded. (174168981)
Workaround: Extract the conditional chart content into a separate function or computed property annotated with @ChartContentBuilder.

SwiftData
Known Issues
• You might experience a deadlock for @Query when saving a Model Context on a background actor while scheduling new async tasks for a Model Actor. (178113288)

SwiftUI
New Features
• AsyncImage now automatically caches downloaded images using HTTP caching protocols, allowing servers to control caching behavior via standard headers. You can customize caching for specific images using the new AsyncImage initializers that accept URLRequest with custom cachePolicy settings. Additionally, you can set a custom URLSession using the new View.asyncImage URLSession(:) API to control how all child AsyncImage views perform data tasks. (78212597)
• A @State declared with an expression as its initial value used to evaluate the expression each time the view struct re-instantiates. In the case of @State private var model = Model(), this means Model.init() gets called many times throughout the view’s life time. Xcode 27 introduces a new @State implementation that avoids this repeated evaluation. This new behavior back-deploys to iOS 17 aligned OSes. The new @State is implemented with a Swift macro. It is largely source compatible with the property wrapper version, with a few exceptions.
If you provide an initial value at @State declaration, and also try to assign a value to it in an initializer, the initializer value is discarded. This behavior has not changed because of the macro, but some such cases no longer compiles.
When assigning initial value via an initializer, do not provide an initial value at the @State declaration.
When all stored member of a struct is private, the compiler synthesizes a private init that can be used in extension of the same type. The state macro disables this synthesized initializer. So the code above no longer compiles. To mitigate, assign value to members explicitly.
In rare situations, the automatic inference of generic argument of @State is less flexible with the macro implementation. Write the type with more specificity.
Composing @State with other property wrappers or macros is not supported. (105893279)
• In apps built with the iOS 27.0 and macOS 27.0 SDKs, selectable Text views now support TextRenderer. (158160386) (FB19589465)
• In apps built with the 27.0 SDKs, the new Readable Document and Writable Document protocols support asynchronous reading and writing, progress reporting, and direct access to document URLs. New DocumentGroup initializers that adopt these protocols let you disable document creation for editing-only apps and present custom UI before any document is opened. The initializers expose an Observable URLDocumentConfiguration and integrate with Swift concurrency and the Observation framework. New applications should prefer Readable and Writable Document over Reference File Document, which remains available. (158441552)
• The menu bar on iPadOS 27.0 and macOS 27.0, as well as context menus on macOS 27.0, present a reduced set of menu item images. By default, SwiftUI now hides all menu item symbol images in most contexts, while non-symbol images remain visible. Review the updated Human Interface Guidelines to determine which menu items in your app should still display images. Use the labelStyle(:) view modifier with the .titleAndIcon style to indicate that a menu item Label’s icon should always be shown — such as when the menu item represents an object or a concept rather than an action. SwiftUI continues to automatically provide default visible menu item images for certain common system-wide menu items, such as Settings, Share, and Print. (170480710)
• In apps built with the latest SDKs, the appearance of Tab Views in inspectors now matches their appearance in sidebars, and in both contexts automatically uses the new .tabs picker style. (170678002)
• Disabled Toggles using the .checkbox style are no longer tinted in macOS, so you can more easily distinguish them from their enabled state. (172689844)
• The Tabs Picker Style is now available for pickers that represent tab-based navigation and content selection. This style is similar to the .segmented style, but VoiceOver reads it as “tabs,” and on macOS it has a distinct visual appearance that distinguishes it from pickers that represent value selection — for example, a text alignment picker in an inspector. (173211711)
• On macOS, the Slider implementation no longer uses NSSlider. (173990195)
• In apps built with the 27.0 SDKs, a Labeled Content view used inside a Menu maps its value to the platform menu item’s subtitle. (175594929)

Resolved Issues
• In apps built with the macOS 27.0 SDK, Text Field respects custom font and color styling applied to its prompt. Apply styling to the Text provided to Text Field’s prompt parameter at initialization. (86580365)
• Fixed: A custom Text Renderer applied via .textRenderer(:) now takes effect on a Text view that also has .textSelection(.enabled) applied. Previously, the custom renderer was dropped on selectable text, falling back to default rendering. (151015350)
• Fixed: When you apply both .fileExporter(:...) and .fileMover(:...) modifiers to a view, some dialogs might not present correctly. (154080867)
• Fixed: In macOS, buttons using the .glass and .glassProminent styles don’t display a hover state when used outside of a toolbar. (158800693)
• Fixed: In apps built with the 27.0 SDKs, the control Size, button Sizing, button Repeat Behavior, menu Indicator Visibility, and Button Border Shape environment values are not reset to their default values in sheets and popovers. (167448274)
• Fixed: Dual-axis scroll views align to .center instead of the .topLeading unit point, which disagrees with documentation. Additionally, specifying .default Scroll Anchor() on dual-axis scroll views results in incorrect placement. (171755081)
• Fixed: On macOS, a Menu composed with a .plain or custom button style uses the AXDescription (Label) attribute instead of the AXTitle attribute. (171831601)
• In macOS apps built with the macOS 27 SDK, List accepts drops in two cases that previously didn’t work: drags with compatible transfer representations are accepted into reorderable content even when the .reorderable Item transfer type isn’t present, and a .drop Destination(...) modifier declared on a list item now performs the drop. These behaviors match the existing iOS List behavior. (174628712)

Known Issues
• Progress reported in Document Reader.read(from:progress:) and Document Writer.write(snapshot:to:previous:progress:) might not be presented. (158441261)

System
New Features
• System now provides Swift APIs for the C stat, lstat, fstat, and fstatat system calls. This includes a new Stat type with initializers from FilePath, FileDescriptor, or a C string; FilePath.stat() and FileDescriptor.stat() instance methods; and supporting types (FileType, FileMode, Flags, UserID, GroupID, DeviceID, and Inode). See SYS-0006 for more details. (160612181)

Known Issues
• Custom FilePath or FileDescriptor extensions that make unqualified calls to stat() or stat(_: :) (without the Darwin. qualification) might conflict with the new Swift stat() instance methods introduced in SYS-0006, causing build errors. (177911316)
Workaround: Migrate to the new Swift stat() methods, or disambiguate using Darwin.stat() and Darwin.stat(: _:). See SYS-0008 for more details.

System Integrity Protection
New Features
• Accessing files in other developer teams’ app data containers and app group containers no longer prompts the user for authorization; such accesses are denied by default and can be managed by the user in Privacy & Security settings. (161835690)

TCC
Deprecations
• Apps can no longer access the local TCC database directly. (90775556)

Thunderbolt
Known Issues
• When connecting to two identical displays (same model and serial number), the first display will work as expected whereas the second display might not light up. (176292156)

UIKit
New Features
• When linked on iOS 27, tvOS 27, macCatalyst 27, or visionOS 27 SDKs, you can use UIScene.extendStateRestoration and UIScene.completeStateRestoration to extend state restoration for UIScene.ActivationState.background to UIScene.ActivationState.foreground lifecycle transitions. (161843040)
• On iOS 27.0 and iPadOS 27.0, Siri can load resources from drag interactions installed in your app’s interface. For example, when Apple Intelligence is invoked from a context menu, the system calls UIDragInteractionDelegate methods to load the content. Because drag sessions might begin without a user-initiated drag gesture, avoid performing animations or presenting modal UI for the drag in dragInteraction(:sessionWillBegin:). Instead, perform those actions in dragInteraction(:sessionDidMove:). (168884200)
• On iPadOS 27.0 and macOS 27.0, the menu bar and context menus present a reduced set of menu item images and do not display images set on menu elements by default. You can use the new preferredImageVisibility property on UIMenuElement — including updated initializers on UIMenu, UIAction, UICommand, and UIKeyCommand — to customize the visibility of each element’s image in these menus. Review the updated Human Interface Guidelines to determine which menu elements in your app should display images. UIKit automatically provides default visible menu element images for certain common system-wide menu items, such as Settings, Share, and Print. (170479084)

Resolved Issues
• Fixed: The UIMenuLeaf protocol is missing the subtitle property introduced in iOS 16.0. (173271862)

Known Issues
• The UIScene Closure Confirmation API does not present a confirmation dialog. (170008344)
• Catalyst views that have both UIDragInteraction and UIContextMenuInteraction do not allow you to activate both interactions with touch. (175048540)

Deprecations
• Apps built with the latest SDK must adopt the scene-based life cycle or they fail to launch. For migration guidance, see Transitioning to the UIKit scene-based life cycle. (141837548)

USDKit
Known Issues
• Some types of USD attributes cannot be read or modified. (170653056)
• Array, vector, matrix, and quaternion types cannot be authored using USDKit. (178071414)

VideoToolbox
New Features
• VTLowLatencySuperResolutionScalerConfiguration now supports a 1.5x scale factor. Call +supportedScaleFactorsForFrameWidth:frameHeight: to discover the scale factors available for your source dimensions. (177635243)
• VTLowLatencyFrameInterpolationConfiguration now supports arbitrary source dimensions up to 1080p. (179040806)

Virtualization
New Features
• The vmnet port forwarding APIs now support port forwarding when communicating over loopback. (64203273) (FB7731708)

Known Issues
• Saving a virutal machine state with one or more USB devices passed through to a virtual machine may fail. (174267926)
Workaround: Disconnect any passed through USB devices before saving the state of a virtual machine.
• If an App uses Accessory Access framework within a Virtualization framework to launch a virtual machine, and if you assign both the Apple Keyboard (A1242 or A1243) and Apple Mouse (A1152) to that app and subsequently un-assign the mouse, then the virtual machine might crash. (174794802)
• A virtual machine might crash during restore if a USB mass storage device was hot-plugged before the virtual machine was saved but is not attached during the restore. (177528319)
• AAUSBAccessoryManager registerListener:withMatchingCriteria:completionHandler: does not work with a non-empty matching criteria array. (177662539)
Workaround: Use an empty matching criteria array to listen for all USB devices and filter manually.

Weather Highlights
Known Issues
• Weather Highlights is currently only available in US English. (164408676)

Window Management
Known Issues
• When you exit a window from fullscreen mode using Mission Control, the window might be lost. (177660206)
Workaround: Switch to the fullscreen window’s space first, then click the green button to exit fullscreen mode.

Writing Tools
Known Issues
• Writing Tools on macOS might stop working after you use Describe Your Change. (174926739)
Workaround: Restart your Mac, or force quit Writing Tools using Activity Monitor.

xnu
Resolved Issues
• Fixed: Launch binaries larger than 2GiB might fail. (134346968)

Original source

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

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

AirPlay
Known Issues
• AirPlay to Home Theaters fails when a PIN or password is required. (176462871)
Workaround: Disable the Home Theater configuration.

AirPods Max 2
Known Issues
• You cannot update AirPods Max 2 firmware beta in iOS 27 Beta 1 and macOS 27 Beta 1. AirPods Max 2 firmware beta updates are supported in iOS 27 Beta 2 and macOS 27 Beta 2. (178280323)

App Intents
Known Issues
• Non-SF Symbol custom images for app entities might not always appear in Siri. (175031314)
• Default values from schemas might not be applied for parameters that are of “Set” type. (175534195)
Workaround: Provide a default value explicitly using @Parameter, such as an empty set.
• Entities you register using Relevant Entities for the workout audio context might not appear as suggestions in Fitness media picker. (177996973)

Apple Intelligence Report
Known Issues
• When you view Apple Intelligence Report entries for Home Intelligence, some data that was sent to Private Cloud Compute won’t appear in the report. (176056930)

AudioAccessoryKit
New Features
• AudioAccessoryKit now allows third-party audio accessory manufacturers to provide headphone information to the system to support fixed spatial audio. It is only available for developer testing on iPhone and iPad in this release, and will be available to customers in the EU in a future iOS 27 and iPadOS 27 release. (178275661)

Background Assets
New Features
• You can reduce your app’s storage usage with localized asset packs. The system delivers the appropriately localized asset packs based on the user’s preferred languages. (163944365)

Battery / Power Management
Resolved Issues
• Fixed: Devices with a deeply discharged battery might fail to boot into the OS and remain stuck on the red dead battery icon screen indefinitely until the device is rebooted or the power adapter is unplugged and reconnected. (177346712)

Camera
Known Issues
• In the Camera app, Portrait mode blur effect might render incorrectly for photos. (177335723)

CarPlay
Known Issues
• CPNavigation Session ETA Tray panel items might not receive focus. (177508893)
• The panel delegate method panelDidHide(_ panel: CPMapPanel) might not be called. (177590525)
• Under certain configurations, CPMapPanel might not dismiss when you tap the close button. (177592347)
• The symbol button handler of CPMapPanelButtonConfiguration might not be called. (177595560)
• Your vehicle’s next and previous track steering wheel buttons might not function correctly in CarPlay. (177832695)
Workaround: Use the on-screen playback controls in CarPlay to advance or go back to the previous track.
• Siri might respond more slowly than expected in CarPlay, particularly under higher device temperatures or poor network conditions. (178952858)
Workaround: Try the request again after the device has cooled down or once you are in an area with better cellular reception.

Clock
Known Issues
• You might be unable to stop a ringing alarm from the lock screen without unlocking your device. (177728602)
Workaround: Unlock your device, or say “stop the alarm,” or say “stop music.”

Control Center
Known Issues
• The “Add a Control” button in edit mode might appear small and clipped. (170774279)

Core AI
Known Issues
• AIModel Cache entries might not honor the cache policy you provide, causing re-specialization to occur more often than expected. (169746264)
• When inference runs on the GPU, InferenceFunction.encode blocks until all compute is complete instead of returning as soon as encoding is done, unless the model is specialized with a preferred compute device of GPU. (175789258)
• Certain weight and activation configurations may not run on the Neural Engine, such as FP8-quantized weights and activations, palettized weights with quantized (non-Float16) values, and sparse weights. Affected models may run on the CPU or GPU instead. (176210080)
• When you run InferenceFunction.run on functions with both state arguments and outputs with dynamic shapes, the framework might be unable to infer the shape of the outputs and throw an error. (176807213)
Workaround: If you know what the output shape will be, pre-allocate the output and provide it through the output Views arguments on InferenceFunction.run.
• Inference might fail or crash for models with control flow over dynamic-shape tensors (for example, linear-attention LLMs such as Qwen3.5/3.6). (177354777)
• Ahead-of-time (AOT) compilation might fail unexpectedly for certain models. (177729331)
• When Metal API Validation is enabled, CoreAI models might fail to execute. (177991751)
Workaround: In Xcode, disable Metal API Validation. From the command line, ensure the MTL_DEBUG_LAYER environment variable is not set.
• Models with custom Metal kernels will fail to load. (178056451)

Core Bluetooth
Known Issues
• The Channel Sounding API in Core Bluetooth is not returning ranging results. (178333845)

Developer Settings
Known Issues
• Deep links into Settings > Developer > Paired Macs might silently fail to navigate to the target Mac computer. The Paired Macs pane loads correctly when entered manually. (178063365)
Workaround: Navigate to Settings > Developer > Paired Macs manually, then select the desired Mac computer from the list.

Dictation
New Features
• Dictation can now be powered by a new on-device model that will boost accuracy. To enable this, go to Keyboard settings > Dictation and Toggle on “Advanced Dictation Preview” (178444388)
Known Issues
• Voice Editing commands such as “Change X to Y”, “Delete X”, and “Undo/Redo” might not work reliably. (173448573)
• The “New Line” and “All Caps” formatting commands might not work reliably in the dictation UI. (177959708)
• When you explicitly dictate punctuation— such as “Period” or “Colon” — both the spoken command word and the punctuation character might be inserted instead of the punctuation character alone. (178078177)
• Dictation might not recognize names from your contacts. (178079519)
• Dictation might insert extra words at the end of a dictated passage that you did not speak. (178269104)

Finder
Known Issues
• Suggested names for a file or folder might be more generic than its contents. For example, a folder containing only bird photos might receive suggestions like “Wildlife” or “Animal Photos” rather than bird-specific names. (178093786)

FindMy
Known Issues
• Siri might not be able to find some of the people sharing location with you in FindMy. (178384345)

First-Party App Search
Known Issues
• Search assets might download slowly for languages and regions other than English and the United States, causing degraded search experiences for first-party apps up to a few hours after you install or upgrade to the latest OS, change your device language, or region. (178186226)

Fitness+
Known Issues
• On larger iPhones in landscape orientation, the Workout Detail view may display duplicate title text and action buttons when browsing workouts or meditations. (177964121)

Foundation
Resolved Issues
• Fixed: +[NSURL URLWithString:] no longer double-encodes the % of valid percent-escape sequences when encoding other invalid characters. (161588649) (FB20439045)

Foundation Models
Known Issues
• Private Cloud Compute might not work when you use simulators. (177684296)
Workaround: Use a physical device running OS 27.0.
• When using the on-device Apple Foundation Model for both tool calling and guided generation, some prompts might cause the model to call tools excessively. (177748926)
Workaround: Adjust your instructions, prompts, and attachment labels.
• @Generable on an enum produces a deprecation warning about GenerationError that cannot be silenced. (177899620)
• Truncating transcript history in the onPrompt modifier might cause an unexpected runtime error. (177901494)
• onPrompt might not be called when applied to a Profile without instructions. (177902488)
Workaround: Always specify instructions in a Profile.
• Private Cloud Compute Language Model always uses greedy decoding. (178181782)
• Passing an any Language Model to the model(_:) modifier will lead to a compiler error. (178545978)
Workaround: Import the Foundation Models framework utilities package, which contains a built-in workaround that will compile your code.

Game Center
Resolved Issues
• Fixed: When you trigger the Access Point, it’s completion handler is never invoked. (172683368)

Game Controller
New Features
• The PlayStation® Access™ controller is now supported on macOS, iPadOS, and iOS. You can create custom input profiles in game controller settings and save them to your Apple device. (168071382)

HealthKit
New Features
• HealthKit adds support for tracking menopausal state and bleeding after menopause; two new sample types are available. HKCategoryTypeIdentifierMenopausalState records a person’s current menopausal state. Values defined by HKCategoryValueMenopausalState are menopause, perimenopause, and none. HKCategoryTypeIdentifierBleedingAfterMenopause records bleeding episodes occurring after menopause. Values use the existing vaginal bleeding flow levels: unspecified, light, medium, and heavy. Both types are read/write, classified under Reproductive Health, and require the standard HealthKit category type authorization. (178532053)

Hearing Test
Known Issues
• During a Hearing Test, visual feedback might not appear when you tap the screen to indicate a tone was heard. (176360906)
Workaround: End the Hearing Test and start a new one. Note that ending a test in progress will not produce a result, which is the expected behavior. For general guidance on difficulties operating a Hearing Test, refer to the troubleshooting guide in the Instructions for Use.

Home Screen
Known Issues
• Switching between many different posters with different icon tints may cause system sluggishness. (178435221)
Workaround: Reboot the device.
• The Home Screen Customization on a newly setup device might not save. (178576719)
Workaround: Reboot the device and try again

HomeKit
New Features
• When Apple Intelligence in the Home app is enabled, your HomeKit Secure Video recordings are processed on-device and through Private Cloud Compute for video descriptions and search. (178858470)

Image Playground
Known Issues
• When VoiceOver is enabled and the gallery contains only one image, the prompt input UI might not appear. (175357842)
Workaround: Duplicate the image so the gallery contains two or more images.
• When Image Wand encounters an error — such as an unsupported flow or unsafe output — you might see the misleading message “Connect to Wi-Fi to create images” even when your device is already connected to Wi-Fi. (177710762)
• If required models are downloading, you might see an error message instead of download progress information. (177833994)
Workaround: This issue occurs only on first install. Wait for the models to finish downloading, then try again.
• In the Image Playground photo picker, the All and Suggested tabs are missing, which might limit the number of photos available for you to choose from. (178256174)

LDCM
Known Issues
• When your device’s charging port is wet but empty, you might see a dialog instructing you to unplug a charger or accessory even though nothing is connected. (175484509)

Lock Screen
Known Issues
• After dismissing Lock Screen, the Lock Screen grabber might appear in the incorrect location or orientation. (178174745)
• Starting a Vision Pro Guest Mode session might result in two Live Activities on screen at the same time. (178200601)
Workaround: Dismiss the Lock Screen and re-lock the device.

Mail Banners
Known Issues
• Mail banners for early flights will show the flight status as delayed. (173869986)
Workaround: Confirm flight status through the track flight action, flight change email communication, or the flight provider website.

Media Sharing Extensions
New Features
• New frameworks allow you to add media sharing protocols through extension at the system level and enable media apps to use these extensions through a common API framework. (168722808)
Known Issues
• Due to a mismatch in runtime checks with the mandatory entitlement for Media Sharing Extensions, extensions using the new Media Device Extension framework can build but don’t run on target devices. (178179521)

Messages
Resolved Issues
• Fixed: Stickers attached to a message from an unknown sender do not appear. (177453147)
Known Issues
• GIFs and pasted images might render as the incorrect size. (177657977)
Workaround: Scroll until that message is offscreen, leave the conversation, or force-quit Messages.

Metal
New Features
• Metal 4.1 is now supported. See Metal for additional details. (176468465)
Known Issues
• When you use a sampler to read from a texture with clamp-to-edge addressing mode, the result might be clamped to zero. (172520325)
• On devices in the Apple 10 GPU family, using a sampler to read from a texture with clamp-to-edge addressing mode might produce results that are clamped to zero. (177318505)

MetricKit
New Features
• Crash Diagnostic now includes a termination Category that maps to the corresponding case in Foreground Termination Metric and Background Termination Metric. (96078210) (FB10494149)
• Apps that emit developer-defined states through the State Reporting framework now receive metrics and diagnostics in the context of those states. (159889985)
• Memory Exception Diagnostic are available when your app or app extension is terminated for exceeding its memory limit. (159890067)
• A new application-level Metal Frame Rate Metric is available for Metal frame pacing rendering insights per CAMetal Layer. (159890165)
• A new Swift-first Metric Manager API enables your app to receive Metric Report and Diagnostic Report objects through Async Stream. Metric Report contains a daily aggregated entry along with interval-based breakdowns that are typically a few hours each. (164439529)

Deprecations
• The original MetricKit APIs — including MXMetric Manager, MXMetric Manager Subscriber, MXMetric Payload, and MXDiagnostic Payload — are no longer recommended for new adoption. Use Metric Manager instead. (174892111)

Nearby Interaction
Known Issues
• The Channel Sounding API in Nearby Interaction does not return ranging results. (178073051)

Network Security
New Features
• Starting in 27.0 operating systems, select system processes now enforce stricter network security (TLS) requirements. These new requirements might cause connections to fail if the server does not meet them. The affected processes are those involved in MDM, DDM, Automated Device Enrollment, configuration profile installation, app installation, and software updates. Servers must support TLS 1.2 at minimum, using cipher suites and certificates that meet App Transport Security (ATS) requirements.
For additional details on affected processes, requirements, and how to audit and diagnose failures in managed environments please reference Prepare your network environment for stricter security requirements. For additional details on ATS and the new requirements please reference Preventing Insecure Network Connections and NSRequires NIAPTLSPackage Version. (176055825)

NetworkExtension
Resolved Issues
• Fixed: When an active VPN configuration sets include All Networks to true, exclude Local Networks fails to exclude wired connections to CarPlay. (176839377)

On Demand Resources
Deprecations
• On Demand Resources and the NSBundle Resource Request API are deprecated. Use Background Assets instead. (170066290)

Photos
Known Issues
• When opened from a grid of Photos search results in Siri on iPadOS, the single-photo viewer might appear blank. (169236746)
Workaround: Close and reopen the viewer.
• You might see a slight shift in color hues after applying Spatial Reframing to photos. (176384327)
• When sharing a Live Photo from the Photos app, you might not be able to disable the Live Photo effect prior to sending. (178093956)
Workaround: Disable Live Photo effect from the Photos app before sharing.
• Photos app might quit unexpectedly when you re-enter the Extend tool on a photo that has already been extended. (178164434)
Workaround: From the Photos app or the editor, use “Revert to Original” to remove the existing Extend adjustment before re-entering the Extend tool.

Photos Edit
Known Issues
• A thin white line might be visible in photos that have had Spatial Reframing applied. (178183850)

Podcasts
Known Issues
• On first launch after updating, you might experience longer-than-expected library migration times, which might last several minutes. (175524004)
Workaround: Remain in the Podcasts app until the “Updating Library…” screen disappears and your Podcasts content appears, even if this takes several minutes.

RealityKit
New Features
• The Gaussian Splat Component API in RealityKit will be available in an upcoming release. (178061856)
Resolved Issues
• Fixed: When Opacity Component is applied to an entity with opaque materials, Reality Renderer renders the opaque materials with transparency, revealing interior surfaces. Only the frontmost surface should appear with partial transparency. (177976245)
Known Issues
• Some MaterialX 1.39 nodes are not supported. (172875414)
• Compute Graph Components stored in a Reality file do not render when loaded. (177674901)

Related Receipts
Known Issues
• The disclaimer “Siri found in Mail or Photos. Not shared with card issuer” does not appear below displayed transaction related receipts in Wallet for Apple Pay, Apple Card, and Apple Cash. (178202101)

Safari
Known Issues
• The Safari tab bar might enter a state where it does not appear on screen. (177812052)
Workaround: Quit and relaunch Safari.
• Safari Intelligence features might appear as available before assets are fully downloaded. If you use the feature before assets are available, it won’t function correctly. (178099724)
Workaround: Wait for assets to finish downloading. You can check download progress in Settings > Apple Intelligence & Siri.
• On iPad, the tip prompting users to automatically organize their tabs might not appear in Safari. (178280800)
Workaround: In the tab overview, tap the “…” button and choose Organize Tabs > Automatically Create Topics.

SensorKit
Known Issues
• PPG sensor reader might return no samples when attempting to fetch data. (178275291)

ShaderGraph
Known Issues
• The realitykit_hair_surfaceshader node does not support Diffuse Light Probe Group Component. Materials built with this node might not respond to diffuse light probe group lighting. (177976666)

Shortcuts
Known Issues
• If an app intent uses Duration or LPLink Metadata, creating a shortcut with that intent and then attempting to edit it with “Describe a change” might fail. (166068090)
Workaround: If the model discards the action, press “Undo” to recover the unsupported intent.
• When an app intent defines a Union Value parameter with two number-related types (for example, both Int and Double), the number option appears twice in the parameter picker menu and shows as double-selected. (168315587)
Workaround: Define only one number-related type in the Union Value parameter (for example, use only Int or only Double, not both).

Siri
Known Issues
• After Siri returns photo search results and you select photos, Siri might not detect which photos are selected on screen. Commands like “Send these” might apply to all photos returned from the search rather than only the selected ones. (171728298)
Workaround: Open Photos, select the photos you want to act on, then perform the action using Siri — for example, “Send these photos to Bob”.
• Siri ignores custom values for navigation preferences, transport, and incident types in apps that use maps.start Navigation or maps.report Incident intent schemas. (175230813)
• When location data is unavailable or only coarse-accuracy location data is available, Maps searches initiated through Siri might return empty or imprecise results. (175380461)
Workaround: Grant Siri access to your location in Settings.
• When you turn off Siri, some photo-related questions might return web search results instead of prompting you to share the photo with ChatGPT. (175884006)
• When you ask Siri to work with reminder lists, you might need to use the exact list name. Siri might not recognize similar or partial list names. (176400964)
Workaround: Use the exact name of your reminder list when speaking or typing to Siri.
• Siri doesn’t support voice commands to interact with specific photos. For example, you can’t refer to photos by number, such as “photo one” or “photo four.” (176812955)
Workaround: Use the photo picker to select the photo you want, or tap to select photos directly.
• App Intents with @Union Value types that accept a Place Descriptor Entity and a String always receive String values instead of Place Descriptor Entity entities. (176844035)
Workaround: Include a String case in your @Union Value enum and manually convert the String to a Place Descriptor Entity when needed.
• When you ask Siri for Maps information, the response snippets might appear incomplete or display formatting issues. (177116121)
Workaround: Ask Siri to repeat the information, or open Maps directly for complete details.
• Starting a call with Siri might fail with an error in apps that adopt CallKit and the phone.start Call AppSchema. (177190637)
• When you ask Siri to send a message to a contact that doesn’t exist on your device, Siri might draft a message to an unrelated contact. (177356158)
• When you ask Siri to add photos to an album, the confirmation prompt and spoken response might report or display more photos than will actually be added. (177376984)
Workaround: Add photos to the album manually in the Photos app: tap Select, tap the photos you want to add, tap the Share button, tap Add to Album, then tap the album.
• You might not see names and images of email senders in the Siri email list UI. (177416168)
• Siri might not resolve some entity types when your app has provided only an Entity String Query for the entity type. (177464215)
Workaround: Index the entity in Spotlight, or provide an Intent Value Query if applicable.
• Siri functionality during software updates is limited, including calls to emergency services. (177476889)
• Asking Siri to call short phone numbers, such as “Call 17”, might fail. (177545828)
Workaround: When calling for emergency services, ask Siri to explicitly “call emergency services.”
• Search results from third-party apps may not be tappable. (177593534)
• Disabling Siri might not delete your Siri and Dictation interaction history from your device. (177649865)
• Siri might not find app-specific contacts that are only indexed in Spotlight and do not appear in the Contacts app. (177679168)
Workaround: Add the contact to the Contacts app.
• Siri cannot create a recurring reminder or update an existing reminder to be reoccurring. (177722240)
• With AirPods connected to iPhone and Announce Notifications enabled, responding “yes” by voice or head gesture to a long incoming notification (for example, a message) prompts you to unlock iPhone instead of reading the full message aloud. (177733317)
• New American English Siri voices 6 and 7 might default to legacy US voices when your device is overheated or in Low Power Mode. (177742977)
Workaround: Turn off Low Power Mode or wait for your device to cool down.
• When you use ChatGPT with Apple Intelligence, some responses used in follow-up queries or when you resume a chat might be logged by Apple. (177755742)
• When you ask Siri to find, search, or read reminders, Siri might list or read the reminders instead of showing a snippet. When reminder lists are displayed, the list color might not appear correctly. (177762533)
• After enabling Expressive Voices, you are not able to modify Pace or Expressiveness in the Settings pane. (177969955)
• Non-SF Symbol custom images for entities might not appear in Siri results for third-party apps. (177984074)
• Siri might run the incorrect Open Intent or system.open intent when multiple intents targeting different entity types are available in your app. (177992979)
• After creating a list through Siri, tapping the list icon might result in an error instead of opening the list in the Reminders app. (177998395)
• When you tap the Send button in the Siri message confirmation flow, the message might fail to send. (178025056)
Workaround: Use your voice to confirm sending the message instead of tapping the Send button.
• When you ask Siri to read your last message, Siri might read an unread message from an unknown sender, such as spam, instead of the most recent message from a known contact. (178049066)
Workaround: Name the sender in your request – for example, “Read my last message from .”
• When you ask Siri to open a URL from the Siri App, Safari might launch to a blank screen. (178163636)
Workaround: After Safari launches, return to the Siri app to confirm the request.
• On CarPlay with Apple Intelligence and the ChatGPT extension enabled, asking ChatGPT a question through Siri might not produce a spoken answer. The Siri orb appears briefly and the microphone reopens without Siri responding. (178247289)
Workaround: When you are done driving, ask the same ChatGPT question using Siri on iPhone directly instead of through CarPlay.
• Siri might respond more slowly than expected in CarPlay, particularly under higher device temperatures or poor network conditions. (178274714)
Workaround: Try the request again after the device has cooled down or once you are in an area with better cellular reception.
• You might encounter build failures when attempting to implement a Transferable Intent Value Representation for PHAsset. (178276448)
Workaround: Explicitly add import _Photos _App Intents to your source file.
• When asking Siri to call, message, or email a contact, Siri might fail to resolve the correct person — particularly when multiple contacts share the same name, when group names contain emoji or special characters, or when relationship labels (e.g., “my brother”) are ambiguous. In some cases, Siri might pick the wrong contact, fail to present a disambiguation prompt, or freeze during the disambiguation UI. (178379209)
Workaround: If Siri selects the wrong contact, try using the person’s full name (first and last) or specifying the contact handle directly.
• For Report a Concern flows started with Siri, the text in attachments might be difficult to read while in Dark Mode. (178381615)
Workaround: Switch your device to Light Mode to review the content in those files.
• Businesses with overnight hours might display as “Closed till [next day]” even during open hours. (178384054)
• In CarPlay, when Apple Intelligence enabled, Siri requests for directions in Maps might fail to start navigation. (178459481)
Workaround: Tap the Go button to start navigation.
• Siri might not respond to your voice correctly. (178489724)
Workaround: Force quit the Siri app and relaunch it.
• In the Siri app, conversations might be deleted a few minutes after receiving streaming responses. (178560562)

Siri, Spotlight, and Mail App Search
Known Issues
• Mail older than 6 months might not be searchable by body content, but is still searchable by sender and subject. (177942110)

StandBy
Known Issues
• StandBy Clocks may be missing. (178061326)

StoreKit
New Features
• Offer code redemption APIs now return a Verification Result when redemption completes. If a redemption succeeds, your app receives a Verification Result that contains a Transaction object. If a redemption fails, your app receives an error that describes what caused the redemption to fail. (141012819)
• StoreKit now includes the Transaction .Ownership Type .assigned and Transaction .Revocation Type .assignment Revoked enum values to support volume purchases. Transaction query methods now additionally return transactions assigned to the Managed Apple Account. (156749517)
• New Product .Product Type APIs represent subscription Bundles and subscription Suites. New APIs in Product .Subscription Info .Bundled Subscription let you fetch merchandising data about subscriptions contained in a Bundle. Transaction and RenewalInfo contain new fields that provide information about purchases and customer status regarding Bundles and Suites. (160501742)
• partner Name and partner Id properties for Advanced Commerce API are available in Transaction .Advanced Commerce Info and Renewal Info .Advanced Commerce Info. (167808780)

StoreKit Testing in Xcode
Resolved Issues
• Fixed: The unified app receipt is not updated after forcing a subscription expiration with SKTest Session. (102093015) (FB11767567)
• Fixed: The SKTest Session disable Dialogs setting is not always respected for all system dialogs. (154390284) (FB18403150)
• Fixed: Subscription upgrades performed with the Xcode Transaction Manager are not reported in Transaction .updates. (160698598) (FB20269723)
• Fixed: The renewal behavior preference is not respected when using the purchase Date(_: renewal Behavior:) purchase option to make purchases using SKTest Session. (162014134) (FB20537538)
Known Issues
• When using StoreKit Testing in Xcode, pricing Terms .commitment Info .price returns an incorrect price for monthly subscriptions billed as a 12-month commitment. (177942756)

Suggestions in Messages
Known Issues
• The app icon shown for navigation suggestions is always the Apple Maps icon. If the suggestion is selected, the user’s preferred navigation app is correctly launched. (178193147)

Swift Charts
Known Issues
• When your project has a minimum deployment target lower than 27.0, using conditionals inside a Chart closure produces the warning “Conformance of ‘_ConditionalContent<TrueContent, FalseContent>’ to ‘ChartContent’ is only available in 27.0 or newer,” and the app might crash at runtime when that content is loaded. (174168981)
Workaround: Extract the conditional chart content into a separate function or computed property annotated with @Chart Content Builder. For example, replace:
Chart(dataPoints, id: .index) { dataPoint in
if selectedMetric == "Rate" {
LineMark(x: .value("X", dataPoint.index), y: .value("Y", dataPoint.rate))
.foregroundStyle(.blue)
} else {
LineMark(x: .value("X", dataPoint.index), y: .value("Y", dataPoint.signal))
.foregroundStyle(.green)
}
}
with:
Chart(dataPoints, id: .index) { dataPoint in
marks(for: dataPoint)
}

private func marks(for dataPoint: DataPoint) -> some ChartContent {
if selectedMetric == "Rate" {
LineMark(x: .value("X", dataPoint.index), y: .value("Y", dataPoint.rate))
.foregroundStyle(.blue)
} else {
LineMark(x: .value("X", dataPoint.index), y: .value("Y", dataPoint.signal))
.foregroundStyle(.green)
}
}

SwiftData
Known Issues
• You might experience a deadlock for @Query when saving a Model Context on a background actor while scheduling new async tasks for a Model Actor. (178113288)

SwiftUI
New Features
• You can now use .toolbar Color Scheme(color Scheme, for: .status Bar) to set a preferred status bar color scheme. (55162154) (FB7234376)
• Async Image now automatically caches downloaded images using HTTP caching protocols, allowing servers to control caching behavior via standard headers. You can customize caching for specific images using the new Async Image initializers that accept URLRequest with custom cache Policy settings. Additionally, you can set a custom URLSession using the new View .async Image URLSession(:) API to control how all child Async Image views perform data tasks. (78212597)
• In apps built with the iOS 27.0 and iPadOS 27.0 SDKs, a Text view with .text Selection(.enabled) applied now supports user-interactive selection using the system text selection UI. Previously, selectable Text views on iOS and iPadOS offered selection functionality through a callout menu. When building with the iOS 27.0 and iPadOS 27.0 SDKs, selectable Text views might include additional gestures for system text selection interactions. Consider using .high Priority Gesture() for custom gestures applied to Text views that should supersede system text selection gestures. (79770704) (FB9208920)
• A @State declared with an expression as its initial value used to evaluate the expression each time the view struct re-instantiates. In the case of @State private var model = Model(), this means Model.init() gets called many times throughout the view’s life time. Xcode 27 introduces a new @State implementation that avoids this repeated evaluation. This new behavior back-deploys to iOS 17 aligned OSes. The new @State is implemented with a Swift macro. It is largely source compatible with the property wrapper version, with a few exceptions.
If you provide an initial value at @State declaration, and also try to assign a value to it in an initializer, the initializer value is discarded. This behavior has not changed because of the macro, but some such cases no longer compiles:
struct StickerPageView: View {
@State private var page = StickerPage()
let title: String
init(title: String) {
// title won't have any effect
// this also won't compile with @State macro
self.page = StickerPage(title: title)
self.title = title
}
}
When assigning initial value via an initializer, do not provide an initial value at the @State declaration.
struct StickerPageView: View {
@State private var page: StickerPage // no initial value expression
let title: String
init(title: String) {
self.page = StickerPage(title: title) // works!
self.title = title
}
}
When all stored member of a struct is private, the compiler synthesizes a private init that can be used in extension of the same type:
struct StickerPageView: View {
@State private var page: StickerPage
private let title: String
...
}
extension StickerPageView {
init(title: String, _ page: StickerPage) {
self.init(page: page, title: title) // using the sythesized init
}
}
The state macro disables this synthesized initializer. So the code above no longer compiles. To mitigate, assign value to members explicitly:
extension StickerPageView {
init(title: String, _ page: StickerPage) {
self.title = title
self.page = page
}
}
In rare situations, the automatic inference of generic argument of @State is less flexible with the macro implementation. Write the type with more specificity.
Composing @State with other property wrappers or macros is not supported. (105893279)
• In apps built with the iOS 27.0 and macOS 27.0 SDKs, selectable Text views now support Text Renderer. (158160386) (FB19589465)
• In apps built with the 27.0 SDKs, the new Readable Document and Writable Document protocols support asynchronous reading and writing, progress reporting, and direct access to document URLs. New Document Group initializers that adopt these protocols let you disable document creation for editing-only apps and present custom UI before any document is opened. The initializers expose an Observable URLDocument Configuration and integrate with Swift concurrency and the Observation framework. New applications should prefer Readable Document and Writable Document over Reference File Document, which remains available. (158441552)
• In apps built with the iOS 27.0 and iPadOS 27.0 SDKs, a Tab View enforces that its selection is set to a visible tab. Tab View might crash when its selection is set to a hidden or otherwise unavailable tab. (164516837)
• You can use .toolbar Visibility(hide Status Bar ? .hidden : .automatic, for: .status Bar) to conditionally hide the status bar. (165329279)
• The menu bar on iPadOS 27.0 and macOS 27.0, as well as context menus on macOS 27.0, present a reduced set of menu item images. By default, SwiftUI now hides all menu item symbol images in most contexts, while non-symbol images remain visible. Review the updated Human Interface Guidelines to determine which menu items in your app should still display images. Use the label Style(:) view modifier with the .title And Icon style to indicate that a menu item Label’s icon should always be shown — such as when the menu item represents an object or a concept rather than an action. SwiftUI continues to automatically provide default visible menu item images for certain common system-wide menu items, such as Settings, Share, and Print. (170480710)
• The Tabs Picker Style is now available for pickers that represent tab-based navigation and content selection. This style is similar to the .segmented style, but VoiceOver reads it as “tabs,” and on macOS it has a distinct visual appearance that distinguishes it from pickers that represent value selection — for example, a text alignment picker in an inspector. (173211711)
• In apps built with the iOS 27.0 SDK, you can display non-interactive content on external display scenes using the .scene Accessory view modifier with an External Non Interactive Accessory type. (175548901)
• In apps built with the 27.0 SDKs, a Labeled Content view used inside a Menu maps its value to the platform menu item’s subtitle. (175594929)

Resolved Issues
• Fixed: In apps built with the 2027 SDKs, tapping the status bar to scroll a Scroll View to its top correctly updates a bound scroll Position. Previously, the binding could be left holding a stale value because the scroll-to-top transition didn’t drive the scroll-phase updates that propagate to the binding. (111501113) (FB12477370)
• Fixed: A custom Text Renderer applied via .text Renderer(:) now takes effect on a Text view that also has .text Selection(.enabled) applied. Previously, the custom renderer was dropped on selectable text, falling back to default rendering. (151015350)
• Fixed: When you apply both .file Exporter(:...) and .file Mover(:...) modifiers to a view, some dialogs might not present correctly. (154080867)
• Fixed: In apps built with the 27.0 SDKs, container Relative Frame(: alignment:) incorrectly accounts for safe-area insets on a Scroll View’s non-scrollable axis, causing the calculated scrollable content size to be too small. For example, a view using container Relative Frame(.vertical) inside a horizontal Scroll View extends into vertical safe-area regions, such as the navigation bar and home indicator, because only the scrollable axis insets are applied. (165913417)
• Fixed: Retroactive conformances of SwiftUI types to Equatable are not consulted when SwiftUI compares their values. (167443223)
• Fixed: In apps built with the 27.0 SDKs, the control Size, button Sizing, button Repeat Behavior, menu Indicator Visibility, and Button Border Shape environment values are not reset to their default values in sheets and popovers. (167448274)
• Fixed: A Button containing both an icon and a title placed inside a List Section header or footer has incorrect spacing between its icon and title. (175681345)
• Fixed: When you present a full Screen Cover with a .navigation Transition(_:) and set @Focus State to true via .on Appear, the keyboard does not animate concurrently with the zoom transition. Instead, it waits for the entire zoom animation to complete before the keyboard begins animating up, resulting in a visually jarring 2-step animation. (178421089)

Known Issues
• Progress reported in Document Reader .read(from: progress:) and Document Writer .write(snapshot: to: previous: progress:) might not be presented. (158441261)

System
New Features
• System now provides Swift APIs for the C stat, lstat, fstat, and fstatat system calls. This includes a new Stat type with initializers from File Path, File Descriptor, or a C string; File Path .stat() and File Descriptor .stat() instance methods; and supporting types (File Type, File Mode, Flags, User ID, Group ID, Device ID, and Inode). See SYS-0006 for more details. (160612181)

Known Issues
• Custom File Path or File Descriptor extensions that make unqualified calls to stat() or stat(_: :) (without the Darwin. qualification) might conflict with the new Swift stat() instance methods introduced in SYS-0006, causing build errors. (177911316)
Workaround: Migrate to the new Swift stat() methods, or disambiguate using Darwin.stat() and Darwin.stat(: _:). See SYS-0008 for more details.

System Experience
Known Issues
• When Siri is off and your iPad is extended to an external display where Spotlight is on screen, disconnecting the display might cause the system to crash. (176281601)
Workaround: Dismiss Spotlight before disconnecting the external display, or turn on Siri.
• After using iPhone Mirroring or other non-main display experiences, a black pill may appear on the CarPlay screen. (177893758)
Workaround: Reboot.

TextKit
New Features
• NSText Table and its related objects and types are available to UIKit clients starting with OS 27 releases. (159870239)

Trust Insights
New Features
• You can now use the TrustInsights framework in your apps by declaring the TrustInsights capability on your app target in Xcode. The framework requires an entitlement and internet connectivity to return results. (154949256)

UIKit
New Features
• When linked on iOS 27, tvOS 27, macCatalyst 27, or visionOS 27 SDKs, you can use UIScene .extend State Restoration and UIScene .complete State Restoration to extend state restoration for UIScene .Activation State .background to UIScene .Activation State .foreground lifecycle transitions. (161843040)
• iOS and iPadOS apps built with the 27.0 SDK or later are required to include a launch screen. Your app’s Info .plist must contain one of the following keys: UILaunch Storyboard Name, UILaunch Storyboards, UILaunch Screen, or UILaunch Screens. Apps that don’t include a launch screen are rejected when the App Store begins accepting apps built with the 27.0 SDK. (168247372)
• On iOS 27.0 and iPadOS 27.0, Siri can load resources from drag interactions installed in your app’s interface. For example, when Apple Intelligence is invoked from a context menu, the system calls UIDrag Interaction Delegate methods to load the content. Because drag sessions might begin without a user-initiated drag gesture, avoid performing animations or presenting modal UI for the drag in drag Interaction(: session Will Begin:). Instead, perform those actions in drag Interaction(: session Did Move:). (168884200)
• In apps built with the iOS 27.0 SDK, a presented view controller inherits its trait collection by walking up its view’s superview chain through the intermediate views of the presentation, rather than jumping directly to the presentation controller. Custom UIPresentation Controller subclasses or view controllers that depend on receiving traits directly from the presentation controller might need to update how they propagate or override trait Collection. (170005251)
• On iPadOS 27.0 and macOS 27.0, the menu bar and context menus present a reduced set of menu item images and do not display images set on menu elements by default. You can use the new preferred Image Visibility property on UIMenu Element — including updated initializers on UIMenu, UIAction, UICommand, and UIKey Command — to customize the visibility of each element’s image in these menus. Review the updated Human Interface Guidelines to determine which menu elements in your app should display images. UIKit automatically provides default visible menu element images for certain common system-wide menu items, such as Settings, Share, and Print. (170479084)
• In apps built with the iOS 27.0 SDK, when UISearch Controller uses center search-bar placement, the scope bar appears inline on the same row as the search field rather than on a separate row beneath it. When the search field is hosted inside a navigation bar, the scope bar sits inline beside the search field within that navigation bar. (173860616)
• In apps built with the iOS 27.0 SDK, window External Display Non Interactive scenes are no longer offered automatically by the system. Use UIView Controller .register Scene Accessory(_:) with a UIScene Accessory .external Non Interactive instance to display non-interactive content on external display scenes. (177015874)

Resolved Issues
• Fixed: The UIMenu Leaf protocol is missing the subtitle property introduced in iOS 16.0. (173271862)

Known Issues
• In apps built with the iOS 27.0 SDK, the deprecated status bar accessors on UIApplication — including status Bar Frame, status Bar Orientation, status Bar Style, and is Status Bar Hidden — might return NaN or null values. (162044221)
Workaround: Read current values from UIWindow Scene .status Bar Manager instead.
• On iPad, if your iPad app is built with the iOS 27 SDK and its UISupported Interface Orientations doesn’t include all four interface orientations, the app is treated as non-continuously resizable. Beginning with iOS 27, supported interface orientations should no longer be a condition for continuous resizability. (166422120)
Workaround: To make your app continuously resizable on iPad, declare support for all four interface orientations in your Info .plist with UISupported Interface Orientations.
• The UIScene Closure Confirmation API does not present a confirmation dialog. (169108042)
• The background might not appear on a bottom toolbar when you use UIBar Button Item .hides Shared Background to hide a toolbar item’s glass background. (174773785)
• In iPhone Mirroring, if your app is built with the iOS 27 SDK its scene will support all interface orientations regardless of the orientations declared in UISupported Interface Orientations or returned by UIView Controller .supported Interface Orientations. Supported interface orientations should be honored until the user begins resizing the window. (178555304)
• In iPhone Mirroring, if your app is built with the iOS 27 SDK and sets UIRequires Full Screen, its scene receives continuous resize updates when the user resizes the window. Each resize should instead be delivered as a discrete change to a new UIScreen with an updated bounds. (178558224)
• In iPhone Mirroring if your app is built with the iOS 27 SDK, its scene is initially connected to a UIScreen that isn’t UIScreen .main. The scene should start on the main screen. (178558897)
• On iPad, if your iPad app is built with the iOS 27 SDK and sets UIRequires Full Screen, the bounds of UIScreen .main changes when the user resizes the window. The bounds of the main screen should remain fixed once the screen connects. (178559386)
• On iPad, if your iPad app is built with the iOS 27 SDK and sets UIRequires Full Screen, its scene receives continuous resize updates when the user resizes the window. Each resize should instead be delivered as a discrete change to a new UIScreen with an updated bounds. (178560235)
• On iPad, if your iPhone-only app is built with the iOS 27 SDK its scene continues to honor supported interface orientations after the user resizes the window. After the first resize, the scene should ignore supported interface orientations. (178561952)
• On iPad, if your iPhone-only app is built with the iOS 27 SDK and sets UIRequires Full Screen, its scene receives continuous resize updates when the user resizes the window. Each resize should instead be delivered as a discrete change to a new UIScreen with an updated bounds. (178562971)
• On iPad, if your iPhone-only app is built with the iOS 27 SDK and supports only portrait or only landscape interface orientations, its layout breaks when the iPad is in an orientation the app doesn’t support. (178573319)

Deprecations
• Apps built with the latest SDK must adopt the scene-based life cycle or they fail to launch. For migration guidance, see Transitioning to the UIKit scene-based life cycle. (141837548)

USDKit
Known Issues
• Some types of USD attributes cannot be read or modified. (170653056)
• Array, vector, matrix, and quaternion types cannot be authored using USDKit. (178071414)

VideoToolbox
New Features
• VTLow Latency Super Resolution Scaler Configuration now supports a 1.5x scale factor. Call +supported Scale Factors For Frame Width: frame Height: to discover the scale factors available for your source dimensions. (177635243)
• VTLow Latency Frame Interpolation Configuration now supports arbitrary source dimensions up to 1080p. (179040806)

Watch Connectivity
Resolved Issues
• Fixed: The WCSession .transfer Current Complication User Info method does not work with complications built using WidgetKit on watchOS. (113202790) (FB12819178)

Weather Highlights
Known Issues
• Weather Highlights is currently only available in US English. (164408676)

WidgetKit
Known Issues
• Your widget extension might not render its timeline when it uses an App Intent with a @Union Value parameter, and content such as images might not appear. This affects Widget Configuration Intent types that you declare with a @Union Value property. (177493357)
Workaround: Use a single App Entity type with a kind property to distinguish the variants.

Writing Tools
Known Issues
• Writing Tools becomes unresponsive when you interact with the Plus button while Writing Tools is in use. (177097101)
Workaround: Force quit Messages to resolve the issue.

Original source

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

Accessibility Resolved Issues

• Fixed an issue where calling speechSynthesis.cancel() removed utterances queued by subsequent speechSynthesis.speak() calls. (46151521)
• Fixed an issue where SVG elements referencing elements inside an were incorrectly included as unnamed images in VoiceOver’s Images rotor. (98999595)
• Fixed an issue where changing the id attribute of an element targeted by aria-owns did not update the accessibility tree. (107644248)
• Fixed slot elements referenced by aria-labelledby to correctly use their assigned slotted content for accessible names and ignore hidden slotted nodes. (114500560)
• Fixed element to have consistent labels between aria-label and title attributes. (127460695)
• Fixed elements with display: contents and content in a shadow root to have their content properly read when referenced by aria-labelledby. (129361833)
• Fixed aria-labelledby to use the checkbox name instead of its value when the checkbox name comes from an associated element. (141564913)
• Fixed VoiceOver cursor positioning for elements focused via the drawFocusIfNeeded() canvas API. (146323788)
• Fixed grid elements with child rows in a shadow root to properly work with VoiceOver. (153134654)
• Fixed an issue where VoiceOver read text within images that have role="presentation". (159304061)
• Fixed an issue where content within dynamically expanded elements was not exposed in the accessibility tree. (159865815)
• Fixed an issue where the contextmenu event was not fired for elements inside iframes when triggered by keyboard or assistive technology actions such as VoiceOver’s VO+Shift+M. (164128676)
• Fixed an issue where changes to elements inside live regions were not announced by assistive technologies. (168200460)
• Fixed ::first-letter text not being exposed in the accessibility tree when no other text accompanies it. (168458291)
• Fixed an issue where VoiceOver was unable to access aria-owned rows and their cells in grids and tables. (168770938)
• Fixed an issue where VoiceOver could not find focusable splitter elements when navigating to the next or previous form control. (170187464)
• Fixed an issue where color picker inputs could not be activated using VoiceOver’s press action. (172218114)
• Fixed an issue where interactive elements containing an named by a child element did not expose an accessible name. (172559238)</li> <li>Fixed an issue where incorrect bounding boxes were computed for MathML table rows and cells. (172851295)</li> <li>Fixed an issue where comboboxes did not forward focus to their aria-activedescendant, preventing assistive technologies from interacting with list items. (172931277)</li> <li>Fixed an issue where aria-owns was not respected when computing the accessible name from element content. (173249317)</li> <li>Fixed VoiceOver line-by-line reading skipping content in read-only documents. (174349841)</li> <li>Fixed invalidation of aria-hidden=“true” when focus lands inside the aria-hidden subtree. (174449524)</li> <li>Fixed VoiceOver’s “Skip redundant labels” setting not being respected on certain web pages. (176297111)</li> </ul> <h3>Animations New Features</h3> <ul> <li>Added the animation property to AnimationEvent and TransitionEvent interfaces. (176527591)</li> </ul> <h3>Animations Resolved Issues</h3> <ul> <li>Fixed an issue where animation-fill-mode did not correctly apply viewport-based units after the viewport was resized. (80075191)</li> <li>Fixed an issue where !important declarations did not override CSS animation values when CSS transitions were also running on the same property. (174367827)</li> <li>Fixed an issue where identity matrix decomposition generated invalid quaternions, resulting in incorrect transform animations. (174813328)</li> </ul> <h3>CSS New Features</h3> <ul> <li>Added support for contain: style applying to CSS quote counters, as specified in CSS Containment Level 2. (84758186)</li> <li>Added support for the case-sensitive modifier s in CSS attribute selectors. (126331481)</li> <li>Added support for the stretch keyword in box sizing properties. (132539604)</li> <li>Added support for the :host(:has()) compound selector in CSS. (139799278)</li> <li>Added support for the :heading pseudo-class. (158759228)</li> <li>Added support for the revert-rule keyword, which rolls back the cascade to behave as if the current style rule had not been present. (171132753)</li> <li>Added support for the normal and none values on the position-anchor CSS property. (172097721)</li> <li>Added support for the insert keyword for the text-autospace property. (175031507)</li> <li>Added support for transform-aware anchor positioning. (175401339)</li> </ul> <h3>CSS Resolved Issues</h3> <ul> <li>Fixed numerous CSS bugs and performance issues including shape-outside in RTL, flex layout, outline offset, aspect-ratio calculations, font-family serialization, and many more detailed fixes.</li> </ul> <h3>Canvas Resolved Issues</h3> <ul> <li>Fixed an issue where a 2D canvas element unnecessarily forced a compositing layer. (172864747)</li> </ul> <h3>Editing New Features</h3> <ul> <li>Added menu items to convert editable text between Simplified and Traditional Chinese characters in the “Transformations” submenu. (156354464)</li> </ul> <h3>Editing Resolved Issues</h3> <ul> <li>Fixed multiple issues related to text selection, font picker, composition events, and input methods.</li> </ul> <h3>Encoding Resolved Issues</h3> <ul> <li>Fixed an issue where CJK encoding state was not reset appropriately during text decoding. (174649963)</li> </ul> <h3>Forms New Features</h3> <ul> <li>Added the customizable <select> element, allowing custom styling with appearance: base-select and custom content with the <selectedcontent> HTML element. (170328089)</li> </ul> <h3>Forms Resolved Issues</h3> <ul> <li>Fixed various issues including keyboard commands in number fields, tabbing position, range input slider thumbs, datalist suggestions in dark mode, and more.</li> </ul> <h3>HTML New Features</h3> <ul> <li>Added support for the auto keyword in the sizes attribute on <img> elements, enabling automatic size calculation based on the rendered layout width. (172827205)</li> <li>Added support for the shadowrootslotassignment attribute on declarative shadow roots. (173227340)</li> <li>Added support for tabindex, focus(), blur(), and autofocus on MathML elements per the HTML Standard. (176258900)</li> </ul> <h3>HTML Resolved Issues</h3> <ul> <li>Fixed multiple issues including map element matching, sequential focus navigation, viewport <meta> parsing, javascript: URL parsing, and more.</li> </ul> <h3>Deprecations</h3> <ul> <li>Deprecated the href attribute on all MathML elements except <a>. (173996661)</li> </ul> <h3>Images Resolved Issues</h3> <ul> <li>Fixed issues with srcset in dynamically created iframes, naturalWidth and naturalHeight for SVG images, HDR image rendering, and more.</li> </ul> <h3>JavaScript New Features</h3> <ul> <li>Added support for static import defer semantics. (176568369)</li> </ul> <h3>JavaScript Resolved Issues</h3> <ul> <li>Fixed multiple bugs including top-level await correctness, regular expressions, TypedArray subarray, RegExp split behavior, and more.</li> </ul> <h3>MathML New Features</h3> <ul> <li>Added support for multiple-character operators in MathML. (170907545)</li> <li>Added support for operator dictionary entries for multi-character operators to align with the MathML Core specification. (176543727)</li> </ul> <h3>MathML Resolved Issues</h3> <ul> <li>Fixed operator dictionary stretchy property, symmetric non-stretchy large operators centering, dynamic changes to <mo> attributes, and other MathML layout and rendering issues.</li> </ul> <h3>Media New Features</h3> <ul> <li>Added support for setting TextTrackCue.endTime to Infinity to represent an unbounded cue duration. (71042767)</li> <li>Added support for synchronized video playback on displays using genlock on macOS. (175197574)</li> </ul> <h3>Media Resolved Issues</h3> <ul> <li>Fixed multiple issues including decoding WebM audio files with more than two channels, preservesPitch and playbackRate handling, MediaCapabilities decoding info, video playback issues, and more.</li> </ul> <h3>Networking New Features</h3> <ul> <li>Added support for secure cookies on loopback hosts. (137604100)</li> </ul> <h3>Networking Resolved Issues</h3> <ul> <li>Fixed issues including redirects to data: URLs, XMLHttpRequest request body dropping during redirects, X-Frame-Options stripping, Safari address bar IDN homograph display, preload scanner integrity metadata, range request validation, and more.</li> </ul> <h3>PDF Known Issues</h3> <ul> <li>Fixed PDF scrollbars to adapt to dark appearance. (174763396)</li> <li>Fixed an issue where panning a zoomed-in PDF on iOS would frequently rubber band back to the starting position. (156854435)</li> </ul> <h3>Printing Resolved Issues</h3> <ul> <li>Fixed issues with animations during print, printing light text on dark background, and WebView embedded in NSPrintOperation dropping all text.</li> </ul> <h3>Rendering New Features</h3> <ul> <li>Added support for subpixel inline layout, enabling more precise text and inline element positioning. (171835370)</li> <li>Added support for anchor-valid and anchor-visible as aliases of anchors-valid and anchors-visible in position-visibility. (174438361)</li> <li>Added support for the Dutch IJ digraph in text-transform: capitalize and ::first-letter, correctly titlecasing “ij” to “IJ” at word starts when the content language is Dutch. (175912959)</li> </ul> <h3>Rendering Resolved Issues</h3> <ul> <li>Fixed multiple issues including table cell rowspan height calculations, ::first-letter styles causing incorrect Range rects, flex item sizing, block formatting context overlaps, checkbox outlines, list markers, and more.</li> </ul> <h3>SVG New Features</h3> <ul> <li>Added support for the lang and xml:lang attribute in SVG. (143751056)</li> </ul> <h3>SVG Resolved Issues</h3> <ul> <li>Fixed multiple SVG issues including animation timing attribute parsing, SMIL animation effects, visited link color propagation, CSS filter invalidation, stroke-dashoffset rendering, systemLanguage attribute, attribute removal, XML document parser script execution, animated SVG images, <tspan> positioning, non-existent filter ID rendering, coordinate calculations, URL fragment decoding, radial gradient defaults, and more.</li> </ul> <h3>SVG Deprecations</h3> <ul> <li>Removed the SVGLocatable and SVGTransformable interfaces to align with the SVG2 specification. (104668934)</li> <li>Removed the non-standard nearestViewportElement and farthestViewportElement properties from SVGGraphicsElement, aligning with the SVG2 specification. (171262197)</li> <li>Removed the viewTarget property from SVGViewSpec to align with the SVG2 specification. (172590438)</li> </ul> <h3>Scrolling New Features</h3> <ul> <li>Enabled scroll anchoring, which prevents visible jumps in scroll position when content is inserted or removed above the viewport. (171840378)</li> </ul> <h3>Scrolling Resolved Issues</h3> <ul> <li>Fixed multiple issues including momentum scroll interruption, smooth scrolling with scroll-snap-type, scroll container rendering, restored scroll position, tabbing scroll, custom CSS scrollbar sizing, rubberbanding behavior, scroll anchoring causing negative offsets, Navigation API offset hit test locations, and more.</li> </ul> <h3>Spatial Web New Features</h3> <ul> <li>Added support for the <model> element on iOS, iPadOS, and macOS. (131735906)</li> <li>Added support for the <img> controls attribute on spatial and panorama photos. (138146584)</li> <li>Added support for immersive website environments in visionOS. (169967223)</li> <li>Added support for dynamic-range-limit on the <model> element. (174775575)</li> <li>Added support for tone mapping in the <model> element. (175889208)</li> </ul> <h3>Spatial Web Resolved Issues</h3> <ul> <li>Fixed spatial and panoramic image controls to support RTL language layout and localization of type labels. (161690817)</li> <li>Fixed <model> elements displaying at 100x the expected size for assets authored in tools that use centimeter units. (167805672)</li> <li>Fixed WebXR viewports not getting an initial value until getViewport() was called. (168125694)</li> <li>Fixed <model> element stagemode orbit physics behaving differently between iOS and visionOS. (172189776)</li> <li>Fixed fullscreen video jumping when exiting fullscreen on visionOS if the browser window was narrower than the video. (174454557)</li> <li>Fixed removing all text from the URL bar on Safari in visionOS showing an empty completion list. (176499710)</li> </ul> <h3>Spatial Web Known Issues</h3> <ul> <li>WebXR might not render when you use Simulator.<ul> <li>Workaround: Use an Apple Vision Pro device instead of Simulator.</li> </ul> </li> </ul> <h3>Storage New Features</h3> <ul> <li>Added support for setting maxAge in the Cookie Store API via cookieStore.set(). (166301541)</li> </ul> <h3>Storage Resolved Issues</h3> <ul> <li>Fixed IndexedDB incorrectly returning a version 0 database after an abort during the initial onupgradeneeded event. (176195526)</li> </ul> <h3>Tables Resolved Issues</h3> <ul> <li>Fixed collapsed border color mismatch when the table cell has a different writing-mode. (173655092)</li> </ul> <h3>Web API New Features</h3> <ul> <li>Added support for the service worker static routing API. (157951894)</li> <li>Added support for async iteration over ReadableStream objects using for await...of loops. (168049382)</li> <li>Added srgb-linear and display-p3-linear to Predefined Color Space. (169340732)</li> <li>Added support for ReadableStream.from() to create a ReadableStream from an async iterable or iterable. (169605740)</li> <li>Added support for transferring ReadableStream objects via postMessage(). (169950592)</li> </ul> <h3>Web API Resolved Issues</h3> <ul> <li>Fixed multiple issues including history.state being set to null incorrectly, scrollbar click blurring active element, change event not firing on input and textarea losing focus, Web IDL bindings rejecting SharedArrayBuffer without [AllowShared], Content Security Policy ASCII whitespace recognition, emoji input keypress suppression, gamepadconnected event firing, CSPViolation Report Body source line number, Digital Credentials API requiring second click, and more.</li> </ul> <h3>Web Extensions New Features</h3> <ul> <li>Added support for runtime.getDocumentId() web extension API. (168060269)</li> <li>Added reporting of uncaught JavaScript exceptions and unhandled promise rejections in Web Extension scripts. (174354070)</li> <li>Added support for propagating user gestures through sendMessage(), connect(), postMessage(), and executeScript() APIs, enabling extensions to perform gesture-requiring actions like media playback. (175797617)</li> </ul> <h3>Web Extensions Resolved Issues</h3> <ul> <li>Fixed cross-origin XMLHttpRequest incorrectly triggering additional Web Extension permission requests. (154866064)</li> <li>Fixed browser.i18n.getMessage() to correctly substitute named placeholders adjacent to non-space characters and two adjacent named placeholders. (169146196, 175315700)</li> <li>Fixed web extension service worker registration database files accumulating on each Safari launch, causing performance degradation. (175484888)</li> <li>Fixed loading Web Extensions breaking Cloudflare bot challenge pages. (176618014)</li> </ul> <h3>Web Inspector New Features</h3> <ul> <li>Added color contrast information within the Color Picker in Web Inspector. (113887185)</li> <li>Added support to show each individual request when there are redirects in the Network tab. (152606018)</li> <li>Improved discoverability of color formats and gamuts in the color picker by adding explicit format and gamut toggle controls. (168216591)</li> <li>Added support for showing contrast information in the Color Picker when editing background color properties. (171332734)</li> <li>Added Subgrid and Grid-Lanes badges to the Elements tab for easier identification of subgrid and grid-lanes layout contexts. (173681497)</li> <li>Added the layout root element to Layout event details in the Timeline tab. (175419350)</li> <li>Added unique colors for style events such as “Style Invalidated” and “Style Recalculated” in the Timeline view to distinguish them from layout events. (176770197)</li> </ul> <h3>Web Inspector Resolved Issues</h3> <ul> <li>Fixed multiple issues including CSS properties added to new rules not applied, Network tab Request/Response menu not remembering selection, inline style editing truncation, tree outlines showing blank content, active recording stopping unexpectedly, rows containing object previews not visible, context menu items displaying irrelevant options, previewing resources error, selected DOM node keys unreadable, Safari Develop menu launching Device Hub instead of Simulator, Layers 3D view texture mapping and snapshot issues, WebAssembly debugger source bytes missing, and more.</li> </ul> <h3>Web Views New Features</h3> <ul> <li>Added WKSerializedNode as a public API, enabling applications to clone DOM nodes including shadow roots between different WKWebView instances. (166552298)</li> <li>Added WKJSHandle as a public API, enabling applications to create and manipulate JavaScript object references across content worlds. (166552556)</li> <li>Added WKContentWorldConfiguration as a public API for configuring content world properties such as autofill scripting, shadow root access, and inspectability when creating a WKContentWorld. (166553118)</li> <li>Added alternateRequest and overrideReferrerForAllRequests properties to WKWebpagePreferences as public API, allowing applications to modify the main resource request during navigation and apply custom referrer headers across all resource loads. (166555923)</li> <li>Added a willSubmitForm callback to WKNavigationDelegate with a new WKFormInfo object, enabling applications to be notified of and respond to HTML form submissions. (166556756)</li> <li>Added mainFrameNavigation to WKNavigationAction and navigation to WKNavigationResponse as public API, allowing applications to reliably correlate navigation actions and responses with their originating loads. (167445147)</li> <li>Added loadURL: to WKWebView as a convenience method for loading a URL directly without wrapping it in an NSURLRequest. (167445337)</li> <li>Added getCookiesForURL: to WKHTTPCookieStore as public API, allowing applications to efficiently retrieve cookies matching a specific URL instead of fetching the entire cookie store. (168165666)</li> <li>Added the ability to clear a content world via WKWebView. (176381093)</li> </ul> <h3>WebAssembly New Features</h3> <ul> <li>Added support for WebAssembly JavaScript Promise Integration (JSPI). (170260385)</li> </ul> <h3>WebAssembly Resolved Issues</h3> <ul> <li>Fixed WebAssembly.Suspending and WebAssembly.SuspendError to be data properties instead of getter functions, aligning with other WebAssembly attributes like WebAssembly.Module. (170155726)</li> <li>Fixed Integer Overflow exceptions thrown by i32.rem_s, i64.rem_s, i32.div_u, i64.div_u, i32.rem_u, and i64.rem_u when both operands are constants. (175122462)</li> <li>Fixed a regression where RegisterSet::normalizeWidths() lost vector-width information, causing v128 argument corruption in WebAssembly SIMD thunks. (176035764)</li> </ul> <h3>WebGL Resolved Issues</h3> <ul> <li>Fixed compressed Tex Image not validating whether the compressed texture format extension has been enabled. (175652171)</li> <li>Fixed some tex Image functions reporting errors with incorrect function names. (175652807)</li> <li>Fixed some WebGL context state properties not being correctly reset on context loss. (176190808)</li> </ul> <h3>WebGPU New Features</h3> <ul> <li>Added support for the clip_distances builtin value in WGSL shaders. (129202606)</li> </ul> <h3>WebGPU Resolved Issues</h3> <ul> <li>Fixed GPUDevice.onuncapturederror event handler attribute not working. (149577124)</li> <li>Fixed: Restored maxStorageBuffersInFragmentStage and related WebGPU limits. (160800947)</li> <li>Fixed rendering failing when using direct GPUTexture objects instead of GPUTextureView with multisampled resolve targets in render passes. (175452924)</li> <li>Fixed a WGSL shader validation failure in binary arithmetic expressions. (176473479)</li> </ul> <h3>WebRTC New Features</h3> <ul> <li>Added support for the targetLatency attribute in WebRTC. (168225793)</li> <li>Added support for the RTCRtpCodec dictionary and related constructs. (172745579)</li> <li>Added support for RTCRtpReceiver.jitterBufferTarget. (173676035)</li> <li>Added support for video source width and height in RTC stats. (173677615)</li> </ul> <h3>WebRTC Resolved Issues</h3> <ul> <li>Fixed multiple issues including I420 BT709 Video Frame color space encoding, RTCPeerConnection.addIceCandidate() rejection when connection closed, outgoing video feeds freezing with virtual background, RTCDataChannel buffered amount check, MediaStreamTrack settings, remote WebRTC track unmuting, RTC send encodings validation, RTCRtpSender.setParameters() clearing unset parameters, WebRTC VP9 encoder frame colorspace propagation, and ICE candidate gathering failures.</li> </ul>

Original source

General

Resolved Issues

• Fixed: The scheme action toolbar button now treats ‘without building’ variants, obtained by holding the Control key, as a one-shot operation and reverts to the normal build-then-perform action when no modifiers are used. (12239704)

Known Issues

• When streaming stdout and stderr from multiple processes at the same time (for example: in parallel testing scenarios), the results may be significantly delayed. (165098287)

Address Sanitizer

Known Issues

• Address Sanitizer might fail to launch on iOS 27.0, tvOS 27.0, watchOS 27.0, and visionOS 27.0 when building with Xcode 26.4 or older. (178072780)

Workaround: Use Xcode 26.5 or later when testing applications with Address Sanitizer.

App Intents

Known Issues

• Siri might generate unexpected responses when attempting to trigger an AppShortcut phrase with an App enum value. (174869053)

Apple Clang Compiler

New Features

• You can now annotate C++ operators declared within classes using API Notes. For example:

Tags:
- Name: MyTag
Methods:
- Name: operator+
Availability: none

(148534260)

Background Assets

New Features

• Asset-pack manifests now support path wildcards, file exclusion, hard-coded source roots, and custom destination subpaths. (163943159)
• You can reduce your app’s storage usage with localized asset packs. The system delivers the appropriately localized asset packs based on the user’s preferred languages. (163944365)
• Use the new Steam Asset Converter to convert your Steam “depots” into asset packs. (163953178)

Known Issues

• There is an issue with Xcode serving asset packs to your app while debugging when setting a Background Asset Packs folder in the Run scheme action’s Options tab (165230494)

Workaround: Use existing Background Assets Mock Server.

C++ Standard Library

New Features

• The following C++ papers have been implemented:
  • Hashing support for std::chrono value classes (P2592R3)
  • zip (P2321R2)
  • std::optional<T&> (P2988R12)
  • sub-string_view from string (P3044R2)
  • Making std::istream::ignore less surprising (P3223R2)
  • Add std::views::indices(n) (P3060R3)
  • Move-only types for equality_comparable_with, totally_ordered_with, and three_way_comparable_with (P2404R3)
  • Checking if a union alternative is active (P2641R4 (std::is_within_lifetime))
  • Expose std::atomic_ref’s object address (P2835R7)
  • Comparisons for reference_wrapper (P2944R3)
  • Give std::optional Range Support (guarded by -fexperimental-library) (P3168R2)
  • Fixes to flat_map and flat_set (P3567R2)
  • Make optional<T&> trivially copyable (P3836R2)
  • Library Support for Expansion Statements (P1789R3)

Performance improvements:

• The performance of associative and unordered containers has been significantly improved, with some functions showing improvement of up to 11x.
• The performance of many algorithms has been improved (including std::find, std::for_each | ranges::for_each for associative containers, std::rotate), resulting in a performance improvement of up to 3x.
• {std,ranges}::{generate, generate_n}, {std,ranges}::{fill, fill_n} and {std,ranges}::distance have been specifically optimized for segmented iterators, resulting in a performance improvement of up to 10x (and even up to 1600x for distance on non-random-access iterators).
• std::search_n for random access iterators now tries to skip elements, resulting in a significant performance improvement (up to 70,000x in contrived cases).
• The vector::reserve() algorithm has been optimized, resulting in a performance improvement of up to 2x.
• num_get::do_get integral overloads have been optimized, resulting in a performance improvement of up to 2.8x.
• Some reallocations are now avoided in std::filesystem::path::lexically_relative, resulting in a performance improvement of up to 1.7x.
• ofstream::write now passes large strings to system calls directly instead of copying them in chunks into a buffer.

Miscellaneous improvements:

• Multiple internal types have been refactored to use [[no_unique_address]], resulting in faster compile times and reduced debug information.
• std::align is now an inline function, which allows the compiler to better optimize calls to it.
• std::atomic::wait has been refactored to accept more types to use platform native wait functions directly. This is guarded behind the ABI Macro _LIBCPP_ABI_ATOMIC_WAIT_NATIVE_BY_SIZE. (178191000)

Deprecations

The following items have been deprecated or removed:

• The minimum supported deployment target on macOS has been increased to 11.0.

Potentially breaking changes:

• The algorithm for multi{map,set}::find has been modified so that it doesn’t necessarily return an iterator to the first equal element in the container. This was never guaranteed by the Standard, but libc++ previously happened to always return the first equal element. Starting with this release, code relying on the first element being returned from find will be broken, and lower_bound or equal_range should be used instead.
• The algorithms for std::{map,set} lower_bound and upper_bound operations were modified so that their result changed for comparators that are not a strict weak order. Being a strict weak order was always a requirement of the Standard and still is, however in this release libc++ changes the behavior of std::{map,set} for such comparators. Since this may be tricky to work around in some cases, an escape hatch is provided in this release: defining _LIBCPP_ENABLE_LEGACY_TREE_LOWER_UPPER_BOUND will revert to the historical implementation of these operations. That escape hatch will be removed in an upcoming release (likely in the next release).
• The ABI flag _LIBCPP_ABI_NO_REVERSE_ITERATOR_SECOND_MEMBER has been split off from _LIBCPP_ABI_NO_ITERATOR_BASES. If you are using this flag and require ABI stability, you should set _LIBCPP_ABI_NO_REVERSE_ITERATOR_SECOND_MEMBER as well.

ABI-affecting changes:

• The ABI flag _LIBCPP_ABI_NO_REVERSE_ITERATOR_SECOND_MEMBER has been split off from _LIBCPP_ABI_NO_ITERATOR_BASES. If you are using this flag and require ABI stability, you should set _LIBCPP_ABI_NO_REVERSE_ITERATOR_SECOND_MEMBER as well.
• The internal types __map_value_compare, __unordered_map_hasher, __unordered_map_equal, __hash_map_hasher and __hash_map_equal have been refactored to use _LIBCPP_COMPRESSED_ELEMENT instead of potentially inheriting from the types they wrap. At this point in time we are not aware of any ABI changes caused by this.
• ranges::iota_view is now aware of __int128. This causes iota_view::difference_type to change from long long to __int128 in some cases.
• std::allocator is now trivially default-constructible. The behaviour can be reverted by defining _LIBCPP_DEPRECATED_ABI_NON_TRIVIAL_ALLOCATOR. This compatibility macro is going to be removed in an upcoming release.
• bitset::operator[] now returns bool, making libc++ conform to the Standard. The behaviour can be reverted by defining _LIBCPP_DEPRECATED_ABI_BITSET_CONST_SUBSCRIPT_RETURN_REF. This compatibility macro is going to be removed in an upcoming release. (178191050)

Coding Intelligence

New Features

• Google Gemini is now available in the coding assistant. (171990272)
• Planning with agents is now first class in Xcode. Plans appear as editable Markdown artifacts next to the conversation. You can use dedicated UI to review, annotate, discuss changes to the plan, and approve before the agent proceeds. (172857081)
• The Coding Assistant sidebar is now dedicated to displaying and organizing your conversations with real-time status and unread indicators, drag-and-drop grouping, archiving, and renaming. See at a glance which conversations are active or waiting for user input, and jump between them without losing context. Select multiple conversations to group, archive, or delete them in bulk. The context menu allows for opening conversations in new tabs, windows, or editor panes. (172926345)
• The Preview Snapshot MCP tool can now render variants such as light/dark appearance, portrait/landscape orientation, and various type size overrides. It also supports specifying timelines for Widgets and toggle states for Live Activities. Taken together, this gives agents more flexibility in how they render previews in your codebase. (172961797)
• Agents can now boot simulators, install and launch apps, synthesize touch events, and capture screenshots to verify UI behavior. (175179787)
• Added new MCP tools to read, plan, and edit translations in String Catalog files. (176376425)
• The toolbar now has a “New Conversation” button that lets you start a fresh conversation from anywhere in Xcode. When conversations are active, it shows a status indicator for easy monitoring at a glance. Click the status indicator to jump directly to the next conversation that needs attention. (176385678)
• The Xcode MCP server has been updated with new tools that allow agents to debug projects by manipulating the active run state, interacting with and reading the contents of the debugger console; listing and switching between available schemes and run destinations and inspecting and modifying build settings, compiler flags, entitlements, and Info.plist keys. (176935844)
• Agents in Xcode now have access to insights about your projects, such as crashes, disk writes, energy, hangs and launch issues impacting your app, helping reduce the time it takes to ship a fix. (177568662)
• The coding assistant has moved out of the navigator into the editor area, with a completely redesigned conversation transcript. Agent-generated artifacts, like code diffs, plans, and SwiftUI preview snapshots, appear alongside the transcript, and annotations on code snippets and plan documents let you give targeted inline feedback without leaving context. (178288550)
• Xcode now ships with Apple-built specialists for targeted tasks, like localization, UIKit resizing and accessibility. (178289150)
• Agents in Xcode can now be extended with plugins that contain skills, MCP servers, and ACP agent configurations. Skills are invokable as slash commands with completion support. (178289210)
• Coding Intelligence now includes a new security layer that monitors and controls filesystem access by coding agents and any processes they spawn. This can be enabled in Coding Intelligence settings. (178289431)
• Xcode adds support for the Agent Client protocol. (178294840)
• Agent Plug-ins can show custom icons and tool names for MCP servers they define by adding additional _meta fields to their JSON definitions.

{
  "name": "MyGreatPlugin",
  "description": "An awesome MCP server configuration.",
  "version": "1.0.0",
  "mcpServers": {
    "MyGreatMCP": {
      "type": "http",
      "url": "...",
      "tools": [
        "*"
      ],
      "_meta": {
        "ideToolIconPath": "./icon.svg",
        "ideToolIconRendersAsTemplate": true,
        "ideToolTitles": {
          "whoami": "Who Am I",
          "get-current-email": "Get Current Email Message"
        }
      }
    }
  }
}

(178470032)

Resolved Issues

• Fixed: Buttons in the Coding Assistant’s prompt area now use more accessible labels and descriptions. (177462284)
• Fixed VoiceOver getting trapped in the Coding Assistant prompt area. (177462397)

Known Issues

• If the plan-mode confirmation bar (“Implement the plan?” with Yes/No buttons) appears while the agent is still streaming a response, clicking either button may trigger a new agent turn on top of the in-flight one, leaving the conversation in an inconsistent state. As a workaround, wait for the agent to finish responding before confirming or dismissing the plan. (178673449)
• ACP agents added as part of agent plug-ins may not leave Xcode’s UI until relaunching Xcode. (178771195)

Console

Known Issues

• Console may fail to scroll fully to the bottom while output is streaming. (175800015)

Core AI

Known Issues

• The option to extract inputs from prediction events in the Core AI gauge in Xcode may not work reliably. (172502576)
• The number of parameters displayed in the Core AI model view in Xcode is inaccurate for models with multiple functions that share parameters. (177784390)
• When Metal API Validation is enabled, CoreAI models might fail to execute. (177991751)

Workaround: In Xcode, disable Metal API Validation. From the command line, ensure the MTL_DEBUG_LAYER environment variable is not set.

Debugging

New Features

• In projects using bridging headers, LLDB can now directly import explicitly built Swift modules and PCH from DerivedData. This can dramatically speed up the first expression or po in a debug session involving a bridging header. (168272248)
• LLDB can now inspect data types with ~Copyable fields in the standard library and other system frameworks. (176282041)
• LLDB now ships with an MCP server (lldb-mcp). See https://lldb.llvm.org/use/mcp.html for examples. (176901842)

Resolved Issues

• Fixed: Xcode 27 supports running and debugging on devices that run a minimum of iOS 17, watchOS 10, tvOS 17, and visionOS 1 (162647535)

Device Hub

Known Issues

• When running parallel testing in simulators, devices may not be visible in Device Hub but are still actively running tests. (176809181)

Workaround: Disable parallelized test runs if you want to watch UI tests executing in simulators.

• Renaming a device in Device Hub may cut off the renaming prematurely. (178477422)

Workaround: Rename the device from Terminal with devicectl device rename or change the name via Settings>General>About on the device itself.

File Template for Launch Tests

New Features

• Added a file template for launch tests that opts into runs For Each Target Application UIConfiguration, so the test runs across every combination of orientation, localization, and appearance your app supports. (168770106)

Foundation

Resolved Issues

• Fixed: +[NSURL URLWithString:] no longer double-encodes the % of valid percent-escape sequences when encoding other invalid characters. (161588649) (FB20439045)

Icon Composer

New Features

• Icon Composer 2.0 supports a new sharper rendering mode for upcoming 2027 operating systems with support for refractivity, outside specular, and deeper shadows.
  Use the group inspector to edit the new properties, and the toolbar to preview in either the new or original design generation.
  When your icon looks great in both design generations, add it to your Xcode project and it will be used for all OS versions. (172404678)

Instruments

New Features

• xctrace record allows you to pass recording options for Instruments from within the CLI. Use --show-recording-options to print available options for a template or instrument as a JSON. Pass a modified JSON file with customized options using --recording-options . (47649405) (FB5336460)
• Summary views in Instruments allows you to select multiple rows and copy the content. (50558735)
• Instruments no longer rescales graphs to reflect the local maximum when the visible timeline region changes to simplify comparison of data across the tracks. To trigger manual rescaling to the current viewport, use View → Rescale menu item. (60970746)
• Instruments now restores pinned tracks from the previous run when recording a new run. You can also save and restore pinned tracks explicitly using View → Track States menu actions. (69098114)
• System Trace now unifies system calls, VM faults, and thread states into a single plot. When zoomed out, a new blending algorithm summarizes activity so dense regions remain readable. You can follow the chain of scheduling events for a thread using left/right key navigation. The inspector panel shows details about each event, providing quick actions like pinning a thread that made another thread runnable. (163589543)
• Foundation Models Instrument now helps you trace and debug Foundation Models usage in your app with quick inspection of instructions, prompts, responses, token usage, and inference performance. (164223804)
• A new inspector displays information about the selected event and provides quick actions for pinning or filtering tracks and filtering the detail view. (165724281)
• Swift Concurrency: Tasks, Collections, Actors and Executors now have a detail option “Profile” which displays Call Tree made of profiling data captured while in state Running. This detail is only visible when recording with the Swift Concurrency instrument alongside Time Profiler or CPU Profiler. (168542912)
• When recording os_log Instrument together with an Instrument that creates process or thread tracks (like Time Profiler, CPU Profiler, or others), you can now overlay logging information on these tracks by enabling “os_log” graph in the “Track Graph Display” popover. (170113899)
• A new Swift Executors instrument is now available. It displays the Cooperative Thread Pool, the Main Actor, and any types conforming to TaskExecutor or SerialExecutor. Instruments properly captures and displays on iOS, iPadOS, macOS, tvOS, watchOS, visionOS 27. On older systems, executor names fall back to “Unknown executor”. (171189428)
• Swift Concurrency Task tracks now appear in new “Swift Task Collection” tracks. Instruments sorts Tasks into Collections based on their name or place of creation. You can switch Collection tracks between displaying task lifetimes and task states. (173885662)
• When opening files like .atrc or .logarchive, you can now specify a preferred template using ‘Settings → General → Templates for Import’ (58151217)
• New setting in the ‘General’ tab allows for overriding preferred template used for opening files such as .atrc or .logarchive. (73868296)
• Call Tree and Top Functions tables now persist selected rows. (120794625)
• Individual backtraces shown in the inspector now offer improved collapsing logic and are more consistent with the call tree’s “Heaviest Stack Trace” view. (130279660)
• When a profiled process terminates, the timeline view displays a flag showing the termination reason and exit code. (130528710)
• SwiftUI instrument adds a “Summary of Updates” focus action to the View Hierarchy detail view that makes it easier to see details about what updates a view in the view hierarchy is performing. (147328805)
• Allocations instrument now visualizes tagged allocations when a process is running with Memory Integrity Enforcement with a ‘(tagged)’ suffix. ‘Statistics’ view contains opt-in columns to view the count and total size of these allocations in aggregate. (149409607)
• States annotated with the StateReporting API are visible in Instruments as part of the Points of Interest instrument track. Expand top level track to inspect all captured domains and state transitions. (159709795)
• The SwiftUI instrument now records additional information about layout passes and the reasons a layout computation wasn’t cached. (162137231)
• Animation Hitches instrument now supports visionOS on devices running visionOS 27.0 or later. (163315840)
• You can now drag and drop files such as .atrc, .logarchive, or .sample onto the Instruments sidebar. This action creates a run for each of the imported files. (167697855)
• The interface to enable and disable graphs on tracks in the Instruments timeline now uses checkboxes to quickly toggle graph visibility on or off. (168232126)
• Swift Concurrency: When recording all processes, Tasks and Executors are now grouped in process hierarchies. (168542643)
• Swift Concurrency: Selecting a bar chart interval in an Actor or Executor Queue plot now displays the list of waiting tasks in the Inspector. Tasks enqueued before the trace started aren’t displayed. (169113107)
• You can now pin threads displayed in call tree views using the context menu. (169208779)
• os_signpost Instrument now displays a track for each signpost name, nested below the category level in the track hierarchy. (170272998)
• Swift Concurrency Tasks and Actors are now displayed even if their lifetime began before the trace. Instruments makes a best effort to display as much data as possible. Tasks now can have “Unknown” state. Tasks and Actors names may depend on order of incoming data. (171187553)
• xctrace export allows you to restrict time range of an export using time-start, time-end, duration arguments. (171320057)
• When you open a .tracetemplate file that isn’t saved in the Instruments user templates folder, the template is now copied into that location and subsequently accessible in the “User” tab. (172516226)
• System Trace template now graphs thread priority over time to help you understand issues related to resource starvation. (173463486)
• xctrace export of traces containing Allocations Instrument now contains a backtrace for each row element in the ‘Allocations List’ detail. Backtraces appear only when captured in the trace data. (173791067)
• The View menu has been reordered to clarify the function of each menu item. (177008275)

Resolved Issues

• Fixed an issue where the Hangs instrument would flag false-positive responsiveness issues in non-UI processes like daemons. (110146539)
• Fixed an issue where profiling an iOS app that was already open would close the app instead of relaunching it. (150320702)
• Fixed an issue where Instruments uses significant amount of memory when importing .atrc files. The memory footprint of the application in these scenarios is on average 1.5GB smaller. (162707266)
• Fixed an issue where the detail filter was not saved or restored when switching details in the Allocations, Leaks, and VM Tracker instruments. (167717200)
• Fixed a performance issue where the timeline would blink or animate unnecessarily when zooming into content. (168081396)
• Fixed an issue where time selection would be cleared when starting a new recording. (172327572)
• Fixed an issue where the Cause & Effect graph in the SwiftUI instrument could use large amounts of memory when zoomed into a very small time range. (172983697) (FB22288896)
• Fixed issues in the App Lifecycle graph: removed the inaccurate ‘Process Creation’ phase and fixed an issue where the ‘System Interface Initialization’ phase appeared twice. (174190644)
• Fixed an issue where Instruments target chooser would always resolve symlinks to binaries, preventing BusyBox binary profiling from working. (176476530)
• Fixed an issue where warnings and errors toolbar icon appeared clipped. (151921162)
• Fixed an issue where tooltips for events would sometimes show incorrect duration when zoomed out. (154788572)
• Fixed an issue where the last few libraries in the Symbols window were hidden behind the bottom bar. (171009409)
• Fixed an issue where the pinned view would resize to fit its content after you had already resized it to your preferred size. (173461626)
• Fixed an issue where ‘Auto Expand’ option in call tree ‘Find’ wouldn’t be enabled by default. (174513327)
• Fixed an issue where Allocations instrument graph constantly rescaled when recording in the immediate mode. (177577222) (FB22824426)

Known Issues

• Instruments crashes when opening ‘Task Creation Calltree’ view in the ‘Swift Tasks’ instrument or ‘Change Call Trees’ view in the ‘SwiftUI’ instrument. (178067883)

Deprecations

• Instruments now requires target iOS, watchOS and tvOS devices with versions of at least iOS 17, watchOS 10, or tvOS 17. (166097304)

Intel Deprecation

New Features

• Build targets with a min deployment target set to macOS 27.0 or DriverKit 27.0 will not build Universal by default. The ARCHS_STANDARD build setting will no longer include x86_64 when MACOSX_DEPLOYMENT_TARGET or DRIVERKIT_DEPLOYMENT_TARGET >= 27.0. The x86_64 architecture can be added to the ARCHS build setting if this is needed. (161837535)

Known Issues

• Xcode 27 will only install and run on Apple silicon Macs. The macOS SDK is still Universal for back deployment up to and including macOS 27. Intel development is still possible with macOS versions that support Rosetta like macOS 27. (162138432)

Interface Builder

New Features

• Introducing a new Interface Builder compilation mode, toolchain, for UIKit (Cocoa Touch) based documents. Enabled by default, toolchain allows compiling IB documents without the need to download a simulator, which is especially useful for build servers. Should you experience issues during this transition period, you can opt out via the IBC_COCOATOUCH_COMPILER_MODE = simulator build setting or using --cocoatouch-compiler-mode simulator when manually invoking ibtool. If you opt out, please file Feedback and include any errors you may have received from ibtool so we can investigate. (114401122)

Linking

Deprecations

• The ld64 linker has been removed and the -ld_classic option is no longer supported. (165165518)

Localization

New Features

• Exporting localizations now extracts NSLocalizedString and similar macros from header files in addition to implementation files. (19191207) (FB5500560)
• Agents in Xcode can now be used to translate strings in String Catalogs. You can ask an agent to translate strings ranging from a single feature to an entire project, into one or more languages.
  Xcode will add languages to your project settings, create missing String Catalogs, and provide guidance and context to agents as they translate. (111514130) (FB12479690)
• Strings in code with a localization comment of “do not translate” will be automatically marked as “Don’t Translate” in String Catalogs and translate="no" in exported XLIFFs. (111715368)
• Exported XLIFFs will use state-qualifier="leveraged-mt" to indicate strings that were translated using machine translation. (161775544)
• The String Catalog editor now includes a Generate Translations button as a shortcut to ask an agent to translate strings. You can also use the context menu to translate specific strings. (169559347)

Resolved Issues

• Fixed an issue where automatic strings could get removed from String Catalogs when declared using AppIntent APIs that take table parameters. (174776249)
• Fixed a crash that could occur when BUILD_ONLY_KNOWN_LOCALIZATIONS is used in a target with multiple Asset Catalogs. (176827483)

Metal

New Features

• The Diagnostics Panel in the Scheme Editor exposes more Metal validation options including logging non-fatal actions, validating load and store actions, logging resource allocation stack traces, and controlling GPU stack overflow detection. (162401628)
• The Metal Performance HUD exposes more MetalFX related metrics such as jitter sequence length and motion vector scale. The configuration panel includes a new “Overrides” panel when MetalFX is enabled, and allows customization of jitter multiplier, motion vector scale and exposure visualization for debugging purposes. (162557993)
• The Metal Capture popover includes a new “Include MetalFX temporal scaler history” advanced option that improves texture quality during replay when your app uses MetalFX temporal scaling. (169816556)
• The Metal Capture popover includes a new “Optimize shared memory capture” advanced option that improves capture performance and reduces GPU trace size on disk. (170023938)

Resolved Issues

• Fixed: The Queue Debugging setting to Enable Backtrace Recording is off by default. To view the process grouped by dispatch queues in the debug navigator, or to get recorded backtraces indicating the originating dispatch operation when viewing the process grouped by thread, please enable the setting in the scheme editor under Run > Options > Queue Debugging > Enable Backtrace Recording (164183224)

Known Issues

• An app may crash when run from Xcode with both Hardware Memory Tagging and GPU Frame Capture enabled. (178488388)

Workaround: Disable GPU Frame Capture in the Options tab of the scheme editor. Or temporarily disable Hardware Memory Tagging in both the Diagnostics tab of the scheme editor and Signing & Capabilities > Enhanced Security.

MusicKit

Known Issues

• MusicPlayer.Queue and MusicPlayer.State might not always update when using @State in SwiftUI. (176947544)

Workaround: Use @ObservedObject.

On Demand Resources

Deprecations

• On Demand Resources and the NSBundleResourceRequest API are deprecated. Use Background Assets instead. (170066290)

Organizer

New Features

• The Insights Overview summarizes high-impact performance regressions for metrics and diagnostic reports for your app. Use it to plan and prioritize performance engineering work. (159975360)
• The new Hitches metric replaces the Scrolling metric in the Organizer, now displaying animation hitches for all animations in your app. Use it to get a comprehensive view of animation performance. (160333794)
• Storage metrics are now available in Xcode Organizer, allowing you to monitor their app’s Documents & Data and App Size across releases and catch regressions in cache usage and bundle size. (160837780)
• AI-driven analysis is now available for diagnostics in Xcode Organizer, enabling expert analysis of power and performance issues and seamless integration with source code and the Coding Assistant. Quickly resolve the highest-impact performance issues in your app by using Generate Recommendations for Crash, Energy, Disk Write, Hang and Launch diagnostics. (177568727)
• Metric goals are now available for Battery Usage, Disk Writes, Hang Rate, Hitches, Memory, and Storage metrics, allowing you to prioritize performance engineering across more areas. Similar-app goals are also supported for Hang Rate, On-screen Battery Usage, Disk Writes, and Storage. Launch Time similar-app goals have been refined for improved accuracy, establishing new baselines. (177572744)

Playgrounds

Known Issues

• Standalone Swift files opened opened by double-clicking in Finder may fail to run #Playground or #Preview blocks. (177587795)

Workaround: Open Swift files using File>Open… or drag them directly onto the Dock icon.

Previews

New Features

• Canvas can now display a grid of previews for each argument passed to the new #Preview(arguments:) syntax. Clicking on a preview in argument or variant grids opens the preview in the Interactive mode. (167544057)
• Holding command will cause the input events (zooming and scrolling) to be handled by the canvas. This can be disabled with the new ‘Send Command-Modified Input to Canvas’ toggle in the Editor > Canvas menu. (170072429)
• iOS previews have a new Resizable Canvas mode that enables viewing the preview in arbitrarily sized containers (171013421)

Known Issues

• Attempting to Preview with an uninstalled runtime may fail to show a placeholder view and instead fall back to another preview destination. (177007609)
• An incorrect error banner may appear while using macOS’s Run as App preview feature (via the Live canvas mode button menu). (178092213)

Previews & Playgrounds

New Features

• Each #Preview and #Playground tab can now be pinned independently in the canvas. (167543928)

Resolved Issues

• Fixed an issue where there was a long delay before Canvas showed an error when a likely crash occurred. (168097944)

Simulator

New Features

• simctl and devicectl now support rebooting a simulator using the reboot command. (172303413)

Known Issues

• An extra control for keyboard capture mode appears in the Device Hub toolbar under the view for the visionOS simulator. (177082480)
• An extra control for Simulate Trackpad or Mouse mode appears in the Device Hub toolbar under the view for the visionOS simulator. (177086926)
• After rebooting a running visionOS simulator, the ability to interact with the simulator is lost. (178635793)

Workaround: Quit and restart the Device Hub application after rebooting the simulator.

• The simulator sometimes does not get cleared after deletion. (178661525)

Workaround: Restart the machine and re-attempt to remove it.

Source Editor

New Features

• All new Markdown editor. View markdown files in your project and from agents in rendered form. Create and edit markdown using familiar formatting tools. View markdown as source code and see the rendered preview by activating Xcode’s canvas. (175022151)

Resolved Issues

• Fixed an issue in macOS 27 where clicking the close button in an expanded macro added a breakpoint rather than closing the expansion. You can use Editor > Hide Macro Expansion to close the expansion. (174376098)

StoreKit Testing in Xcode

New Features

• New StoreKit configuration UI to configure In-App Purchase offer codes, and new off-device purchase options to test purchases with IAP offer codes via the Transaction Manager. (141012907)
• Subscription Bundles can be configured for local testing in the StoreKit Configuration. (164203930)
• Subscription Suites can be configured for local testing in the StoreKit Configuration. (166899262)
• Add support for creating volume purchase transactions for 1-month and 1-year auto-renewing subscriptions through the Xcode Transaction Manager. (169041777)

Swift Compiler

New Features

• The Swift dependency scanner has been optimized to avoid redundant setup work and header searches when looking up Clang modules during a single dependency-scan action, substantially improving scanning performance.
  As a consequence of this change, every Clang module reachable from a single Swift dependency-scan action must have a unique module name. If two module maps visible to the same scan declare a Clang module with the same name, the scan may report an error. Previously, the scanner may have tolerated duplicating names.
  The most common cases are projects or SDKs that vend the same Clang module name from more than one location on the header search path, and vendored third-party sources that ship a module.modulemap redeclaring an SDK module. (136303612)

Swift Package Manager

New Features

• When one or more test targets in a package experience a test failure, swift test summarizes them at the end. (168311253)
• swift test now supports repeating test cases until a condition is met. Pass --maximum-repetitions and --repeat-until [pass|fail] to swift test to repeat your tests until they pass or fail. Only those test cases that match the repeat condition will be repeated. (177561078)

Swift Testing

Resolved Issues

• Fixed: The ‘Test Repetition Mode’ setting now only repeats individual Swift Testing test cases, rather than repeating the entire test plan. (130508488)
• Fixed: Large Swift Testing test suites with many parameterized test cases have significantly better performance in Xcode 27. (171415950)

Swift/C++ Interoperability

New Features

• When calling a C++ constructor that has parameters with default expressions, you no longer have to pass all arguments explicitly in Swift. (118987713)
• You can now convert Swift closures to instances of std::function. For example:

// C++
void processNumbers(const std::vector<int> &numbers, std::function<void(int)> op);
// Swift
processNumbers([1, 2, 3], .init { print($0) })

(133777029)

• You can now annotate constructors of foreign reference types as SWIFT_RETURNS_RETAINED or SWIFT_RETURNS_UNRETAINED. (135368369)
• Mapping __counted_by and std::span parameters annotated with __noescape to Swift Span no longer requires the SafeInteropWrappers experimental feature flag.
  Mapping return values to Span using __lifetimebound is still guarded by the experimental feature flag.
  For more information, see https://www.swift.org/documentation/cxx-interop/safe-interop/#safe-overloads-for-annotated-spans-and-pointers (148994016)
• Raw pointers to intrusively reference counted types (annotated with SWIFT_SHARED_REFERENCE) are imported as Swift classes. Starting with this release you can now annotate smart pointer types pointing to such reference counted types with SWIFT_REFCOUNTED_PTR macro to bridge their instances to Swift classes. For example:

struct SWIFT_SHARED_REFERENCE(...) SharedObj {};
template <class T>
struct SWIFT_REFCOUNTED_PTR(.getPtr) Ptr {
  Ptr(T* ptr);
  T *_Nullable getPtr() const { return ptr; }
};
using ObjPtr = Ptr<SharedObj>;
void takesSmartPtr(ObjPtr p);

The function takesSmartPtr is imported to Swift as:

func takesSmartPtr(_ p: SharedObj?)

(156521316)

System

New Features

• System now provides Swift APIs for the C stat, lstat, fstat, and fstatat system calls. This includes a new Stat type with initializers from FilePath, FileDescriptor, or a C string; FilePath.stat() and FileDescriptor.stat() instance methods; and supporting types (FileType, FileMode, Flags, UserID, GroupID, DeviceID, and Inode). See SYS-0006 for more details. (160612181)

Known Issues

• Custom FilePath or FileDescriptor extensions that make unqualified calls to stat() or stat(_: _:) (without the Darwin. qualification) might conflict with the new Swift stat() instance methods introduced in SYS-0006, causing build errors. (177911316)

Workaround: Migrate to the new Swift stat() methods, or disambiguate using Darwin.stat() and Darwin.stat(_: _:). See SYS-0008 for more details.

System Trace: Quality of Service

New Features

• Thread Activity Instrument now displays Quality of Service of individual threads. Effective QoS is displayed by default, Requested QoS is hidden by default (use the track dropdown menu of Thread items in order to reveal it). (173043672)

Testing

New Features

• In your Test Plan, you can control how the system responds to target application crashes during UI testing by choosing one of four severity levels: off, warning, failure (default), or fatal failure. (168107814)
• Added a filter to the test plan configurations tab. (168608491)
• Added recent tests and open tests filters to the Test Navigator. (168608830)
• When you call an XCTest or Swift Testing assertion within a test from the opposite framework, you will see a runtime issue with warning severity if the assertion failed. Control this behavior with the new Swift Testing and XCTest Interoperability setting in your test plan. (170335449)
• Updated the test plan JSON to sort tags, making it easier to review changes. (174178766)

Resolved Issues

• Fixed an issue where adding an attachmen to a test case during the XCTestObservation callbacks testCaseWillStart(:) or testCaseDidFinish(:) by calling XCTestCase.add(_:) did not persist the attachment in the results. (89059895)
• Fixed: Swift Testing is now better-able to associate recorded issues with the tests that generated them when they occur in detached Swift tasks, on dispatch queues, or on background threads. (169036231)

Known Issues

• When running tests with the swift CLI, cross-framework issues from XCTest are not surfaced when running Swift Testing tests in Swift Package projects. (177970158)

Workaround: Run tests in your project with Xcode.

Wi-Fi Aware

Known Issues

• wifiAware and wifiAware(_:) extensions on NWParameters are unavailable for configuring Wi-Fi Aware properties. (178019157)

Workaround: Use wifiAware(_:) extension on NWParametersBuilder instead to configure Wi-Fi Aware properties.

XCTest UI and Unit Tests

Known Issues

• watchOS Unit and UI tests may not run on device. (178874363)

Workaround: Run tests on simulator.

Original source

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

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

• Fixed: macOS deprecation notifications incorrectly identify a host app as Intel-only when a system plugin loader, such as a Color Picker or Print Dialog Extension, loads x86 code into the host process. (174841181) (FB22512943)

Original source

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

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

Known Issues

• You might be unable to create new stickers or see existing stickers when sticker data becomes corrupted. This prevents you from using stickers, and the issue can persist to other devices when synced via iCloud. (163377768)

Original source