{"abstract":[{"text":"Update your apps to use new features, and test your apps against API changes.","type":"text"}],"hierarchy":{"paths":[["doc:\/\/com.apple.documentation\/documentation\/technologies","doc:\/\/com.apple.Xcode-Release-Notes\/documentation\/Xcode-Release-Notes"]]},"identifier":{"interfaceLanguage":"swift","url":"doc:\/\/com.apple.Xcode-Release-Notes\/documentation\/Xcode-Release-Notes\/xcode-27_2-release-notes"},"kind":"article","legalNotices":{"copyright":"Copyright &copy; 2026 Apple Inc. All rights reserved.","privacyPolicy":"https:\/\/www.apple.com\/privacy\/privacy-policy","termsOfUse":"https:\/\/www.apple.com\/legal\/internet-services\/terms\/site.html"},"metadata":{"availableLanguages":["de-DE","en-US","es-419","fr-FR","it-IT","ja-JP","ko-KR","pt-BR","zh-CN"],"role":"article","roleHeading":"Article","title":"Xcode 27.2 Release Notes"},"primaryContentSections":[{"content":[{"anchor":"Overview","level":2,"text":"Overview","type":"heading"},{"inlineContent":[{"text":"Xcode 27.2 includes Swift 6.4 and SDKs for iOS 27.2, iPadOS 27.2, tvOS 27.2, watchOS 27.2, macOS 27.2, and visionOS 27.2.","type":"text"},{"text":" ","type":"text"},{"text":"Xcode 27.2 supports on-device debugging in iOS 17 and later, tvOS 17 and later, watchOS 10 and later, and visionOS.","type":"text"},{"text":" ","type":"text"},{"text":"Xcode 27.2 requires a Mac running macOS Tahoe 26.6 or later.","type":"text"}],"type":"paragraph"},{"inlineContent":[{"text":"See ","type":"text"},{"identifier":"https:\/\/developer.apple.com\/support\/xcode\/","isActive":true,"type":"reference"},{"text":" to learn more about compatible platforms and deployment targets.","type":"text"}],"type":"paragraph"},{"anchor":"Device-Hub","level":3,"text":"Device Hub","type":"heading"},{"anchor":"New-Features","level":4,"text":"New Features","type":"heading"},{"items":[{"content":[{"inlineContent":[{"text":"When used via Sidecar or a MacBook with Touch, Device Hub now sends touches on the iPad screen to the remote device as touches. This allows you to use multi-finger gestures such as pinch and rotate to test your applications.","type":"text"},{"text":" ","type":"text"},{"text":"(188634387)","type":"text"}],"type":"paragraph"}]},{"content":[{"inlineContent":[{"text":"Device Hub in Xcode 27.2 contains multiple improvements:","type":"text"}],"type":"paragraph"},{"items":[{"content":[{"inlineContent":[{"text":"Support for touch events through Sidecar","type":"text"}],"type":"paragraph"}]},{"content":[{"inlineContent":[{"text":"Support for Standby in iPhone Duo","type":"text"}],"type":"paragraph"}]},{"content":[{"inlineContent":[{"text":"Input support for iOS 17.x simulator runtimes","type":"text"}],"type":"paragraph"}]},{"content":[{"inlineContent":[{"text":"Slow Motion Animation (simulators only)","type":"text"}],"type":"paragraph"}]},{"content":[{"inlineContent":[{"text":"Simulate Shake (simulators only)","type":"text"}],"type":"paragraph"}]},{"content":[{"inlineContent":[{"text":"Simulate Fall (simulators only)","type":"text"}],"type":"paragraph"}]},{"content":[{"inlineContent":[{"text":"Simulate Memory Pressure (simulators only)","type":"text"}],"type":"paragraph"}]},{"content":[{"inlineContent":[{"text":"Context Menu for Screenshots","type":"text"}],"type":"paragraph"}]},{"content":[{"inlineContent":[{"text":"Improved Drag and Drop Compatibility for Screenshot Icon","type":"text"}],"type":"paragraph"}]},{"content":[{"inlineContent":[{"text":"Option to Hide Device Bezels","type":"text"}],"type":"paragraph"}]},{"content":[{"inlineContent":[{"text":"App Settings","type":"text"}],"type":"paragraph"},{"items":[{"content":[{"inlineContent":[{"text":"Quit Behavior for Booted Simulators","type":"text"}],"type":"paragraph"}]},{"content":[{"inlineContent":[{"text":"Keyboard Shortcut Behavior","type":"text"}],"type":"paragraph"}]},{"content":[{"inlineContent":[{"text":"Secure Keyboard Entry","type":"text"}],"type":"paragraph"}]},{"content":[{"inlineContent":[{"text":"Hardware Keyboard Simulation","type":"text"}],"type":"paragraph"}]},{"content":[{"inlineContent":[{"text":"Screen Capture Save Location","type":"text"},{"text":" ","type":"text"},{"text":"(189236369)","type":"text"}],"type":"paragraph"}]}],"type":"unorderedList"}]}],"type":"unorderedList"}]}],"type":"unorderedList"},{"anchor":"Resolved-Issues","level":4,"text":"Resolved Issues","type":"heading"},{"items":[{"content":[{"inlineContent":[{"text":"Fixed: Modifier keys such as Shift, Control, Option, and Command were not sent to the correct device when more than one device window was open.","type":"text"},{"text":" ","type":"text"},{"text":"(177181719)","type":"text"}],"type":"paragraph"}]},{"content":[{"inlineContent":[{"text":"Fixed: Keyboard and mouse inputs to simulators for OS versions before iOS 18.0, tvOS 18.0, watchOS 11.0, and visionOS 2.0 were not accepted.","type":"text"},{"text":" ","type":"text"},{"text":"(181945323)","type":"text"}],"type":"paragraph"}]},{"content":[{"inlineContent":[{"text":"Fixed: After disconnecting a physical device from Device Hub when “Simulate Hardware Keyboard” was in use, the device might have remained in “hardware keyboard” mode for up to 2 minutes. This caused the software keyboard not to appear when selecting a text field.","type":"text"},{"text":" ","type":"text"},{"text":"(182553164)","type":"text"}],"type":"paragraph"}]},{"content":[{"inlineContent":[{"text":"Fixed: Device Hub stopped sending touch and button input to a connected device after a period of inactivity.","type":"text"},{"text":" ","type":"text"},{"text":"(182695157) (FB23873443)","type":"text"}],"type":"paragraph"}]},{"content":[{"inlineContent":[{"text":"Device Hub now supports input to iOS 17 simulator devices.","type":"text"},{"text":" ","type":"text"},{"text":"(187484157)","type":"text"}],"type":"paragraph"}]},{"content":[{"inlineContent":[{"text":"Fixed: Selecting a Vision Pro simulator in Device Hub might cause Device Hub to quit unexpectedly if a visionOS runtime is not available.","type":"text"},{"text":" ","type":"text"},{"text":"(188313956)","type":"text"}],"type":"paragraph"}]},{"content":[{"inlineContent":[{"text":"Fixed: The Device > Simulate Memory Warning menu item did not work.","type":"text"},{"text":" ","type":"text"},{"text":"(188326513)","type":"text"}],"type":"paragraph"}]},{"content":[{"inlineContent":[{"text":"Fixed: Device Hub might terminate unexpectedly when running on earlier macOS 27.2 betas.","type":"text"},{"text":" ","type":"text"},{"text":"(190126101)","type":"text"}],"type":"paragraph"}]}],"type":"unorderedList"},{"anchor":"Known-Issues","level":4,"text":"Known Issues","type":"heading"},{"items":[{"content":[{"inlineContent":[{"text":"When the “Secure keyboard entry” setting is on, it prevents any app on the system from intercepting keyboard events before Device Hub sends them to the controlled device. It cannot be used at the same time as the “Capture Keyboard” feature.","type":"text"},{"text":" ","type":"text"},{"text":"(176305816)","type":"text"}],"type":"paragraph"}]},{"content":[{"inlineContent":[{"text":"Device Hub support for CarPlay requires devices to be physically connected via USB cable (not over the network). iOS Simulator is not supported for CarPlay.","type":"text"},{"text":" ","type":"text"},{"text":"(179494052) (FB23101450)","type":"text"}],"type":"paragraph"}]},{"content":[{"inlineContent":[{"text":"Screenshots and recordings in iPhone Duo might be black for up to a few minutes after booting the device.","type":"text"},{"text":" ","type":"text"},{"text":"(187146039)","type":"text"}],"type":"paragraph"}]},{"content":[{"inlineContent":[{"text":"VoiceOver, the Accessibility Inspector, and other accessibility tools cannot convey screen content on an iPhone Duo within Device Hub.","type":"text"},{"text":" ","type":"text"},{"text":"(187148389)","type":"text"}],"type":"paragraph"}]},{"content":[{"inlineContent":[{"text":"Device Hub is unable to customize the text size for a device running iOS 18 or earlier.","type":"text"},{"text":" ","type":"text"},{"text":"(189261485) (FB25077755)","type":"text"}],"type":"paragraph"}]},{"content":[{"inlineContent":[{"text":"When switching between the inner and outer display of the iPhone Duo simulator, modifier keys such as Shift and Command might stop working.","type":"text"},{"text":" ","type":"text"},{"text":"(189465196)","type":"text"}],"type":"paragraph"},{"inlineContent":[{"inlineContent":[{"text":"Workaround:","type":"text"}],"type":"strong"},{"text":" Click with the mouse on the currently visible screen.","type":"text"}],"type":"paragraph"}]}],"type":"unorderedList"},{"anchor":"Instruments","level":3,"text":"Instruments","type":"heading"},{"anchor":"Resolved-Issues","level":4,"text":"Resolved Issues","type":"heading"},{"items":[{"content":[{"inlineContent":[{"text":"Fixed: Hovering over the top ruler in the timeline would sometimes not show all tooltips for the timestamp you hovered over.","type":"text"},{"text":" ","type":"text"},{"text":"(168530263)","type":"text"}],"type":"paragraph"}]}],"type":"unorderedList"},{"anchor":"Interface-Builder","level":3,"text":"Interface Builder","type":"heading"},{"anchor":"Resolved-Issues","level":4,"text":"Resolved Issues","type":"heading"},{"items":[{"content":[{"inlineContent":[{"text":"Fixed: Interface Builder ","type":"text"},{"code":"toolchain","type":"codeVoice"},{"text":" compilation mode incorrectly encoded standard\/system ","type":"text"},{"code":"UIStackView.spacing","type":"codeVoice"},{"text":" as ","type":"text"},{"code":"0","type":"codeVoice"},{"text":".","type":"text"},{"text":" ","type":"text"},{"text":"(186354589) (FB24605403)","type":"text"}],"type":"paragraph"}]},{"content":[{"inlineContent":[{"text":"Fixed: Interface Builder ","type":"text"},{"code":"toolchain","type":"codeVoice"},{"text":" compilation mode failed to encode ","type":"text"},{"code":"UIButtonConfiguration.contentInsets","type":"codeVoice"},{"text":".","type":"text"},{"text":" ","type":"text"},{"text":"(187747632) (FB24829108)","type":"text"}],"type":"paragraph"}]}],"type":"unorderedList"},{"anchor":"Mac-Catalyst","level":3,"text":"Mac Catalyst","type":"heading"},{"anchor":"Known-Issues","level":4,"text":"Known Issues","type":"heading"},{"items":[{"content":[{"inlineContent":[{"text":"Projects that use APIs specific to iOS 27.1 show compile errors when building for Mac Catalyst (“undeclared identifier”, “not found”, “has no member”, “cannot find”, and similar errors).","type":"text"},{"text":" ","type":"text"},{"text":"(185924957)","type":"text"}],"type":"paragraph"},{"inlineContent":[{"inlineContent":[{"text":"Workaround:","type":"text"}],"type":"strong"},{"text":" Use build-time conditionals like ","type":"text"},{"code":"#if !targetEnvironment(macCatalyst)","type":"codeVoice"},{"text":" (Swift) or ","type":"text"},{"code":"#if !TARGET_OS_MACCATALYST","type":"codeVoice"},{"text":" (Objective-C) to isolate affected code.","type":"text"}],"type":"paragraph"}]}],"type":"unorderedList"},{"anchor":"Memory-Gauge","level":3,"text":"Memory Gauge","type":"heading"},{"anchor":"Resolved-Issues","level":4,"text":"Resolved Issues","type":"heading"},{"items":[{"content":[{"inlineContent":[{"text":"Fixed: Memory usage needle rotated beyond the meter when swap is used.","type":"text"},{"text":" ","type":"text"},{"text":"(187611943)","type":"text"}],"type":"paragraph"}]}],"type":"unorderedList"},{"anchor":"Previews","level":3,"text":"Previews","type":"heading"},{"anchor":"Resolved-Issues","level":4,"text":"Resolved Issues","type":"heading"},{"items":[{"content":[{"inlineContent":[{"text":"Fixed an occasional issue where selecting a preview from a preview group’s thumbnail grid on macOS would fail to 1-up the right preview.","type":"text"},{"text":" ","type":"text"},{"text":"(183475595)","type":"text"}],"type":"paragraph"}]},{"content":[{"inlineContent":[{"text":"A clearer error with recovery steps is now shown when previews fail because another user account on this Mac owns the Previews JIT directory.","type":"text"},{"text":" ","type":"text"},{"text":"(184564292)","type":"text"}],"type":"paragraph"}]},{"content":[{"inlineContent":[{"text":"A clearer error is now shown when the selected platform does not support a preview’s content.","type":"text"},{"text":" ","type":"text"},{"text":"(185436582)","type":"text"}],"type":"paragraph"}]},{"content":[{"inlineContent":[{"text":"Fixed: Previews could fail in source files that use Windows-style (CRLF) line endings.","type":"text"},{"text":" ","type":"text"},{"text":"(186255376)","type":"text"}],"type":"paragraph"}]},{"content":[{"inlineContent":[{"text":"The RenderPreview MCP tool now returns the list of available render destinations, and lets the caller specify which destination to use for rendering.","type":"text"},{"text":" ","type":"text"},{"text":"(186442676)","type":"text"}],"type":"paragraph"}]}],"type":"unorderedList"},{"anchor":"Project-Format","level":3,"text":"Project Format","type":"heading"},{"anchor":"New-Features","level":4,"text":"New Features","type":"heading"},{"items":[{"content":[{"inlineContent":[{"text":"Xcode now supports a JSON-based project format (","type":"text"},{"code":".xcproj","type":"codeVoice"},{"text":") that’s more readable, merge-friendly, and easier for coding agents to edit. Enable it in the File inspector. Projects using ","type":"text"},{"code":".xcproj","type":"codeVoice"},{"text":" also open in earlier versions of Xcode 27. Learn more in ","type":"text"},{"identifier":"https:\/\/developer.apple.com\/documentation\/xcode\/updating-your-xcode-project-configuration-file-format","isActive":true,"type":"reference"},{"text":".","type":"text"},{"text":" ","type":"text"},{"text":"(184661114)","type":"text"}],"type":"paragraph"}]}],"type":"unorderedList"},{"anchor":"SDK","level":3,"text":"SDK","type":"heading"},{"anchor":"Known-Issues","level":4,"text":"Known Issues","type":"heading"},{"items":[{"content":[{"inlineContent":[{"text":"macOS, watchOS, tvOS, and visionOS SDKs in Xcode 27.2 incorrectly report 27.1 as a valid deployment target. Builds and other functionality might have unexpected behavior if this deployment target is used. Mac Catalyst builds with a 27.1 or 27.2 deployment target might be unable to use newly introduced API.","type":"text"},{"text":" ","type":"text"},{"text":"(187160501)","type":"text"}],"type":"paragraph"}]}],"type":"unorderedList"},{"anchor":"Simulator","level":3,"text":"Simulator","type":"heading"},{"anchor":"Resolved-Issues","level":4,"text":"Resolved Issues","type":"heading"},{"items":[{"content":[{"inlineContent":[{"text":"Fixed: Some simulator runtimes are not completely deleted when removed, reappearing after a reboot.","type":"text"},{"text":" ","type":"text"},{"text":"(141290052) (FB16083602)","type":"text"}],"type":"paragraph"}]},{"content":[{"inlineContent":[{"text":"Fixed: If a simulator runtime is reinstalled after being deleted, it might still show up as unavailable in Xcode.","type":"text"},{"text":" ","type":"text"},{"text":"(187950199)","type":"text"}],"type":"paragraph"}]},{"content":[{"inlineContent":[{"text":"Fixed: In the iPhone Duo simulator, an app using ","type":"text"},{"code":"CameraCaptureAccessory","type":"codeVoice"},{"text":" could use both displays at the same time without an active camera capture session.","type":"text"},{"text":" ","type":"text"},{"text":"(190155353)","type":"text"}],"type":"paragraph"}]}],"type":"unorderedList"},{"anchor":"Known-Issues","level":4,"text":"Known Issues","type":"heading"},{"items":[{"content":[{"inlineContent":[{"text":"Cloning a simulator device running runtime 27.2 might fail due to incorrect file permissions.","type":"text"},{"text":" ","type":"text"},{"text":"(188407822) (FB24939277)","type":"text"}],"type":"paragraph"},{"inlineContent":[{"inlineContent":[{"text":"Workaround:","type":"text"}],"type":"strong"},{"text":" ","type":"text"},{"code":"find ~\/Library\/Developer\/CoreSimulator\/Devices\/<SOURCE_UDID>\/data -name '*.sb-????????-??????' -delete","type":"codeVoice"}],"type":"paragraph"}]}],"type":"unorderedList"},{"anchor":"XCTest-UI-Automation","level":3,"text":"XCTest UI Automation","type":"heading"},{"anchor":"Resolved-Issues","level":4,"text":"Resolved Issues","type":"heading"},{"items":[{"content":[{"inlineContent":[{"text":"Fixed: Tests using ","type":"text"},{"code":".rotateDigitalCrown","type":"codeVoice"},{"text":" might fail due to the device not registering the action.","type":"text"},{"text":" ","type":"text"},{"text":"(188422137)","type":"text"}],"type":"paragraph"}]}],"type":"unorderedList"}],"kind":"content"}],"schemaVersion":{"major":0,"minor":3,"patch":0},"sections":[],"seeAlsoSections":[{"anchor":"Xcode-27","generated":true,"identifiers":["doc:\/\/com.apple.Xcode-Release-Notes\/documentation\/Xcode-Release-Notes\/xcode-27_3-release-notes","doc:\/\/com.apple.Xcode-Release-Notes\/documentation\/Xcode-Release-Notes\/xcode-27_1-release-notes","doc:\/\/com.apple.Xcode-Release-Notes\/documentation\/Xcode-Release-Notes\/xcode-27-release-notes"],"title":"Xcode 27"}],"references":{"doc://com.apple.Xcode-Release-Notes/documentation/Xcode-Release-Notes":{"abstract":[{"text":"Learn about changes to Xcode.","type":"text"}],"identifier":"doc:\/\/com.apple.Xcode-Release-Notes\/documentation\/Xcode-Release-Notes","kind":"article","role":"collection","title":"Xcode Release Notes","type":"topic","url":"\/documentation\/xcode-release-notes"},"doc://com.apple.Xcode-Release-Notes/documentation/Xcode-Release-Notes/xcode-27-release-notes":{"abstract":[{"text":"Update your apps to use new features, and test your apps against API changes.","type":"text"}],"identifier":"doc:\/\/com.apple.Xcode-Release-Notes\/documentation\/Xcode-Release-Notes\/xcode-27-release-notes","kind":"article","role":"article","title":"Xcode 27 Release Notes","type":"topic","url":"\/documentation\/xcode-release-notes\/xcode-27-release-notes"},"doc://com.apple.Xcode-Release-Notes/documentation/Xcode-Release-Notes/xcode-27_1-release-notes":{"abstract":[{"text":"Update your apps to use new features, and test your apps against API changes.","type":"text"}],"identifier":"doc:\/\/com.apple.Xcode-Release-Notes\/documentation\/Xcode-Release-Notes\/xcode-27_1-release-notes","kind":"article","role":"article","title":"Xcode 27.1 Release Notes","type":"topic","url":"\/documentation\/xcode-release-notes\/xcode-27_1-release-notes"},"doc://com.apple.Xcode-Release-Notes/documentation/Xcode-Release-Notes/xcode-27_3-release-notes":{"abstract":[{"text":"Update your apps to use new features, and test your apps against API changes.","type":"text"}],"identifier":"doc:\/\/com.apple.Xcode-Release-Notes\/documentation\/Xcode-Release-Notes\/xcode-27_3-release-notes","kind":"article","role":"article","title":"Xcode 27.3 Beta 2 Release Notes","type":"topic","url":"\/documentation\/xcode-release-notes\/xcode-27_3-release-notes"},"doc://com.apple.documentation/documentation/technologies":{"abstract":[],"identifier":"doc:\/\/com.apple.documentation\/documentation\/technologies","kind":"technologies","role":"overview","title":"Technologies","type":"topic","url":"\/documentation\/technologies"},"https://developer.apple.com/documentation/xcode/updating-your-xcode-project-configuration-file-format":{"identifier":"https:\/\/developer.apple.com\/documentation\/xcode\/updating-your-xcode-project-configuration-file-format","title":"Updating your Xcode project configuration file format","titleInlineContent":[{"text":"Updating your Xcode project configuration file format","type":"text"}],"type":"link","url":"https:\/\/developer.apple.com\/documentation\/xcode\/updating-your-xcode-project-configuration-file-format"},"https://developer.apple.com/support/xcode/":{"identifier":"https:\/\/developer.apple.com\/support\/xcode\/","title":"Xcode Support","titleInlineContent":[{"text":"Xcode Support","type":"text"}],"type":"link","url":"https:\/\/developer.apple.com\/support\/xcode\/"}}}