macOS Updates & Release Notes

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.

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.

Overview

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

StoreKit

New Features

• You can read pricing information for subscriptions that have a monthly with 12-month commitment billing plan configuration in App Store Connect or StoreKit Testing in Xcode through the new PricingTerms model on SubscriptionInfo.pricingTerms. (150388310)
• You can specify the billing plan type to use for subscriptions that have a monthly with 12-month commitment billing plan configuration using the new billingPlanType PurchaseOption. (150388542)
• Read customer entitlement metadata for subscriptions purchased with a monthly billing plan type through the new CommitmentInfo data model on Transaction and SubscriptionRenewalInfo. (150388746)
• When you import both StoreKit and SwiftUI, you can merchandise the monthly billing plan configuration for subscriptions that have a monthly with 12-month commitment billing plan using built-in styles through the new preferredSubscriptionPricingTerms(_:) API. (150389069)

StoreKitTest

Known Issues

• SKTestSession cannot use the selected StoreKit configuration during unit tests, resulting in failed test actions. (172583218) (FB22237318)

Workaround: To use SKTestSession in 26.3 and 26.4, build and run the app on device using the same StoreKit configuration as the test. Then close the app and run the unit test using SKTestSession without changing any configuration settings in the test environment. This allows the configuration to be saved on device before the test begins and maintain your selected configuration settings through the test session.

See Also

macOS 26

macOS Tahoe 26.4 Release Notes

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

macOS Tahoe 26.3 Release Notes

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

macOS Tahoe 26.2 Release Notes

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

macOS Tahoe 26.1 Release Notes

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

macOS Tahoe 26 Release Notes

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

Original source

Overview

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

AppKit

Resolved Issues

• Fixed: Window resize pointer does not follow the window’s corner shape. (149726089)

Background Assets

New Features

• You can now check the status of an asset pack while offline by calling localStatus(ofAssetPackWithID:) or assetPackIsAvailableLocally(withID:) on the shared asset pack manager. The former method returns all available status information. The latter returns only a Boolean value but can be called synchronously. Not all status information is available offline. (164498466)
• You can make the latest version of an asset pack available locally by calling ensureLocalAvailability(of:requireLatestVersion:) on the shared asset pack manager and passing true to the shouldUpdate parameter. (166237389)

Known Issues

• Setting a URL override could break apps from the App Store that use Apple-Hosted Background Assets. (169558509)
  Workaround: Remove any URL override that you previously set before installing or using an app from the App Store.
• Apps might crash when downloading asset packs. (169648111)
  Workaround: If an app crashes due to this issue, then relaunch it. The app should then have local access to the asset pack that it was downloading when it crashed.

CoreMIDI

New Features

• Audio MIDI Setup now supports Network MIDI 2.0 sessions in the redesigned MIDI Network Setup panel. You can create MIDI 2.0 connections over your local network using UDP transport for Universal MIDI Packets, enabling both Legacy MIDI and MIDI 2.0 protocol communication. Network MIDI 2.0 sessions appear alongside existing RTP MIDI sessions and support automatic device discovery through mDNS and data integrity features for reliable wireless performance. (118728162)

External Boot

Known Issues

• When installing an external disk, some configurations of M1 Apple Silicon Macs might panic at boot. (170263142)
  Workaround: Install to a secondary volume in APFS container instead of external disk to validate secondary boot sequences.

External Media

Known Issues

• HFS external media might fail to mount automatically. (168672160)
  Workaround: For macOS only, use CLI tool diskutil mount to attach the relevant disk device.

Internet Accounts

Known Issues

• Exchange syncing for Calendar, Reminders and Notes might fail. (168082477)
  Workaround: To continue syncing Calendar and Reminders, disable Notes syncing in Internet Accounts.

Login

Known Issues

• Touch ID might not be available to unlock the screen of a standard user account after updating to this release. This occurs when FileVault is enabled and a standard user account is logged in prior to any administrator logging in following the update. (169743642)
  Workaround: An administrator user should sign in to the Mac before any standard users.

macOS Recovery

Known Issues

• When deleting a boot volume from the Activation Lock window in macOS Recovery, full erase functionality might not work. (170280070)
  Workaround: Use the “Erase All Content and Settings” functionality from the booted OS instead of triggering from recovery.

