Xcode 12.2 Beta 3 Release Notes

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

Overview

Xcode 12.2 beta 3 includes SDKs for iOS 14.2, iPadOS 14.2, tvOS 14.2, watchOS 7.1, and macOS Big Sur 11. The Xcode 12.2 beta 3 release supports on-device debugging for iOS 9 and later, tvOS 9 and later, and watchOS 2 and later. Xcode 12.2 beta 3 requires a Mac with Apple silicon running macOS Big Sur 11 or later, or an Intel-based Mac running macOS Catalina 10.15.4 or later.

General

Known Issues

• Building or running an iOS app with a macOS destination may fail if you’re building the app with a newer iOS SDK than your version of macOS supports. (68261281, 68714781, 68948002)

  The failure may present in one of the following ways:

  • The application crashes on launch

  • Xcode displays an alert stating “The operation couldn’t be completed. (OSStatus error -10825.)”

  • Xcode displays an alert stating “Unable To Install”

  Workaround: Change the iOS deployment target for the iOS app to a version supported by the version of macOS you’re using, or upgrade to a version of macOS that supports the iOS deployment target configured in the project. macOS 11.0 beta supports the iOS 14.0 deployment target, and macOS 10.15.6 supports the iOS 13.6 deployment target when running apps built using Mac Catalyst.

Build System

Known Issues

• xcodebuild double-escapes the output of xcodebuild -showBuildSettings -json. (63554669)

Core Data

Known Issues

• Core Data’s model editor may display a blank Detail area for an Entity when running in macOS 11 beta 9. (69472812)

Debugging

Known Issues

• Xcode fails to install an app with multibyte UTF-8 characters in its bundle name, and presents an error of “failed to hardlink copy”. (69887557) (FB8766413)

  Workaround: Use only uppercase letters (A-Z), lowercase letters (a-z), hyphens (-), underscores(__), and spaces in an app’s bundle name. By default, an app’s bundle name matches its target name, which you can change in the project editor.

  Note that this issue doesn’t impact an app’s Bundle ID or Bundle Display Name, only the name of the app’s .app folder on disk, which isn’t usually seen by users.

• When you build and run an app in macOS 11 beta 10, the app may pause immediately at a SIGCONT signal. (69936597)

  Workaround: Continue execution as you would if the app had stopped at a breakpoint.

Previews

Known Issues

• Using the device name “Mac Catalyst” in a SwiftUI PreviewDevice modifier may cause the preview to fail to update. Instead, the banner displays the error “Cannot preview in this file – rendering service was interrupted”. (65305155)

  Workaround: Remove the previewDevice modifier and switch to the “My Mac” run destination.

Signing and Distribution

Resolved Issues

• Xcode can now distribute an archive containing an App Clip even if the parent app’s application identifier doesn’t begin with a Team ID. (67401115) (FB8461092)

Simulator

Resolved Issues

• Fixed an issue that could cause apps linking against Core NFC to crash with an error of “Library not loaded” from dyld. (67961203)

• Fixed an issue that could prevent Shortcuts from running in simulated devices. (69516795)

Known Issues

• Simulators may not be available when running command-line tools like simctl or xcodebuild from a non-root LaunchDaemon, or when launching as a different user from the current user (for example, with sudo or launchctl). (62188195)

• Simulator runtimes for iOS 13, tvOS 13, and watchOS 6 and earlier don’t work on the Developer Transition Kit. Preferences offers these runtimes for download, but creating a simulated device from one of these runtimes fails, claiming the runtime is unavailable. Future Macs with Apple silicon will support a limited set of older simulator runtimes for iOS and tvOS. (66115743) (FB8157217)

Deprecations

• Simulators for watchOS 6 or earlier aren’t supported on Macs with Apple silicon. (66352760)

Swift

Resolved Issues

• Fixed a regression that caused property wrappers to leak objects during their initialization. (69023636)

Swift Packages

Known Issues

• Swift Packages may not respect the “Build Active Architecture Only” project build setting when you try to build universal binaries. (64344067)

  Workaround: Use the “Any Mac”, “Any iOS Device (arm64)”, “Any watchOS Device”, or “Any tvOS Device” destination to build for all applicable devices.

Testing

Known Issues

• Xcode can’t run UI tests for an iOS app on Apple silicon. If the active scheme or test plan includes both unit and UI tests, Xcode skips the UI tests, and logs a message that the UI tests were skipped in the test-activity log. (60059698)

• Xcode doesn’t run iOS app tests in parallel on Apple silicon. The tests run sequentially instead. (60514529)

• iOS unit tests fail to launch on Apple silicon if the test target’s host application is set to None. (65309328)

  Workaround: In the General tab of the test target’s project settings, set the host application to an iOS application target.

Updates in Xcode 12.2 beta 2

General

Resolved Issues

• You can upload an app for App Store submission or Developer ID notarization even if Xcode’s path contains a space. (69009477)

Apple Clang Compiler

Resolved Issues

• Fixed an issue that caused strip, install_name_tool and vtool to corrupt the ad-hoc code signatures generated by the linker for arm64 Mach-O files. (51911417)

Devices

Resolved Issues

• Fixed a hang in rvictl when running on macOS 11. (65205535)

Playgrounds

Resolved Issues

• Fixed a crash that could occur when presenting a live view on a Mac with Apple silicon. (68930351)

Previews

New Features

• Xcode provides SwiftUI previews for macOS Widget extensions. (57990060)

Project Navigator

Resolved Issues

• Fixed an issue where the Finish button was not enabled when adding Swift Packages to a project. (68731814)

Simulator

Resolved Issues

• SwiftUI projects using StoreKit can now build for simulated watchOS devices. (68931021, 68935233)

Source Editor

Resolved Issues

