AppKit macOS 10.14 to 10.15 API Differences

NSApplication.h
NSAttributedString.h
NSButtonCell.h
AvailabilityDeprecation Message
FromAvailablenone
ToDeprecatedThe keyEquivalentFont property is no longer used. It always returns the NSButtonCell's font, and setting it has no effect.

AvailabilityDeprecation Message
FromAvailablenone
ToDeprecatedThe keyEquivalentFont property is no longer used. Setting it has no effect.

NSButtonTouchBarItem.h
NSClipView.h
AvailabilityDeprecation Message
FromAvailablenone
ToDeprecatedNSClipView will always minimize the area of the document view that is invalidated. To force invalidation of the document view, use -[NSView setNeedsDisplayInRect:].

NSCollectionView.h
AvailabilityDeprecation Message
FromAvailablenone
ToDeprecatedUse -collectionView:pasteboardWriterForItemAtIndexPath: instead

AvailabilityDeprecation Message
FromAvailablenone
ToDeprecatedUse -collectionView:pasteboardWriterForItemAtIndexPath: instead

NSCollectionViewCompositionalLayout.h
NSColor.h
NSColorSampler.h
NSDiffableDataSource.h
NSEvent.h
NSFont.h
NSFontDescriptor.h
NSImage.h
AvailabilityDeprecation Message
FromAvailablenone
ToDeprecatedUse -[NSWorkspace iconForFile:], -[NSWorkspace iconForFiles:], -[NSWorkspace iconForFileType:], or +[NSImage imageNamed:] instead.

NSKeyValueBinding.h
AvailabilityReplacement
FromAvailablenone
ToDeprecated+[NSBindingSelectionMarker setDefaultPlaceholder:forMarker:withBinding:onClass:]

AvailabilityReplacement
FromAvailablenone
ToDeprecated+[NSBindingSelectionMarker defaultPlaceholder:forMarker:withBinding:onClass:]

NSLayoutAnchor.h
Added #def NSLAYOUTANCHOR_EXTERN
NSLayoutConstraint.h
Added #def NSLAYOUTCONSTRAINT_EXTERN
Declaration
From+ (NSArray<NSLayoutConstraint *> *)constraintsWithVisualFormat:(NSString *)format options:(NSLayoutFormatOptions)opts metrics:(NSDictionary<NSString *,NSNumber *> *)metrics views:(NSDictionary<NSString *,id> *)views
To+ (NSArray<NSLayoutConstraint *> *)constraintsWithVisualFormat:(NSString *)format options:(NSLayoutFormatOptions)opts metrics:(NSDictionary<NSString *,id> *)metrics views:(NSDictionary<NSString *,id> *)views

Declaration
From@property (readonly, weak) id firstItem
To@property (readonly, assign) id firstItem

Declaration
From@property (readonly, weak) id secondItem
To@property (readonly, assign) id secondItem

NSLayoutManager.h
Protocols
FromNSCoding, NSGlyphStorage
ToNSGlyphStorage, NSSecureCoding

AvailabilityReplacement
FromAvailablenone
ToDeprecatedshowCGGlyphs:positions:count:font:textMatrix:attributes:inContext:

AvailabilityDeprecation Message
FromAvailablenone
ToDeprecatedPlease use usesDefaultHyphenation or -[NSParagraphStyle hyphenationFactor] instead.

NSMenuToolbarItem.h
NSMovie.h
Added -[NSMovie initWithCoder:]
Added -[NSMovie init]
Modified -[NSMovie initWithMovie:]
DeclarationAvailabilityDeprecation Message
From- (id)initWithMovie:(QTMovie *)movieAvailablenone
To- (instancetype)initWithMovie:(QTMovie *)movieDeprecatedAs of macOS 10.15 this method always returns nil.

Modified -[NSMovie QTMovie]
AvailabilityDeprecation Message
FromAvailablenone
ToDeprecatedAs of macOS 10.15 this method always returns nil.

NSOutlineView.h
AvailabilityDeprecation Message
FromAvailablenone
ToDeprecatedUse -outlineView:pasteboardWriterForRow: instead

NSPickerTouchBarItem.h
NSResponder.h
NSScreen.h
Removed NSScreenAuxiliaryOpaque
NSSharingServicePickerToolbarItem.h
NSSharingServicePickerTouchBarItem.h
Declaration
From@property (retain) NSImage *buttonImage
To@property (strong) NSImage *buttonImage

NSSliderTouchBarItem.h
NSSplitView.h
AvailabilityDeprecation Message
FromAvailablenone
ToDeprecatedNSSplitView no longer supports collapsing sections via double-click. This delegate method is never called.

NSSplitViewController.h
AvailabilityDeprecation Message
FromAvailablenone
ToDeprecatedNSSplitView no longer supports collapsing sections via double-click. This delegate method is never called, and NSSplitViewController's implementation always returns NO.

NSStepperTouchBarItem.h
NSStoryboard.h
NSSwitch.h
Added NSSwitch
NSTableView.h
AvailabilityDeprecation Message
FromAvailablenone
ToDeprecatedUse -tableView:pasteboardWriterForRow: instead

NSTextAlternatives.h
Protocols
Fromnone
ToNSSecureCoding

NSTextAttachment.h
Protocols
FromNSCoding, NSTextAttachmentContainer
ToNSSecureCoding, NSTextAttachmentContainer