Networking

Resolved Issues

• Fixed: Multiple processes leak CFRunLoopSource objects when Automatic proxy configuration (PAC) or Auto proxy discovery are configured.
  For clients of the CFNetwork ExecuteProxyAutoConfigurationURL and CFNetwork ExecuteProxyAutoConfigurationScript API, please check to make sure your process is not working around the leak by overreleasing the CFRunLoopSourceRef returned by those functions or the CFArrayRef and CFErrorRef passed to the completion. (166839810) (FB21376045)

Resource fork

Resolved Issues

• On macOS 26.4 and later, file systems that do not natively support extended attributes restrict partial writes to the first 286 bytes of the resource fork extended attribute (com.apple.ResourceFork).
  To modify the resource fork, replace the entire 286-byte range, or write beyond the 286-byte offset. (156896699)

Rosetta

Deprecations

• As announced at WWDC in 2025, macOS Tahoe 26 is the last release to support Intel based Macs. Additionally, Rosetta support for apps will end after macOS 27. Starting in macOS Tahoe 26.4, users will be notified when they launch apps that use Rosetta of the upcoming incompatibility.
  During the beta period, the cadence of notifications will be accelerated, enabling Apple and developers to address any issues that might occur.
  There will continue to be support for older, unmaintained gaming titles leveraging Rosetta along with software running Intel binaries in Linux VMs.
  Organizations using a device management service can control the notification experience with the allowRosettaUsageAwareness key. (169228455)

StoreKit

New Features

• New fields revocationType and revocationPercentage have been added to Transaction. (148858551)

SwiftUI

Resolved Issues

• Fixed: SwiftUI does not surface the latest .userActivity as the current user activity. (163136831)
• Fixed: On macOS, a non-opaque window that hosts glass content will correctly update the backdrop content behind the glass even if the window is inactive. (166828089) (FB21375029)

Known Issues

• Multiple implicit SwiftUI animations (triggered by RealityViewContent.animate or Entity.animate) that modify a RealityKit component’s properties, are combined only when the implicit animations target the same set of component properties.
  For example, if you initiate an implicit animation on Transform.scale and then initiate an implicit animation on Transform.scale and Transform.translation then the animations affecting the scale property will be independent of each other, and will not combine. In this case, the most recently initiated animation will overwrite the scale property. (169723142)
  Workaround: Ensure the same component properties are animated by subsequent implicit animations when possible.

Virtualization

Resolved Issues

• Fixed: On certain hardware configurations, new macOS Tahoe virtual machine installations may boot to a black screen. (169654019)

Original source

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

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

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

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

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

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

Overview

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

Remote Widgets

Resolved Issues

• Fixed: Remote Widgets might render blank on mismatched iOS and macOS releases. (115436466)

Wallet

Resolved Issues

• Fixed: Some event ticket passes might fail to ingest into Wallet when added from a website on a Mac. (115216417)

WidgetKit

Known Issues

• In widgets Text(_: style:) doesn’t animate its content by default. (107582710)

Workaround: To explicitly request an animation, use the View.contentTransition(_:) modifier.

iPhone 12 in France

Notes

• Updates the iPhone 12 for users in France to accommodate a test protocol for Specific Absorption Rate (SAR) testing. For more information, visit this website: https://support.apple.com/kb/HT213923 (116601274)

Original source

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

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

iMessage Contact Key Verification

With iMessage Contact Key Verification, users can choose to further verify that they are messaging only with the people they intend. iMessage Contact Key Verification uses Key Transparency to enable automatic verification that the iMessage key distribution service returns device keys that have been logged to a verifiable and auditable map. When a user enables the feature, they will be notified about any validation errors directly in the Messages conversation transcript and Apple ID Settings.

For even higher security, iMessage Contact Key Verification users can compare a contact verification code in person, on FaceTime, or through another secure call. They can also choose to create or edit a contact and save a public key to turn on iMessage Contact Key Verification with that person.

All devices signed into your iCloud account must be on the minimum supported version of iOS 17.2 Beta, macOS 14.2 Beta, or watchOS 10.2 Beta. If you wish to keep using other devices on older versions of the OS, you will need to sign out of iMessage on these devices in order to enable contact key verification. (111356044)

