iOS And ipadOS Release Notes Release Notes

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

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

General

New Features • Recovery Assistant is a new way to recover your device if it doesn’t start up normally. It can look for problems and attempt to resolve them if found. (151856202)

Resolved Issues • Fixed: Some iPhone 15 and iPhone 16 models might show a low battery symbol and be unable to start up after updating to iOS 26 beta 1. Follow the steps below to restore the affected iPhone using the updated version of iOS 26 beta 1, or to downgrade to the currently-released version of iOS.

1. Disconnect the iPhone from all USB-C cables.
2. Connect a USB-C cable to a computer, then open Finder if using Mac, or the Apple Devices app if using Windows.
3. When the iPhone’s screen is black, connect the USB-C cable to the iPhone while simultaneously pressing and holding both the side button and volume down button.
4. After 3 seconds, release the side button and continue holding the volume down button until you see the iPhone in Finder or Apple Devices (this may take up to 15 seconds).
5. Restore the iPhone using the updated version of iOS 26 beta 1 or the version of iOS that is currently available.
6. Restore the iPhone from your backup. (153071880)

AdAttributionKit New Features • Advertisers of apps can now specify attribution windows based on ad network and ad interaction type in the Info.plist. This information is taken into account when deciding which ad impression drives the conversion. (136554905) • Advertisers of apps can now specify cooldown periods during which ad conversions will not be attributed for their app. This cooldown can be specified for app installs and reengagement attribution. (136728405) • AdAttributionKit now provides country code in the postback when crowd anonymity thresholds are met. (136850837)

AirPlay Known Issues • AutoMix song transitions might not work as expected when streaming with AirPlay. (155925891)

Alternate App Distribution Known Issues • In-development web browsers, when tested on a device that is not eligible for alternate app distribution features, will not be able to successfully install web-distributed apps. The app installation will begin but will fail before completion. (152209203)

App Store New Features • A new Accessibility section has been added to the App Store product pages that highlights accessibility features within apps and games. These Accessibility Nutrition Labels give users a new way to learn if an app will be accessible to them before they download it, and give developers the opportunity to better inform and educate their users on features their app supports. (138344118)

AppIntents Resolved Issues • Fixed: Code that references @AppIntent(schema: .visualIntelligence.semanticContentSearch) fails to compile. (152321182)

Apple Intelligence New Features • The Foundation Models framework provides you with direct access to the on-device large language model at the core of Apple Intelligence. For release notes about the framework, see the Foundation Models framework section below. (139996377)

Apple TV app Resolved Issues • Fixed: Certain text on Apple TV app content cards might be hard to read. (149376362) • Fixed: Certain line items in Apple TV app settings appear twice or disappear unexpectedly. (152248009) • Fixed: Certain text and images in the “Key Plays” content tab in live sports playback might not display correctly. (152516659)

Apps Resolved Issues • Fixed: On iPhone 11, if you have organized apps into folders on your Home Screen, you might only see the leftmost column of the grid of apps when opening a folder. The other two columns in the folder do not display the app icons, preventing users from launching those apps. (156425266)

ARKit Resolved Issues • Fixed: Usage of ARBodyTrackingConfiguration causes a crash on certain devices. (152417820)

AssistantSchemas Resolved Issues • Fixed: If you have adopted any of the following email AssistantSchemas, you will experience a compilation error due to a parameter type change: createDraft, updateDraft, replyMail, forwardMail, message, and draft. (148633307)

AuthenticationServices New Features • ASAuthorizationControllerRequestOptions.preferImmediatelyAvailableCredentials now works for passkey registration requests. This request only shows UI when the device is immediately able to create a passkey; otherwise, no UI is shown. (150688929)

AVFoundation Resolved Issues • Fixed: AVPlayerLayer does not ensure a valid video frame is always displayed during item replacement, as the isReadyForDisplay property does not remain true during transitions. (151902458)

Background Assets Resolved Issues • Fixed: The system might not update downloaded asset packs as frequently as is expected for apps that internal testers install from TestFlight. (143281558) • Fixed: Asset pack downloads might fail unexpectedly or stall indefinitely, including across reboots. (151498902) • Fixed: The system might not deliver status updates to your app for ongoing asset pack downloads. (151647839) • Fixed: Pausing and resuming an app installation or update while the system is downloading essential asset packs might cause the installation or update to stall indefinitely. (151942388) • Fixed: The installation of large asset packs might fail. (153128086) • Fixed: The URL Override setting doesn’t save an entered URL’s port number. The device always attempts to communicate with the mock server over port 443. (156113742) (FB18913475)

Bluetooth Resolved Issues • Fixed: Certain Non-Connectivity Car Consortium (CCC) Digital Car Key pairings might fail. (154703309)

Books Resolved Issues • Fixed: Highlight menu color palette in EPUB is black and white. (152321612)

Camera Resolved Issues • Fixed: In some cases, the mode selection picker remains expanded after launch. (154589210)

CarPlay Resolved Issues • Fixed: CarPlay template apps that use the Now Playing screen might occasionally not load artwork on full-screen Now Playing. (151807323)

Cellular Data Usage Known Issues • On a Dual SIM iPhone with multiple lines enabled, cellular data usage might not update after changing the default line for cellular data. Workaround: Restart the device after switching the default cellular data line.

CloudKit Resolved Issues • Fixed: CloudKit sharing URLs do not launch third-party apps. (151778655) • Fixed: The request access APIs, such as CKShareRequestAccessOperation, are available in the SDK but are currently nonfunctional. (151878020)

Communication Safety Known Issues • Communication Safety might cause hangs in FaceTime when triggered to show an intervention. Workaround: Reboot the device.

Contacts Known Issues • Characters for Monogram Avatars in some non-English languages might show up as unexpected symbols. (154824077)

CoreData Resolved Issues • Fixed: In beta 5 SDK, CoreData changed several Sendable annotations to resolve compatibility issues with Swift 6’s new MainActor default isolation feature. These changes include marking NSManagedObject as NS_SWIFT_NONISOLATED NS_SWIFT_NONSENDABLE, marking NSManagedObjectContext as NS_SWIFT_NONISOLATED NS_SWIFT_SENDABLE, and requiring NS_SWIFT_SENDABLE closures for the family of perform, performBlock, performBlockAndWait and similar methods. These changes are ABI compatible with past releases but might introduce new warnings while building source code that violates the longstanding CoreData concurrency guidelines. NSManagedObject are mutable reference types inextricably related to others in a graph and cannot be made Sendable. They are expected to be isolated to the scope of the NSManagedObjectContext that creates or fetches them. NSManagedObjectContext is a style of actor which encapsulates its own dispatch queue. While it’s impermissible to use many methods on NSManagedObjectContext from other threads, it is permissible to pass references around to invoke the performBlock family of methods, for the purpose of routing a Sendable closure to its managed dispatch queue. CoreData supports a user default -com.apple.CoreData.ConcurrencyDebug 1 which can be used to enable additional assertions. (153848710) (FB18216198)

Deprecations • This release removes support for the following deprecated NSPersistentStore option keys: ◦ NSPersistentStoreUbiquitousContentNameKey ◦ NSPersistentStoreUbiquitousContentURLKey ◦ NSPersistentStoreUbiquitousPeerTokenOption ◦ NSPersistentStoreRemoveUbiquitousMetadataOption ◦ NSPersistentStoreUbiquitousContainerIdentifierKey ◦ NSPersistentStoreRebuildFromUbiquitousContentOption These keys have been deprecated for more than a decade. Affected apps rebuilt with the iOS or macOS 26 SDK will get errors. Apps built against older SDKs will log warnings when opening the store. The on-device persistent store will be fully usable after these keys are removed from options dictionary, albeit without syncing. For data syncing, these APIs were superseded by NSPersistentCloudKitContainer in iOS 13 and SwiftData in iOS 17. If absolutely necessary, the iCloud content remains accessible in the containers with the last baseline as a .zip archive file. (157297746) (FB19286235)

DeclaredAgeRange API Known Issues • If requestAgeRange triggered the onboarding flow for a parent, selecting Always or Never will lead to the API not responding. Workaround: Try calling requestAgeRange again to get a valid response. • On iOS, requestAgeRange might incorrectly return notAvailable. Workaround: Please try signing out and back in with your Apple Account or wait 24 hours. • On macOS, if onboarding leads to the Ask First state, the user is not prompted to share or not share their age range. Workaround: Try calling requestAgeRange again to get a valid response.

Documents Known Issues • EPUB files are shown with an app icon rather than a document icon. Other document types might also be affected. The icon shown is the icon of the app set to open the document. The document opens normally. (154800649)

Find My App Resolved Issues • Fixed: Play Sound fails when invoked from Share Item Location links, and “Not Reachable” is displayed. (152029301)

Foundation New Features • Interpolating non-localized types into a LocalizedStringResource/String(localized:)/AttributedString(localized:) value will now display a deprecation warning instead of potentially falling back to a fully-unlocalized string. Provide a localized value to interpolate into the text instead, or silence the warning by wrapping the unlocalized value in a call to String(describing:). (126876158) • ISO8601FormatStyle now allows fractional seconds, regardless of the setting of includingFractionalSeconds. Additionally, ISO8601FormatStyle now allows hours-only time zone offsets. (136950769)

Foundation Models framework New Features • LanguageModelSession.prewarm() now caches the instructions and prefix of your prompt, in addition to loading system resources. The best place to use prewarm() is when your app is waiting for user interactions that might trigger response generation. This will reduce the time to the first-generated token. (152381043) • #Playground in Xcode now allows for filing feedback for Foundation Models framework responses. (153770707) • The .contentTagging use case now supports non-English languages. You can query the supported languages using SystemLanguageModel(useCase: .contentTagging).supportedLanguages. Tags will be generated based on the language of the prompt. (155801948) • When you use guided generation, the framework now supports programmatically detecting when and why the model refuses to respond when the content is not unsafe. In previous beta releases, this manifested as a guardrail violation. Now you can catch a specific error case LanguageModelSession.GenerationError.refusal and obtain a model-generated explanation for why it refused to respond. Depending on your use case, you might be able to display the explanation in your UI. (156086748) • In GeneratedContent, you can use the isComplete property to check whether the content was fully generated by the model. (156109416) • When using guided generation, you can now access the underlying weakly typed GeneratedContent by accessing the rawContent property on Response or ResponseStream. (156351123) • New guardrails mode Guardrails.permissiveContentTransformations allows transformations of content that might otherwise violate the default guardrails. Use this mode for text-to-text tasks, such as summarization and rewrite. (156721060)

Known Issues • Some instructions and prompts to the model might not lead to expected responses. Use Feedback Assistant to report satisfactory or unsatisfactory cases. When applicable, you can use LanguageModelSession.logFeedbackAttachment() to serialize the feedback to a JSON file and attach it to Feedback Assistant. (152318091) Workaround: Refine your instructions and prompts using #Playground in Xcode. When applying guided generation with a @Generable type, add @Guide with a custom description on properties to steer the model’s responses. • If Argument type is an enum with associated type, tools will encounter a ToolCallError with an underlying decodingFailure when the model attempts to call it. (156723065) Workaround: Wrap the enum in a struct.

Game Center Known Issues • User cannot start a Challenge for a leaderboard that has not been published Live via App Store Connect. (151928236) Workaround: Test leaderboard locally using Game Progress Manager in Xcode, or publish a leaderboard as Live before creating an associated challenge.

Game Controller New Features • For supported game controllers, pressing the Home button once opens the Game Overlay. Set preferredSystemGestureState to receive additional Home button press events. (137780853) • Pair multiple Apple devices to your DualSense or DualSense Edge controller and easily switch between them directly using the controller or Bluetooth settings. See this PlayStation blog post for details. (137782227)

Game Mode Resolved Issues • Fixed: The LSSupportsGameMode Info.plist key is currently ignored. (151814151)

HealthKit New Features • A user’s medications and their dose events in the Health app are now available for reading via a new API. Use HKUserAnnotatedMedicationQuery to get a list of HKUserAnnotatedMedication objects that encapsulate the users medications. A new HKSample subclass, HKMedicationDoseEvent, tracks the medication doses logged by the user. (114279172) • Workout session APIs are now available on iOS and iPadOS. This includes HKWorkoutSession and HKLiveWorkoutBuilder, which can be used in your app to track workouts. (125746390)

Resolved Issues • Fixed: An app that was granted Read-only authorization for certain data types (e.g. workout routes) might lose its ability to read the data type without the user explicitly turning it off in Settings > Health. (149024236) • Fixed: The authorization screen prompted by the Medications Authorization API cannot be dismissed if the user has no available medications needing authorization. (152094574) • Fixed: On an iPhone or iPad without a passcode, Health data might become inaccessible when you reach the Power Off slider. (155576088)

Image Playground Resolved Issues • Fixed: The Create Image action fails to appear in Shortcuts app and Spotlight. (153235442)

iPad Multitasking Resolved Issues • Fixed: The Multitasking mode picker is missing from Control Center on some iPad models. (152457491)

Known Issues • Apps launched on external displays default to the same size and position. (143158703) • Switching apps by swiping left or right with one finger along the bottom edge, or with four/five fingers anywhere on screen, does not work in the new Windowed App Multitasking mode. (151293681)

