Update your apps to use new features, and test your apps against API changes.
The macOS 10.15 SDK provides support for developing apps for Macs running macOS Catalina 10.15. The SDK comes bundled with Xcode 11 beta available from Beta Software Downloads. For information on the compatibility requirements for Xcode 11, see Xcode 11 Beta 4 Release Notes.
Installing third party kernel extensions now requires that you restart your Mac before they’re permitted to load. (50340461)
macOS Catalina beta 4 does not support the MacBook Air model released in Summer 2019. A future beta of Catalina will add support for MacBook Air (Retina, 13-inch, 2019).
During installation of macOS 10.15 you might be prompted to enter your administrator password multiple times to allow installation to proceed. (51206649)
You can unlock a Mac that has Activation Lock enabled when you use Recovery Assistant to erase it when reinstalling macOS. (52017040)
You no longer see only third-party applications when you click the Applications shortcut in the Finder sidebar if you used Migration Assistant to migrate your data to a Mac running macOS Catalina beta. (51651200)
Apps consistently relaunch after installation or applying an update. (51228752)
macOS frameworks are now thinned for the x86-64 architecture. Apps that execute i386 code now fail with the
EBADARCHerror code. The remaining stub frameworks are nonfunctional and exist only for compatibility purposes. (51236070)
VoiceOver feedback sounds are available while in macOS Recovery. (48218068)
You might receive an error when downloading or updating apps. (49755328)
Workaround: Sign out of your account using the Store menu, then sign back in and retry your download.
Apps such as Final Cut Pro, Motion, Compressor, and iMovie can consistently be found using Search. (51245576)
Users are prompted to authenticate when using the
SecureAPI with access control set on keys. (51279188)
Support for signing in with an account from a different country is currently unavailable. (51240948)
To enhance security, AppleEvents and AppleScripts that target an app on a remote system must authenticate as the same user on the remote system. An AppleEvent that targets an app running as a different user receives a
To allow remote AppleEvents to target apps in any user session, run the following command in Terminal on the server:
Then disable and reenable Remote Apple Events in System Preferences > Sharing. (5353592)
You can now enable voice processing mode on
You can use new
AVAudiotypes to wrap a user-defined block for sending or receiving data in real-time.
A new method is available for an
AVAudiobased app to retrieve a list of all nodes attached to an
A new rendering mode in
AVAudioselects the best spatial audio rendering algorithm automatically based on the output device.
AVAudioproperty allows system sounds and haptics to play while the session is actively using audio input.
A new property,
AVAudioinforms apps which style of voice prompt they should play based on other audio activity in the system.
Session .Prompt Style
AVAudioenumeration is extended to allow apps to specify route sharing policies so their audio and video is routed to the same location as AirPlay.
Session .Route Sharing Policy
Audio Unit Extensions now support user presets that are available across all host apps.
The OpenAL framework is deprecated and remains present for compatibility purposes. Transition to
AVAudiofor spatial audio functionality.
AUGraphis deprecated in favor of
Inter-App audio is deprecated. Use Audio Units for this functionality.
Carbon component-based Audio Units are deprecated and support will be removed in a future release.
Legacy Core Audio HAL audio hardware plug-ins are no longer supported. Use Audio Server plug-ins for audio drivers.
AVFoundation now supports encoding video with alpha channels using HEVC. Videos encoded in this manner are broadly supported in AVFoundation APIs and by Safari within web pages. Technical details of the format can be found in the Interoperability Profile specification. (8045917)
The previously deprecated 32-bit QuickTime framework is no longer available in macOS 10.15.
The symbols for QTKit, which relied on the QuickTime framework, are still present but the classes are non-functional.
Audio books appear correctly after migrating. (50823065)
You can consistently import books into your library. (50962112)
Locally downloaded cloud items don’t move back to iCloud after upgrading to macOS Catalina beta. (51306790)
If the ‘Restrict books with explicit content’ setting is enabled, your purchased books are no longer unexpectedly hidden. (51602141)
Books stored in iCloud Drive appear without delay in your Library. (51435740, 50776390)
Apps using Picture Taker must specify the
NSCamerakey to access the FaceTime camera. (47916725)
Applying a filter to console messages consistently succeeds. (51524242)
Added new APIs for instantiating and modifying the built-in Core Image filters.
CIKernelinstances now support arguments with arbitrarily structured data.
CIKernelinstances now support returning a group of two by two pixels.
The integer values of
CIFormatsymbols, such as
ARGB8, have changed to a new set of values which are consistent across platforms. The former values remain supported for backward compatibility; however, you should avoid dependancies on specific numerical values.
You no longer see unexpected results when creating 10-bit HEVC video content. (50322535)
Sending a Volume Purchase Program download request to a client from a Mobile Device Management server might cause an authorization dialog to appear on the client. (49376544)
DriverKit drivers don’t build in macOS Catalina beta 4. Continue using beta 3 for DriverKit development. (52858797)
The Filter Packet network extension type and
NWEthernetAPI now work with network interface drivers implemented using DriverKit. (48709552)
Your Mac starts correctly when an EndpointSecurity extension that contains the
NSEndpointkey is installed and then uninstalled. (52010655)
Security Early Boot
openevents are cached and invalidated correctly when the file is manipulated. (45497117)
EndpointSecurity system extensions have access to early boot events. (49487645)
kauthAPI will be removed in a future release. (50419013)
Password reset for FileVault volumes from macOS Recovery functions as expected. (50455695)
Final Cut Pro
You can consistently access content from your Photos library. (51600540)
Finder no longer quits unexpectedly when you try to restore using the Time Machine interface. (49398715)
Files can be copied from and deleted on an iOS device using the Files tab in Finder. (48649759)
You can now download folders from iCloud properly. (50855741)
When iCloud Desktop is enabled, attempting to drag a volume mounted on the desktop no longer results in the volume being copied to the Desktop. (51187890)
If you’re using iCloud Desktop and Documents and documents saved to your Desktop aren’t appearing, turn iCloud Drive off and then on again. (51569326, 52731989)
The Cloud Files section in About This Mac > Storage > Manage might inaccurately represent the current state of files on your Mac. (50362095)
Even when Optimize Storage is switched off, iCloud Drive might fail to automatically download all files. (50667204)
Workaround: Download files individually.
When creating a new Pages, Numbers, or Keynote document in a shared folder, you might see the message “Couldn’t connect to iCloud”. (50827963)
Workaround: Close and reopen the document.
All of your iCloud Drive data is consistently present after upgrading to macOS Catalina beta. (51787170, 51950018)
Documents download correctly in iCloud Drive. (52295165)
There are no longer multiple empty Application libraries within iCloud Drive. You can safely remove any empty folders. (51635803)
The content of folders inside an iCloud Shared Folder is available to other users viewing your shared folder. (51591135)
Turning off the Siri switch in iCloud settings correctly stops Significant Locations from syncing. (50908297)
Pages, Numbers, and Keynote documents in shared folders correctly show an error message when you try to access them from iCloud.com. (50738067)
Attempting to open iWork documents in Finder will unexpectedly create a
.cpgzfile if the corresponding iWork app isn’t installed. (40693892)
Workaround: Install the corresponding app from the App Store before opening the document.
Certain languages might exhibit clipped or misaligned layout. (51068688,50983852)
Certain languages might display unlocalized text. (47765173,51196633)
MPMediamight not display the contents of your library. (51785735)
AppKit and Mac Catalyst apps are currently view-only clients of PencilKit. (51146823)
In order to show a share sheet from a toolbar item using the
UIActivity, create the
init(iteminitializer and pass it a
UIBarconfigured as a
UIBar. There is no need to set the
Button Item .System Item .action
Event handling in extension contexts may produce unexpected results, including failure to deliver trackpad pinch and zoom gestures. (50145462)
When sending Mail attachments via MessageUI, each attachment might appear as two icons when viewed by the recipient. (50369995)
Controls drawn with accent color incorrectly maintain their active color when the window is inactive. There is no need to work around this in your app. (50563638)
The UIKit module currently doesn’t import the newly added
NSTouch. You can import these headers directly in Objective-C, or you can create a bridging header to import them for Swift. Be sure to import Foundation before importing these headers. (50704322)
Bar+UIKit Additions .h
When your Mac Catalyst app is launched directly into the background, it experiences all the state transitions of a regular app launch — such as
did Finish Launching With Options:)
application— followed by state transitions to return to background state from there —
Did Become Active(_:)
Will Resign Active(_:)
application. This will soon be updated to match iOS, where your app will receive only
Did Enter Background(_:)
application, and only if it wasn’t already running. (50742219)
Did Finish Launching(_:)
For Mac Catalyst apps to save to Photos Library, explicitly linking the Photos framework is required. (50781430)
Opening a CloudKit share URL might not launch a Mac Catalyst app that’s present on the system. Additionally, the system might not take the user to the appropriate App Store page to download an app which isn’t present on the system. (50877241)
Action and share extensions might exhibit visual anomalies. (51005363)
All assets at 3x scale factor are currently ignored when compiling the asset catalog for Mac Catalyst apps. Because the search begins with the universal asset, assets for a specific memory or graphics class won’t be found. For example, if you provide an image and only give a 6GB and Metal 5v1 asset, it won’t be found at runtime. It’s recommended that you provide all images as vectors to allow generation of the correct scale factors, or at minimum provide 2x versions of the assets. If you’re classifying resources based on memory and graphics families then you should provide "Any Memory" and "Any Graphics”. (51033745)
CXActioninstances might return an error. (51074735)
When creating a Mac Catalyst app from your iPad app, Xcode automatically generates a unique Mac bundle identifier. If you have an existing Mac bundle identifier you’d prefer to use, you can do so by using manual signing in Xcode. (51076014)
Follow these steps to configure your project, AppID, and provisioning profile:
Sign in to Apple Developer, then select Certificates, Identifiers, and Profiles.
In the Identifiers section, select your iOS app identifier to edit.
Check the Mac Catalyst capability to enable it, then click the Configure button.
Choose Use an existing macOS AppID and select the identifier you'd like to use from the popup menu. Click the Save button to finish editing your AppID.
In the Profiles section, click the + button to create a new profile, select ‘macOS App Development’, and click Continue.
Select your iOS AppID from the popup, click Continue, and complete the rest of the profile creation flow. When finished, click the Download button.
In Xcode, select your project to view the Project Editor and select your app’s target. Then select the Build Settings tab.
Set the Derive Mac Catalyst Product Bundle Identifier setting to No.
Expand the Product Bundle Identifier build setting to view its configurations. Next to the Debug configuration, click the + button to add a conditional value.
For the build setting condition, select Any macOS from the popup menu. Edit the value of the conditional build setting to match the macOS bundle identifier you want to use. Repeat this step for all configurations in your project.
In the Signing & Capabilities tab, uncheck Automatically manage signing.
For your macOS app, select Import Profile from the Provisioning Profile popup and then select the profile you downloaded earlier.
Apps no longer launch in the foreground without user input if the app uses APIs that might result in a background launch. (51287556)
default()function no longer returns the nonextended color range renderer format by default. (51303954)
You can now import AppKit and UIKit modules in the same compilation unit. (48094910)
The completion handler is no longer invoked with an error when donating interactions using the
INInteractionclass on macOS. (48371526)
productsmethod from StoreKit currently returns with didFailWithError and products aren’t loaded. (51028870)
Request(_: did Receive:)
MTKViewobjects might render correctly. (51084042)
If your Mac contains both macOS Mojave 10.14 and macOS 10.15 volumes, you might experience issues searching in Mail. (46611310)
Workaround: While running macOS Mojave 10.14, open Terminal and execute the following command:
Reboot into macOS 10.15, open Terminal and execute the following command:
Reboot into macOS Mojave 10.14, open Terminal and execute the following command:
Depending on the size of your Mail database, it might take many hours to reindex all content.
Navigating using the back button might produce unexpected results. (51248128)
You might be unable to scroll content on shelves. (51248128)
Artwork changes might not immediately appear; playlists will be added in an upcoming beta. (51201715)
Music might not remember the previously selected tab when it’s relaunched. (50922604)
Music launches at the expected speed. (51207753)
You can log into the store regardless of whether you're logging in from the country in which you’re currently located. (51105585)
NWEthernetAPI doesn’t currently support VLAN interfaces.
NEPacketwill see both tagged and untagged frames arriving on physical interfaces. Depending on the Ethernet driver, VLAN tags might be processed by hardware and thus stripped off the Ethernet frames thus
NEPacketwon’t see the VLAN tag. (51275655)
An active Network Extension content filter configuration no longer interrupts the boot process indefinitely following a kernel panic. (50965627)
Support for FTP and File URL schemes for Proxy Automatic Configuration (PAC) is removed. HTTP and HTTPS are the only supported URL schemes for PAC. This affects all PAC configurations including but not limited to configurations set using Settings, System Preferences, profiles, URLSession APIs such as
Execute Proxy Auto Configuration URL(_: _: _: _:)
The Network Kernel Extension API is now deprecated. (49284108)
NetBIOS is disabled in macOS 10.15 to speed up mounting, browsing, and connecting to SMB shares. Some older printers and file servers may require NetBIOS to connect. (51119111)
To enable NetBIOS, you can create or edit the
/etc/nsmbfile. If your system doesn't already have an
/etc/nsmbfile, use the following Terminal commands while logged in as an Administrator:
To disable NetBIOS, you can safely delete the
To improve the Photos upgrade experience, Photos is testing database upgrades using a clone of the Photo Library. This clone doesn’t include the content of each photo, but does include faces metadata and a thumbnail image of each person in your library. It also contains metadata such as the asset name and the geographic location of the photo. It is created at
~/Pictures/mac, and you can manually remove this backup at any time. The clone will be removed automatically before the final release of macOS 10.15. (51033690)
OS 10 .15 Pre-Upgrade Backup
The sidebar might render unexpectedly until quitting and relaunching the app. (51340728)
Deleting podcasts using About This Mac > Storage > Manage doesn’t update what’s shown in the Podcasts app until it’s relaunched. (50354510)
Setting “Automatically Download Episodes” to “Never” might not take effect. (50960777)
Manually checking for feed updates when Option-clicking the Podcasts app in the dock isn’t currently available. (50958585)
Workaround: Quit and relaunch the app.
If Podcasts is placed in Full Screen mode, some UI elements might be obscured by the toolbar. (47125303)
Writing a review behaves as expected. (46173722)
Browse and Top Charts consistently display content from the expected country. (51681853)
A migration is no longer triggered even if there’s no content to migrate the first time you launch Podcasts. (51145044)
Apps that previously asked for access to services in the System Preferences > Security & Privacy > Privacy pane might ask for approval again after updating to macOS Catalina beta 4. (51312574)
Starting in macOS 10.15, the Quartz Composer framework is deprecated and remains present for compatibility purposes. Transition to frameworks such as Core Image, SceneKit, or Metal. (50911608)
If the Mac you’re screen sharing with is running macOS 10.15 beta, you can now drag and drop onto the screen share. (50791710)
Users can click ‘One more minute’ multiple times per day instead of only once each time they reach a limit for that app. (48773803)
Screen Time > Content & Privacy > Content > Web Content > Allowed Websites Only isn’t currently enforced in macOS 10.15 beta. (50462899)
Scripting Language Runtimes
Scripting language runtimes such as Python, Ruby, and Perl are included in macOS for compatibility with legacy software. Future versions of macOS won’t include scripting language runtimes by default, and might require you to install additional packages. If your software depends on scripting languages, it’s recommended that you bundle the runtime within the app. (49764202)
Use of Python 2.7 isn’t recommended as this version is included in macOS for compatibility with legacy software. Future versions of macOS won’t include Python 2.7. Instead, it’s recommended that you run
python3from within Terminal. (51097165)
.dmgfiles signed before June 1, 2019 using a Developer ID might incorrectly display an error message. All
.dmgfiles signed using a Developer ID after June 1, 2019 must be notarized. For more information about notarization, see Notarizing Your App Before Distribution. (52234399)
Workaround: Control-click the .dmg file in Finder and choose Open.
Mail messages might not display previews. (35678035)
Drives formatted using exFAT and FAT are searchable using Spotlight. (52271781)
Environmentstructure has four new properties for reading accessibility values from the environment:
Differentiate Without Color
Bindableprotocol’s requirement is now
willinstead of didChange, and should now be sent before the object changes rather than after it changes. This change allows for improved coalescing of change notifications. (51580731)
Rangeprotocol is extended to include a
remove(atmethod and the
Mutableprotocol is extended to include a
move(frommethod. Each new method takes
Offsets: to Offset:)
Indexinstances that you use with the onMove(perform:) and onDelete(perform:) modifiers on
Added improved presentation modifiers:
Presented: on Dismiss: content:)
Sheet(is Presented: content:)
alert(is— along with
isin the environment — replace the existing
Updated the APIs for creating animations. The
basicanimations are now named after the curve type — such as
ease. The interpolation-based
spring(mass:animation is now
stiffness: damping: initial Velocity:)
Spring(mass: stiffness: damping: initial Velocity:)
Spring(stiffness: damping Fraction: blend Duration: timestep: idle Threshold:)
damping Fraction: blend Duration:)
interactive, depending on whether or not the animation is driven interactively. (50280375)
Spring(response: damping Fraction: blend Duration:)
You can style a
Navigationusing two new style properties:
double. By default, navigation views on iPhone and Apple TV visually reflect a navigation stack, while on iPad and Mac, a split-view styled navigation view displays. (51636729)
When using the
doublestyle, you can provide two views when creating a navigation view — the first is the master and the second is the detail. For example:
Using Xcode 11 beta 3 with macOS Catalina beta 4 prevents previews from working. Update to Xcode 11 beta 4 to use previews. (52082331)
relativemodifiers are deprecated. Use other modifiers like
Width: ideal Width: max Width: min Height: ideal Height: max Height: alignment:)
Approving system extensions using Mobile Device Management is now available. (50553712)
Upgrading system extension versions is now supported. (48943883)
Location-based naming is now available. (48048663, 50743045)
Voice Memos synced from iCloud might not finish downloading. (49512619)
The File menu might be unexpectedly empty. (51475831)
Swift interfaces for several new
URLSessionAPIs are now available. (50517967)
Command line tool support for Subversion — including
git-svn, and related commands — is no longer provided by Xcode. If you need Subversion or related command line tools, install the Command Line Tools package by running
xcode-select --install. (50266910)