macOS Release Notes

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

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

AirDrop

Known Issues

• Some macOS devices set to “Everyone” are not displayed in AirDrop (163684116)
  • Workaround: Set the devices to “Contacts Only” in AirDrop settings and ensure the devices have each other’s Apple account email or phone number in their Contacts.

Instruments

Resolved Issues

• Fixed: The Allocations instrument sometimes fails to report reference counting operations for native Swift types. (163080666)

StoreKit

Resolved Issues

• Fixed: An issue prevents the purchase of a subscription using a win-back offer when testing with StoreKit Testing in Xcode. (162357552) (FB20604848)

Known Issues

• SubscriptionStatus.all returns old SubscriptionStatus after a subscription change. (163505178)
  • Workaround: Wait 24 hours and try again.

See Also

• macOS 26
• mac OS Tahoe 26 .1 Release Notes

Update your apps to use new features, and test your apps against API changes.
mac OS Tahoe 26 Release Notes
Update your apps to use new features, and test your apps against API changes.

Original source Report a problem

New Features

NSButton

• Buttons no longer highlight using the accent color when clicked. Before using any subclass that performs custom drawing, inspect the button cell’s doc://com.apple.documentation/documentation/appkit/nscell/1526141-interiorbackgroundstyle property to determine if the bezel draws in a normal or emphasized state.
• Buttons now support custom tinting with the bezel Color property. This property — previously applied only in the Touch Bar — now functions for all in-window buttons using the doc://com.apple.documentation/documentation/appkit/nsbuttontype/nsbuttontypemomentarypushin style.

NSSlider

• When clicking on the track, for linear sliders, circular sliders, or dial, the slider now animates to the new value.
• You can now tint sliders with colorful track fills using the track Fill Color property. This property now functions for all in-window sliders.

NSSegmentedControl

• Segmented controls now support custom tinting via the selected Segment Bezel Color property. This property now functions for all in-window segmented control styles that draw colorful selected segments.

NSPopover

• NSPopover has a new animation when appearing and dismissing.

Symbol Images

• SF Symbols now support layered symbol images. Layered symbol images use an updated data format to annotate each path element of the symbol with a level in a hierarchy: primary, secondary, tertiary, and so on. At draw time, AppKit can assign different colors to each layer of the symbol using new APIs on NSImage .Symbol Configuration. Many system-provided symbol images redesigned to include layered versions.
• NSImage .Symbol Configuration now supports merging two configurations with applying(_) method.
• NSImage now includes a read-only property, NSImage .Symbol Configuration, for its current symbol configuration. You can use this property to configure other symbol images to match a reference image, or to merge an image’s existing configuration with a set of new configuration options.

Restorable State

• To enable secure coding for a restorable state, implement application Supports Secure Restorable State(_:). When opted in:
  • The system requires classes passed to restoration Class to explicitly conform to NSWindow Restoration.
  • Set requires Secure Coding to true and the decoding Failure Policy to NSCoder .Decoding Failure Policy .set Error And Return for any coder the following implementations or overrides use decoding Failure Policy set to NSCoder .Decoding Failure Policy .set Error And Return:
    • restore Window(with Identifier: state: completion Handler:)
    • restore Window(with Identifier: state: completion Handler:)
    • encode Restorable State(with:)
    • encode Restorable State(with: background Queue:)
    • restore State(with:)
    • restore Window(with Identifier: state: completion Handler:)
    • encode Restorable State(with:)
    • encode Restorable State(with: background Queue:)
    • restore State(with:)
  • Additionally, restorable State Key Paths must only point at NSSecure Coding-compliant values and you need to implement allowed Classes(for Restorable State Key Path:) to specify the type of the object.

NSMenu

• The new user preference “Automatically hide and show the menu bar in full screen” in Dock & Menu Bar preferences is enabled by default. In macOS Monterey 12, the user can choose to disable this setting to always show the menu bar in full screen spaces. Standard full screen windows are resized to fit below the menu bar. Some apps assume a full screen-sized window, and don’t work well with this setting.

NSTableView

• 20-point spacing precedes each group row to make the separation between sections more visible. Source lists have a similar, but smaller, 13-point spacing. This applies to the NSTable View .Style .inset and NSTable View .Style .full Width effective styles in apps linked against the macOS 12 SDK. NSTable View .Style .plain doesn’t display the spacing.
• The floating group row transition — previously a push transition — instantly replaces the new floating group row. It occurs when the x-height of the group row’s label meets the bottom of a currently floating group row.

NSOutlineView

• The disclosure button now aligns with the cell view’s first Baseline Offset From Top. The system overrides it in NSTable Cell View so it matches the baseline of its text Field (assuming textfield sets the baseline). Overriding the property and returning 0 reverts to the previous behavior.
• When collapsing several items, the selection Did Change Notification only posts once. Previously, it posted once per collapsed item.

NSOpenPanel

• Setting can Choose Files to false automatically disabled files, but all of the directory contents were sent to panel(_: should Enable:) or panel: should Show Filename:. In macOS Monterey 12, files aren’t sent to the delegate methods unless can Choose Files is true. In addition, file packages are excluded unless treats File Packages As Directoriesis is true. This change allows optimization in the delegate method.

TextKit 2

• TextKit 2 introduces a new text layout engine and its associated API. You can use TextKit 2 alongside the existing TextKit API.
• NSText Content Storage and NSText Layout Manager are the two main controller objects superseding NSText Storage and NSLayout Manager respectively. NSText Paragraph managed by NSText Content Storage represents a paragraph of text. NSText Layout Manager stores the layout information in its model objects: NSText Layout Fragment and NSText Line Fragment.
• In TextKit 2, NSText Selection encapsulates information associated with a text selection while NSText Selection Navigation manipulates and converts the selection object based on keyboard and mouse navigation actions.

Original source Report a problem

NSEPSImageRep

• Deprecated in macOS 14.0 as encapsulated PostScript (EPS) files are no longer supported by macOS. Learn more on Apple Support. (107052479)
• Attempting to initialize an instance of NSEPSImageRep will always return nil on macOS 14.0 and later.
• Attempting to initialize an instance of NSImage with an EPS file or data will always return nil on macOS 14.0 and later.
• If a multi-rep image is initialized by name (NSImage(named:), Bundle.image(forResource:), etc.), it will no longer include EPS reps. If no supports (non-EPS) reps could be produced, this will result in nil being returned from these functions.

NSImageDelegate

• Deprecated four of the five NSImageDelegate methods as of Mac OS X 10.4 Tiger. (18422088)
• -image: will Load Representation:
• -image: did Load Representation Header:
• -image: did Load Part Of Representation: with Valid Rows:
• -image: did Load Representation: with Status:
• These methods haven’t been called by AppKit since Mac OS X 10.4 Tiger.
• Using these symbols in Objective-C may produce warnings or errors, depending on the project’s build settings.
• These symbols are no longer available in Swift in the macOS 14.0 SDK.

NSSavePanel, NSOpenPanel

• Added the property identifier. (4228269)
• Modeless and application modal open and save panels are now main windows. (14623155, 103038843)
 This fixes a problem where menu items that weren’t applicable to the open or save panel remained enabled.
Open and save panels that are displayed as sheets are unchanged.
• Removed the titlebar from modal and modeless NSSavePanels. (105212420)
 This changes NSSavePanel to have consistent behavior with NSOpenPanel.

NSPrintPanel, NSPageLayout