Journaling Suggestions New Features • Journaling Suggestions on iPhone now sync over iCloud securely to iPads. Users can enjoy the suggestions created on iPhone on their iPad Journal app or other journaling apps that adopt the API. (152322897) • Smart notifications now let users know when it’s the best time to journal, based on their routine and location. You can also adopt smart notifications in your journaling app. (152469176) • Suggestions have been revamped to show scene classification and inferences such as Holidays and Celebrations, new groupings based on patterns, and more. (152469363)

Resolved Issues • Fixed: Journaling suggestions might not download. (151995727)

Known Issues • iCloud Storage for Journaling Suggestions returns after “Delete Data From iCloud”. Workaround: Disable Journaling Suggestions, in Settings > Apple Account > iCloud > Saved to iCloud > Journaling Suggestions, before invoking “Delete Data From iCloud”.

Kernel Deprecations • @Description: Calls to sem_open or sem_unlink from a process signed with a Team ID entitlement no longer observe any semaphores created by processes signed with different Team IDs. Named semaphores are now scoped to a single development team. (123476459)

Keyboards Resolved Issues • Fixed: Keyboards are sometimes missing keys in first-party apps. The keys are not visible, but users are still able to type over the missing key to use it. (152375527) • Fixed: Users with Korean 10-key keyboard might experience missing and blank keys on iPhone. (154158767) • Fixed: Tapping the Return key on Japanese and Chinese 10-key keyboards is unresponsive after you rotate the device from Landscape to Portrait. (154163977)

Landscape Mode Known Issues • Safe area, search bar alignment, and locations might be incorrect in landscape mode. (152365383)

Lock Screen Resolved Issues • Fixed: Adjusting the glass tint color for Lock Screen time might not be easily accessible. (151240707) • Fixed: When editing a photo wallpaper the widget area incorrectly overlaps with the time. (151418602) • Fixed: If you create a wallpaper using the first-row circles at the top of the Wallpaper Gallery, you might not be able to place widgets directly below the time. (151709613) • Fixed: Wallpapers and posters with adaptive clock lose depth if you upgrade from iOS 26 beta 1 to iOS 26 beta 2. (153005914) • Fixed: Time might appear black in color. (154773881)

Known Issues • If device is locked and an app is running on the Lock Screen, launching a camera app with Camera Control might not work. Workaround: Reboot the device. • Lock Screen controls might be hard to see over lighter wallpaper content. (151324807) • Clock, notifications, and other elements might not display. Workaround: Swipe down from the status bar to re-present the Lock Screen, or reboot the device. • Devices might not auto sleep while the passcode UI is visible on the Lock Screen. Workaround: Dismiss passcode UI or manually lock the device.

Mail Resolved Issues • Fixed: While in Dark Mode, Mail controls may not adjust to content with a light background. (156225857)

Known Issues • When opening the search field on iPadOS, a blank column will display instead of the message list if the user does not have recent searches or link/document suggestions. Workaround: Once the user starts typing in the search field or dismisses the search, the message list will re-appear. • The Select button is missing in Search to perform bulk edit actions. Workaround: Users can still get into the same state by swiping down with two fingers to select then long-pressing to choose an action.

Maps Known Issues • Pinned places, including Home and Work, might be missing icons or display the incorrect icons. Workaround: Quit and relaunch Maps. • Curated guides do not scroll on iOS, iPadOS, or visionOS when the iPhone is in landscape mode. Workaround: On iPhone, view curated guides in portrait mode. • Vehicles with a touchpad interface might not be able to start navigation in CarPlay. Workaround: Navigation can be started from another available input device, such as iPhone. • Custom tap gesture callbacks registered using onTapGesture might not work as expected on a SwiftUI Map. (157612948) (FB19394663) Workaround: Use simultaneousGesture(TapGesture().onEnded {}) to register the callback.

Memory Tools Known Issues • Leaks might be falsely reported by memory analysis tools when a target has instances of types that use Obj-C properties implemented in Swift using bridged types with @objc @implementation. Memory analysis tools include the leaks CLI tool, Leaks instrument, and Xcode memory graph debugger. (157798911)

Menu Bar Resolved Issues • Fixed: On iPad, the gesture to invoke the Menu Bar does not work in right-to-left text layouts. (152447825)

Menu Customization Known Issues • Menu customization in apps like Notes and Mail might have some visual glitches. (148472167)

Messages Resolved Issues • Fixed: Sent translated messages do not get re-translated after editing. (149401758) • Fixed: In regions where Screen Unknown Senders is on by default, notifications for message categories are erroneously off by default. (149450560) • Fixed: In one-to-one conversations, background changes might be attributed incorrectly after quitting and re-opening the Messages app. (150548773) • Fixed: Transaction or Promotion messages filtered by a Message Filter App Extension might be badged as “Unknown” in the conversation list rather than “Transaction” or “Promotion”. (151869409) • Fixed: Generative backgrounds do not work with Japanese keyboard. (155186919)

Known Issues • Users on older devices won’t see compatibility messages for polls, so they might be unaware a poll was sent. (148545742) • Expanding Conversation Details causes the list of conversations to collapse. Workaround: Closing Conversation Details will bring back the list. • Deleting and reporting as spam a message that was filtered by a Message Filter App extension does not send the spam report to the extension. (150832702) • Devices with “Filter Unknown Senders” on before update might have “Time Sensitive” on by default under the Allow Notifications setting in the Unknown Senders section of Messages Settings. Workaround: Enable “Time Sensitive” manually. • Messages fail to translate when only the recipient has translation enabled. Workaround: Both participants in the conversation must enable translation.

Metal New Features • Metal 4 is now supported. See Metal for additional details. (113781091)

Resolved Issues • Fixed: If you’re using Metal 4 command encoders, you should add render and compute pipelines that support indirect command buffers to your residency sets. The Metal device driver currently does not enforce this requirement. (145066238) • Fixed: Metal Shader Validation might not work with shaders that use Metal Performance Primitives. (149263281)

Known Issues • Metal Shader Validation might not work with Metal 4 ray tracing pipelines. Workaround: Selectively disable Shader Validation for pipelines using ray tracing. See documentation.

MetalFX Resolved Issues • Fixed: Denoised temporal upscaling for MTL4CommandBuffer’s MTL4FXTemporalDenoisedScaler does not work. (146436460) • Fixed: Temporal upscaling for MTL4CommandBuffer’s MTL4FXTemporalScaler does not work. (146436741)

MetricKit Resolved Issues • Fixed: MetricKit might fail to deliver MXDiskSpaceUsage Metrics on iOS 26 Beta. (151712405)

NetworkExtension Deprecations • Algorithms DES, 3DES, SHA1-96 and SHA1-160 as well as Diffie-Hellman groups less than 14 are no longer supported for IKEv2 VPNs. (148767790)

Notifications Known Issues • Notification icons do not automatically follow the system appearance when configured to do so. (152191515)

NSLog New Features • Dynamic string data in format arguments for NSLog will be redacted to in the Unified Logging System. This specifically targets data that enters the Unified Logging System via NSLog, and will not impact the Xcode console or NSLog’s stdout output. If you wish to log un-redacted data to the Unified Logging System please use the “os_log” or “Logger” interfaces. (137129180)

Object Capture New Features • A new algorithm significantly improves PhotogrammetrySession reconstruction quality of low-texture objects not captured with the Object Capture Session front end. It will be downloaded and cached once in the background when the PhotogrammetrySession is used at runtime. If network isn’t available at that time, the old low quality model will be used until the new one can be downloaded. There is no code change needed to get this improved model. (145220451)

Order Tracking New Features • Wallet now finds emails sent by merchants or delivery carriers and conveniently tracks order progress by pulling them together in one place. This feature is available with beta on Apple Intelligence enabled devices. (152090735)

Known Issues • Users might experience a spinner issue when clicking the ‘Track’ button on the email banner. Workaround: Charge the device overnight and try again afterward.

Passcode Resolved Issues • Fixed: Users with alphanumeric passcodes might be presented a passcode entry screen that accepts a single digit, preventing correct entry. (156070293)

Phone Known Issues • A user on multiple calls on an iPhone without a Dynamic Island will see two Swap buttons, and the one next to the Contact’s name will not be functional. Workaround: Use the functional Swap button between the Audio and Mute buttons.

Photos Known Issues • Existing Social Groups might disappear from the Photos app when manually creating a new one. Workaround: Quit and relaunch the Photos app.

Photos / Photos Picker Known Issues • Invoking search in the Photos picker causes the picker to crash. Or invoking Search in a collection in Photos causes Search to crash. Workaround: Use the Photos app to search for the content. Once you’ve found it, you can share or copy it to continue with the workflow. Use Search in the Library tab to find the content.

Push to Talk Deprecations • The legacy Push to Talk Entitlement com.apple.developer.pushkit.unrestricted-voip.ptt is no longer supported on apps built with the iOS 26 SDK or later. Push to Talk apps must be updated to use the Push to Talk framework introduced in iOS 16. (147700313)

Reality Composer Resolved Issues • Fixed: When you create or open a project in RealityComposer on devices with LiDAR, the screen freezes and shakes after entering AR mode and pressing the Play button. (152324341)

RealityKit Resolved Issues • Fixed: Entities with a PortalComponent ignore any ModelSortGroupComponent and instead use a fixed rendering order. In case of sorting rendering issues with portal surface, explicitly add a ModelSortGroupComponent using a .planar UIAlwaysBehind sort group. (149899345) • Fixed: ParticleEmitterComponent does not render properly on iOS, macOS, and tvOS. (152201501) • Fixed: The animate functions on Entity and RealityViewContent do not start animations. (152456435)

Known Issues • Some properties and components do not update SwiftUI Views when accessed through the .observable property on Entity. (147063698)

Search Resolved Issues • Fixed: Some applications might quit unexpectedly when using search. The issue will be resolved automatically with an over-the-air update when connected to Wi-Fi. (157464670)

Security Deprecations • For apps linked on or after iOS 26 and macOS 26, the default minimum TLS version of URLSession and Network frameworks has changed from 1.0 to 1.2. If your process connects only to your servers, verify that they support TLS 1.3 or TLS 1.2. If your process needs to connect to 3rd-party servers which cannot be updated to support newer versions of TLS, restore the previous behavior through URLSession and Security framework APIs: URLSessionConfiguration.tlsMinimumSupportedProtocolVersion and sec_protocol_options_set_min_tls_protocol_version. (135996267)

Setup Assistant Known Issues • The cursive Welcome text might be missing at the end of Setup Assistant. Workaround: Swipe up or tap Get Started to complete setup.

Shortcuts Resolved Issues • Fixed: Titles for some Messages actions and filter properties display incorrectly. (153740390)

Simulator Resolved Issues • Fixed: Siri does not accept voice input, making it unusable. (152738556) • Fixed: Messages app crashes when launched. (153672262) • Fixed: Preview app crashes whenever it is launched. (155906732)

Siri Resolved Issues • Fixed: Knowledge requests that are handled by ChatGPT might produce results that are based on stale data. (154889929)

Software Update New Features • Depending on the amount of free space available, iOS might dynamically reserve update space for Automatic Updates to download and install successfully. (137003545)

Resolved Issues • Fixed: Software Updates might reserve more space than necessary. (151413019)

StoreKit New Features • There is a new option for the Transaction.Offer.PaymentMode API called oneTime. This new case supports the method of payment for In-App Purchase offer codes. (142501142) • Subscription promotional offers can now be signed using JWS and attached to a purchase using the new PurchaseOption.promotionalOffer(_:compactJWS:) API. There are also new corresponding SwiftUI APIs in StoreKit to attach a signed promotional offer or a signed introductory offer override to a view. (143395736) • SubscriptionOfferView is a new SwiftUI view to merchandise auto-renewable subscriptions. It is designed to capture customers’ attention about the app’s service. (145251635)

Resolved Issues • Fixed: Subscription status updates might not be reported correctly if the subscription went into billing retry in StoreKit Testing in Xcode. (133799135) (FB14789854) • Fixed: Price of offers is not displayed in the payment sheet when making a purchase to a subscription with a higher level of service in StoreKit Testing in Xcode. (140635780) (FB15980635) • Fixed: Renewal transactions might be created regardless of the Ask to Buy status of the purchase request in StoreKit Testing in Xcode. (145242611) • Resolved an issue with the Identifiable conformance of the PurchaseIntent API. Conformance to this protocol now begins starting with iOS 18.0 and macOS 15.0. (148751460) (FB17151889) • Fixed: SKProduct from the original StoreKit API fails to decode products when using StoreKit Testing in Xcode. (150851879) • Resolved an issue where the id member of the PurchaseIntent API was only available starting with iOS 18.0 and macOS 15.0, and no longer available for Mac Catalyst. It is now available starting with iOS 16.4, macOS 14.4, and Mac Catalyst 16.4. The PurchaseIntent conformance to Identifiable remains unchanged. (152858281) (FB17829716) • Fixed: Transactions might not finish, resulting in subsequent purchases of the same product failing. (155449267)

Swift Charts New Features • Available in iOS 26, macOS 26, and visionOS 26, Chart3D allows you to visualize your data and mathematical surfaces in 3D, powered by RealityKit. (148361385)