• The source editor properly displays errors and warnings from Run Script build phases that use relative paths; clicking the issue in the Issues navigator takes you to the issue in the source editor. (43290386) (FB5420750)

Swift

Resolved Issues

• Fixed a compiler crash that could occur when a function builder body contains an empty switch statement. This issue could also cause a SourceKit crash while typing a switch statement in a SwiftUI view body. (65983237) (FB8111944)

Updates in Xcode 12.2 beta

General

New Features

• When bringing iPad apps to macOS, you can now enable the “Optimize Interface for Mac” target setting to use native Mac controls and resolution. (56344940)

• Xcode’s run destination menu now shows an Any Mac destination for Mac schemes. This is a new build destination that builds each target in the scheme for all of their supported architectures, regardless of the native architecture of the local Mac. (62736613)

• Xcode now supports iOS, tvOS, and watchOS development on Macs with Apple silicon. (64317985, 65077539, 65701094)

Core ML

Resolved Issues

• The Core ML editor’s Preview tab for sound classifier models now shows a classification result when you click on Listen. Also, when you add an audio file, clicking the Play button updates the timeline as the file plays. (67515312)

Create ML

New Features

• Training Control helps you explore and interact with models during training. The training process can be paused, saved, resumed, and extended. This feature requires macOS 11 or later. (45241965)

• The new Style Transfer template lets you train deep neural networks to stylize photos and videos in real time. This template requires macOS 11 or later. (55848835)

• The new Action Classification template lets you train neural networks to classify a single person’s actions in a video clip. This template requires macOS 11 or later. (56622350)

• The Object Detection template’s new Transfer Learning option helps improve model accuracy when training data is limited. This feature requires macOS 11 or later. (58627183)

• The Word Tagger template’s new Transfer Learning option uses dynamic word embeddings to help improve model accuracy when training data is limited. This feature requires macOS 11 or later. (59281335)

Devices

Resolved Issues

• You can debug a WatchKit App when an App Clip is added to its paired iOS App, even if that iOS App isn’t installed. (65784374) (FB8065876)

Interface Builder

New Features

• Added support for Inline and Compact UIDatePicker styles. (65085323) (FB7847821)

Resolved Issues

• Fixed the search field clipping on a navigation bar when first dragged from the object library. For existing navigation controllers in storyboards, you can correct clipping by selecting the navigation bar in the controller, and enable Size Inspector > Safe Area Relative Margins. (66566017) (FB8269384)

• Fixed an issue that could cause an NSTableView to lose its Source List style when deploying to macOS versions earlier than macOS 11. (67700315) (FB8525478)

Organizer

Resolved Issues

• Thinning for “all compatible device variants” no longer causes export of a watchOS application for Ad Hoc or Development distribution to fail. (66637482)

Previews

New Features

• The action menu has a new “Embed…” menu item that lets you specify the type of View container in which to embed the selected view hierarchy. (51152198)

• The action menu has a new “Embed in ZStack” menu item. (56989502)

• The SwiftUI previews canvas now automatically shows and hides based on the presence of a PreviewProvider in the file you’re editing. (67083504, 67693254)

• The Editor menu now includes Create Preview to create a PreviewProvider, and Create Library Item to create a LibraryContentProvider. (67110969)

Resolved Issues

• Fixed an issue that prevented previews from loading in projects with non-ASCII characters in their names, or in symbols within the project. (57260388) (FB7451792)

• Previews correctly display interpolated strings, including for localized strings. (64278576)

• Fixed an issue that prevented previews from loading for code that contains multi-line string literals. (65735599)

• On Intel-based Macs, previews now load for iOS, watchOS, or tvOS projects that depend on libraries without an arm64 slice. (65890022)

• The canvas displays error details when a preview fails to launch due to the underlying app crashing, such as when the app doesn’t have an EnvironmentObject. (67955924)

Known Issues

• SwiftUI previews for macOS projects may not load if Xcode is located outside the /Applications folder. (69442156)

Signing and Distribution

New Features

• Xcode can now sign iOS apps for development or distribution to Macs with Apple silicon. You must register your Mac with Apple silicon on the Developer website in order to run Mac, iPhone, or iPad apps. Registration requires your Mac’s hardware identifier, which you can find in Xcode’s error message or in the System Information app’s Hardware > Provisioning UDID field. Once you’ve registered your Mac, you can use Xcode’s automatic signing or manually sign apps to run on the device. (54476962, 65752056)

• Xcode can sign and provision an archived iOS app to run on your Mac with Apple silicon. Find the archive in the Organizer window, click on Distribute App, select either “Ad Hoc” or “Development”, choose your distribution options, select “Automatically manage signing”, and proceed through the remainder of the distribution assistant to create an IPA. Once you’ve created the IPA, you can transfer it to your Mac with Apple silicon, and double-click on it to install. During the app’s first launch, macOS prompts you to open the Security & Privacy preferences pane and enable the app. To see the launch button in the preferences pane, make sure your Mac is configured to only allow apps from the App Store and identified developers. (68513041, 68528315).

Resolved Issues

• When distributing an iOS archive using the Ad Hoc or Development method, Xcode validates that Macs with Apple silicon are included in the provisioning profile generated by automatic signing. (66803918)

• Xcode automatic signing includes your registered Macs with Apple silicon in your provisioning profile when exporting an archive. (66857321)

Simulator

New Features

• Simulated watchOS 7 devices support 64-bit processes. To verify watchOS projects are 64-bit clean in Simulator, make sure ARCHS is set to its default value. (54654060, 66352876)

  Note

  Projects must be 64-bit clean to run in Simulator on Macs with Apple silicon, which don’t support 32-bit code.

StoreKit

Resolved Issues

• Fixed a crash that could occur when selecting “Subscription Options” in the StoreKit transaction manager. (68354368)