• Applications linking against SDKs released for Fall 2023 may now release the NSPrintInfo instance and other related objects as soon as the NSPrintPanel/NSPageLayout panel is dismissed.
• Added block based variants of the begin-sheet methods (6990600):
  class NSPrintPanel {
  open func beginSheet(using printInfo: NSPrintInfo, on parentWindow: NSWindow, completionHandler handler: ((NSPrintPanel.Result) -> Void)? = nil)
  open func beginSheet(using printInfo: NSPrintInfo, on parentWindow: NSWindow) async -> NSPrintPanel.Result
  }
  class NSPageLayout {
  open func beginSheet(using printInfo: NSPrintInfo, on parentWindow: NSWindow, completionHandler handler: ((NSPageLayout.Result) -> Void)? = nil)
  open func beginSheet(using printInfo: NSPrintInfo, on parentWindow: NSWindow) async -> NSPageLayout.Result
  }

NSColor

• NSColor.textInsertionPointColor provides a robust way to get the current text insertion point color as defined by the system.
• To be consistent with an NSTextView, use NSTextView.insertionPointColor.
• Otherwise, if not using a text view, use NSColor.textInsertionPointColor.

NSTextInsertionIndicator

• NSTextInsertionIndicator is a new NSView that encapsulates all the behavior for a text insertion indicator — such as blinking while waiting for typing and prompting during dictation. NSTextView uses the NSTextInsertionIndicator. But, if using a custom text implementation, instantiate and add an NSTextInsertionIndicator as a subview of the custom text view. Its text implementation only needs to set the indicator view’s display mode—automatic, visible, or hidden—and frame. Based on the display mode the indicator view will infer from the frame whether it needs to blink or not.

NSView

• In macOS 14, AppKit is exposing the clipsToBounds property of NSView.

For applications linked against the macOS 14 SDK, the default value of this property is false. Apps linked against older SDKs default to true. Some classes, like NSClipView, continue to default to true. The change in defaults recognizes that it is vastly easier to reason about clipping a view’s descendants than it is to unclip a view’s ancestors.

Users can turn clipping back on by using the NSView.clipsToBounds setter or using the attributes inspector of a view in the Xcode interface builder.

This property is available back to macOS 10.9. This availability is intended to allow code targeting older OSes to set this property to true without guarding the setter in an availability check. Setting this property to false on previous OSes may not work reliably.

Some patterns that have historically worked will require adjustment:
◦ Showing or hiding UI by setting an ancestor’s frame to zero. When attempting to hide a view hierarchy by shrinking the size of an ancestor, or positioning a descendent view outside an ancestors view’s bounds, it is now necessary to set the ancestor’s view’s .clipsToBounds property to true. An alternative may be to set NSView.isHidden, instead.
◦ Filling the dirty rect of a view inside of -drawRect. A fairly common pattern is to simply rect fill the dirty rect passed into an override of NSView.draw(). The dirty rect can now extend outside of your view’s bounds. This pattern can be adjusted by filling the bounds instead of the dirty rect, or by setting clipsToBounds = true.
◦ Confusing a view’s bounds and its dirty rect. The dirty rect passed to .drawRect() should be used to determine what to draw, not where to draw it. Use NSView.bounds when determining the layout of what your view draws. (10905750)

NSViewController

• Added API:
  open var viewIfLoaded: NSView? { get }
  open func loadViewIfNeeded()
  open func present(_ viewController: NSViewController, asPopoverRelativeTo positioningRect: NSRect, of positioningView: NSView, preferredEdge: NSRectEdge, behavior: NSPopover.Behavior, hasFullSizeContent: Bool)
• NSViewController.loadView() no longer throws an exception when the view controller’s nibName is nil. (81775005)

TextKit API Coordinate System Changes

• Applications linking against SDKs released for Fall 2023 have behavior changes from TextKit API.
• NSTextLineFragment.typographicBounds is relative to NSTextLayoutFragment.layoutFragment.origin (instead of in the text container coordinate system as it was before)
• NSTextLineFragment.typographicBounds.size.width doesn’t contain NSTextContainer.lineFragmentPadding. The side effect of this change is that the padding is also excluded from both NSTextLayoutFragment.layoutFragmentFrame and NSTextLayoutManager.usageBoundsForTextContainer. Consequently, NSTextLineFragment.glyphOrigin.x no longer includes the padding, either.
• NSTextLineFragment.locationForCharacterAtIndex() used to return a point relative to NSTextLayoutFragment.origin. It now returns a point relative to the text line fragment coordinate system as documented.

Restorable State

• Secure coding is automatically enabled for restorable state for applications linked on the macOS 14.0 SDK. Applications that target prior versions of macOS should implement NSApplicationDelegate.applicationSupportsSecureRestorableState() to return true so it’s enabled on all supported OS versions.

Display Link

• A CADisplayLink can be created via NSView.displayLink(target: selector:). The CADisplayLink will automatically track the display the view is on, and will be automatically suspended if it isn’t on a display. A CADisplayLink instance can also be created from an NSWindow or NSScreen.

NSToolbar

• Applications linked against the macOS 14.0 SDK will no longer show the .toggleSidebar toolbar item to the leading edge of the inline window title and will instead show relative to its order in the defaultItemIdentifiers delegate method. It is recommended to place this item above the sidebar section of the toolbar as the leading most item of that section so that toggling the sidebar does not move the toolbar item itself. As a reminder, items placed before the .sidebarTrackingSeparator in the defaultItems delegate method will appear above the sidebar in the toolbar. Similarly, the best place for the new .toggleInspector item is above the inspector section of the toolbar as the trailing most item following the .inspectorTrackingSeparator, but it may be placed elsewhere in the toolbar if appropriate.
• NSToolbar now supports centering items in multiple sections of the toolbar. Use the centeredItemIdentifiers property to specify a set of items and they will be centered in the section they appear in. The set of centered items no longer applies to a single section of the toolbar, but may be used to center one item in the sidebar section and another item in the content section for instance.
• NSToolbar with autosavesConfiguration enabled and allowsUserCustomization disabled will now persist manual changes to the toolbar from -insertItemWithIdentifier: atIndex: and -removeItemAtIndex: across app launches. Previously manual inserts/removes were not persisted. Additionally, NSToolbars with autosavesConfiguration disabled will now sync manual inserts/removes to other NSToolbar objects with the same identifier, including new windows, but the toolbar’s configuration will not persist across app launches. If syncing across windows is not desired, each window’s toolbar should be given a unique identifier. (103038749)

Menus

• In macOS 14, menus have been reimplemented from the ground up to fully use AppKit.
• New section header API provides a consistent way to organize and structure menus.
• NSMenu has new selectionBehavior property, which allows the menu to automatically manage state of the same selection groups, reducing the amount of code the developer has to write.
• Palette presentation style allows to show menu items in a horizontal series, embedded inline in the parent menu.
• NSMenuItem has new API to create section header menu items, which are used to organize and structure menus. The appearance and behavior of section header items are entirely defined by NSMenu and cannot be customized. (59962793)
• For applications linked against the macOS 14 SDK, NSMenu will now assert if a secondary thread inserts or removes menu items from menus contained within the main menu. Making changes to the main menu from any thread other than the main thread has never been a supported or safe programming practice, because the main thread may be examining the main menu contents at any time (for example, to draw the menubar, to determine if a menu item matches a key event, to answer an accessibility request, etc), and there is no method for a background thread to modify the main menu while ensuring that the main thread is not simultaneously examining its contents. This practice is now prevented at runtime. (96331659)

App Activation