Resolved Issues • Fixed: Annotations on a scrollable chart might be clipped. (109164195)

Swift Compiler Resolved Issues • Fixed: The Swift compiler might crash when building a project that initializes a UISymbolContentTransition. (150858005)

Swift Standard Library Resolved Issues • Fixed: The span properties of InlineArray and CollectionOfOne trap at runtime.
 (147500528) • Fixed: mutating members of MutableSpan and MutableRawSpan are unavailable. (152467655)

Known Issues • lengthOfBytes(using: .utf16) and -lengthOfBytesUsingEncoding: NSUTF16StringEncoding/NSUnicodeStringEncoding might produce an incorrect result when used on Swift Strings, including NSStrings formed by bridging Swift Strings to Objective-C. (156675395)

SwiftUI New Features • ControlSize now conforms to Comparable, and View/controlSize(:) can now be used to clamp the environment’s controlSize to a given range. (99633360) (FB11465757) • In apps built with the macOS 26 SDK, Section footers within a Form of the Grouped Form Style now have leading alignment, default font, and foreground styles. Use the sectionActions(content:) view modifier on your Section to supply section actions, which maintain a trailing placement in macOS. In iOS and iPadOS, each section action displays as its own form row. (129868475) • Text, TextEditor, and TextField now by default use string contents to determine the appropriate base writing direction for each paragraph, instead of relying on layout directionality. To specify the writing direction explicitly on a per-paragraph basis, use Foundation’s AttributedString.writingDirection attribute. To make the base writing direction follow the layout direction for an entire view, apply the view modifier .writingDirection(strategy: .layoutBased). (134821288) • In apps built with the macOS 26 and iOS 26 SDKs, a Picker of a style that produces a button-like control now has a fitted sizing behavior by default. If needed, use the buttonSizing(:) view modifier to make the Picker flexible and fill the available width of its container. (136649748) • When linking news SDKs, NavigationLinks produce a single view, rather than a list of views in view list contexts. This change improves performance of many NavigationLinks in lazy containers like List. However, if you are relying on ContainerValues propagating out of the label view of a NavigationLink, or similarly relying on ContainerValues of a ButtonStyle used to style a link, the containerValue(:: ) modifier should be moved outside of the link. Below is a minimal example that demonstrates the behavior difference:

import SwiftUI

struct ContentView: View { @State private var presentPopover = false var body: some View { NavigationLink("Custom Link", value: 84) .buttonStyle(MyButtonStyle(containerValue: "Eighty-four")) } }

struct ParentView: View { var body: some View { Group(subviews: ContentView()) { subviews in ForEach(subviews) { subview in Text(subview.containerValues.myCustomValue) } } .frame(minWidth: 100, minHeight: 100) } }

struct MyButtonStyle: PrimitiveButtonStyle { var containerValue: String func makeBody(configuration: Configuration) -> some View { Button(configuration) .buttonBorderShape(.circle) .containerValue(.myCustomValue, containerValue) } }

private struct MyContainerValueKey: ContainerValueKey { static let defaultValue: String = "Default value" }

extension ContainerValues { var myCustomValue: String { get { self[MyContainerValueKey.self] } set { self[MyContainerValueKey.self] = newValue } } }

#Preview { ParentView() }

(140283584)

• List no longer ignores the vertical insets of rows with a height close to the default minimum height on iOS and visionOS. Use listRowInsets(: :) to change the vertical row insets. (141160852) • In NavigationSplitView and TabViews configured as sidebar Adaptable, the view trailing the sidebar’s safe area is inset in the width of the sidebar. It can display content outside its safe area, underneath the sidebar. (141222137) • On macOS, after linking new SDKs, the style of search fields with SearchFieldPlacement.sidebar is now fixed to the toolbar. Previously the search field would scroll as the first element in the list. (143546967) • In iOS and iPadOS apps that adopt the new design, a picker of .segmented style now supports .large and .extraLarge control sizes. (144417732) • In apps that adopt the new design, the buttonBorderShape(:) view modifier can be used to customize the shape of bordered buttons. Previously this modifier only affected buttons in Widgets in macOS. (145773436) • The buttonSizing(:) view modifier specifies the sizing behavior of Button, Picker, Menu, and other button-producing controls. If you are using Spacer views or an infinite-width frame in your Button label to create a flexible button, apply buttonSizing(.flexible) to the Button instead. (146327046) • On iPadOS, sidebars and inspector titles now default to inline in the regular size class. You can use navigationTitleDisplayMode(:) to specify a different title display mode. (150891824) • On iPadOS, navigation link chevrons are not visible by default in the content column of NavigationSplitViews in the regular size class. You can use navigationLinkIndicatorVisibility(:) to specify a different indicator visibility. (151646790)

Resolved Issues • Fixed:

• TextEditor’s undo stack might contain invalid operations for applications with multiple TextEditor views. (83650197) (FB9662463) • Fixed: The menu content of some Menu views does not update as the result of a state change. (106878937) • Fixed:
• View.onHover(perform:)
• View.onContinuousHover(coordinateSpace:perform:) affect hit-testing for gestures. Gestures are not received if one of these view modifiers is used within an overlay. (108560020) • Fixed: Section views without isExpanded binding are collapsible in a sidebar-styled List on macOS. (115797465) (FB13192271) • Fixed:
• listSectionSpacing does not work correctly for sections that have headers and footers. For more control over the list section layout, use the listSectionMargins modifier. (140929163) • Fixed: On iOS, navigationSplitViewColumnWidth() does not respect the specified minimum and maximum column widths. (143529326) • Fixed: Multiple title views in sidebar list labels on iOS are not styled hierarchically as title and subtitle. (144253754) • Fixed: In custom layouts that do not implement explicit Alignment(of:in:proposal:subviews:cache:), alignment guides do not work correctly for a right-to-left layout direction. (145073832) • Fixed: Applying a bold modifier to Text resets the weight configuration. The interaction of bold and weight is not consistent between Text and Font. (147270079) • Fixed: Environment updates from outside of a popover might fail to propagate into the popover’s content view. (147954025) • Fixed: Gestures added using the simultaneousGesture(:isEnabled:) view modifier are incorrectly simultaneous with ancestor gestures. (147970990) • Fixed: On platforms supporting edge-attached and non-edge-attached sheets, non-edge-attached sheets present erroneously as full-screen covers when .navigationTransition(.zoom...) is specified. If you wish to keep the full-screen cover in compact size classes, configure a sheet with: .sheet(...) { ContentView() .navigationTransition(.zoom...) .presentationSizing(.page) .presentationCompactAdaptation(.fullScreen) } (150455117) • Fixed: On iOS and iPadOS, sheets applied to toolbar items sometimes do not display if the sheet is presented at the same time a popover is dismissed. (150764801) • Fixed: On iOS and iPadOS, toolbar items in the navigation bar may become non-centered after a state change. (152168945) • Fixed: If Default Actor Isolation is set to MainActor, @Animatable macro emits concurrency warnings in Swift 5 language mode and does not compile in Swift 6 language mode. (152524435) • Fixed: On iOS and iPadOS, .fullScreenCover backgrounds are transparent when they should be opaque. (154232311) • Fixed: Gestures do not have the same lower priority over the view’s existing UIGestureRecognizers and NSGestureRecognizers as they do over the view’s existing SwiftUI gestures. In apps built with iOS 26, macOS 26, tvOS 26, and visionOS 26, use highPriorityGesture(:isEnabled:) to make sure your gesture takes precedence over the view’s existing gestures, or use simultaneousGesture(_:isEnabled:) to give your gesture the same priority as the view’s existing gestures. (155581361) • Fixed: On iOS, iPadOS, and Mac Catalyst, popovers that access environment objects declared outside of a popover’s content view might crash when isPresented = true. (156906038)

Known Issues • On iOS and iPadOS, inspector does not respect the width applied with inspectorColumnWidth. (145162377) • toolbarForegroundStyle no longer tints toolbar button labels on watchOS. (151487439) Workaround: Tint the button label directly, using Text("foo").foregroundStyle(...). • On iOS and iPadOS, bordered prominent buttons in toolbars do not have the correct default padding or symbol metrics. (151792861) • .toolbarVisibility(for:) does not hide the navigation bar on watchOS. (152326250)

Deprecations • Text concatenation using the + operator is deprecated because it makes it hard to create localized strings that are correct across all languages. Use Text interpolation instead. See documentation on Text for more info on how to produce localized strings. (128144043) • On iOS and iPadOS, inspector columns do not present if the hierarchy does not contain a NavigationSplitView.

TextKit New Features • iOS 26, tvOS 26, visionOS 26, watchOS 26, and macOS Tahoe 26 have two methods for resolving the natural alignment NSTextAlignment.natural and the last line of NSTextAlignment.justified into concrete alignments, left and right. The first approach utilizes the UI language, which is determined by passing nil-language to NSParagraphStyle.defaultWritingDirection(forLanguage:). This behavior was employed prior to this release. The second method is new and dynamically utilizes the base writing direction for the paragraph. When the base writing direction is set to NSWritingDirection.rightToLeft, the text is aligned to right, and vice versa. The behavior is selected by API introduced in this major release: NSTextLayoutManager.resolvesNaturalAlignmentWithBaseWritingDirection, NSStringDrawingOptions.ResolvesNaturalAlignmentWithBaseWritingDirection, UITraitCollection.resolvesNaturalAlignmentWithBaseWritingDirection, and NSTextField.resolvesNaturalAlignmentWithBaseWritingDirection. (152045248)

Resolved Issues • Fixed: The directionality of NSParagraphStyle indentation properties (firstLineHeadIndent, headIndent, and tailIndent) is determined by inconsistent hidden rules implemented by the TextKit typesetting engine. With iOS 26, macOS 26, tvOS 26, watchOS 26, and visionOS 26, the TextKit 2 typesetting engine has been standardized to utilize the resolved writing direction for the paragraph when linked with the OS 26 versions of the corresponding SDKs. For binary compatibility, applications developed with prior SDK versions will use the UI language in a subset of API interfaces. Specifically, for UILabel, NSTextField, SwiftUI.Text, and NSStringDrawing, the indentation directionality is determined by the UI language queried by passing nil to NSParagraphStyle.defaultWritingDirection() in applications built with prior SDK versions. (155893102)

TextKit 2 New Features • A new property, includesTextListMarkers, is introduced to NSTextList, NSTextContentStorage, and NSWritingToolsCoordinator. This property controls whether to include the text list marker string in the contents of NSAttributedString for paragraphs associated with NSTextList. TextKit 1 expects the marker string, while TextKit 2 does not. The TextKit 2 behavior was adopted by UIKit starting with iOS 18 (includesTextListMarkers=NO). AppKit is also adopting the TextKit 2 text list behavior starting with macOS 26. (128479184)

Translation Known Issues • Downloading languages for translation might display incomplete indicators on the download screen resulting in translation features being unavailable. (148923222) Workaround: Reboot the device.

UIKit New Features • In TextKit 2, the includesTextListMarkers property has been introduced to NSTextList, NSTextContentStorage and UIWritingToolsCoordinator. For paragraphs associated with NSTextList, the property controls whether to include the text list marker string in the NSAttributedString contents. The classes within TextKit 1 expect the marker string, while the classes within TextKit 2 do not. (144903432)

Known Issues • In apps using UIToolbar, the Search bar sometimes does not respond to taps and displays without the magnifying glass, dictation button, or placeholder text. (151126350) Workaround: Quit the app then re-launch it. • On iPhone only, the searchTextField property of a UISearchBar belonging to a UISearchController (i.e. searchController.searchBar.searchTextField) might not return the same instance when called at different times. (153550157) Workaround: Look for UISearchBar or UISearchController API equivalent to the UISearchTextField API you’re using. If none can be found, you can prevent the issue by setting the UINavigationItem.searchBarPlacementAllowsToolbarIntegration property to false on the navigation item the search controller has been assigned to. • In rare cases after launching an app on iPhone, unusual client code timing of assembling the view controller hierarchy might cause the search bar belonging to a view controller in a tab to disappear from the navigation bar when first switching to that tab. (156174227) Workaround: Set the searchBarPlacementAllowsToolbarIntegration property of the UINavigationItem to false at the same time you set the searchController. • In rare cases, the layout calculation from a client’s layout constraint for their search results might change when presenting a UISearchController directly (for example, using -presentViewController:) after building with the new SDK. This is due to removal of internal constraints with the identifier UIView-Encapsulated-Layout-Width and UIView-Encapsulated-Layout-Height. (157208725) Workaround: Examine the existing constraints and determine how to modify them to be stable independent of the presence of the encapsulation constraints. Compare the results of po [ _autoLayoutTrace] with an older SDK and look for views marked with a bullet. If they don’t have a bullet on the new SDK, their encapsulation constraints will have been removed. This will get you started on adjusting your constraints setup.

Deprecations • UIScreen.mainScreen has been changed from API_TO_BE_DEPRECATED to deprecated in iOS 26, tvOS 26, and visionOS 26. (142902390)

Wallpapers Known Issues • Widgets might be missing on the previews of photo wallpapers in the gallery. (151464159) • After install or reboot, the default wallpaper might show as pink when the display dims or is on rotation. (152119543) • Some wallpapers specific to certain devices might be missing. (152284310)