NSTextCheckingClient.h
NSTextCheckingController.h
NSTextContainer.h
Protocols
FromNSCoding, NSTextLayoutOrientationProvider
ToNSSecureCoding, NSTextLayoutOrientationProvider

NSTextList.h
Modified NSTextList
Protocols
FromNSCoding, NSCopying
ToNSCopying, NSSecureCoding

NSTextStorage.h
Modified NSTextStorage
Protocols
Fromnone
ToNSSecureCoding

NSTextTable.h
Modified NSTextBlock
Protocols
FromNSCoding, NSCopying
ToNSCopying, NSSecureCoding

NSTextView.h
NSToolbarItem.h
AvailabilityDeprecation Message
FromAvailablenone
ToDeprecatedThis item is no longer recommended and will be ignored on 10.7 and later.

AvailabilityDeprecation Message
FromAvailablenone
ToDeprecatedThis item is no longer recommended and will be ignored on 10.7 and later.

NSToolbarItemGroup.h
NSTouchBar.h
NSWorkspace.h
AvailabilityDeprecation Message
FromAvailablenone
ToDeprecatedUse -[NSWorkspaceOpenConfiguration setForPrinting:YES] instead.

AvailabilityDeprecation Message
FromAvailablenone
ToDeprecatedUse -[NSWorkspaceOpenConfiguration setPromptsUserIfNeeded:YES] instead.

AvailabilityDeprecation Message
FromAvailablenone
ToDeprecatedThis option does nothing.

AvailabilityDeprecation Message
FromAvailablenone
ToDeprecatedUse -[NSWorkspaceOpenConfiguration setAddsToRecentItems:YES] instead.

AvailabilityDeprecation Message
FromAvailablenone
ToDeprecatedUse -[NSWorkspaceOpenConfiguration setActivates:NO] instead.

AvailabilityDeprecation Message
FromAvailablenone
ToDeprecatedWhen using NSWorkspaceOpenConfiguration, all launches are asynchronous.

AvailabilityDeprecation Message
FromAvailablenone
ToDeprecatedUse -[NSWorkspaceOpenConfiguration setCreatesNewApplicationInstance:YES] instead.

AvailabilityDeprecation Message
FromAvailablenone
ToDeprecatedUse -[NSWorkspaceOpenConfiguration setHides:YES] instead.

AvailabilityDeprecation Message
FromAvailablenone
ToDeprecatedUse -[NSWorkspaceOpenConfiguration setHidesOthers:YES] instead.

AvailabilityDeprecation Message
FromAvailablenone
ToDeprecatedUse NSWorkspaceOpenConfiguration instead.

AvailabilityDeprecation Message
FromAvailablenone
ToDeprecatedUse NSWorkspaceOpenConfiguration instead.

AvailabilityDeprecation Message
FromAvailablenone
ToDeprecatedUse -[NSWorkspaceOpenConfiguration setAppleEvent:] instead.

AvailabilityDeprecation Message
FromAvailablenone
ToDeprecatedUse -[NSWorkspaceOpenConfiguration setArguments:] instead.

AvailabilityDeprecation Message
FromAvailablenone
ToDeprecatedUse -[NSWorkspaceOpenConfiguration setEnvironment:] instead.

AvailabilityDeprecation Message
FromAvailablenone
ToDeprecatedDo not specify an architecutre. When unspecified, the architecture for a new application instance will be determined based on the available architectures in its executable.

AvailabilityDeprecation Message
FromAvailablenone
ToDeprecatedUse -[NSWorkspace openURL:] instead.

AvailabilityDeprecation Message
FromAvailablenone
ToDeprecatedUse -[NSWorkspace openURLs:withApplicationURL:configuration:completionHandler:] instead.

AvailabilityDeprecation Message
FromAvailablenone
ToDeprecatedUse -[NSWorkspace openURLs:withApplicationURL:configuration:completionHandler:] instead.

AvailabilityDeprecation Message
FromAvailablenone
ToDeprecatedUse -[NSWorkspace openApplicationAtURL:configuration:completionHandler:] instead.

AvailabilityDeprecation Message
FromAvailablenone
ToDeprecatedUse -[NSWorkspace openApplicationAtURL:configuration:completionHandler:] instead.

AvailabilityDeprecation Message
FromAvailablenone
ToDeprecatedUse -[NSWorkspace openURL:configuration:completionHandler:] instead.

AvailabilityDeprecation Message
FromAvailablenone
ToDeprecatedUse -[NSWorkspace openURLs:withApplicationURL:configuration:completionHandler:] instead.

AvailabilityDeprecation Message
FromAvailablenone
ToDeprecatedUse -[NSWorkspace openApplicationAtURL:configuration:completionHandler:] instead.

AvailabilityDeprecation Message
FromAvailablenone
ToDeprecatedUse -[NSWorkspace URLForApplicationWithBundleIdentifier:] instead.

AvailabilityDeprecation Message
FromAvailablenone
ToDeprecatedUse -[NSWorkspace URLForApplicationWithBundleIdentifier:] instead.

AvailabilityDeprecation Message
FromAvailablenone
ToDeprecatedUse -[NSWorkspace openApplicationAtURL:configuration:completionHandler:] instead.

AvailabilityDeprecation Message
FromAvailablenone
ToDeprecatedUse -[NSWorkspace openURLs:withApplicationURL:configuration:completionHandler:] instead.