• In macOS 14, app activation is driven by user intent. It is treated by the system as a request and is not always guaranteed to be honored or to succeed. Apps have the ability to provide context with activation requests in cases where a more deterministic result is desired.
• NSApplication.activate(ignoringOtherApps:) and NSApplication.ActivationOptions.ignoringOtherApps are deprecated in macOS 14 and should not be used.
• NSApplication has a new method, activate, that sends the activation request to the system. The request may provide different results based on the context in which the app is running, user activity, and other factors. If necessary for app functionality, active status can be checked by querying the isActive property on NSApplication. In general, apps should not assume that activation requests will always succeed.
• macOS 14 provides more ways for apps to express the context in which activation should occur. A common scenario is cooperative activation, or passing the active state from one app to another. This process can be useful for apps that need to explicitly pass activation state, such as launchers and view services. The active app can use NSApplication.yield(to:) method to yield its active state to an instance of NSRunningApplication, or yield(toApplicationWithBundleIdentifier:) to yield to a bundle ID, which may be used in case the receiver app is not running or its status is unknown. Note that the sender does not deactivate at the time of invoking these methods. After yielding, the sender may activate the receiver using NSRunningApplication API, or the target app may simply activate itself by invoking the NSApplication.activate method. The cooperative activation mechanism guarantees successful activation as long as the yielding app is active at the time of the request and the receiver can become active.
• Existing calls to NSApplication.deactivate() should be replaced by NSApplication.yield(to:) to make activation handoff more explicit, and to delay changing the appearance of the calling app until the target app has activated.

Original source Report a problem

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

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

• Fixed an issue where iPod shuffle (3rd and 4th generation) cannot be synced due to an unknown error (-244). (107114363)

• Fixed an issue where NSHostingView would not appear when printed using NSPrintOperation. (109412691)

Original source Report a problem

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

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

Apple Studio Display firmware update starts showing progress but never completes. (107287354)

Workaround: To install other updates including future macOS Beta Updates, click "More info..." in Software Update Settings, uncheck Apple Studio Display firmware update, and click "Install Now."

Fixed increasing column-count above 2 not updating the layout. (71808738)

Fixed a regression in macOS Ventura 13.3 where a security check causes bookmark resolution to fail when the path contains Unicode characters stored with composed normalization. As an example, this prevented files in Finder from opening when double-clicked. (107550080)

Fixed: Using Image Renderer within a Share Link's preview closure crashed the running application. (107763234)

Original source Report a problem

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

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

General

Resolved Issues
• Fixed: Users might experience a blank screen with an active cursor for an indefinite period of time when attempting to update to Sonoma Beta 6. (114166127)

Accelerate

New Features
• Spatial
◦ Introduced trigonometry functions for Spatial angle type.
◦ Introduced spherical linear interpolation for Spatial rotations.
◦ Introduced swing-twist decomposition for Spatial rotations.
• BNNS
◦ Introduced BNNSRandom Fill Categorical Float that fills a tensor with random values from the categorical distributions with event probabilities.
◦ Introduced k-nearest neighbors calculation.
• vImage
◦ Introduced vImage Convolve Float Kernel _ARGB8888 that applies convolution to 8-bit-per-channel, 4-channel interleaved images using 32-bit floating-point weights.
◦ Introduced vImage Sep Convolve _ARGB8888 that applies separable convolution to 8-bit-per-channel, 4-channel interleaved images.
◦ Added flood fill, perspective transform, and new lookup table transforms to vImage.Pixel Buffer. (105830806)

Accessibility

Resolved Issues
• Fixed: VoiceOver might not speak inline predictive text in some text fields. (109225941)
• Fixed: VoiceOver users might not be able to move focus to enter Recovery mode. Instead users will hear “Accessibility Visuals Agent has no windows.” (109588439)

AirPods

New Features
• To test new features such as Adaptive Audio, Personalized Volume, and Conversation Awareness, developers need to install AirPods beta firmware. To learn more, see Installing Apple Beta Software (110183983)
• With Personalized Volume, when watching third party media, a volume slider might show up. (110266313)
• Conversation Awareness might react to self-made sounds such as humming, throat clearing, and might fail to end automatically when there is ongoing speech nearby. (110266324)
• Conversation Boost in Control Center Hearing Module will not turn on the feature. (110266328)

Resolved Issues
• Fixed: Press and Hold AirPods in Settings on iOS and macOS for AirPods will only save the noise control rotations on the local device. (110266311)
• Fixed: FaceTime calls from iOS answered with macOS with AirPods stem might not able to mute. (110266339)
• Fixed: Spotify App on macOS will automatically route audio from Spotify on iOS without playing audio. (110266347)
• Fixed: AirPods color might be inverted in dark mode in the tutorial cards for Adaptive Audio. (110266361)

App Intents

Resolved Issues
• Fixed: The Deprecated App Intent protocol might not show the App Intent as deprecated in the Shortcuts app. (103277731)
• Fixed: UI shown in Widget configuration and the Shortcuts editor might not respect the size of an array @Parameter. (109050453)
• Fixed: Widget configuration, Focus Filters, and Shortcuts editor might not allow some Measurement dimensions to be configured. (109114787)

AppKit

New Features
• See AppKit Release Notes for macOS 14. (110084217)

ATS and ATSUI

Deprecations
• Starting macOS 14 Sonoma, whenever the OS detects the usage of ATS or ATSUI APIs, the user will be presented a dialog stating that the application needs to be updated. Once the dialog is dismissed by the user, the application will exit. (100521621)

Authentication Services and Passkeys

New Features
• The Credential Provider API for password managers has been expanded to support passkeys. Credential providers can save and offer passkeys for apps and websites across the system. (83501802) (FB9651656)
• ASSettings Helper allows password manager apps to directly open the Settings view where the Credential Provider Extension for system-wide Password AutoFill and passkey sign-in can be enabled.
• ASSettings Helper also allows verification code (TOTP) apps to directly open the Settings view where you can configure which app opens verification code setup links. (106351958) (FB12039478)

Camera and AVFoundation Capture

Resolved Issues
• Fixed: On iPhone 14 and 14 Plus models third-party camera applications might fail to capture images, and the built-in Camera app and third-party applications using the new Deferred Processing API might fail to process final images. (113158045)

Continuity Camera

Resolved Issues
• Fixed: In Control Center’s Video Effects Menu, clicking on the zoom button should reset the zoom level to the default value. If you’re using a Continuity Camera device with only one camera, or the Apple Studio Display camera, it does not reset. (109541385)

Control Center / Video Preview

Resolved Issues
• Fixed: Zoom slider in Control Center video preview might be missing for apps when Center Stage is OFF. (110818198)

CreateML

Known Issues
• Create ML may crash or hang on launch on devices with macos 14.0 beta 7. (113703568)
Workaround: Use macos 14 beta 6 or earlier

Documentation

Resolved Issues
• Fixed: Xcode crashes on macOS Sonoma Beta 1 and Beta 2 when scrolling documentation in Quick Help, the documentation window, and the Swift Package dependency manager. (109810157)

Facetime handoff

Resolved Issues
• Fixed: Facetime handoff to another device might result in call drop or no media. (110126569)

FaceTime on Apple TV

Resolved Issues
• Fixed: When an Apple TV calls a Mac, a non-human readable string might appear in the calling notification. (110021693)

File System

New Features
• The implementations of the exfat and msdos file systems on macOS have changed; these file systems are now provided by services running in user-space instead of by kernel extensions. If the application has explicit checks or support for either the exfat or msdos file systems, validate the applications with those file systems and report any issues. (110421802)

Find My

Resolved Issues
• Fixed: The Find My application on macOS might quit unexpectedly while enabling Lost Mode on a device. (109379261)

Foundation

New Features
• Introduced Term Of Address which describes how a person should be addressed in language. This can be used in conjunction with Automatic Grammar Agreement to refer to people in a string using their preferred pronouns and grammatical agreement in English, Spanish, Portuguese, French, Italian, and German. (99745330)
• Foundation now supports grammatical agreement with a detached phrase using the agreeWithConcept markdown attribute. (102595293)