Watch App Known Issues • Apple Watch apps with a MinimumOSVersion of watchOS 26 that have an iOS counterpart fail to install to the watch via the Watch app on iPhone. (153195856) Workaround: Use Xcode to install the app directly to the watch.

Watch Faces Known Issues • Complications configured on watch faces might appear ‘Off’ on the Watch app. (152324791) Workaround: Use Apple Watch directly to edit complications.

Weather Resolved Issues • Fixed: Users might see a blank white button on some tips for Weather features. The button will be operable. (152088799)

Web Apps Resolved Issues • Fixed the “Add to Home Screen” flow failing to load webpage data, preventing users from making new Home Screen web apps. (154655565)

WebKit API New Features • The load APIs on WebPage now return an AsyncSequence directly that can be used to track relevant navigation events. The current NavigationEvent property has been removed in favor of the navigations property, which produces an indefinite sequence directly. (152414525) • The WebPage API now supports directly loading URLs. Additionally, when loading an HTML string, there is now a default value for the baseURL parameter. (152904248) (FB17850359)

Resolved Issues • Fixed: webView OnScrollGeometryChange might report an incorrect content size. (146576790)

Wi-Fi Aware Resolved Issues • Fixed: transmitLatency property of WAPerformanceReport might not report latency values. (151628308) • Fixed: Network connection to a paired device with an already-established connection might not succeed. (151873702) • Fixed: Connections might be terminated unexpectedly after 120 seconds. (152279075) • Fixed: Connections attempted while browser is not running might fail. (152336071) • Fixed: The wifiAware property for connection-related NWError objects will be nil. (153100140) • Fixed: New connections to an endpoint after multiple connect and disconnect operations might not succeed. (153689457)

Widgets Known Issues • A select few widgets such as Batteries, Contacts, Files might have an incorrect UI treatment. (145492734)

Xcode Resolved Issues • An issue causes a drop in on-screen and background termination metrics reported in Xcode Organizer and MetricKit, for iOS 18.4, 18.5, 18.6 and 18.7 users. As more users upgrade to iOS 26, the termination metrics will undergo self-correction. (145270174)

Overview

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

Background Assets

Resolved Issues

• Fixed: AssetPackManager.url(for:) unexpectedly throws an error when looking up the URL for a locally available asset file. (157959878) (FB19512759)

Game Controller

Resolved Issues

• Fixed: The time returned by GCPressedStateInput.lastPressedStateTimestamp is not in the correct time domain. (159124910)

HealthKit

New Features

• HealthKit authorization UI now displays a single Blood Pressure switch to control changes to Systolic and Diastolic Blood Pressure type authorizations. The API is unchanged and apps should request for both types in code. (153579893)

Resolved Issues

• Fixed: HKCorrelation objects of type .bloodPressure fail to save with error Invalid Argument HKError code if they don’t have exactly one systolic and one diastolic blood pressure quantity its set of objects. (151889745)

Keyboard

Known Issues

• You are unable to select diacritical marks and character variants with keyboard. The base character is inserted instead of the intended variant. (159398021)

NearbyInteraction

New Features

• NINearbyAccessoryConfiguration now supports additional UWB parameters such as hopping mode. (157879907)

Known Issues

• Running an NISession with an NIDLTDOAConfiguration results in an error. (151352056)

Siri

Known Issues

• Questions related to News in Portuguese might fall back to Web search or ChatGPT. (153935878)
• Siri Voice preview might default to legacy pt-BR voices, rather than new pt-PT options. (155929981) Workaround: Select Voice 2 as your new Siri voice. Ask Siri a question, and you will hear the new pt-PT offering.
• The initial pt-PT Siri Voices have pronunciation and word stress issues. Your feedback is appreciated. (160205691)

SwiftUI

New Features

• @Animatable macro is now available starting with iOS 13, macOS 10.15, tvOS 13, and watchOS 6. (158895616)

Resolved Issues

• Fixed: Buttons that do not specify an explicit label display text instead of a symbol in toolbars. (157671221)
• Fixed: The navigationLinkIndicatorVisibility modifier crashes when run on iOS 17, iOS 18 and aligned releases. You must recompile your app against the 26.1 SDK to receive this fix. (158236264) (FB19613386)

Known Issues

• On iOS and iPadOS, @FocusState doesn’t work in safeAreaBar. (158720838)

UIKit

Resolved Issues

• UIDocument was incorrectly annotated to be main actor only. This has been corrected. As a result you might see new warnings or errors show up in your Swift code using UIDocument. (149990945)

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

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

Fixed: User might be unable to play newly added background sounds (Fire and Night). (128898875) Fixed: Sound Recognition and Sound Actions might not work on iPad Pro models with M4. (128949527) Fixed: Music Haptics might disappear after the first time it is entered in Accessibility Settings until Settings restarts. (128960448)

AccessorySetupKit Fixed: Users might be unable to rename Accessory’s display name or SSID. (128958722)

Activity Sharing Fixed: Notifications for workouts completed by a friend might show incorrect text. (128939058)

AdAttributionKit New Features AdAttributionKit now supports measuring re-engagement, which is click-through attribution for apps that were already installed. Re-engagement also supports deep linking into content in apps using Universal Links. (111224069) Fixed an issue where development postbacks fail to send after developer mode has been enabled for an extended period of time. (130100361)

App Intents Fixed: EntityURLRepresentation allows arbitrary custom URLs without validation. (119524801) Fixed: AppIntent static properties including title and description are not concurrency-safe. (128090148) Fixed: Parameterless @Parameter and @Property wrappers might cause protocol conformance failures. (130219933)

Known Issues @Union Value types currently only work as intent results. Attempting to use a @Union Value as the type of an intent parameter or entity property results in failure to compile. (128069844)

App Store New Features On-demand resources limits were increased for iOS 18, iPadOS 18, tvOS 18 and visionOS 2. See On-demand resources size limits for more information. (122163236)

Apple Cash Known Issues With Tap to Cash, you can send and receive Apple Cash by holding two iPhones together. An Apple Cash account is required to send and receive payments. Payments will be returned to the sender if the receiver doesn’t set up an Apple Cash account or verify their personal information within 7 days. For Developer Beta, Tap to Cash payments cannot exceed $250 per transaction. Transaction limits are subject to change, including lowering limits, at any time during the Developer or Public Betas without notice. (128977390)

Assistive Access Resolved Issues Fixed: The Messages app might hang in Assistive Access. (127601737) Fixed: Users might not be able to add Photos or Camera apps to Assistive Access and the apps might be removed from an existing user’s setup if they open Assistive Access settings. (128905924)

Audio Resolved Issues Fixed: Some bluetooth headphones might not be useable as an audio output route with certain AVAudioSession configurations. (126693883)

Calculator Resolved Issues Fixed: Deleting history item with the Edit button visually deletes the top item in the list. The backing data stays correct. (126768783)

Camera Resolved Issues Fixed: For Camera background replacement, it might be necessary to double click to add a background image from your Photos Library using the Photo Picker. (122358378) Fixed: First Portrait capture after boot might take longer than expected to finish. (128881179) Fixed: Camera functions might take up to 2 minutes to work after booting iPhone/iPad. (128899310) Fixed: When using the Document Scanning feature from Camera app on iPad, it might sometimes result in a black screen instead of a live preview from camera. (128907349) Fixed: Portrait mode preview with rear facing camera might show artifacts when pointed at objects when using Stage Light, Stage Light Mono, and High-Key Light Mono light filters. Artifacts will not affect captured assets. (129024197)

CarPlay Resolved Issues Fixed: Bluetooth pairing UI could become irresponsive for BMW users, which leads to failed contact transfer. (129043855)

CFNetwork Resolved Issues Fixed: CFNetwork Execute Proxy Auto Configuration Script and CFNetwork Execute Proxy Auto Configuration URL have always returned a +1 retained CF type object, but the function declarations were not decorated with the CF_RETURNS_RETAINED attribute until iOS 18, macOS 15, tvOS 18, and visionOS 2. For C-based languages, the clang static analyzer might note if the object is leaked. No source code changes are required, but they are encouraged to fix the leak. For Swift, this changes the return type of these functions from Unmanaged<> to the actual CF type returned, which will require a source change to fix when compiling with newer SDKs. However, Swift programs compiled with older SDKs will continue to work on the new OSes, though the returned CF type object will continue to leak as it did prior to this change. (126154509)

Containerization Resolved Issues Fixed: Improved the handling of the duplicate containers created by Xcode 15 through 15.3. Those versions of Xcode might create duplicate containers on the device. This change ensures that the app launches with a consistent container and that deleting the app also deletes any duplicate containers. (123480553)

Control Center Resolved Issues Fixed: Control Center page control is overlapped by the Dynamic Island in landscape. (125913281) Fixed: Empty pages in Control Center might linger after exiting edit mode. (126760824) Fixed: Control widgets with a parameterized OpenIntent action are not configurable. (128241927) Fixed: Voice Memos control will not render correctly or be functional after upgrading to iOS 18 if it was part of Control Center prior to the update. (129184182)

Known Issues App Icons in Control Center gallery always appear in Dark Mode. (126721275)

Core ML Resolved Issues Fixed: Core ML Model Deployment API is unavailable (MLModel Collection and MLModel Collection Entry). Consider using Background Assets or NSURLSession instead. (122955353)

CoreMedia Resolved Issues Fixed: Seeking into an interstitial event with non-zero resumption offset on the integrated timeline might result in the event being cancelled. (129175283)

Display Resolved Issues Fixed: Phones with Always on Display enabled might panic/reboot on exit. (128268712)

FaceTime New Features FaceTime in Low Data Mode now uses more data when network conditions are good for improved video call quality. (128408959) Resolved Issues Fixed: When user picks up FaceTime Video call from lock screen and unlock the device later, the camera might be disabled where user cannot see remote side via PiP and vice versa. (124719544)

Files Resolved Issues Fixed: Users might be unable to navigate within Move panel in the Files app on iPhone. (128868597)

Known Issues Creating local files in the Files app fails in the visionOS 2 and iOS 18 simulators if the host is not upgraded to macOS Sequoia Beta. (132561244)

FinanceKit Resolved Issues Fixed: Transactions shared via the Transaction Picker might have empty description strings. (128618523)

Fitness+ Resolved Issues Fixed: The Fitness app might not load the Fitness+ For You page immediately on first launch. (127116109)

Foundation New Features JSONEncoder.OutputFormatting.sortedKeys will now sort keys with a different ordering. Previously, keys were sorted using a numeric, case-insensitive, or localized ordering. Beginning in beta 4, keys are sorted lexicographically based on the keys’ UTF-8 contents. (126874437) Resolved Issues Fixed: Date.Components Format Style was incorrectly producing strings like "1m" with the Date.Components Format Style .Style .condensed Abbreviated style and strings like "1min" with the .narrow style instead of the other way around. The behavior was corrected to match the behavior of Duration .Units Format Style .Unit Width . (125790342)

Freeform Resolved Issues Fixed: Some images inserted into iWork and Freeform might be zoomed in. (128637913)

Handwriting Resolved Issues Fixed: Auto-refine animation contains rendering issues for users with Display Zoom set to “More Space” within the Display & Brightness settings. (129419813)

Headphone Accommodations New Features Headphone Accommodations can now be configured on macOS. When user set up Headphone Accommodations with AirPods Pro 2s, user will continue to hear audio adjusted when connected to other audio sources. (130245415)

Health Resolved Issues Fixed: In Cycle Tracking, multiple pregnancy samples might be saved after a user adds or edits a pregnancy. (121271613) Fixed: Doses of medication logged via mirrored watch notifications for incompatible schedule types do not save on phone if device is locked. (128635016) Fixed: Cardio Fitness notifications will not turn back on automatically 12 weeks post pregnancy or after a pregnancy cycle factor is deleted. (128659463) Fixed: Period flow is displayed as Bleeding during Pregnancy and Bleeding after Pregnancy in Cycle Detail View. (128929595) Fixed: When Heart Rate Watch App is deleted, Health Checklist in Health App and Watch Settings still show features (Irregular Rhythm Notifications, High Heart Rate Notifications, Low Heart Rate Notifications) as active. (128970200) Fixed: The Cycle Tracking snippet might continue to display flow or symptoms logged pre-pregnancy. (129066144) Fixed: In Cycle Tracking, if a pregnancy sample is edited or created on a device different than where pregnancy onboarding was completed, Medical ID might not display pregnancy information correctly. (130777331)

Known Issues If a pregnancy sample is deleted on a device that is not on iOS 18, users are not prompted to remove pregnancy data from MedicalID if applicable. (129296194) Workaround: Manually delete pregnancy data from Medical ID. In Cycle Tracking, if a pregnancy sample is edited or created on a device different than where pregnancy onboarding was completed, Medical ID might not display pregnancy information correctly. (130784441) Workaround: Edit Medical ID to add pregnancy information.

HealthKit Resolved Issues Fixed: Workout routes for workout types created by Apple Watch Workout app are not available in third-party workout apps. (123450917)