Resolved Issues

• Fixed: When verifying another user, Contact Verification Code will not show unless both users are on beta 4 or higher. (114462363)
• Fixed: After verifying a contact, the verificaton checkmark might not show up in Messages app. (116142336)
• Fixed: Users might see an error to Turned Off transcript every few hours. (116405131)
• Fixed: Users might see that they’re are not eligible to enable Contact Key Verification on some of their upgraded devices. (117044482)

Known Issues

• The Learn More links do not link to Knowledge Base articles during Beta. (101563811)

Messages

Resolved Issues

• Fixed: Unlocalized string shown for member count in the full screen Map View of Group Messages might appear (e.g. DETAIL_NUMBER_OF_PEOPLE_LABEL). (117287069)

ServiceManagement

Resolved Issues

• Fixed: Requirements for agents and daemons registered with SMApp Service have changed to prevent sandbox escapes. The target executable must be sandboxed if the main app is sandboxed. A small sandboxed trampoline tool can be written to execute scripts and unsandboxed or system tools. (113037504)

StoreKit

New Features

• New pricing properties price, currency, and currencyCode are now available on Transaction. If an offer was applied to the transaction, a new property offer is available to see information about it (id, type, payment mode), as well as convenience properties offerID, offerType, and offerPaymentMode. (106650768)

Resolved Issues

• Fixed: The StoreKit 2 Transaction properties price, currency, and Offer.paymentMode now have Optional types. (116592563)
• Fixed: The StoreKit 2 Transaction properties price, currency, and Offer.paymentMode now have Optional types. (116809380)
• Fixed an issue causing the refund request “Done” button to not dismiss the sheet when using StoreKit Testing in Xcode. (117482750)
• Fixed an issue where StoreKit 2 device Verification was incorrect, which caused transaction verification to fail. (117689523) (FB13315344)

Swift Charts

Resolved Issues

• Fixed an issue where a scrollable chart did not respect the initial non-zero binding value passed to chartScrollPosition. (114889276)

SwiftUI

New Features

• Use _logChanges() to log causes of SwiftUI view updates.

• Call the new debugging method _logChanges() in the body of a SwiftUI view to log information about why the system is updating the view. For example:

  struct MyView: View {
  #if DEBUG
  let _ = Self._logChanges()
  #endif
  // … rest of view body …
  }

• As well as the physical property names, “@self” marks that the view value itself has changed, and “@identity” marks that the identity of the view has changed (that is, that the persistent data associated with the view has been recycled for a new instance of the same type).

• The new _logChanges() method is like the existing _printChanges() one, except that the new method uses the system console, which is useful in some debugging workflows.

• Calls to _logChanges() log at the info level to the “com.apple.SwiftUI” subsystem with the category “Changed Body Properties”. (113352555)

Resolved Issues

• Fixed: Resolved a possible Swift access conflict crash that could occur with toolbar items. (113992797)
• Fixed: To prevent unintentional implicit dependency cycles, ImageRenderer no longer sends Observable updates when the image it produces changes. This change does not affect the behavior when a dependency is explicitly declared by observing the ImageRenderer’s publisher. (116836341)

WidgetKit

Resolved Issues

• Fixed: In widgets Text(_:style:) does not animate its content by default. (107582710)

Original source

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

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

AppKit

Resolved Issues

• Fixed: Resolves a performance issue where partial update causes the entire NSView to be redrawn. (113028520)

Automatic Assessment Configuration

Resolved Issues

• Fixes an issue where the Mac can lose its internet connection during Automatic Assessment Configuration due to DHCP lease expiration. (111437675)

Notifications

Resolved Issues

• Fixed: Resolved an issue where WebPush notifications fail to deliver after restart. (118134672)

StoreKit

Resolved Issues

• Fixed: Resolved an issue where APIs which provide Transaction values would unexpectedly fail when the purchase price of the transaction is a very large number. (118883880)

Virtualization

Resolved Issues

• Fixed: Resolved an issue where virtualized macOS Monterey guest fails to boot after installing software update. (111970030)

Original source

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