Freeform

Resolved Issues
• Fixed: Strokes drawn using Beta 2 might appear distorted when viewed on devices running Beta 1. (107901155)
• Fixed: The Follow Me feature will only work when collaborators are on the same Beta version. (110656281)

iCloud

Resolved Issues
• Fixed: Users with iCloud Drive sync disabled are unable to access settings for some apps using iCloud. (105284675)
• Fixed: The System Settings application might become unresponsive after creating a new account and then signing out of iCloud. (109789130)
• Fixed: Non-local files in iCloud Drive might fail to download and open after using Migration Assistant to set up a new volume. (109798846)

iCloud Drive

Resolved Issues
• Fixed: iCloudDrive folders owned by root or other local users might be inaccessible after upgrade to Sonoma. (109204311)
• Fixed: Enabling desktop and documents sync might fail after upgrade to Sonoma. (109507087)
• Fixed: Finder or Apps might hang when accessing App created folder with .folder extension. (112600553)

iCloud Settings

Resolved Issues
• Fixed: Users might not be able to view Apps Syncing to Drive in iCloud Drive Settings. (110732437)

iMovie Theater & iCloud Drive

Known Issues
• “Copy to File” to iCloud Drive destination might not work as expected. (113644592)

Installation

Resolved Issues
• Fixed: Updates to macOS 14 beta will freeze if installing to a HFS formatted volume on intel machines. (112165783)

iPhone Widgets on Mac

New Features
• iPhone Widgets on Mac might appear duplicated if switching between more than one supported iPhone as source. (108567555)
• iPhone Widgets on Mac might not be removed when disabling iPhone Widgets On Mac in System Settings. (109236950)
• iPhone Widgets on Mac might not populate on the Edit Widgets add sheet until after a reboot post sign in. (109479534)
• iPhone Widgets on Mac might not be removed when signing out of iCloud. (109527436)
• iPhone Widgets on Mac might not update upon wake from sleep. They will update at the next cadence when the Mac and iPhone are nearby and awake. (109691143)
• iPhone widgets on Mac allow XL widgets from iPhone to be available. If assets are not available on the iPhone, the assets will be missing. (109782417)
• iPhone Widgets on Mac that contain drop down sortable lists in their configurations might fail to configure. (109976067)
• iPhone Widgets on Mac might not update upon wake from sleep. They will update at the next cadence when the Mac and iPhone are nearby and awake. (109978135)
• iPhone Widgets on Mac might not be removed when disabling iPhone Widgets On Mac in System Settings. (110804620)
• Widget App icons might appear blank in the Add Sheet if Mac is updated from Beta 2 to Beta 3 before iPhone is updated. (111334099)
• iPhone widgets on Mac might not be available if 2 users are signed into the same Mac at the same time. (111336466)

Resolved Issues
• Fixed: iPhone Widgets on Mac might lead to additional power draw on iPhone if a Mac signed into the same iCloud account is present. (110074764)

Localization

Resolved Issues
• Fixed: Some content might appear in English. Some strings might appear clipped. (109393568)

Lockdown Mode

Resolved Issues
• Fixed: When erasing a Mac that has Lockdown Mode turned on, the Lockdown Mode state might inadvertently persist in NVRAM. (109470608)

Login Window

Resolved Issues
• Fixed: Users will be missing or duplicated when the multi-user layout is shown. (108899565)
• Fixed: When using a smart card, the multi-user layout can be accessed. (109425371)
• Fixed: The password field might not show the PIN placeholder text when using a smart card. (109428156)
• Fixed: The “Your password is required to enabled Touch ID” message might be shown when smart card is in use. (109429083)

Mac App Store

Resolved Issues
• Fixed: Users are unable to create new Apple IDs in the Mac App Store. (108293571)

Mac Catalyst

Resolved Issues
• Fixed: *Catalyst Optimized for Mac:
◦ SwiftUI Toolbar Content in Catalyst apps Optimized for Mac was previously bridged into the Mac toolbar (NSToolbar) dependent on whether the view containing the toolbar content filled the entire scene (width and height matched within a small floating point margin). In macOS 14.0 and later, toolbar content is now bridged into the Mac toolbar if the heights approximately match and only the leading edge aligns with the scene’s leading edge. In practice this might change a Catalyst app that had two Navigation Stacks side by side with toolbar content. Prior to macOS 14.0, neither stack would have its toolbar content bridged into the Mac toolbar and all toolbar content would be in the toolbar of the Navigation Stacks themselves. On and after macOS 14.0, the leading stack will have its toolbar content bridged, while the trailing stack’s content will stay in the stack’s toolbar. (108519092)

Maps

Resolved Issues
• Fixed: When a Linear Gradient stroke is used with a Map Polyline in SwiftUI, the specified gradient color might be ignored. (106152300)
• Fixed: When using Map, Xcode emits a runtime warning that “Publishing changes from within view updates is not allowed.” (106174743)
• Fixed: At certain zoom levels, the title of a selected MKMarker Annotation View can overlap other marker titles. (109491779)
• Fixed: For non-Catalyst SwiftUI apps, some Maps controls like the legal link and compass appear outside the safe area. (109611122)

Media

Resolved Issues
• Fixed muting capture in all other tabs when Safari starts camera and/or microphone capture in a tab. (109896538)
• Fixed: MP3 files with malformed ID3 tags will fail to play (110230071)

Messages

Resolved Issues
• Fixed: The transcription for long audio messages is truncated without a way to expand and view the full transcription. (107174385)
• Fixed: Unexpected visual artifacts might appear when the transcription is inserted while sending an audio message. (109799338)

Known Issues
• The Catch up affordance might display incorrectly. (109468262)
Workaround: Leave and return to the affected conversation.

Metal Ray Tracing

Resolved Issues
• Fixed: The methods assume_curve_control_point_count, assume_curve_basis, and assume_curve_type on intersection_params and intersector, the methods get_curve_control_point_count, get_curve_basis, and get_curve_type on intersection_params, and the related curve_basis and curve_type enumerations, are not supported in the Metal Shading Language. (104142182)
• Fixed: After initializing an intersection_query with an acceleration structure using max_levels where Count > 2, calls to next() might cause the GPU to restart. (108863335)
• Fixed: Reflection returned via the new {Render|Compute|Tile}PipelineWithDescriptor API for ray tracing pipelines might be incorrect. (109850134)

Networking

New Features
• URLSession supports resumable uploads in HTTP. Just like download tasks, upload tasks can now be paused and resumed if the server supports the latest protocol draft. To learn more, see Resumable Uploads for HTTP. (68890505)
• Apple devices now support connection to 802.1X networks using EAP-TLS with TLS 1.3 (EAP-TLS 1.3). EAP-TLS 1.3 further improves security and privacy by always providing forward secrecy, never disclosing the peer identity, and by mandating use of revocation checking when compared to EAP-TLS with earlier versions of TLS. (74526852)

Resolved Issues
• Fixed: For apps linked on or after iOS 17 and aligned OS versions, App Transport Security now requires secure connections to external IP addresses by default. For more information on these requirements, see Preventing Insecure Network Connections. Exceptions can be made using NSExceptionDomains, which now supports exceptions for individual IP addresses and ranges specified in classless inter-domain routing (CIDR) notation. (101967030)
• Fixed: For apps linked on or after iOS 17 beta, macOS 14 beta, watchOS 10 beta, and tvOS 17 beta, the Transfer-Encoding header field of a streamed HTTP/1 request is set to chunked instead of Chunked. (107390029)

Photos

New Features
• A new PHContentEditingOutput.renderedContent URL(for:) API adds support for UTType.heic encoded rendered image content. (109861295)