Known Issues With the introduction of Swift 6 this year, developers who update their projects to use Swift 6 might have issues with their apps, which can lead to app crashes when executing a variety of HealthKit API calls. (131794283) Workaround: Annotate your callbacks in code with @sendable, NS_SWIFT_SENDABLE, or use pre-Swift 6 versions of the language.

Home app Known Issues If a user has multiple devices running beta 1 or 2 and onboarded Home with a Utility account, the account might get offboarded when one device is upgraded to beta 3. (130850945) Workaround: Re-onboard Home Utility account, only after upgrading all devices to beta 3.

Home Screen Resolved Issues Fixed: There might be a delay when switching to dark or tinted icons on the home screen. (129069905) Fixed: Icon tint slider knob might not update to selected color on the first use after boot. (129114071)

HomeKit Resolved Issues Fixed: Accessory Firmware update will not be offered for an accessory if a user reboots the resident or the primary switches. (128255088)

Hotspot Resolved Issues Fixed: Carrier EAP-SIM/EAP-AKA auto-joint will fail and user will be unable to use carrier public Hotspot. (130650425)

iCloud Drive Resolved Issues Fixed: Frequently changed files syncing over iCloud Drive will use more data than expected. (128771010)

iPhone Mirroring Resolved Issues Fixed: Dictation is available during iPhone Mirroring. (126654567) Fixed: Keyboard input might not work in Spotlight or App Library when using iPhone Mirroring. (126928807) Fixed: Users might be able to launch lock screen apps while using iPhone Mirroring. (128281331) Fixed: Settings might show incompatible devices under iPhone Mirroring. (128633492) Fixed: The camera is not enabled in any case, and only FaceTime shows the alert. FaceTime triggers the “Camera not allowed in iPhone Mirroring” alert. Other apps do not trigger the alert though the Camera is disabled. (128646948)

Journaling Suggestions New Features Journaling Suggestions is introducing a set of new features to keep encouraging people to reflect and write about their day-to-day experiences to get the mental wellbeing benefits of Journaling. The API now supports Landscape mode and Reflection prompts. Added support for State of Mind logged on Health or Journal app, Run and mixed Walk/Run sessions performed while carrying a standalone iPhone, Media played by apps that donate to MPNowPlayingInfoCenter, People and Pet names from Photos and enhancements to Trips Suggestions to highlight Countries and States visited. (129029773) Resolved Issues Fixed: Users might experience blank suggestions or engineering text. (128774773) Fixed: Users might experience long spinner after tapping ‘+’ to open Journaling Suggestions sheet. (128950895) Fixed: When tapping ‘+’ to launch the Journaling Suggestions sheet, it might not launch. (128970387)

Kernel Deprecations kern.bootsessionuuid is no longer available to apps. (47217954)

Keyboard Resolved Issues Fixed: Users will not be able to configure Keyboard in Settings, including adding/removing keyboards for different languages or adding/removing keyboard extensions. (129174947)

Lock Screen Resolved Issues Fixed: Lock Screen Quick Action buttons might disappear. (128096099) Fixed: Users will be unable to configure Controls that have configuration on the Lock Screen. (128967021)

Mail Resolved Issues Fixed: The Mail badge count might not update until Mail is launched. (129914323) Known Issues Upgrading from iOS 18.0 beta 5 to iOS 18.1 beta might cause all Mail to redownload. (132930689)

Maps New Features Introduced Place ID, a unique and persistent identifier. (129071038) Added new resultTypes to MKLocalSearch.Request and additional PointofInterestCategory values. (129073725) Introduced Place Card API to show Maps Place Card UI. (129073922) Resolved Issues Fixed: Maps Share ETA might fail when sending to a recipient via SMS. (127547239) Fixed: The Place Card API might fail to load place details. (128504304) Fixed: In searches that use MKLocalSearch.Request, the result type option physicalFeature is ignored. (128961972) Known Issues Conversion between a point in the map view and a physical location (CLLocationCoordinate2D) might be imprecise at high zoom levels. (129042241)

Math Notes Resolved Issues Fixed: Adjusting negative numbers can lead to multiple negative signs. (123738353) Fixed: Adjusting a number with a comma can immediately change the number value to 0. (127904684)

Memory Allocation New Features The system memory allocator (malloc(3)) has switched to a new implementation for most allocation sizes. Users might experience exposure of latent memory access bugs due to changes in heap layout, differences in performance for allocation-heavy workloads, and changes in fragmentation. (127493322)

Messages New Features Sent and received messages via satellite might not be relayed to your other devices. (125574729) Messages via satellite is currently available only in the U.S. SMS messaging via satellite is available on select carriers. (127751557) Messages via satellite is currently available only in the U.S. SMS messaging via satellite is available on select carriers. (131421891) RCS messaging is available on select carriers. (131499640) Resolved Issues Fixed: A send message sound will play when scheduling the message instead of when the message is sent. (121896789) Fixed: When applying tapbacks by long pressing on a Message, users will be unable to use 3rd party stickers. (122379099) Fixed: When off grid, text message conversations might incorrectly display text suggesting that the carrier does not support text messages via satellite, even though user is able to send and receive text messages over satellite. (127334940) Fixed: Emoji tapbacks might display incorrectly in SMS group conversations. (127446747) Fixed an issue where multi-part SMS notifications for MMS are not correctly processed by the device while on-grid. (128880899) Fixed: Existing RCS 1:1/Group chat will downgrade to SMS even if RCS is still registered. (130029732) Known Issues For group messages with RCS and iMessage participants, a reply to a text message attachment might not display as a thread on the receiver device. (133326509)

Networking Resolved Issues Fixed: For apps linked on macOS 15 / iOS 18 or newer, the default User-Agent request header field value generated by URLSession now includes the unlocalized bundle name instead of the localized bundle name. (117380285)

Notifications Resolved Issues Fixed: Incoming notifications on Lock Screen might not be seen when in List View. (129021171)

Phone Resolved Issues Fixed: In the Phone app, the Keypad search results always display a video icon, although tapping the icon places audio calls. (131601723)

Photos New Features Collection order and visibility changes will be reset if they were made on iOS and iPadOS 18.0 beta 4 or earlier. (132117458) Resolved Issues Fixed: Photos and videos might stop syncing via iCloud Photo Library. (128325085) Fixed: Photos-related services might not respond. This issue can impact iCloud Photo Library syncing, Camera captures, Screenshot captures, and Sharing. (130739189) Fixed: Upgrading from iOS 18.0 beta 5 to iOS 18.1 beta results in a Photos Library rebuild. (131845921)

Platform New Features On Apple Silicon based devices with M3 or later, and A16 Bionic or later, the values returned by reading the CNTFRQ_EL0 and CNTVCT_EL0 registers have been updated to 1 GHz, instead of the prior value of 24 MHz. It is still recommended for apps to use libsystem APIs like mach_absolute_time() for timekeeping. Your app will not be impacted by this change if it uses Apple’s timekeeping APIs. For compatibility purposes, this change will only be visible when using the SDK associated with this release or later. On macOS, applications running inside a Virtualization.framework VM will continue to receive the legacy behavior. (84639494) The firmware image for iBoot will be made available in cleartext in the PCC image. To reduce the overhead imposed by firmware encryption and align policies where appropriate, firmware encryption has been disabled for iBoot on iOS, macOS, watchOS, tvOS, and visionOS. See Private Cloud Compute for more details. (125171074)

Podcasts Resolved Issues Fixed: Podcasts will incorrectly show “View Transcript” as an option in shortcuts. (131070716)

Previews Resolved Issues Fixed: Triggering an on-device preview might fail. (129150211)

RealityKit New Features USD files which use Catmull-Clark subdivision now render using subdivision in RealityKit. Meshes which produce less than 35,000 patches can render using subdivision. This can increase memory consumption and reduce rendering performance. (129016034) Virtual objects now render using the Display P3 color gamut. When using a Drawable Queue connected to a Texture Resource with the .color semantic, render using the Display P3 color space. (129017592) Resolved Issues Fixed: In iOS & iPadOS 17, macOS 14, visionOS 1 and earlier, UnlitMaterials’ blending modes inconsistently respond to .blending , .color , and .base Color setters. In applications building against RealityKit from iOS & iPadOS 18, macOS 15, or visionOS 2, alpha-blending enablement should be configured explicitly with .blending = .transparent(opacity:) . Developers are advised to check that their code-configured materials are alpha-blending as intended, and use the .blending setting where appropriate. (118210191) In iOS & iPadOS 17, macOS 14, visionOS 1 and earlier, transparent materials’ apparent final opacities respond inconsistently to .blending , .color , and .base Color setters. In applications building against RealityKit from iOS & iPadOS 18, macOS 15, or visionOS 2, the final opacity of transparent materials is computed as a multiplication of its .color or .base Color ’s alpha and .blending = .transparent(opacity:) . Developers are advised to check that their code-configured transparent materials render with the intended final opacities, and update their usages of .color , .base Color and/or .blending = .transparent(opacity:) when necessary. (125431647) Fixed: The pixel Cast function might not work correctly on iOS. (125742631) Fixed: Grounding shadows are less prominent than expected. (126498888) Fixed: Using an Image 2D Array Shader Graph node in Reality Composer Pro might result in corruption or a system crash. (127122590) Fixed: Grounding shadows will not be visible in ARQL on certain iPad Pros. Apps enabling ray-traced shadows via Xcode storyboards will not take affect. (127748381) Fixed: Setting the environment property of a Reality View to .world Tracking does not automatically start an ARKit session, and the background of your Reality View might be black. (128417183) Fixed: Reality files written by beta versions of RealityKit might not load in later versions. (128424173) Fixed: Physics simulation behavior is different from previous releases. (128435086) Fixed: The stop function on SpatialTrackingSesssion has no effect. (128559666) Fixed: Emphasize actions are always additive and should be played with separate Animated Value set to true. (128622689) Fixed: In the Swift 6 language mode, subclasses of the Entity class fail to compile. (128787131) Fixed: The .trigger mode of CollisionComponent no longer generates CollisionEvents when both involved collision shapes use the .trigger mode. (129016567) Fixed: [.world, .plane, .image, .object, .face, .camera] anchor capabilities used in conjunction with any scene understanding capabilities on a device without a LiDAR scanner would cause those anchor capabilities to not work. (129253808)

Deprecations In previous versions, the order of child entities was sometimes preserved. Now, the order of an Entity ’s children might not be reliable and can change unexpectedly when any child is reparented. (129015381)

Screen Time Resolved Issues Fixed: Parent approving remotely from the parent device will always grant 1 hour, regardless of whether a child asks for a 15-minute, 1-hour, or all-day exception for an app or website. (129084141) Fixed: When an Apple Watch is upgraded to 11.0 from an earlier Beta, Screen Time App Limits might be deleted for both the parent and child. If this occurs, parent will need to add back the app limits. (130981807)

Search Resolved Issues Fixed: The “Help Apple Improve Search” control is not functional. (129226418)

Settings Resolved Issues Fixed: Recents and search results are sometimes missing and might not navigate to nested panes. (128802504) Fixed: The available storage listed in General > About might be incorrect. (129688831) Fixed: When navigating to Settings > General > Storage, the Settings app might crash if you have not opened Podcasts prior. (131180865)

Shortcuts Resolved Issues Fixed: The Shortcuts editor might offer some new actions that are not yet ready for use. If you save a shortcut with one of these actions, you might need to correct it after a future update with the corrected actions. (128841105) Fixed: Adding or removing SiriKit intents or App Intents might not reflect immediately in the Shortcuts app. (130039560) Fixed: The Create Board and Open Board Shortcuts actions and App Shortcuts might not be available. (133023610)

Simulator Resolved Issues Fixed: Using Safari in the simulator can cause the simulator to hang. (128545001)

Siri New Features In iOS 18, when an iPhone is connected via Bluetooth to a vehicle without CarPlay, Siri’s audio quality can be significantly improved through the new option “Respond over Media Source”. First, users need to enable the setting by going to (with Developer settings enabled) Settings, “Developers” “Siri in Bluetooth Car testing” Toggle “Show Audio Output in Settings”. Users then will be able to use this feature by going to Settings “Siri & Search” “Siri Responses” “When Connected to Car Bluetooth”. (128692679)

Software Update Resolved Issues Fixed: Devices updating from an iOS/iPadOS 18 beta build or macOS 15 beta build prior to iOS 18 beta 4 or macOS 15 beta 4 can hit a download error. (130652449)

Spotlight Known Issues Icons in Spotlight might not match icons on the Home Screen. (134088480)

StoreKit New Features The Subscription Store View now supports custom control styles. To create a custom control style, declare a type that conforms to Subscription Store Control Style and implement make Body(configuration:) method. (106819454) New standard styles are available for laying out subscription store view controls with a compact height. Use paged Picker and paged Prominent Picker for a platform appropriate paging effect, or compact Picker to place options in a horizontal stack. For watchOS, the new paged Picker style is available for laying out Subscription Store View controls with a compact height. (110286601) Use types such as Subscription Option Group and Subscription Period Group Set to declare a hierarchical structure for your Subscription Store View. You can use the subscription Store Control Style(:) to choose between presenting groups as a tab view or as navigation links. (110429924) (FB12264937) The subscription status Renewal Info object now supports new properties renewal Price and currency to indicate the price at which the subscription will renew, and its currency. There is also a new offer property containing the information of the offer that will be applied to the next renewal, if there is any. This includes the offer ID, the offer type, and the payment mode. (114217892) Finished consumables can now be included when using the Transaction APIs. Users can enable this feature by setting SKIn App Purchase History Includes Consumables to true in app’s Info.plist. (115079880) When configuring the control style for a Subscription Store View, users can specify a placement for the controls using the subscription Store Control Style( : placement:) view modifier. For tvOS, by default Subscription Store View will place the controls trailing the marketing content. (115319543) When building an app with Xcode 16, Subscription Store View instances using the picker control style have an updated appearance. Use subscription Store Picker Item Background(in:) to configure a different background color and shape for the picker items. (120558960) Users can now use APIs like monthly or yearly to get common Product .Subscription Period values when comparing subscription periods. (122684230) Resolved Issues Fixed: Selecting Done in the refund request confirmation sheet returns an error when using the refund request API with StoreKit Testing in Xcode. (123865137) Fixed: VoiceOver does not read a product’s title and description in Product View and Store View. (124254957) (FB13679318) Fixed an issue where the tab control in Susbcription Store View is too wide when using Store Content with the tabs option group style. (128567088) The request Review environment variable is now compatible with Swift 6. (129929512) (FB13922875)

Known Issues When using Subscription Store Picker within a container view, the window bar doesn’t work correctly. (117701666) Workaround: Return Subscription Store Picker as a top level view from make Body(configuration:) method, instead of using it within a container.

Deprecations The Original API for In-App Purchase is now deprecated, including: SKStoreReviewController, SKProduct, SKReceiptRefreshRequest, SKStorefront, SKPayment, SKRequest, SKProductsRequest, and SKProductDiscount. Please upgrade to StoreKit 2 for current APIs and future enhancements. (116600524)

Swift Charts New Features Plot math functions using Line Plot and Area Plot. (117186178) Visualize large datasets more efficiently using vectorized plot APIs such as Point Plot and Rectangle Plot. (117469419) Resolved Issues Fixed: Rotated axis labels stretch to incorrect sizes. (106013386) Fixed: Blur and shadow effects on marks might disappear during animation. (125493885) Fixed: Glitches when animating a connected scatter plot made of Line Mark. (127196185) Fixed: Stroke styles can now be animated. (127465359) Fixed: For function plots, the Y domain cannot be inferred automatically. (128877906) Fixed: Animations involving charts might lead to the disappearance of marks with a .foreground Style(Color) throughout the duration of the animation, even if the color did not change. (130023892)

SwiftUI New Features When using a Tab View, tapping on the current tab now pops any embedded navigation stack. (50924017) Pickers now can have keyboard shortcuts attached to their individual options, by attaching the keyboard Shortcut() modifier to the individual views in the picker content. (67682762) (FB8522629) If Label is used inside of a List with multiple views as its title, it will now stack them vertically and apply subtitle treatments to every view after the first. (115528544) For Observable Object subclasses used with @Environment Object, @Observed Object, and @State Object, SwiftUI will now only call object Will Change once per property per object instance. If you use @Published and the default Observable Object Publisher, you do not need to change anything. If you override object Will Change, ensure the lifetime of the publisher you return matches the lifetime of its enclosing Observable Object. (116197689) On iPad, TabViews using the automatic style have a new appearance in the regular horizontal size class. The tab bar now appears at the top, instead of the bottom, with a more compact visual appearance. (117029720) SwiftUI sheets presented with the .sheet modifier now use .automatic sizing by default. .automatic resolves to .form or .form.fitted(horizontal: false, vertical: true) depending on the platform (see the symbol’s documentation for more). Platforms prior to iOS 18 and aligned releases used different, non-customizable default sheet sizing. iOS 17 and earlier used what is now called .page presentation sizing. macOS 14 and earlier used what is now called .fitted sizing. visionOS 1 used .fitted sizing. When linking apps against iOS 18 and aligned SDKs, audit your sheet presentations and pick the sizing best for you. Apply a .presentation Sizing modifier to sheet contents: ContentView().sheet(isPresented: $present) { SheetView().presentationSizing(.form) } (117551515) Improved the interaction of highPriorityGesture with ScrollView. (119333786) Document-based applications linked against iOS 18 now have a new launch screen design. Users can customize the default design by adding a Document Group Launch Scene to the app definition. Users can change the screen title and background, replace action buttons, and add decorative accessory views. Non-document-based apps also can use the new screen via Document Launch View. (119843158) Types conforming to the View protocol, and other similar SwiftUI protocols, are now isolated to the @Main Actor by default. SwiftUI’s runtime behavior with respect to actor isolation has not changed: SwiftUI views and similar types have always been evaluated on the main actor at runtime; this change improves compile-time diagnostics for potential data-race safety issues. To opt out of the new default main actor isolation and restore the previous default isolation, add the nonisolated keyword to methods and properties as needed, or move the protocol conformance to an extension to opt out the entire type. (120815051) Known FormatStyles that are dependent on a FormatStyleCapitalizationContext and are embedded into a LocalizableStringResource via string interpolation now automatically infer capitalization based on sentence structure. The capitalization is only inferred automatically if it was unknown before. (122688257) Text(: format:) now automatically injects Format Style known to SwiftUI with the Time Zone and Calendar from the environment. (123662780) @Entry macro can now be used to simplify declarations of custom Environment Values, Focused Values, Transaction, and Container Values properties. (125568810) Added the ability to give a gesture a name, which gets surfaced to UIGestureRecognizers when establishing dependencies. (126527559) Nesting a TabSection within a TabSection is supported in the .sidebar Adaptable TabViewStyle on iPadOS and visionOS. (128237671) Resolved Issues Fixed an issue where long press gestures would block gestures on other descendant views. (57368881) Fixed an issue where UIButton used with UIView Representable might not receive touches. Tap gestures in SwiftUI also now correctly coordinate with UITap Gesture Recognizer instances. (57885589) Fixed: For apps linked on or after iOS 18, the popover modifier now respects the arrow Edge argument on iOS and iPadOS. (66839017) (FB8350757) Fixed: SwiftUI gestures no longer errantly trigger when dismissing a menu. (69703502) (FB8751308) Fixed: For Each is now able to reclaim persistent state of unused child views. @State values created by views inside For Each elements might be destroyed earlier than previously observed. (90667238) Fixed: A Dismiss Action captured in the content or detail column of a Navigation Split View now pops the implicit stack. For apps linked on or after iOS 18 and aligned releases, the button in the example below will now clear any selection in the sidebar List. Previously, this would fail silently on iOS, and close the window on macOS. To retain the previous behavior, capture the Dismiss Action from the environment above the Navigation Split View. (92522613) Fixed: A Scroll View now propagates safe area insets on its non-scrollable edges. By default, Scroll indicator for scroll views that occupy the size of the screen have improved insets. (102766716) Fixed: Outline Lists do not animate correctly. (106239318) Fixed an issue where searchable suggestions automatically filter out completion options that have a search Completion matching the current search text. Exact matches should be explicitly elided from the suggestions if desired. (107706241) Fixed: View.print Changes now outputs key path of mutated observable properties instead of “@dependencies”. (111392797) Fixed: Using the scroll Clip Disabled() view modifier with a Scroll View with a Lazy HStack or Lazy VStack will use the containing window to determine what content the lazy stack should render. (111796138) Fixed: SwiftUI will now assert that types conforming to the App protocol are value types. (113634782) Fixed: In macOS, a Toggle of the .switch style now animates when its is On state is changed programatically, matching the existing behavior on iOS and iPadOS. The animation can be disabled in all platforms by setting the transaction’s disables Animations property when updating a Toggle’s state. (115071023) Fixed: Automatically updating Text created via Text(: style:) or Text(timer Interval: pause Time: counts Down: shows Hours:) was causing increased battery drain when used in long running Live Activities. They now no longer animate changes in digits that signal the seconds value, keeping the power impact to a minimum. (115906895) Fixed: SwiftUI no longer overrides a nil scroll Target Anchor when using the scroll Position(id: anchor:) modifier with a nil anchor. Specify a top Leading anchor to restore the previous behavior. (116124988) Fixed: When linking against iOS 18 SDKs, SwiftUI prevents cycles in .sheet presentations caused by presentations preferences (e.g. presentation Detents or presentation Background) that depend on the size of the sheet. In some cases prior to iOS 18, these cycles might settle independently after some oscillation. (117699610) Fixed: App scenePhase now reports as active when at least one scene is active. (117864591) Fixed: The arrow Edge argument in .popover modifiers is now respected when linking against the iOS 18 SDK. If previously relying on the default argument of .top, this argument was not respected, and instead, the popover presented with .any behavior. If passing an explicit value, that value will now be respected. If not passing an explicit argument to the arrow Edge parameter, upon recompiling with the iOS 18 SDK, overload resolution will select a new method that takes no arrow edge in which the system picks the best arrow edge. When recompiling with the iOS 18 SDK, ensure popovers are not clipped or off-screen due to presenting in the wrong direction. (117921721) Fixed: Scroll views can now accept interaction in their content insets. (117928468) Fixed: .navigation Destination(for: destination) modifiers inside of lazy containers are no longer evaluated. .navigation Destination(is Presented: destination:) and navigation Destination(item: destination) will log warning when used in lazy containers. Lazy containers in this context include: List, Lazy VGrid, Lazy HGrid, Lazy HStack, Lazy VStack, Table, and Tab View. If using navigation Destinations in lazy containers, users will see logged errors at runtime. Lift the modifiers higher up in the view hierarchy so they are outside of the lazy containers. Allowing navigation destination modifiers in lazy containers had two significant costs: (1) app navigation state could be undefined if a navigationDestination had been scrolled off screen (2) The navigation system had to explore all list contents to ensure navigation destinations remained up to date. Only allowing these modifiers outside of lazy containers improves app navigation reliability and performance. (117998693) Fixed an issue that caused SwiftUI gestures to trigger simultaenously with UIControl subclasses or gestures in UIView Representable views. (119335307) Fixed: Views at the root of a Navigation Stack will now always have matching on Appear and on Disappear callbacks. (119737698) Fixed: The order of Shape Style compositing modifiers is now honored with respect to shadows. Previously in fill(style .blend Mode(…).shadow(…)) the added blend mode would also apply to the shadow, that is no longer the case. The blend mode modifier must be added after the shadow modifier to affect it. As a consequence, the fill and any shadows added can now use different blend modes. Similar rules apply to Shape Style .opacity() except that outer opacity() modifiers multiply with inner modifiers, e.g. in fill(style .opacity(0 .5).shadow(…).opacity(0 .5)) the shadow is drawn with 50% opacity (of whatever style draws) and style itself draws with 25% opacity. (119738072) Fixed an issue where Popover presentations automatically dismiss if they go outside the safe area. (120458490) Fixed: The meaning of the boolean value passed to the Content Transition .numeric Text(counts Down:) function has been flipped for apps deployed prior to iOS 18 aligned releases. (120561508) Fixed: Gestures might not pick up a modified content shape, such as when increasing the tappable area of a button. (120938385) Fixed: A Picker ’s current value label does not default to the first option anymore when initialized with an invalid selection. (121871839) Fixed: Resolved an issue where rapidly toggling the visibilility of columns in a NavigationSplitView could cause the sidebar to become stuck in either the visible or hidden position. (122840735) Fixed: Sidebar headers no longer respond to increased prominence. (123518195) Fixed an issue when a sheet modifier is removed from a view hierarchy. This can happen if the sheet modifier is in one branch of an if statement and the statement’s condition changes. For apps linked on or after iOS 18 and aligned releases, when a sheet modifier is completely removed from the hierarchy, the binding associated with the sheet will not be reset. (123742063) Fixed: For Each child views are no longer re-evaluated unconditionally, only when a parameter of the For Each view might have changed. (123902210) Fixed: Apps might crash when nesting a TabSection inside of another TabSection. (123928013) Fixed: Scroll views have improved behavior in right to left languages when the size of their content is smaller than the size of their container. (124008045) Fixed: Elements along a Navigation Path or the data structure passed to the path parameter of Navigation Stack(path: root:) are now compared more efficiently. Any side-effects from setting a path equal to itself are no longer reliable and likely will not occur. (125093883) Fixed: The state of the root view of UIHosting Configuration is now reset before the associated cell is displayed. (125100960) Fixed: Scene Builder, Widget Bundle Builder, Table Column Builder, Table Row Builder, Commands Builder, and Toolbar Content Builder now diagnose unsupported if #available conditions at compile time instead of crashing at run time. (125379937) Fixed: Resolved an issue where context menus with custom previews could not be interacted with. (125517121) Fixed: UIView Representable, NSView Representable, and their view controller variants no longer create a layer with allows Group Opacity set to true. (125561916) Fixed: In certain scenarios, Text( : style:) produced suboptimal output, such as choosing an unnecessarily small calendar unit, showing zero values for large calendar units instead of omitting them, or showing seconds in Always On Display. (125885307) Fixed: Text(timer Interval: pause Time: counts Down: shows Hours:) was redacting the seconds value even when the timer was paused, had not started yet, or had already reached its end. (125885429) Fixed: When applying a searchable() modifier to a Tab View, the tab view will reset the search state when switching tabs. (125926765) Fixed: Resolved an issue where scroll views would not receive touches if placed near a tappable control. When rebuilt with the newer SDK, make sure that small buttons and tap targets are correctly enlarged. You can use the content Shape modifier. (126232279) Fixed: Document Group scenes that do not allow document editing, created via Document Group(viewing: viewer:), will not render the document view. (127076044) Fixed: NewDocumentButton() within DocumentLaunchView fails to create a document when pressed. (127389818) Fixed: TabView customization emits runtime errors if customization identifiers are not provided for tabs with automatic customization behavior. (127442031) Fixed: Some NavigationLinks in the deprecated Navigation View might not work. (128358023) Fixed: Sheets presented with the .sheet modifier will have Fitted Presentation Sizing by default. This can cause sheets to appear too narrow or too large, depending on their contents. This is incorrect. The default presentation sizing should be .form. (128902804) Fixed: Deprecated Navigation Links links with an is Active argument that are wrapped with a get/set Binding derived from another Binding might not update the destination view if the derived binding updates too late. (129018685) Fixed: In the Swift 6 language mode, the @Entry macro now works with non- Sendable types if the type of the entry is declared explicitly. (129073803) Fixed: Fixed an issue where the name passed to the gesture modifier would not be available when resolving UIKit dependencies. (129590852)