Known Issues
• Applications providing image content via PHContentEditingOutput.renderedContent URL in formats other than UTType.jpeg will fail with an .invalid Resource error. (110068158)

Pre-filled Titles for Events and Reminders

New Features
• Messages now supports machine learning based pre-filled titles for English events and reminders. Tap or long-press the highlighted date/time in an SMS or iMessage conversation and select Create Event to trigger this feature. (110889506)

Presenter Overlay

Resolved Issues
• Fixed: Moving small Presenter Overlay while a Keynote presentation is played in fullscreen mode temporarily stops the presentation from being shared. (110033699)

Printing

Deprecations
• macOS has removed the functionality for converting PostScript and EPS files to PDF format. As a result, CoreGraphics CGPSConverter returns an error when invoked, ImageIO no longer converts EPS files, NSEPSImageRep does not display EPS files, and PMPrinterPrintWithFile does not accept a PostScript file for non-PostScript print queues. (110019863)

Reactions

Resolved Issues
• Fixed: Reactions arent currently available when using video conferencing apps in Safari. (109789920)

Rosetta

Resolved Issues
• Fixed: Intel applications might quit unexpectedly on launch under Rosetta. (110021755)

Safari

Resolved Issues
• Fixed: Safari might offer search suggestions while in Private Browsing by using an on-device model. The search terms are not sent from the device to a search provider. (105606453)

Screen Sharing

New Features
• A High Performance connection requires a network that supports at least 75Mbps for one 4K virtual display and at least 150Mbps for two 4K virtual displays. Low network latency is also required for responsiveness. (110068856)

Resolved Issues
• Fixed: When the viewer window in Screen Sharing.app is made full screen with Dynamic Resolution enabled in a High Performance connection, the video content might not resize to fill the window. (109683500)
• Fixed: During screen sharing sessions using the new High Performance mode, the display connected to the server Mac might not be blank. Activity in the screen sharing session will be visible on the server Macs display during and after the session ends. (109837767)
• Fixed: The video and cursor might lag during a High Performance connection with two 4K virtual displays to an M1 or M1 Pro server (110342712)

Screen Time Settings

Resolved Issues
• Fixed: Selecting a family member in Screen Time causes an error to occur in iCloud accounts with Family Sharing enabled and a family member that is under 18. (110736804)

ScreenSharing

Deprecations
• Use of legacy CGDisplayStream APIs to capture screen content will result in additional consent alerts. (110529324)

ShazamKit

Resolved Issues
• Fixed: SHManaged Session.State is unavailable. (109670750)
• Fixed: SHLibrary.default.items is unavailable. (109670918)

StoreKit

New Features
• Users have access to the new Product.SubscriptionInfo.Status.all sequence to get the status for each of your apps subscription groups. One can use the new subscriptionStatus property on the latest Transaction value for a subscription to access the full status information. (102064614)
• StoreKit 2 now provides a collection of UI components to help merchandise in-app purchases. Use ProductView, StoreView and SubscriptionStoreView to add in-app purchases to an app with just a few lines of code. (102066107)
• Users can access in-app purchase product metadata and entitlement information from a SwiftUI view using new view modifier APIs in StoreKit. Declare a view as dependent on a single product or collection of products using storeProductTask(for:priority:action:) or storeProductsTask(for:priority:action:) respectively. Declare a view as dependent on the current entitlement for a product using currentEntitlementTask(for:priority:action:). Declare a view as dependent on the status of a subscription group with subscriptionStatusTask(for:priority:action:). All of the modifiers will start a task to load the data before the view appears, and provide your action with the state of the task as it progresses and whenever the data changes. (102397222)
• User have access to the new groupLevel property of Product.SubscriptionInfo to understand the level of service of a subscription plan. (103885148)
• Users have access to the new reason, and storefront properties on Transaction to understand the reason why the transaction was created, and which storefront it is for. The new renewalDate property on RenewalInfo to understand if and when a subscription will renew next. (104246730)
• Users have access to new groupDisplayName property of Product.SubscriptionInfo to get the localized display name of a subscription plans group. (105689964)
• The subscriptionStoreControlBackground(:) view modifier is available when using StoreKit and SwiftUI. Use this modifier to set the background behind controls in SubscriptionStoreView instances within a view to a gradient material effect, or any shape style. (105690554)
• The productViewIconBorder() view modifier is available when using StoreKit and SwiftUI. Use this modifier on the icons to provide ProductView and StoreView to add a standard border around the icon. (106649532)
• You can now customize the button style used for purchase and subscribe buttons in ProductView, StoreView, and SubscriptionStoreView instances. Use the buttonStyle(:) view modifier to choose any standard button style, or a custom button style. (107713282)
• StoreKit Views ProductView and StoreView have initializers have initializers that give you access to the promotional icon as a SwiftUI view and the various phases of the loading operation. Use initializers such as init(id:icon:placeholderIcon:), init(icon:), init(ids:icon:placeholderIcon:), and init(products:icon:) to provide an icon view for each phase. (110470147)
• The following StoreKit types are renamed:
• DefaultProductViewStyle is renamed to AutomaticProductViewStyle
• DefaultSubscriptionStoreMarketingContent is renamed to AutomaticSubscriptionStoreMarketingContent
• DefaultProductPlaceholderIcon is renamed to AutomaticProductPlaceholderIcon (111185321)

Resolved Issues
• Fixed: When testing in the sandbox environment, the groupDisplayName property on Product.SubscriptionInfo might return an empty string if the localization in the current storefront is not in an approved state. When using the SubscriptionStoreView without providing a marketing content view, the automatic view might show the name of the app instead of the subscription group’s display name. (107206601)
• Fixed the loading animation for StoreView instances displaying a single product. (110414023)
• Fixed: New StoreKitTest APIs are now available when testing on macOS: setSimulatedError(_:forAPI:), simulatedError(forAPI:), and buyProduct(identifier:options:). (110547347)
• Fixed issue where StoreView or SubscriptionStoreView content might appear in English, or show a localization key, instead of showing localized text for the App Store storefront. (110734447)
• Fixed an issue which can cause unexpected layouts when providing a tall view as custom marketing content for a SubscriptionStoreView. (112862984) (FB12748731)

Swift

New Features
• Properties of @Observable and @Model types currently always require default values or optionality. (109441094)

Swift Charts

New Features
• Enable scrolling in a chart using view modifier chartScrollableAxes(_:). (70444254)
• Use chartXSelection, chartYSelection, and chartAngleSelection to enable selection on a chart. If needed, use chartGesture to override the default gesture for selection. (79083764)
• Swift Charts now supports creating pie charts and donut charts using the new SectorMark API. (102309263)
• Pass an AnnotationOverflowResolution to the annotation modifier to specify how to align an annotation when it would otherwise overflow the bounds of the chart or the plot. (106009062)
• Use ChartProxy.plotContainerFrame to obtain the visible portion of the plot in a scrollable chart. (109675790)

Resolved Issues
• Fixed a crash with certain combinations of chart content. (105197081)
• Fixed an issue where frequent updates to a chart caused unexpected growth in memory footprint. (107611114)
• Fixed: If major alignment is specified for scroll behavior, scrolling charts always align to the major unit and skip minor units. (107644532)
• Fixed: When a selection gesture goes out of bounds, the selection binding will now be clamped to the nearest data value rather than set to nil. (108398019)
• Fixed: Improved performance and CPU usage for charts with selection bindings. (108954531)
• Fixed: Scrolling charts might behave unexpectedly on right-to-left languages. (109129343)
• Fixed: Improved animations for charts in a widget. (110035011)
• Fixed an issue where the compositingLayer chart content modifier caused marks with custom symbols to disappear. (110399956)
• Fixed an issue where the compositingLayer chart content modifier caused annotation boundary resolutions to behave unexpectedly. (112232314)
• Fixed: Improved performance and CPU usage for scrolling charts with scroll position bindings. (113149095)