TipKit New Features The new Tip Group API and Cloud Kit Container syncing will be made available via an upcoming beta SDK release. (129425412)

Translation New Features Users can translate text and display results in app. See the Translation Session class, and learn more in the WWDC24 video “Meet the Translation API.” (112844581) Translation now supports translating Hindi in the Translate app, System-wide translation, Safari translation, and the new Translation APIs. (116622913) Resolved Issues Fixed: When using .translation Presentation() on an iPhone, the background above the sheet blocks the presenting view instead of letting it show through. (128504309)

UIApplication Resolved Issues Fixed: Applications built with iOS 18, iPadOS 18, Mac Catalyst 18, or tvOS 18 SDKs will call to the deprecated method UIApplication.open URL(_:). The specified URL will not open and will always return false. (125695759)

UIKit Resolved Issues Fixed: UITab Group.managing Navigation Controller does not work as expected. (126277771) Fixed: Creating a new document in using “+” sign in “Recents” tab of UIDocumentBrowserViewController might fail. (128520498) Fixed: tabBarController(_:didSelectTab:previousTab:) is not called when a child of a UITab Group is selected. (128697021) Fixed: Tab titles are missing in iPad tab bars for RTL languages. (130154177)

Deprecations If UIImage(named:) was called with the name of an app icon, it would previously return an undefined image of the icon set, without any masking or shadowing applied. On iOS 18, it now returns nil. To display an icon within the app itself, add the desired image to the asset catalog as an image set. (130491812) (FB14052579)

Vision Framework Deprecations face Capture Quality is now replaced by capture Quality.score on Face Observation. (132508104)

Wallet New Features To help prevent fraud, when adding an ID to iPhone, the user might be asked to take a Live Photo instead of, or in addition to, conducting a series of head and facial movements. The Live Photo is evaluated by the device and Apple to help ensure that the photo being submitted is of a live person and that the same live person is submitting the photo. (129338051)

Resolved Issues Fixed: Sharing your ID in Wallet within apps is not available when Require Face ID for Wallet is enabled. (128775860)

Wallet & Apple Pay Known Issues Users with an Apple Watch might be prompted to reauthorize Connected Accounts in Wallet on iPhone. (129127520) Workaround: Wait for iPhone and Apple Watch to synchornize. If the issue persists after several minutes, try reauthorizing the connection on iPhone.

Watch Faces Resolved Issues Fixed: In Apple Watch > Face Gallery on iPhone, complications for the Podcasts and Music apps are unavailable. (131747921)

WeatherKit Resolved Issues Fixed: HistoricalComparisons data will not be returned unless it is requested with other weather datasets (e.g. CurrentWeather). (107204312) Fixed: Returned HistoricalComparisons conditions, such as precipitation, might have placeholder values for baseline and currentValue. (126496817) Fixed: Responses for more than 90 days of DayTemperatureSummary and DayPrecipitationSummary data might be slow to return. (127768828) Fixed: Some PrecipitationStatistics fields such as averagePrecipitationProbability and averageSnowfallAmount might show placeholder values. (128008885) Fixed: WeatherKit v2 is currently available only for Swift, not for the REST API. (128024852)

WidgetKit Resolved Issues Fixed: Adopting ‘autoPresentConfigAfterAdding’ currently doesn’t auto present config sheet for widgets or controls. (114470520) Fixed: Disabled and privacy-redacted control states do not render properly for control widgets used with the Action button. (125867980) Fixed: Control widget label views might not be able to read redaction reasons from the environment. (126232534) Fixed: The prompts For User Configuration() modifier has no effect for control widgets in Control Center, the Lock Screen, and the Action button. (126862283) Fixed: ControlCenter.currentConfigurations does not include configured control push tokens. (127601613) Fixed: An error building a control template that states “Template request failed: WidgetKit.ChronoError.AppIntent.conversionFailure(underlyingError: AppIntent has missing parameter value for ’timerName’” might occur. Users might need to set a default value in the initializer of @Parameter, or using the default method on Query. (129066701) Fixed: Widget extensions using ControlWidgetButton and ControlWidgetToggle will crash on iOS 18 beta 5 and later when built from Xcode 16 beta 4 and earlier. (130760581)

Known Issues For control widgets that specify both a subtitle and value, Control Center displays only the subtitle. (127906735) Images used in a ControlWidgetConfiguration that are loaded from the app extension’s bundle might glitch when using a symbol effect content transition. (131789007) Workaround: Apply the .contentTransition(.identity) view modifier to the Image.

Widgets Resolved Issues Fixed: Resizing widgets on the home screen in RTL might not work as expected. (128625613) Fixed: If tinting is enabled for the home screen shortly after updating, the widgets might appear with the incorrect background color until it reloads automatically by the system. (128701638)

Deprecations Legacy Today View extensions are removed in iOS 18. (116246167)

Wifi Calling Resolved Issues Fixed: T-Mobile Users will not be able to initiate/receive wifi calls on secondary devices that are signed onto the same iCloud account. (130227345)

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

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

HealthKit

Known Issues

• Health data becomes inaccessible when you reach the “slide to power off” page on an iPhone or iPad without a passcode. (154706523)
  • Workaround: Add a passcode or reboot the device.

See Also

• Related iOS & iPadOS 18 Release Notes:
  • iOS & iPadOS 18.5 Release Notes - Update your apps to use new features, and test your apps against API changes.
  • iOS & iPadOS 18.4 Release Notes - Update your apps to use new features, and test your apps against API changes.
  • iOS & iPadOS 18.3 Release Notes - Update your apps to use new features, and test your apps against API changes.
  • iOS & iPadOS 18.2 Release Notes - Update your apps to use new features, and test your apps against API changes.
  • iOS & iPadOS 18.1 Release Notes - Update your apps to use new features, and test your apps against API changes.
  • iOS & iPadOS 18 Release Notes - Update your apps to use new features, and test your apps against API changes.

Overview

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

Apple Vision Pro app

Resolved Issues

• Fixed: On iOS 18.4 beta 1, the Apple Vision Pro app launches with a black screen if downloaded from the App Store. Upgrade to iOS 18.4 beta 2 and newer, and the app will launch as expected. (146814396)

Broadcast Extensions

New Features

• Broadcast extensions now have a higher per-process memory limit. This should enable capturing & streaming content at higher quality, if the system resources are available. (144104867)

hvf

Resolved Issues

• Fixed: Availability checking is disabled for C APIs in hvf. (148385341)

Security

Resolved Issues

• Fixed: Some enterprise apps might not launch. If you experienced this issue on iOS 18 or later, uninstall all enterprise apps from the device and reinstall them. (147965052)

Siri

Known Issues

• Siri requests to play a song in Apple Music might fail across multiple platforms. (149392508)

StoreKit

Resolved Issues

• Fixed: Calling isEligibleForIntroOffer(for:) will return false if there is no user account signed in. (146119524)

Writing Tools

Resolved Issues

• Fixed: Resolved an issue where the attributes in the NSAttributedString passed in writingToolsCoordinator(:replace:in:proposedText:reason:animationParameters:completion:) (or its companion async form) are stripped when an NSWritingToolsCoordinator or UIWritingToolsCoordinator has resultOptions set to [.plainText]. The attributes are no longer stripped but instead use the same attributes as were included by the delegate in the NSAttributedString returned in writingToolsCoordinator(:requestsContextsFor:completion:) (or its companion async form). (144105888)

Overview

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

AdAttributionKit

• AdAttributionKit now supports Overlapping Conversions, which enables advertisers to have multiple simultaneous re-engagement conversions. The system provides a conversion tag as the value of the re-engagement URL parameter. You can pass the conversion tag into the updateConversionValue API to update the specific conversion. (136100247)
• New AdAttributionKit testability for advertised apps is in iOS Settings > Developer > Ad Attribution Testing. You can now create and interact with development postbacks for your app in iOS Settings, instead of requiring a separate publisher app to sign and show ads for your app. If your app is built with Xcode, you can now create development postbacks for your app in iOS Settings, replacing the need for your app to first be distributed in the App Store or alternative app marketplace. (136704392)

Apple Intelligence Resolved Issues

• Fixed: For languages other than English (US), Apple Intelligence support requires Siri to be enabled. (144092696)
• Fixed: After restoring iOS 18.4 or iPadOS 18.4, some Apple Intelligence features might not be available or you might see “Downloading support…”. (145117473)
• Fixed: Some Apple Intelligence features are unavailable until device is rebooted. (145431408)

Apple Vision Pro app Resolved Issues

• Fixed: On iOS 18.4 beta 1, the Apple Vision Pro app launches with a black screen if downloaded from the App Store. Upgrade to iOS 18.4 beta 2 and newer, and the app will launch as expected. (146814396)

hvf Known Issues

• Availability checking is disabled for C APIs in hvf. (147323772)

  Workaround: To enable availability checking, add this ahead of any headers: #define BUILD_FOR_APPLE_SDK 1

libxml2 Deprecations

• The custom allocation API for libxml2 is deprecated starting in macOS Sequoia 15.4, iOS 18.4, tvOS 18.4, visionOS 2.4, and tvOS 18.4. If this API is not used, no changes are required. If this API is currently used, make changes to call malloc() instead of xmlMalloc() or xmlMallocAtomic(); call realloc() instead of xmlRealloc(); call free() instead of xmlFree(); and call strdup() instead of xmlMemStrdup(). Stop calling xmlMemSetup, xmlMemGet, xmlGcMemSetup, and xmlGcMemGet to set custom allocation functions. Do not set global variables xmlMalloc, xmlMallocAtomic, xmlRealloc, xmlFree, and xmlMemStrdup. Internally, libxml2 and libxslt will now use the system allocator instead of this API, so do not rely on these libraries using the custom allocation API. (138404994)

Nearby Interaction New Features

• Apps with an active Live Activity can now use Nearby Interaction in the background to perform Ultra Wideband ranging. (141170262)

Notifications Resolved Issues

• Fixed: Scrolling through Notifications might cause them to flicker or collapse momentarily. (142497254)

Simulator Known Issues

• Safari Extensions do not appear in iOS or visionOS simulator. (147511062)

Siri Resolved Issues

• Fixed: In non-English languages, some Siri suggestions might fail to complete successfully. (143407922)

StoreKit New Features

• New StoreKit APIs support Advanced Commerce API in-app purchases. (118528943)
• By using the new purchase option API introductoryOfferEligibility(compact JWS:), you can now set a preference for whether an introductory offer should be redeemed during a purchase. This API requires you to sign a payload on your server in order to either apply the offer (even if the customer is not eligible) or block it. (136152740)
• New properties appTransactionID, originalPlatform, and period are now available in AppTransaction, Transaction, Transaction.Offer, and Product.SubscriptionInfo.RenewalInfo. (136395697)
• The Platform symbol used by originalPlatform in AppTransaction has been moved to AppStore.Platform. (143632084)
• The introductory offer eligibility preference API in PurchaseOption has been renamed to introductoryOfferEligibility(compact JWS:). (143905053)
• watchOS is removed as an option in the AppStore.Platform API. watchOS is now combined with iOS. (145578780)

Resolved Issues

• Fixed: StoreKit helper application quits with NSCocoaErrorDomain error 4097 during a purchase. (140317005) (FB15907723)
• Fixed: StoreKit APIs might return errors from the StoreKit 2 domain during a purchase. (144191684)

Known Issues

• Calling isEligibleForIntroOffer(for:) will return false if there is no user account signed in. (146119524)

  Workaround: The user should sign in with their App Store account to request introductory offer eligibility.

Deprecations

• Transaction.currentEntitlement(for:) is now deprecated. This API returns the latest transaction that entitles the user to a product, which may not include transactions originated for family shared subscriptions. Use the Transaction.currentEntitlements(for:) method to get all the transactions that entitle the user to a product. (138320205)

SwiftUI Resolved Issues

• Fixed: A color set by the tint(_:) modifier does not override the tint color of buttons in that view’s confirmation dialogs and alerts. (138774306)
• Fixed: For apps compiled against iOS 18.4 beta, applying defaultVisibility(.hidden) to customizable toolbar items does not hide the item by default on iOS. (139815290)
• Fixed: When NavigationStack or NavigationSplitView content updates, the environment is not invalidated unless properties in the environment have changed. (139855826)
• Fixed: .onPreferenceChange modifier’s closure argument is required to be @Sendable. This might cause concurrency diagnostics that’s unnecessary if the closure needs to access main actor-isolated values. This particular closure shouldn’t have to be this restrictive. (145238570)

System Calls New Features

• fileport_makeport(2) and fileport_makefd(2) are now APIs with manual pages. (66571768) (FB8270900)

UIWritingToolsCoordinator Resolved Issues

• Fixed: The two optional delegate methods intended for multiple container support are not available. (136619485)
• Fixed: The delegate method -writingToolsCoordinator:requestsRangeInContextWithIdentifierForPoint:completion: does not support asynchronous use of the completion block. (136824869)
• Fixed: The delegate receives more calls to -writingToolsCoordinator:selectRanges:inContext:completion: than necessary. (138868937)
• Fixed: In iOS 18.4 beta, UIWritingToolsCoordinatorDelegate method -writingToolsCoordinator:requestsRangeInContextWithIdentifierForPoint:completion: is marked as optional will not be called. (139544247)

URLSession New Features

• To enable the new HTTP loading mode, set usesClassicLoadingMode to false on URLSessionConfiguration. The new loading mode will become the default in a future release. (89390075)

Wi-Fi Calling Resolved Issues

• Fixed: Wi-Fi Calling might not work for US cellular customers on iOS 18.4 beta. (144450317)

Writing Tools Resolved Issues

• Fixed: After generating a list, key point, table, or summary in the pop-over, selecting “Replace” results in an error message. (145186545)

Overview

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

Apple Intelligence New Features

• For users new or upgrading to iOS 18.3, Apple Intelligence will be enabled automatically during iPhone onboarding. Users will have access to Apple Intelligence features after setting up their devices. To disable Apple Intelligence, users will need to navigate to the Apple Intelligence & Siri Settings pane and turn off the Apple Intelligence toggle. This will disable Apple Intelligence features on their device. (141646604)

Genmoji Resolved Issues

• Fixed: A personalized Genmoji might not generate without selecting a different person first. (139676076)

HealthKit Resolved Issues

• Fixed: HealthKit authorization granted by the user for a data type might not persist, resulting in the app being unable to access data and potentially prompting the user again for authorization. (134678955) (FB14923881)

Writing Tools Resolved Issues

• Fixed: For third-party apps adopting Writing Tools API on iOS, if the first responder is not a UIView, it will not be able to use the complete inline experience. (139833232)

See Also

• Related iOS & iPadOS 18 Release Notes

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

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

Overview

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

Accessibility

Resolved Issues

• Fixed: If you use the Ignore Trackpad setting, it will be reset after updating to iOS 18.2 Beta. (139611885)

AVFoundation

Resolved Issues

• Fixed: In Swift, iterating over AVCaptureSynchronizedDataCollection with a for-in loop causes a crash. (135132312)

ChatGPT Integration

Resolved Issues

• Fixed: For devices with MDM profiles, users with anonymous restrictions are unable to sign out. (135440023)
• Fixed: Requests to generate images with ChatGPT in Writing Tools might fail. (138791595)

Find My

Resolved Issues

• Fixed: Play Sound and Precision Finding features of AirTags, AirPods and third-party Find My-enabled accessories might not work. (138283512)

Genmoji

Known Issues

• A personalized Genmoji might not generate without selecting a different person first. (139676076) Workaround: In the People selector screen, select a different person, then reselect the original person.

Mail

Resolved Issues

• Fixed: Recategorizing an email from a domain with a high number of messages might cause unexpected grouping behavior. (140360935)

Messages

Resolved Issues

• Fixed: Messages might not appear in the Messages app. (138152993)

Stickers

Resolved Issues

• Fixed: Stickers might not appear in the Emoji keyboard or in the sticker sheet. The sticker sheet is accessed through the Stickers item in Messages or in various other places like Freeform and Markup. You’ll either see missing stickers or a message that states you do not have any stickers. (138790914)

SwiftUI

Resolved Issues

• Fixed: Compiling in the Swift 6 language mode might cause an @Entry error due to “static property defaultValue is not concurrency-safe because non-‘Sendable’ type”. (133885814)
• For apps compiled against iOS 18.2/visionOS 2.2 and run against iOS 18.0/visionOS 2.0, the popover modifier does not respect the arrowEdge argument on iOS, iPadOS, or visionOS, regardless of the deployment target of the app. Now, apps compiled against iOS 18.2/visionOS 2.2 and run against iOS 18.1/visionOS 2.1 and later do respect the arrowEdge argument. (135231043)
• Fixed: Views won’t accept dropped directories if UTType.directory or UTType.fileURL are not in the list of accepted content types for drop. (138158126)

UIKit

Known Issues

• In iOS 18.2 Beta 3, -[UIApplication defaultStatusForCategory:error:] and its Swift equivalent UIApplication.isDefaultApplication(for:) are not present. (139669875) Workaround: Build and run against iOS 18.2 Beta 2 to test adoption of this new interface.

UIWritingToolsCoordinator

Known Issues

• The two optional delegate methods intended for multiple container support are not available in iOS 18.2 Beta. (136619485)
• When the UIWritingToolsCoordinator state is Noninteractive, textual changes might be applied through the UITextInput Paste API, instead of through -writingToolsCoordinator:replaceRange:inContext:proposedText:reason:animationParameters:completion:. (136631598)
• The delegate method -writingToolsCoordinator:requestsRangeInContextWithIdentifierForPoint:completion: does not support asynchronous use of the completion block. (136824869) Workaround: For the correct behavior when a user taps on a proofreading suggestion, the completion block for the method must be executed inline.
• UIWritingToolsCoordinator throws an exception if the delegate returns modified text in -writingToolsCoordinator:replaceRange:inContext:proposedText:reason:animationParameters:completion:, when reason is Noninteractive. (138775662) Workaround: Only return modified text when reason is Interactive.
• The delegate receives more calls to -writingToolsCoordinator:selectRangesInContext:completion: than necessary. (138868937)
• On Catalyst, if the delegate does not implement -isEditable as an @objc method, then Writing Tools will not apply changes to the text. (139031260)
• The UIWritingToolsCoordinator might quit Writing Tools if a user types in the InteractiveResting state or during operation of the previous/next revision buttons in the UI. (139196667)
• The UIWritingToolsCoordinator might request underline paths from the delegate at a time when they can’t be calculated. (139532897) Workaround: The delegate must be arranged to send -updateForReflowedTextInContextWithIdentifier: to the writingToolsCoordinator when underline paths can be calculated.
• Undo/redo grouping behavior is unpredictable when Writing Tools is active. (139533079) Workaround: For proper undo/redo grouping behavior, the delegate must start the grouping when the UIWritingToolsCoordinator’s state changes to InteractiveStreaming and stop when the state changes away from InteractiveStreaming. When the undo/redo stack is popped, the delegate should notify the Writing Tools coordinator, using -updateRange:withText:reason:forContextWithIdentifier: and passing the UndoRedo reason for each item. When all the items in the group have popped, use the same method to notify the coordinator, passing a 0-length range and a 0-length attributedString along with Typing for the reason.

Writing Tools

Known Issues

• For third-party apps adopting Writing Tools API on iOS, if the first responder is not a UIView, it will not be able to use the complete inline experience. (139833232)

Overview

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

General

Known Issues

• Updating from iOS & iPadOS 18 beta 5 to iOS & iPadOS 18.1 beta 1 is not currently supported and will be available in a future iOS & iPadOS 18.1 beta. (133235636)

App Intents Resolved Issues

• Fixed: Apps that support universal links might not open normally and instead open the browser when the user navigates to a URL provided by the OpenURLIntent or URLRepresentable Intent APIs. (133764689) (FB14784347)

Apple Intelligence

New Features

• When using Apple Intelligence, the new Siri UI might fail to render full screen on large CarPlay displays. (131586542)

AVFoundation

Resolved Issues

• Fixed: AVCaptureIndexPicker instances initialized with -initWithLocalizedTitle:symbolName:numberOfIndexes can appear in Camera Controls overlay. (135734701)
• Fixed: AVCaptureControls from LockedCameraCapture extensions can appear in Camera Controls overlay. (135844632) (FB15108682)
• Fixed: VSampleBufferDisplayLayer can show content from LockedCameraCapture extensions. (135851476)

Camera Control

Resolved Issues

• Fixed: Installing an app with a Capture Extension while another Camera Control app is already selected might cause a momentary system crash. (135021680)

Files

Resolved Issues

• Fixed: Creating local files in the Files app fails in the visionOS 2 and iOS 18 simulators if the host is not upgraded to macOS Sequoia Beta. (132561244)

HealthKit

Resolved Issues

• Fixed: With the introduction of Swift 6 this year, developers who update their projects to use Swift 6 might have issues with their apps, which can lead to app crashes when executing a variety of HealthKit API calls. (131794283)

Lock Screen

Resolved Issues

• Fixed: When on Lock Screen, pulling down to invoke Spotlight does not work. (133404809)

Mail

Known Issues

• Upgrading from iOS 18.0 beta 5 to iOS 18.1 beta might cause all Mail to redownload. (132930689)

Messages

Resolved Issues

• Fixed: Sending attachments via RCS might not work after swapping SIMs. (136209940)

Siri

Resolved Issues

• Fixed: Siri result snippets might appear in the wrong position. (135035793)

Spotlight

Resolved Issues

• Fixed: Icons in Spotlight might not match icons on the Home Screen. (134088480)

StoreKit

Resolved Issues

• Fixed: The transaction of a successful purchase on the default win-back offer redemption sheet might not appear on Transaction.updates sequence until the next app launch. (133575987)
• Fixed: In StoreKit Testing in Xcode, the offer identifier in the subscription renewal info might be reported incorrectly for offer codes. (133774710)

Swift Charts

Resolved Issues

• Fixed: Any project that utilizes Swift Charts fails to build when targeting iOS, macOS, or visionOS. (135905498)

SwiftUI

Resolved Issues

• Fixed: Scene restoration launches the incorrect scene. (132497400)
• Fixed: In apps compiled against SDKs prior to iOS 18.0 and visionOS 2.0, explicit arrow edges are not respected when the app is run on iOS 18.1 or visionOS 2.1. Apps compiled against any macOS SDK will still have the arrow edge respected. (133295608)
• On iOS 18.0, there is a known issue where passing nil to the .preferredColorScheme modifier, after the preferred color scheme is set by a different view in the hierarchy, does not trigger the system color scheme to change. Starting in iOS 18.1, when nil is passed to the .preferredColorScheme modifier, the view indicates no preference for the color scheme and thus uses the system color scheme. The view with the above modifier applied prefers dark mode when isDarkMode is set to true but otherwise defers to the color scheme as determined by the system. (133689390) (FB14768320)
• Fixed: On iOS, tvOS, and visionOS, View.navigationSplitViewColumnWidth (all overloads) does not produce an effect if applied after the NavigationSplitView is created. (135434989)
• Fixed: Using if #available in @WidgetBundleBuilder and @SceneBuilder crashes on prior OS versions due to “unknown OS version.” (136098106)

Telephony

Known Issues

• On some managed and supervised devices, the RCS messaging service might not be blocked as expected although the MDM restriction of allow RCSMessaging is installed successfully. (137974410)

WidgetKit

New Features

• A control’s default tint will be set to the App/ extension’s accent color, if a tint is not specified explicitly using the tint(_:) modifier. If neither is specified, the control’s tint will be the default system blue tint. (131662481)

Resolved Issues

• Fixed: Rectangular complications and Watch-specific custom Live Activity views use the wrong font metrics, causing title2 and title3 to render much larger than intended and largeTitle to render much smaller than intended. Additionally, custom Live Activity views use the wrong default font (SF Pro instead of SF Compact). (135831317)

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

Audio

• Fixed: Some bluetooth headphones might not be usable as an audio output route with certain AVAudioSession configurations. (129624040)

Camera and AVFoundation Capture

• Fixed: AVCaptureDeviceRotationCoordinator returns incorrect values for videoRotationAngle For Horizon Level Capture and videoRotationAngle For Horizon Level Preview when using the Front Camera on iPad Air (6th generation) and iPad Pro (7th generation). (126887983)

MarketplaceKit

• Fixed: an issue where user notification fails to display when an app, with an expired license and installed from a marketplace, fails to launch. (129306666)
• Fixed: an issue where reinstalling an offloaded app from a marketplace might get stuck with a disabled home screen icon. (130278683)

Notes

Known Issues

• For devices running iOS 17.6 betas 2 or 3, the Notes folder widget might display “No Folder Available”, and tapping on this widget might cause Notes to crash. (131921810)
• Workaround: Remove the Notes folder widget and re-add it, or update device to iOS 17.6 beta 4.