Known Issues
• Annotations on a scrollable chart might be clipped. (109164195)

SwiftData

New Features
• Existing @Query property declarations might not always correctly infer the model type for predicate and sort descriptor parameters. (Note: the @Query attribute is now resolved as a macro, instead of as a property wrapper.)
• For example, specifying a filter predicate as a parameter to the @Query attribute will now require explicitly providing the model type used in the predicate, i.e. #Predicate { … } instead of #Predicate { … } :

@Query(filter: #Predicate { ... }) var people: [Person]

• Another example: passing a sort descriptor or key path will now require explicitly providing the model type used for the root type of the key path, i.e. \ModelType.property instead of .property :

@Query(sort: [SortDescriptor(\Person.name)]) var people: [Person]

• In all cases, the model type used in the filter: and sort: parameters is still required to be the same type used as the element in the query’s wrapped array type, and will emit a build error if not. (109433172)

Resolved Issues
• Fixed: Properties with default values are not initialized correctly. (107887871)
• Fixed: @Query results can appear stale or fail to refresh. (108385553)
• Fixed: Case value is not stored properly for a string rawvalue enumeration. (108634193)
• Fixed: Schema migration can fail when nesting non-optional properties inside an optional containing struct. (108854663)
• Fixed: Properties with .externalStorage are not being stored in peripheral files. (108972391)
• Fixed: Scene modifier isUndoEnabled does not propagate correctly. (109373617)
• Fixed: Modeled enum properties with default values won’t compile unless they are fully qualified values. (109421492)
• Fixed: SwiftData queries will not work with #Predicate { true } and #Predicate { false } will cause a crash. (109425342)
• Fixed: Conflicting writes from other processes sharing the same file can cause a crash. (109488127)
• Fixed: #Predicate does not support UUID, Date, and URL properties. (109539652)
• Fixed: @Query using SortDescriptors based on .reverse sorting on strings can fail to fetch results. (109572633)
• Fixed: Creating a @Query with a sortdescriptor that uses a relationship keypath will crash. (109626376)
• Fixed: will Set and did Set observers will prevent @Model from properly transforming those stored properties and they will not persist. (109664186)
• Fixed: SwiftData queries don’t support some #Predicate flatmap and nil coalescing behaviors. (109723704)
• Fixed: Xcode code generation for SwiftData Models from CoreData xcdatamodels will refer to original Name instead of renaming Identifier. (109782236)
• Fixed: Unsigned applications using Document API without a proper app container might overwrite the default container. (109784405)
• Fixed: After deleting an item, SwiftUI might attempt to reference the deleted content during the animation causing a crash. (109838173)
• Fixed: Custom schema migrations with SchemaMigrationPlan will fail. (110114696)
• Fixed in beta 7: Apps using SwiftData that are built with Xcode 15 beta 6 have known issues when running on macOS Sonoma 14 beta 6. (113971288)

Known Issues
• SwiftData models with implicitly unwrapped optional properties will generate a compiler error that all stored properties were not set. (114140139)
Workaround: Set the value of non-relationship stored properties in the initializer, and mark relationship properties as optional.

SwiftUI

New Features
• Adds .accessoryBar and .accessoryBarAction button styles on macOS for buttons used in the context of an accessory toolbar (sometimes referred to as a “scope bar”).
• Buttons of the .accessoryBar style typically narrow the focus of a search or other operation.
• Buttons of the .accessoryBarAction style perform extra actions releative to the accessory toolbar’s main functions, like adding or editing filters.
• Both styles affect other view types that you can apply a button style to, like Toggle, Picker, and Menu, in addition to Button. (44351471)
• Bordered buttons on macOS now support flexibly large heights for larger label sizes. If the label has no preferred size or a small size, the button will be the standard macOS button height. However, if the button label has a larger minimum size, the button will also now grow larger instead of clipping the label. (56652012) (FB7411612)
• Adds new view modifiers to customize alerts and other dialogs within a view.
◦ Use dialogIcon(:) to customize the icon. In macOS, this icon replaces the default icon of the app. This modifier has no effect in other platforms.
◦ Use dialogSeverity(:) to set the severity of confirmation dialogs and alerts, which can help indicate that extra care should be taken when choosing a particular action in the dialog.
◦ Use dialogSuppressionToggle to enable user supression of dialogs and alerts in macOS. (62920817)
• RoundedRectangle now defaults to the continuous corner style. (63246947)
• .onChange has new overloads where the closure takes 0 or 2 arguments, these new versions will call the new version of the closure (i.e. after the specified value has changed), so any captured properties will have up to date values. The previous overload (which calls the old version of the closure) has been deprecated. (67344857)
• Spring animations will now default to being critically damped (i.e. a bounce of 0). (75149732)
• Scenes in Catalyst now support the windowResizability modifier. (84203422)
• Added support for dialogSeverity in Catalyst applications. (95918809)
• Use the springLoadingBehavior(:) view modifier to control spring loading behavior of views.
Some views, like TabView, default to allowing spring loading, while others, like Button, do not.
Spring loading refers to a view being activated during a drag and drop interaction. On iOS this can occur when pausing briefly on top of a view with dragged content. On macOS this can occur with similar brief pauses or on pressure-sensitive systems by “force clicking” during the drag. (96569875) (FB10572945)
• Lists using the SidebarListStyle hosted in primary column of a UIKit UISplitNavigationController were previously rendering with an insetGrouped appearance. With this change they will render as the expected sidebar appearance similar to if the List were hosted in a SwiftUI NavigationSplitView. (96909195)
• The toolbar and navigationTitle modifiers now work outside of the SwiftUI App Lifecycle on macOS. Use NSHostingView.sceneBridgingOptions to enable or disable this functionality. (101092365)
• The SceneStorage dynamic property now works when using an NSHostingView, provided the view and its window have been configured for state restoration via AppKit. See NSUserInterfaceItemIdentification and NSWindowRestoration for more information regarding state restoration in AppKit. (101097013)
• DismissAction can now be used to programmatically close an NSWindow when its content View is an NSHostingView. (101097410)
• ProgressView labels can be hidden with the labelsHidden view modifier. (101517619)
• The badge view modifier now works on views within a menu in macOS. Use a badge to convey optional, supplementary information about a menu item. (102025014)
• Use the buttonRepeatBehavior(:) view modifier to make buttons repeatedly trigger their actions on prolonged interactions. Apply this to buttons that increment or decrement a value or perform some other inherently iterative operation. Interactions such as pressing-and-holding on the button, holding the button’s keyboard shortcut, and holding down the space key while the button is focused trigger this repeat behavior. (102156410)
• Animation.default now uses a spring animation equivalent to Animation.spring. In addition, Animation.default is now only equal to itself when using ==, allowing users to differentiate between animations that were intentionally chosen and those that use the default animation. (103169056)
• During gesture change callbacks, velocity will automatically be tracked so that it can be applied to animations that finish when the gesture finishes. (103371523)
• View.focusable() now opts in to keyboard focus whether or not keyboard navigation is enabled in System Settings. For the previous behavior, pass .activate for the modifier’s interactions argument. (104616966)
• When two Text are vertically adjacent (for example in a VStack with no spacer in between) SwiftUI will automatically calculate appropriate spacing. To opt-out if this behavior either place a Spacer or specify spacing parameter to the container view. (104782785)
• For apps built using the macOS 14 SDK, using DismissAction to close a window will default to using DismissBehavior.interactive. (105406945)
• When an NSHostingView is the content View of an NSWindow, its sceneBridgingOptions property will default to .all, unless otherwise specified. (106216343)
• When using @Environment(.self) to capture an entire EnvironmentValues, SwiftUI will now track which properties are accessed to only invalidate the property when those properties change. (106310433)
• Use the new navigationDestination(item:destination:) overload to present a navigation destination when a bound item is non-nil, or to dismiss the destination when the bound item becomes nil again. (106319528)
• The sidebar toggle toolbar item in NavigationSplitView was moved from over the detail column to over the sidebar column for apps linked on Ventura or later. If the new position is amenable, ensure that items previously in the sidebar column are not inadvertently hidden due to limited space. Either move these items into the detail/content column view builder, or set a minimum width on the sidebar column that allows these items to show with navigationSplitViewColumnWidth(min:ideal:). If the prior behavior is desired, remove the toggle button with toolbar(removing: .sidebarToggle) and place your own sidebar toggle toolbar item. Note that SidebarCommands() is orthogonal to the button. (107148514)
• Shapes now default to mirroring when in a right to left layout direction. (107405880)
• Changing from one Gradient value to another will now animate, but only once apps are rebuilt against the new SDK. (107408691)
• All Sections inside Lists and Tables can be configured to be collapsible using new initializers on Section. Previously all Sections inside Lists using the SidebarListStyle received outline disclosure indicators in every header. Section headers will no longer render this control by default. An outline disclosure will only be provided in the header if the Section is initialized with an isExpanded binding to a bool. This bool represents the isExpanded state of the Section. Sections created with an isExpanded binding inside a Table on macOS will now provide a default outline disclosure indicator to collapse or expand the Section. (107592493)
• The listSectionSpacing modifier can now be used within Lists. (109271050)
• View.onKeyPress(_:action:) can’t filter key presses when bridged controls have focus. (109799056)
• Scenes in Catalyst now support the defaultSize modifier. (110038374)

Resolved Issues
• Fixed: Menu could not be used with hoverEffect. (67879883) (FB8554520)
• Fixed an issue where dynamically enabled buttons (e.g. with a TextField) were not updated in alerts. (95917673) (FB10463211)
• Fixed: menuStyle(.button) is compatible with custom button style implementations. Applying a custom buttonStyle on a Menu is supported. (96156722)
• Fixed: DatePicker on macOS now maintains a fixed ideal size instead of filling the width of its container. (98798881)
• Fixed: Scroll environment properties like isScrollEnabled and scrollDismissesKeyboardMode are no longer propagated past nested scroll views. (99195890)
• Fixed: Previously it was possible for views animating their removal via a transition to be drawn above a view with the same zIndex that has not yet been removed. This was unintentional and has now been updated: views transitioning out of the view hierarchy are always drawn below non-removed views with the same zIndex. (101085960)
• Fixed: Table row identifiers in ForEach are now derived from their identifier rather than the TableRow identifier within the ForEach. In this example, from within a Table:

ForEach(myData) { data in
TableRow(data.someFieldAlsoOfTypeData)
}

the resulting identifiers used by SwiftUI are now data.id rather than data.someFieldAlsoOfTypeData.id. If user needs to restore prior behavior, specify the ID explicitly using the id of the ForEach. (101174261)
• Fixed: Table supports triggering primaryAction of contextMenu with return key. (101194950)
• Fixed: LazyVGrid or LazyHGrid has an improved layout when used with fixedSize(). (103075945)
• Fixed:
List and Table on macOS now have visible separators by default, unless unspecified or unless alternating row backgrounds are enabled. Separators can be explicitly hidden using the existing listRowSeparator(.hidden) modifier on the rows views. (103687472)
• Fixed:
fileImporter and fileMover view modifiers now require calling URL.startAccessingSecurityScopedResource() before accessing the provided URL, and URL.stopAccessingSecurityScopedResource() when user no longer needs access to a file or directory pointed to by a security-scoped URL. (104448864)
• Fixed: The new .navigationDestination(item:content:) modifier now works correctly both inside a NavigationStack and outside a stack but inside a column of a NavigationSplitView. Inside a stack, setting the bound item to a non-nil value will push a view onto the stack immediate above the view containing the modifier. Setting the bound item to a nil value will pop the view. Outside a stack but inside a column of a NavigationSplitView, setting the bound item to a non-nil value will replace the root view of the subsequent column. Setting the bound item to a nil value will restore the original root view. (106106406)
• Fixed: When a flexible frame modifier (e.g. frame(minHeight: 100, maxHeight: 200)) is used inside a scroll view the modified view could end up truncating content. This would most often be visible with the content view being a VStack with multiline text. (107014454)
• Fixed: When scrolling to the end of a scroll view using ScrollViewReader, the final offset will be clamped to the scroll view’s total content size and no longer overscroll. (107558652) (FB12094127)
• Fixed: Removed a spurious warning, “NavigationLink presenting a value must appear inside a NavigationContent-based NavigationView. Link will be disabled.” (107877668) (FB12111423)
• Fixed: Views in Lists and Lazy Stacks might be improperly displayed after scrolling. (108021411)
• Fixed: Suggested search tokens will be hidden by default when the search text is not empty (108381393)
• Fixed: ScrollView when used with the searchable modifier has an improved transition when presenting or dismissing search on iOS and iPadOS. (109265624)
• Fixed an issue where NSHostingView would not appear when printed using NSPrintOperation. (109412691)
• Fixed: Two NavigationSplitView initializers taking columnVisibility as a value rather than a Binding. (109426553)
• Fixed: macOS under-toolbar/full-height inspectors now behave as presented in the WWDC23 inspector session. Notably the full-height appearance was previously used incorrectly sometimes. (109532401)
• Fixed: Clicking on a button can errantly warn about updating state during a view update. (109610945)
• Fixed: Inspector presentations no longer have an animation glitch. Inspector presentations no longer increase window size on first presentation unless the window is forced to grow larger by navigationSplitViewColumnWidth modifiers. (111577034) (FB12488754)

Known Issues
• View.defaultFocus(_: _:) isn’t reliable with text controls. (109750983)
Workaround: Manually update focus state bindings from an action passed to View.onAppear(perform:).
• On iOS, using an Observable object’s property as a selection value of a List inside NavigationSplitView may cause a “Simultaneous accesses to …” error when a list selection is made via tap gesture. (113978783) (FB12981860)
Workaround: There is no current workaround for Observable properties. Alternatives include factoring out the selection value into separate state stored outside the object, or using ObservableObject instead.

SwiftUI Navigation

Resolved Issues
• Fixed: Animations inside Navigation* structures are no longer disabled. (107771283)

SwiftUI Outline

Resolved Issues
• Fixed: Leaf views in OutlineGroups (those views where the children keyPath argument has a value of nil) are no longer wrapped in implicit HStacks. If relying on an implicit HStack before, users will now see multiple rows when linking against the new SDK.

Symbol Effects

Resolved Issues
• Fixed: In the objective-C API in Symbols.framework, requesting effectWithWholeSymbol on NSSymbolPulseEffect and NSSymbolBounceEffect will result in the effect being configured to animate by layer instead. (109284710)

System UI Languages

Resolved Issues
• Fixed: There are some strings left in English for people running macOS 14.0 Beta in other languages. (109520700)

Trusted Execution

New Features
• /usr/bin/syspolicy_check is a new command line tool to help determine if the provided macOS application will pass the current running configurations’ system policy. This includes the same checks performed by the Apple notary service and other macOS Trusted Execution layers such as codesign, Gatekeeper, XProtect, and more. Please see the main page for additional details. (108737781)
• /usr/bin/gktool is a new command line tool to assess Gatekeeper Policy on applications. gktool can be called to pre-warm the system cache so users do not see the Verifying… dialog on first launch of an application. (109793778)

UIKit

New Features
• The query rects passed in to -layoutAttributesForElementsInRect: will be more specific to the collection view’s frame, and the rect might intersect with previously queried frames. If subclassing a UIKit vended layout and modifying the frames of elements by applying offsets, make sure that the same offset is applied to the rect passed in to -layoutAttributesForElementsInRect: as well, or the user might see items disappearing when they shouldn’t be. (108663389)

Update

Resolved Issues
• Fixed: T2 Macs might receive an error in the Software Update Preferences pane when attempting to update to macOS Ventura 13.6 Beta 1 or macOS Monterey 12.7 Beta 1. (113829185)

Video Effects

Resolved Issues
• Fixed: Changing video effects settings for an application that accepts camera input changes the settings for other applications that also accept camera input. (108229728)
• Fixed: The Video Effects menu bar item might not appear for certain applications. (110038665)

Virtualization

Resolved Issues
• Fixed: Installing the macOS Seed in a virtual machine might fail on a host Mac. (109234128)

Vision

Resolved Issues
• Fixed: VNDetectHumanBodyPose3DRequest now returns results for images/frames of people without depth metadata or camera intrinsics explicitly provided. (109723859)
• Fixed issue with cameraOriginMatrix so a 180 rotation around x axis is no longer required. Please reference updated sample code for WWDC Session 111241. (110726503)

Weather Averages

Resolved Issues
• Fixed: Placeholders are displayed in locations where Weather averages data isn’t available. (110133240)

Web Apps

Resolved Issues
• Fixed: When the system is set to dark mode, the title bar for web apps now appear correctly. (99514840)
• Fixed: Clicking a notification activates the web app on the current page instead of opening the expected URL. (107906244)
• Fixed: After allowing permission access, the web app correctly appears in System Settings > Privacy & Security > Location Services. (109499769)

Wi-Fi

Resolved Issues
• Fixed: While a Mac has active traffic via Wi-Fi, you might experience difficulty discovering and connecting to Continuity Camera. (109954955)

WidgetKit

Resolved Issues
• Fixed: Some widgets on macOS, especially those that use App Intents for Configuration, might not work properly the first time the system is started. (109518265)
• Fixed: Apps that use the .showsWidgetContainerBackground environment variable no longer crash. (113947483) (FB12974903)

WKWebView

New Features
• Added support for inline predictions for autocomplete. (105197136)

Xcode

Resolved Issues
• Fixed: Xcode might crash when creating a new file. (112337760)

Original source Report a problem

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

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

ARKit

Resolved Issues

• Fixed: iPhone and iPad apps on Apple Silicon Macs quit unexpectedly when initializing ARSkeleton Definition. (128038936)

Core Spotlight

Resolved Issues

• Fixed: iPhone and iPad apps on Apple Silicon Macs quit unexpectedly when invoking -[CSSearchable Item Attribute Set set Action Identifiers:]. (128039095)

Finder

Resolved Issues

• Fixed: Home Videos unexpectedly sync as Music Videos to iPod nano (7th generation). (94899119)

Video Subscriber Account

Resolved Issues

• Fixed: iPhone and iPad apps on Apple Silicon Macs quit unexpectedly if VSOpen TVProvider Settings URLString is referenced. (113562872)

Video Toolbox

Resolved Issues

• Fixed an issue and now on Apple Silicon, if width or height is greater than 4096 columns or rows and content uses 4:2:0 chroma subsampling and 8-bit depth, the hardware decoder driver will reject it and a software decoder will be automatically selected to ensure artifact-free decoding. AVC (H.264) content at level 5.2 or lower can be handled by the hardware decoder. Content that otherwise conforms to level 5.2 but is high frame rate (e.g. 4k at 100 or 120 fps) is labelled level 6, 6.1 or 6.2 and is also handled by hardware. If content is 10-bit, 4:2:2 or 4:4:4, the hardware decoder will be used. (122448862)

Original source Report a problem

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

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

FaceTime

Resolved Issues

• Fixed: Users might not be able to approve or decline a FaceTime link call because notifications might not be received on the caller side for them to accept or decline the call. (125617787)

Mac (Designed for iPad) Apps

Resolved Issues

• Fixed: macOS might launch the wrong version for (Designed for iPad) apps after double clicking the icon or after building from Xcode. (121404522)

Original source Report a problem

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

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

AppKit

Resolved Issues

• Fixed an issue where center or right aligned NSTextField appears blurry. (120819010)
• Fixed: Resolves an issue where pointer style does not update when browsing in Safari. (121131986)

Core Audio

Known Issues

• To improve security and stability, using launchctl kickstart -k is no longer permitted for critical system processes. If a process must be forcefully terminated, it is recommended to use kill instead. (123028502)

Core ML

New Features

• ML Program models that are loaded with MLComputeUnits.cpuOnly will use a new high performance CPU backend that takes advantage of Accelerate framework’s BNNS library. (114037934)

CreateML

Resolved Issues

• Fixed: When using the transfer learning algorithm option, the CreateML app and framework object detection template might fail to converge and cause poor model quality and produce more than expected false positives. (114480994)

Finder

Resolved Issues

• Fixed: Resolves an issue where tiling a window causes the desktop picture to turn black. (118044617)

Messages

Resolved Issues

• Fixed: Stickers (Memoji and 3rd party) might appear blank. (120994483)

Passkeys

Resolved Issues

• Fixed: Registering passkeys might not work on certain websites. (122217903)

Software Updates

Resolved Issues

• Fixed: Updates to macOS 14.4 starting from macOS 11.0–12.3.1 will not work. (120548971)

StoreKit

New Features

• productDescriptionHidden(_:) API can be used to configure the visibility of product descriptions in ProductView, StoreView, and SubscriptionStoreView instances within a view hierarchy. When building with Xcode 15.3, the view modifier can be used even if your app is running on iOS 17.0, iPadOS 17.0, macOS 14.0, tvOS 17.0, watchOS 10.0, visionOS 1.0, or later.
  When implementing a product view style, it can support this new view modifier by checking the descriptionVisibility property on the configuration value. (110414819) (FB12261973)
• You can use SubscriptionStoreView to present promotional offers by adding the subscriptionPromotionalOffer(offer:signature:) modifier.
  If you’re already using inAppPurchaseOptions(_:) modifier to support promotional offers for StoreKit views, you should adopt the new API instead when your app is running on iOS 17.4, iPadOS 17.4, macOS 14.4, tvOS 17.4, watchOS 10.4, visionOS 1.1 or later. Do not use both APIs to apply a promotional offer for the same view. (115358806)

Resolved Issues

• Fixed: The isEligibleForIntroOffer property and isEligibleForIntroOffer(for:) method now reflect ineligibility in cases where a customer would otherwise be eligible for the offer if they weren’t actively subscribed. This means a customer which is not currently eligible for an introductory offer may become eligible in the future. Customers who redeem an introductory offer for a given subscription group will continue to never be eligible for another introductory offer in that subscription group. You can detect this case this by checking if any one transaction with a matching subscriptionGroupID has the type property on offer set to introductory. (103604770) (FB11889732)

SwiftUI

New Features

• Table now supports dynamic numbers of columns with the new TableColumnForEach. (79492167) (FB9189673)

Resolved Issues

• Fixed: DatePicker in macOS reset focus to the first date component when its bound date changes and timeZone is overriden in the environment. (97376561)

Synchronization

New Features

• New os_sync_wait_on_address APIs have been added. They are expected to be used for implementing synchronization primitives that do not have a sense of ownership. Please file feedback if you need Synchronization functionality not covered by existing API. (94759935) (FB10141068)

Original source Report a problem