AppKit macOS 10.13 to 10.14 API Differences

AppKitDefines.h
Added #def APPKIT_IVAR
AppKitErrors.h
NSAccessibilityConstants.h
Declaration
Fromvoid NSAccessibilityPostNotificationWithUserInfo(id _Nonnull element, NSAccessibilityNotificationName _Nonnull notification, NSDictionary<NSAccessibilityNotificationUserInfoKey,id> * _Nonnull userInfo)
Tovoid NSAccessibilityPostNotificationWithUserInfo(id _Nonnull element, NSAccessibilityNotificationName _Nonnull notification, NSDictionary<NSAccessibilityNotificationUserInfoKey,id> * _Nullable userInfo)

NSAccessibilityCustomAction.h
Declaration
From- (nonnull instancetype)initWithName:(nonnull NSString *)name handler:(nullable BOOL (^)())handler
To- (nonnull instancetype)initWithName:(nonnull NSString *)name handler:(nullable BOOL (^)(void))handler

Declaration
From@property (copy, nullable) BOOL (^)() handler
To@property (copy, nullable) BOOL (^)(void) handler

NSAccessibilityProtocols.h
AvailabilityReplacement
FromAvailablenone
ToDeprecatedaccessibilityHeader

NSAnimationContext.h
NSAppearance.h
Modified NSAppearance
Protocols
FromNSCoding
ToNSSecureCoding

NSApplication.h
Modified NSApplication
Protocols
FromNSAccessibility, NSAccessibilityElement, NSUserInterfaceValidations
ToNSAccessibility, NSAccessibilityElement, NSAppearanceCustomization, NSMenuItemValidation, NSUserInterfaceValidations

Declaration
From- (BOOL)application:(nonnull NSApplication *)application continueUserActivity:(nonnull NSUserActivity *)userActivity restorationHandler:(nonnull void (^)(NSArray * _Nonnull))restorationHandler
To- (BOOL)application:(nonnull NSApplication *)application continueUserActivity:(nonnull NSUserActivity *)userActivity restorationHandler:(nonnull void (^)(NSArray<id<NSUserActivityRestoring>> * _Nonnull))restorationHandler

NSApplicationScripting.h
AvailabilityDeprecation Message
FromAvailablenone
ToDeprecatedThis is now an optional method of the NSApplicationDelegate protocol.

NSAttributedString.h
Removed NSUnderlinePatternSolid
Removed NSUnderlinePatternDot
Removed NSUnderlinePatternDash
Removed NSUnderlinePatternDashDot
Removed NSUnderlinePatternDashDotDot
Removed NSUnderlineByWord
Added NSUnderlineStylePatternSolid
NSBezierPath.h
Removed NSButtLineCapStyle
Removed NSRoundLineCapStyle
Removed NSSquareLineCapStyle
Removed NSMiterLineJoinStyle
Removed NSRoundLineJoinStyle
Removed NSBevelLineJoinStyle
Removed NSNonZeroWindingRule
Removed NSEvenOddWindingRule
Removed NSMoveToBezierPathElement
Removed NSLineToBezierPathElement
Removed NSCurveToBezierPathElement
Removed NSClosePathBezierPathElement
Modified NSBezierPath
Protocols
FromNSCoding, NSCopying
ToNSCopying, NSSecureCoding

NSBitmapImageRep.h
AvailabilityDeprecation Message
FromAvailablenone
ToDeprecatedUse -[NSView cacheDisplayInRect:toBitmapImageRep:] to snapshot a view.

AvailabilityReplacement
FromAvailablenone
ToDeprecatedNSBitmapImageFileTypeTIFF

Modified NSBMPFileType
AvailabilityReplacement
FromAvailablenone
ToDeprecatedNSBitmapImageFileTypeBMP

Modified NSGIFFileType
AvailabilityReplacement
FromAvailablenone
ToDeprecatedNSBitmapImageFileTypeGIF

AvailabilityReplacement
FromAvailablenone
ToDeprecatedNSBitmapImageFileTypeJPEG

Modified NSPNGFileType
AvailabilityReplacement
FromAvailablenone
ToDeprecatedNSBitmapImageFileTypePNG

AvailabilityReplacement
FromAvailablenone
ToDeprecatedNSBitmapImageFileTypeJPEG2000

AvailabilityReplacement
FromAvailablenone
ToDeprecatedNSBitmapFormatAlphaFirst

AvailabilityReplacement
FromAvailablenone
ToDeprecatedNSBitmapFormatAlphaNonpremultiplied

AvailabilityReplacement
FromAvailablenone
ToDeprecatedNSBitmapFormatFloatingPointSamples

AvailabilityReplacement
FromAvailablenone
ToDeprecatedNSBitmapFormatSixteenBitLittleEndian

AvailabilityReplacement
FromAvailablenone
ToDeprecatedNSBitmapFormatThirtyTwoBitLittleEndian

AvailabilityReplacement
FromAvailablenone
ToDeprecatedNSBitmapFormatSixteenBitBigEndian

AvailabilityReplacement
FromAvailablenone
ToDeprecatedNSBitmapFormatThirtyTwoBitBigEndian

NSBox.h
Removed NSBoxSecondary
Removed NSBoxOldStyle
AvailabilityDeprecation Message
FromAvailablenone
ToDeprecatedborderType is only applicable to NSBoxOldStyle, which is deprecated. To replace a borderType of NSNoBorder, use the `transparent` property.

NSButton.h
NSButtonCell.h
AvailabilityReplacement
FromAvailablenone
ToDeprecatedNSButtonTypeMomentaryLight

AvailabilityReplacement
FromAvailablenone
ToDeprecatedNSButtonTypePushOnPushOff

AvailabilityReplacement
FromAvailablenone
ToDeprecatedNSButtonTypeToggle

AvailabilityReplacement
FromAvailablenone
ToDeprecatedNSButtonTypeSwitch

Modified NSRadioButton
AvailabilityReplacement
FromAvailablenone
ToDeprecatedNSButtonTypeRadio

AvailabilityReplacement
FromAvailablenone
ToDeprecatedNSButtonTypeMomentaryChange

Modified NSOnOffButton
AvailabilityReplacement
FromAvailablenone
ToDeprecatedNSButtonTypeOnOff

AvailabilityReplacement
FromAvailablenone
ToDeprecatedNSButtonTypeMomentaryPushIn

AvailabilityReplacement
FromAvailablenone
ToDeprecatedNSButtonTypeAccelerator

AvailabilityReplacement
FromAvailablenone
ToDeprecatedNSButtonTypeMultiLevelAccelerator

AvailabilityReplacement
FromAvailablenone
ToDeprecatedNSBezelStyleRounded

AvailabilityReplacement
FromAvailablenone
ToDeprecatedNSBezelStyleRegularSquare

AvailabilityReplacement
FromAvailablenone
ToDeprecatedNSBezelStyleDisclosure

AvailabilityReplacement
FromAvailablenone
ToDeprecatedNSBezelStyleShadowlessSquare

AvailabilityReplacement
FromAvailablenone
ToDeprecatedNSBezelStyleCircular

AvailabilityReplacement
FromAvailablenone
ToDeprecatedNSBezelStyleTexturedSquare

AvailabilityReplacement
FromAvailablenone
ToDeprecatedNSBezelStyleHelpButton

AvailabilityReplacement
FromAvailablenone
ToDeprecatedNSBezelStyleSmallSquare

AvailabilityReplacement
FromAvailablenone
ToDeprecatedNSBezelStyleTexturedRounded

AvailabilityReplacement
FromAvailablenone
ToDeprecatedNSBezelStyleRoundRect

AvailabilityReplacement
FromAvailablenone
ToDeprecatedNSBezelStyleRecessed

AvailabilityReplacement
FromAvailablenone
ToDeprecatedNSBezelStyleRoundedDisclosure

AvailabilityReplacement
FromAvailablenone
ToDeprecatedNSBezelStyleInline

NSCell.h
Removed NSBackgroundStyleLight
Removed NSBackgroundStyleDark
AvailabilityReplacement
FromAvailablenone
ToDeprecatedNSControlStateValue

Modified NSMixedState
AvailabilityReplacement
FromAvailablenone
ToDeprecatedNSControlStateValueMixed

Modified NSOffState
AvailabilityReplacement
FromAvailablenone
ToDeprecatedNSControlStateValueOff

Modified NSOnState
AvailabilityReplacement
FromAvailablenone
ToDeprecatedNSControlStateValueOn

AvailabilityDeprecation Message
FromAvailablenone
ToDeprecatedThe controlTint property is not respected on 10.14 and later. For custom cells, use +[NSColor controlAccentColor] to respect the user's preferred accent color when drawing.

AvailabilityDeprecation Message
FromAvailablenone
ToDeprecatedChanges to the accent color can be manually observed by implementing -viewDidChangeEffectiveAppearance in a NSView subclass, or by Key-Value Observing the -effectiveAppearance property on NSApplication. Views are automatically redisplayed when the accent color changes.

NSCollectionView.h
AvailabilityDeprecation Message
FromAvailablenone
ToDeprecatedUse -[NSCollectionViewDataSource collectionView:itemForRepresentedObjectAtIndexPath:] instead

AvailabilityDeprecation Message
FromAvailablenone
ToDeprecatedUse -registerNib:forItemWithIdentifier: or -registerClass:forItemWithIdentifier: instead.

AvailabilityDeprecation Message
FromAvailablenone
ToDeprecatedUse NSCollectionViewGridLayout as the receiver's collectionViewLayout, setting its maximumNumberOfRows instead

AvailabilityDeprecation Message
FromAvailablenone
ToDeprecatedUse NSCollectionViewGridLayout as the receiver's collectionViewLayout, setting its maximumNumberOfColumns instead

AvailabilityDeprecation Message
FromAvailablenone
ToDeprecatedUse NSCollectionViewGridLayout as the receiver's collectionViewLayout, setting its minimumItemSize instead

AvailabilityDeprecation Message
FromAvailablenone
ToDeprecatedUse NSCollectionViewGridLayout as the receiver's collectionViewLayout, setting its maximumItemSize instead

NSColor.h
AvailabilityDeprecation Message
FromAvailablenone
ToDeprecatedNSControlTint does not describe the full range of available control accent colors. Use +[NSColor controlAccentColor] instead.

AvailabilityDeprecation Message
FromAvailablenone
ToDeprecatedUse a color that matches the semantics being used, such as `separatorColor`

AvailabilityDeprecation Message
FromAvailablenone
ToDeprecatedUse a color that matches the semantics being used, such as `separatorColor`

AvailabilityDeprecation Message
FromAvailablenone
ToDeprecatedUse a color that matches the semantics being used, such as `separatorColor`

AvailabilityDeprecation Message
FromAvailablenone
ToDeprecatedUse a color that matches the semantics being used, such as `separatorColor`

AvailabilityDeprecation Message
FromAvailablenone
ToDeprecatedUse NSScroller instead

AvailabilityDeprecation Message
FromAvailablenone
ToDeprecatedUse NSScroller instead

AvailabilityDeprecation Message
FromAvailablenone
ToDeprecatedUse NSScroller instead

AvailabilityDeprecation Message
FromAvailablenone
ToDeprecatedUse NSVisualEffectMaterialTitlebar

AvailabilityDeprecation Message
FromAvailablenone
ToDeprecatedUse NSVisualEffectMaterialSelection

AvailabilityDeprecation Message
FromAvailablenone
ToDeprecatedUse NSVisualEffectMaterialHeaderView

AvailabilityReplacement
FromAvailablenone
ToDeprecatedunemphasizedSelectedContentBackgroundColor

AvailabilityReplacement
FromAvailablenone
ToDeprecatedselectedContentBackgroundColor

AvailabilityReplacement
FromAvailablenone
ToDeprecatedalternatingContentBackgroundColors

AvailabilityDeprecation Message
FromAvailablenone
ToDeprecatedUse -type and NSColorType instead

AvailabilityDeprecation Message
FromAvailablenone
ToDeprecatedUse -colorUsingType: or -colorUsingColorSpace: instead

AvailabilityDeprecation Message
FromAvailablenone
ToDeprecatedUse -colorUsingType: or -colorUsingColorSpace: instead

NSColorList.h
AvailabilityDeprecation Message
FromAvailablenone
ToDeprecatedUse -writeToURL:error: instead

NSColorPanel.h
AvailabilityDeprecation Message
FromAvailablenone
ToDeprecatedThis is now a method of the NSColorChanging protocol.

AvailabilityReplacement
FromAvailablenone
ToDeprecatedNSColorPanelModeNone

AvailabilityReplacement
FromAvailablenone
ToDeprecatedNSColorPanelModeGray

AvailabilityReplacement
FromAvailablenone
ToDeprecatedNSColorPanelModeRGB

AvailabilityReplacement
FromAvailablenone
ToDeprecatedNSColorPanelModeCMYK

AvailabilityReplacement
FromAvailablenone
ToDeprecatedNSColorPanelModeHSB

AvailabilityReplacement
FromAvailablenone
ToDeprecatedNSColorPanelModeCustomPalette

AvailabilityReplacement
FromAvailablenone
ToDeprecatedNSColorPanelModeColorList

AvailabilityReplacement
FromAvailablenone
ToDeprecatedNSColorPanelModeWheel

AvailabilityReplacement
FromAvailablenone
ToDeprecatedNSColorPanelModeCrayon

NSColorSpace.h
AvailabilityReplacement
FromAvailablenone
ToDeprecatedNSColorSpaceModelUnknown

AvailabilityReplacement
FromAvailablenone
ToDeprecatedNSColorSpaceModelGray

AvailabilityReplacement
FromAvailablenone
ToDeprecatedNSColorSpaceModelRGB

AvailabilityReplacement
FromAvailablenone
ToDeprecatedNSColorSpaceModelCMYK

AvailabilityReplacement
FromAvailablenone
ToDeprecatedNSColorSpaceModelLAB

AvailabilityReplacement
FromAvailablenone
ToDeprecatedNSColorSpaceModelDeviceN

AvailabilityReplacement
FromAvailablenone
ToDeprecatedNSColorSpaceModelIndexed

AvailabilityReplacement
FromAvailablenone
ToDeprecatedNSColorSpaceModelPatterned

NSControl.h
AvailabilityDeprecation Message
FromAvailablenone
ToDeprecatedThis is now an optional method of the NSControlTextEditingDelegate protocol.

AvailabilityDeprecation Message
FromAvailablenone
ToDeprecatedThis is now an optional method of the NSControlTextEditingDelegate protocol.

AvailabilityDeprecation Message
FromAvailablenone
ToDeprecatedThis is now an optional method of the NSControlTextEditingDelegate protocol.

NSController.h
Modified NSController
Protocols
FromNSCoding
ToNSCoding, NSEditor, NSEditorRegistration

Declaration
From- (void)objectDidBeginEditing:(nonnull id)editor
To- (void)objectDidBeginEditing:(nonnull id<NSEditor>)editor

Declaration
From- (void)objectDidEndEditing:(nonnull id)editor
To- (void)objectDidEndEditing:(nonnull id<NSEditor>)editor

NSDatePickerCell.h
Removed NSTextFieldAndStepperDatePickerStyle
Removed NSClockAndCalendarDatePickerStyle
Removed NSTextFieldDatePickerStyle
Removed NSSingleDateMode
Removed NSRangeDateMode
Removed NSHourMinuteDatePickerElementFlag
Removed NSHourMinuteSecondDatePickerElementFlag
Removed NSTimeZoneDatePickerElementFlag
Removed NSYearMonthDatePickerElementFlag
Removed NSYearMonthDayDatePickerElementFlag
Removed NSEraDatePickerElementFlag
NSDocument.h
Modified NSDocument
Protocols
FromNSFilePresenter, NSUserInterfaceValidations
ToNSEditorRegistration, NSFilePresenter, NSMenuItemValidation, NSUserActivityRestoring, NSUserInterfaceValidations

NSDocumentController.h
Protocols
FromNSCoding, NSUserInterfaceValidations, NSWindowRestoration
ToNSCoding, NSMenuItemValidation, NSUserInterfaceValidations, NSWindowRestoration

NSDragging.h
Declaration
From- (nullable NSWindow *)draggingDestinationWindow
To@property (readonly, nullable) NSWindow *draggingDestinationWindow

Declaration
From- (NSDragOperation)draggingSourceOperationMask
To@property (readonly) NSDragOperation draggingSourceOperationMask

Declaration
From- (NSPoint)draggingLocation
To@property (readonly) NSPoint draggingLocation

Declaration
From- (NSPoint)draggedImageLocation
To@property (readonly) NSPoint draggedImageLocation

DeclarationAvailabilityDeprecation Message
From- (nullable NSImage *)draggedImageAvailablenone
To@property (readonly, nullable) NSImage *draggedImageDeprecatedUse NSDraggingItem objects instead

Declaration
From- (nonnull NSPasteboard *)draggingPasteboard
To@property (readonly, nonnull) NSPasteboard *draggingPasteboard

Declaration
From- (nullable id)draggingSource
To@property (readonly, nullable) id draggingSource

Declaration
From- (NSInteger)draggingSequenceNumber
To@property (readonly) NSInteger draggingSequenceNumber

NSFontManager.h
Modified NSFontManager
Protocols
Fromnone
ToNSMenuItemValidation

AvailabilityDeprecation Message
FromAvailablenone
ToDeprecatedThis is now an optional method of the NSFontChanging protocol.

NSFontPanel.h
AvailabilityDeprecation Message
FromAvailablenone
ToDeprecatedThis is now an optional method of the NSFontChanging protocol.

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

NSGraphics.h
Modified NSReadPixel()
AvailabilityDeprecation Message
FromAvailablenone
ToDeprecatedUse -[NSBitmapImageRep colorAtX:y:] to interrogate pixel values. If necessary, use -[NSView cacheDisplayInRect:toBitmapImageRep:] to snapshot a view hierarchy into an NSBitmapImageRep.

AvailabilityDeprecation Message
FromAvailablenone
ToDeprecatedDoesn't return anything useful since 10.0

AvailabilityDeprecation Message
FromAvailablenone
ToDeprecatedAs of 10.11 it is not generally necessary to take explicit action to achieve visual atomicity. +[NSAnimationContext runAnimationGroup:] and other similar methods can be used when a stronger than normal need for visual atomicity is required. The NSAnimationContext methods do not suffer from the same performance problems as NSDisableScreenUpdates.

AvailabilityDeprecation Message
FromAvailablenone
ToDeprecatedAs of 10.11 it is not generally necessary to take explicit action to achieve visual atomicity. +[NSAnimationContext runAnimationGroup:] and other similar methods can be used when a stronger than normal need for visual atomicity is required. The NSAnimationContext methods do not suffer from the same performance problems as NSEnableScreenUpdates.

NSImage.h
Modified NSImage
Protocols
FromNSCoding, NSCopying, NSPasteboardReading, NSPasteboardWriting, NSSecureCoding
ToNSCopying, NSPasteboardReading, NSPasteboardWriting, NSSecureCoding

Declaration
From+ (nonnull NSImage *)imageWithSize:(NSSize)size flipped:(BOOL)drawingHandlerShouldBeCalledWithFlippedContext drawingHandler:(nonnull BOOL (^)(NSRect))drawingHandler
To+ (nonnull instancetype)imageWithSize:(NSSize)size flipped:(BOOL)drawingHandlerShouldBeCalledWithFlippedContext drawingHandler:(nonnull BOOL (^)(NSRect))drawingHandler

NSImageView.h
Modified NSImageView
Protocols
FromNSAccessibilityImage
ToNSAccessibilityImage, NSMenuItemValidation

NSKeyValueBinding.h
Added NSEditor
Added NSManagedObjectContext (NSEditorAndEditorRegistrationConformance)
DeclarationAvailabilityReplacement
Fromid _Nonnull NSMultipleValuesMarkerAvailablenone
ToNSBindingSelectionMarker * _Nonnull NSMultipleValuesMarkerDeprecatedNSBindingSelectionMarker.multipleValuesSelectionMarker

DeclarationAvailabilityReplacement
Fromid _Nonnull NSNoSelectionMarkerAvailablenone
ToNSBindingSelectionMarker * _Nonnull NSNoSelectionMarkerDeprecatedNSBindingSelectionMarker.noSelectionMarker

DeclarationAvailabilityReplacement
Fromid _Nonnull NSNotApplicableMarkerAvailablenone
ToNSBindingSelectionMarker * _Nonnull NSNotApplicableMarkerDeprecatedNSBindingSelectionMarker.notApplicableSelectionMarker

Declaration
From+ (void)setDefaultPlaceholder:(nullable id)placeholder forMarker:(nullable id)marker withBinding:(nonnull NSBindingName)binding
To+ (void)setDefaultPlaceholder:(nullable id)placeholder forMarker:(nullable NSBindingSelectionMarker *)marker withBinding:(nonnull NSBindingName)binding

Declaration
From+ (nullable id)defaultPlaceholderForMarker:(nullable id)marker withBinding:(nonnull NSBindingName)binding
To+ (nullable id)defaultPlaceholderForMarker:(nullable NSBindingSelectionMarker *)marker withBinding:(nonnull NSBindingName)binding

AvailabilityDeprecation Message
FromAvailablenone
ToDeprecatedThis is now a method of the NSEditor protocol.

AvailabilityDeprecation Message
FromAvailablenone
ToDeprecatedThis is now a method of the NSEditor protocol.

AvailabilityDeprecation Message
FromAvailablenone
ToDeprecatedThis is now a method of the NSEditor protocol.

AvailabilityDeprecation Message
FromAvailablenone
ToDeprecatedThis is now a method of the NSEditor protocol.

DeclarationAvailabilityDeprecation Message
From- (void)objectDidBeginEditing:(nonnull id)editorAvailablenone
To- (void)objectDidBeginEditing:(nonnull id<NSEditor>)editorDeprecatedThis is now a method of the NSEditorRegistration protocol.

DeclarationAvailabilityDeprecation Message
From- (void)objectDidEndEditing:(nonnull id)editorAvailablenone
To- (void)objectDidEndEditing:(nonnull id<NSEditor>)editorDeprecatedThis is now a method of the NSEditorRegistration protocol.

NSLayoutConstraint.h
AvailabilityReplacement
FromAvailablenone
ToDeprecatedNSViewNoIntrinsicMetric

NSLayoutManager.h
NSLevelIndicatorCell.h
AvailabilityReplacement
FromAvailablenone
ToDeprecatedNSLevelIndicatorStyleRelevancy

AvailabilityReplacement
FromAvailablenone
ToDeprecatedNSLevelIndicatorStyleContinuousCapacity

AvailabilityReplacement
FromAvailablenone
ToDeprecatedNSLevelIndicatorStyleDiscreteCapacity

AvailabilityReplacement
FromAvailablenone
ToDeprecatedNSLevelIndicatorStyleRating

NSMatrix.h
Modified NSMatrix
Protocols
FromNSUserInterfaceValidations
ToNSUserInterfaceValidations, NSViewToolTipOwner

NSMenu.h
Declaration
From@property (readonly, copy, nonnull) NSArray<NSMenuItem *> *itemArray
To@property (copy, nonnull) NSArray<NSMenuItem *> *itemArray

AvailabilityDeprecation Message
FromAvailablenone
ToDeprecatedThis is now a method of the NSMenuItemValidation protocol.

NSMenuItem.h
NSOpenGL.h
Added #def NS_OPENGL_DEPRECATED
Added #def NS_OPENGL_ENUM_DEPRECATED
Added #def NS_OPENGL_CLASS_DEPRECATED
Availability
FromAvailable
ToDeprecated

Availability
FromAvailable
ToDeprecated

Availability
FromAvailable
ToDeprecated

Availability
FromAvailable
ToDeprecated

Availability
FromAvailable
ToDeprecated

Availability
FromAvailable
ToDeprecated

Availability
FromAvailable
ToDeprecated

Availability
FromAvailable
ToDeprecated

Availability
FromAvailable
ToDeprecated

Availability
FromAvailable
ToDeprecated

Availability
FromAvailable
ToDeprecated

Availability
FromAvailable
ToDeprecated

Availability
FromAvailable
ToDeprecated

Availability
FromAvailable
ToDeprecated

Availability
FromAvailable
ToDeprecated

Availability
FromAvailable
ToDeprecated

Availability
FromAvailable
ToDeprecated

Availability
FromAvailable
ToDeprecated

Availability
FromAvailable
ToDeprecated

Availability
FromAvailable
ToDeprecated

Availability
FromAvailable
ToDeprecated

Availability
FromAvailable
ToDeprecated

Availability
FromAvailable
ToDeprecated

Availability
FromAvailable
ToDeprecated

Availability
FromAvailable
ToDeprecated

Availability
FromAvailable
ToDeprecated

Availability
FromAvailable
ToDeprecated

Availability
FromAvailable
ToDeprecated

Availability
FromAvailable
ToDeprecated

Availability
FromAvailable
ToDeprecated

Availability
FromAvailable
ToDeprecated

Availability
FromAvailable
ToDeprecated

Availability
FromAvailable
ToDeprecated

Availability
FromAvailable
ToDeprecated

Availability
FromAvailable
ToDeprecated

Availability
FromAvailable
ToDeprecated

Availability
FromAvailable
ToDeprecated

Availability
FromAvailable
ToDeprecated

Availability
FromAvailable
ToDeprecated

AvailabilityDeprecation Message
FromAvailablenone
ToDeprecatedPlease use Metal or MetalKit.

Availability
FromAvailable
ToDeprecated

Availability
FromAvailable
ToDeprecated

Availability
FromAvailable
ToDeprecated

Availability
FromAvailable
ToDeprecated

Availability
FromAvailable
ToDeprecated

Availability
FromAvailable
ToDeprecated

Availability
FromAvailable
ToDeprecated

Availability
FromAvailable
ToDeprecated

Availability
FromAvailable
ToDeprecated

Availability
FromAvailable
ToDeprecated

Availability
FromAvailable
ToDeprecated

Availability
FromAvailable
ToDeprecated

Availability
FromAvailable
ToDeprecated

Availability
FromAvailable
ToDeprecated

Availability
FromAvailable
ToDeprecated

AvailabilityDeprecation Message
FromAvailablenone
ToDeprecatedPlease use Metal or MetalKit.

DeclarationAvailabilityDeprecation Message
From@property (weak, nullable) NSView *viewAvailablenone
To- (void)setView:(nullable NSView *)viewDeprecatedUse NSOpenGLView to provide OpenGL content in a Cocoa app.

AvailabilityReplacement
FromAvailablenone
ToDeprecatedNSOpenGLContextParameterSwapInterval

AvailabilityReplacement
FromAvailablenone
ToDeprecatedNSOpenGLContextParameterSurfaceOrder

AvailabilityReplacement
FromAvailablenone
ToDeprecatedNSOpenGLContextParameterSurfaceOpacity

AvailabilityReplacement
FromAvailablenone
ToDeprecatedNSOpenGLContextParameterSurfaceBackingSize

AvailabilityReplacement
FromAvailablenone
ToDeprecatedNSOpenGLContextParameterReclaimResources

AvailabilityReplacement
FromAvailablenone
ToDeprecatedNSOpenGLContextParameterCurrentRendererID

AvailabilityReplacement
FromAvailablenone
ToDeprecatedNSOpenGLContextParameterGPUVertexProcessing

AvailabilityReplacement
FromAvailablenone
ToDeprecatedNSOpenGLContextParameterGPUFragmentProcessing

AvailabilityReplacement
FromAvailablenone
ToDeprecatedNSOpenGLContextParameterHasDrawable

AvailabilityReplacement
FromAvailablenone
ToDeprecatedNSOpenGLContextParameterMPSwapsInFlight

AvailabilityReplacement
FromAvailablenone
ToDeprecatedNSOpenGLContextParameterSwapRectangle

AvailabilityReplacement
FromAvailablenone
ToDeprecatedNSOpenGLContextParameterSwapRectangleEnable

AvailabilityReplacement
FromAvailablenone
ToDeprecatedNSOpenGLContextParameterRasterizationEnable

AvailabilityReplacement
FromAvailablenone
ToDeprecatedNSOpenGLContextParameterStateValidation

AvailabilityReplacement
FromAvailablenone
ToDeprecatedNSOpenGLContextParameterSurfaceSurfaceVolatile

NSOpenGLLayer.h
Modified NSOpenGLLayer
AvailabilityDeprecation Message
FromAvailablenone
ToDeprecatedPlease use CAMetalLayer instead.

NSOpenGLView.h
Modified NSOpenGLView
AvailabilityDeprecation Message
FromAvailablenone
ToDeprecatedPlease use MTKView instead.

Availability
FromAvailable
ToDeprecated

Availability
FromAvailable
ToDeprecated

NSPasteboard.h
AvailabilityDeprecation Message
FromAvailablenone
ToDeprecatedThis is now a method of the NSPasteboardTypeOwner protocol.

AvailabilityDeprecation Message
FromAvailablenone
ToDeprecatedThis is now an optional method of the NSPasteboardTypeOwner protocol.

AvailabilityReplacement
FromAvailablenone
ToDeprecatedNSPasteboardTypeString

AvailabilityDeprecation Message
FromAvailablenone
ToDeprecatedCreate multiple pasteboard items with NSPasteboardTypeFileURL or kUTTypeFileURL instead

AvailabilityReplacement
FromAvailablenone
ToDeprecatedNSPasteboardTypeTIFF

AvailabilityReplacement
FromAvailablenone
ToDeprecatedNSPasteboardTypeRTF

AvailabilityReplacement
FromAvailablenone
ToDeprecatedNSPasteboardTypeTabularText

AvailabilityReplacement
FromAvailablenone
ToDeprecatedNSPasteboardTypeFont

AvailabilityReplacement
FromAvailablenone
ToDeprecatedNSPasteboardTypeRuler

AvailabilityReplacement
FromAvailablenone
ToDeprecatedNSPasteboardTypeColor

AvailabilityReplacement
FromAvailablenone
ToDeprecatedNSPasteboardTypeRTFD

AvailabilityReplacement
FromAvailablenone
ToDeprecatedNSPasteboardTypeHTML

AvailabilityReplacement
FromAvailablenone
ToDeprecatedNSPasteboardTypeURL

AvailabilityReplacement
FromAvailablenone
ToDeprecatedNSPasteboardTypePDF

AvailabilityReplacement
FromAvailablenone
ToDeprecatedNSPasteboardTypeMultipleTextSelection

AvailabilityReplacement
FromAvailablenone
ToDeprecated@"com.adobe.encapsulated-postscript"

AvailabilityReplacement
FromAvailablenone
ToDeprecatedkUTTypeVCard

AvailabilityReplacement
FromAvailablenone
ToDeprecatedkUTTypeInkText

AvailabilityReplacement
FromAvailablenone
ToDeprecatedkPasteboardTypeFileURLPromise

AvailabilityReplacement
FromAvailablenone
ToDeprecatedNSPasteboardTypeTextFinderOptions

NSPathCell.h
Modified NSPathCell
Protocols
FromNSOpenSavePanelDelegate
ToNSMenuItemValidation, NSOpenSavePanelDelegate

NSPopUpButtonCell.h
Protocols
Fromnone
ToNSMenuItemValidation

NSPrintInfo.h
Removed NSAutoPagination
Removed NSFitPagination
Removed NSClipPagination
AvailabilityReplacement
FromAvailablenone
ToDeprecatedNSPaperOrientationPortrait

AvailabilityReplacement
FromAvailablenone
ToDeprecatedNSPaperOrientationLandscape

NSProgressIndicator.h
Availability
FromAvailable
ToDeprecated

Availability
FromAvailable
ToDeprecated

Availability
FromAvailable
ToDeprecated

Availability
FromAvailable
ToDeprecated

AvailabilityReplacement
FromAvailablenone
ToDeprecatedNSProgressIndicatorStyleBar

AvailabilityReplacement
FromAvailablenone
ToDeprecatedNSProgressIndicatorStyleSpinning

NSResponder.h
Removed -[NSResponder insertText:]
Removed -[NSResponder doCommandBySelector:]
Removed -[NSResponder moveForward:]
Removed -[NSResponder moveRight:]
Removed -[NSResponder moveBackward:]
Removed -[NSResponder moveLeft:]
Removed -[NSResponder moveUp:]
Removed -[NSResponder moveDown:]
Removed -[NSResponder moveWordForward:]
Removed -[NSResponder moveWordBackward:]
Removed -[NSResponder moveToBeginningOfLine:]
Removed -[NSResponder moveToEndOfLine:]
Removed -[NSResponder moveToBeginningOfParagraph:]
Removed -[NSResponder moveToEndOfParagraph:]
Removed -[NSResponder moveToEndOfDocument:]
Removed -[NSResponder moveToBeginningOfDocument:]
Removed -[NSResponder pageDown:]
Removed -[NSResponder pageUp:]
Removed -[NSResponder centerSelectionInVisibleArea:]
Removed -[NSResponder moveBackwardAndModifySelection:]
Removed -[NSResponder moveForwardAndModifySelection:]
Removed -[NSResponder moveWordForwardAndModifySelection:]
Removed -[NSResponder moveWordBackwardAndModifySelection:]
Removed -[NSResponder moveUpAndModifySelection:]
Removed -[NSResponder moveDownAndModifySelection:]
Removed -[NSResponder moveToBeginningOfLineAndModifySelection:]
Removed -[NSResponder moveToEndOfLineAndModifySelection:]
Removed -[NSResponder moveToBeginningOfParagraphAndModifySelection:]
Removed -[NSResponder moveToEndOfParagraphAndModifySelection:]
Removed -[NSResponder moveToEndOfDocumentAndModifySelection:]
Removed -[NSResponder moveToBeginningOfDocumentAndModifySelection:]
Removed -[NSResponder pageDownAndModifySelection:]
Removed -[NSResponder pageUpAndModifySelection:]
Removed -[NSResponder moveParagraphForwardAndModifySelection:]
Removed -[NSResponder moveParagraphBackwardAndModifySelection:]
Removed -[NSResponder moveWordRight:]
Removed -[NSResponder moveWordLeft:]
Removed -[NSResponder moveRightAndModifySelection:]
Removed -[NSResponder moveLeftAndModifySelection:]
Removed -[NSResponder moveWordRightAndModifySelection:]
Removed -[NSResponder moveWordLeftAndModifySelection:]
Removed -[NSResponder moveToLeftEndOfLine:]
Removed -[NSResponder moveToRightEndOfLine:]
Removed -[NSResponder moveToLeftEndOfLineAndModifySelection:]
Removed -[NSResponder moveToRightEndOfLineAndModifySelection:]
Removed -[NSResponder scrollPageUp:]
Removed -[NSResponder scrollPageDown:]
Removed -[NSResponder scrollLineUp:]
Removed -[NSResponder scrollLineDown:]
Removed -[NSResponder scrollToBeginningOfDocument:]
Removed -[NSResponder scrollToEndOfDocument:]
Removed -[NSResponder transpose:]
Removed -[NSResponder transposeWords:]
Removed -[NSResponder selectAll:]
Removed -[NSResponder selectParagraph:]
Removed -[NSResponder selectLine:]
Removed -[NSResponder selectWord:]
Removed -[NSResponder indent:]
Removed -[NSResponder insertTab:]
Removed -[NSResponder insertBacktab:]
Removed -[NSResponder insertNewline:]
Removed -[NSResponder insertParagraphSeparator:]
Removed -[NSResponder insertNewlineIgnoringFieldEditor:]
Removed -[NSResponder insertTabIgnoringFieldEditor:]
Removed -[NSResponder insertLineBreak:]
Removed -[NSResponder insertContainerBreak:]
Removed -[NSResponder insertSingleQuoteIgnoringSubstitution:]
Removed -[NSResponder insertDoubleQuoteIgnoringSubstitution:]
Removed -[NSResponder changeCaseOfLetter:]
Removed -[NSResponder uppercaseWord:]
Removed -[NSResponder lowercaseWord:]
Removed -[NSResponder capitalizeWord:]
Removed -[NSResponder deleteForward:]
Removed -[NSResponder deleteBackward:]
Removed -[NSResponder deleteBackwardByDecomposingPreviousCharacter:]
Removed -[NSResponder deleteWordForward:]
Removed -[NSResponder deleteWordBackward:]
Removed -[NSResponder deleteToBeginningOfLine:]
Removed -[NSResponder deleteToEndOfLine:]
Removed -[NSResponder deleteToBeginningOfParagraph:]
Removed -[NSResponder deleteToEndOfParagraph:]
Removed -[NSResponder yank:]
Removed -[NSResponder complete:]
Removed -[NSResponder setMark:]
Removed -[NSResponder deleteToMark:]
Removed -[NSResponder selectToMark:]
Removed -[NSResponder swapWithMark:]
Removed -[NSResponder cancelOperation:]
Removed -[NSResponder makeBaseWritingDirectionNatural:]
Removed -[NSResponder makeBaseWritingDirectionLeftToRight:]
Removed -[NSResponder makeBaseWritingDirectionRightToLeft:]
Removed -[NSResponder makeTextWritingDirectionNatural:]
Removed -[NSResponder makeTextWritingDirectionLeftToRight:]
Removed -[NSResponder makeTextWritingDirectionRightToLeft:]
Removed -[NSResponder quickLookPreviewItems:]
Modified NSResponder
Protocols
FromNSCoding, NSTouchBarProvider
ToNSCoding, NSStandardKeyBindingResponding, NSTouchBarProvider, NSUserActivityRestoring

NSScroller.h
Availability
FromAvailable
ToDeprecated

Availability
FromAvailable
ToDeprecated

Availability
FromAvailable
ToDeprecated

Availability
FromAvailable
ToDeprecated

Availability
FromAvailable
ToDeprecated

Availability
FromAvailable
ToDeprecated

Availability
FromAvailable
ToDeprecated

Availability
FromAvailable
ToDeprecated

Availability
FromAvailable
ToDeprecated

AvailabilityDeprecation Message
FromAvailablenone
ToDeprecatedHas had no effect since 10.7

AvailabilityDeprecation Message
FromAvailablenone
ToDeprecatedHas had no effect since 10.7

AvailabilityDeprecation Message
FromAvailablenone
ToDeprecatedHas had no effect since 10.7

AvailabilityDeprecation Message
FromAvailablenone
ToDeprecatedNot invoked since 10.7

AvailabilityDeprecation Message
FromAvailablenone
ToDeprecatedScrollers don't have arrows as of 10.7

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

NSSharingService.h
AvailabilityDeprecation Message
FromAvailablenone
ToDeprecatedThis service is no longer included with the system.

AvailabilityDeprecation Message
FromAvailablenone
ToDeprecatedThis service is no longer included with the system.

AvailabilityDeprecation Message
FromAvailablenone
ToDeprecatedThis service is no longer included with the system.

AvailabilityDeprecation Message
FromAvailablenone
ToDeprecatedThis service is no longer included with the system.

AvailabilityDeprecation Message
FromAvailablenone
ToDeprecatedThis service is no longer included with the system.

AvailabilityDeprecation Message
FromAvailablenone
ToDeprecatedThis service is no longer included with the system.

AvailabilityDeprecation Message
FromAvailablenone
ToDeprecatedThis service is no longer included with the system.

AvailabilityDeprecation Message
FromAvailablenone
ToDeprecatedThis service is no longer included with the system.

AvailabilityDeprecation Message
FromAvailablenone
ToDeprecatedThis service is no longer included with the system.

AvailabilityDeprecation Message
FromAvailablenone
ToDeprecatedThis service is no longer included with the system.

AvailabilityDeprecation Message
FromAvailablenone
ToDeprecatedThis service is no longer included with the system.

AvailabilityDeprecation Message
FromAvailablenone
ToDeprecatedThis service is no longer included with the system.

NSSliderCell.h
Declaration
From- (void)setTitleCell:(NSCell *)cell
To- (void)setTitleCell:(null_unspecified NSCell *)cell

Declaration
From- (id)titleCell
To- (null_unspecified id)titleCell

Declaration
From- (void)setTitleColor:(NSColor *)newColor
To- (void)setTitleColor:(null_unspecified NSColor *)newColor

Declaration
From- (NSColor *)titleColor
To- (null_unspecified NSColor *)titleColor

Declaration
From- (void)setTitleFont:(NSFont *)fontObj
To- (void)setTitleFont:(null_unspecified NSFont *)fontObj

Declaration
From- (NSFont *)titleFont
To- (null_unspecified NSFont *)titleFont

Declaration
From- (NSString *)title
To- (null_unspecified NSString *)title

Declaration
From- (void)setTitle:(NSString *)string
To- (void)setTitle:(null_unspecified NSString *)string

NSSound.h
Modified NSSound
Protocols
FromNSCoding, NSCopying, NSPasteboardReading, NSPasteboardWriting
ToNSCopying, NSPasteboardReading, NSPasteboardWriting, NSSecureCoding

NSTableHeaderView.h
Protocols
Fromnone
ToNSViewToolTipOwner

NSTabView.h
Declaration
From@property (readonly, copy, nonnull) NSArray<__kindof NSTabViewItem *> *tabViewItems
To@property (copy, nonnull) NSArray<__kindof NSTabViewItem *> *tabViewItems

AvailabilityDeprecation Message
FromAvailablenone
ToDeprecatedThe controlTint property is not respected on 10.14 and later.

NSTextView.h
Modified NSTextView
Protocols
FromNSAccessibilityNavigableStaticText, NSCandidateListTouchBarItemDelegate, NSDraggingSource, NSTextInput, NSTextInputClient, NSTextLayoutOrientationProvider, NSTouchBarDelegate, NSUserInterfaceValidations
ToNSAccessibilityNavigableStaticText, NSCandidateListTouchBarItemDelegate, NSColorChanging, NSDraggingSource, NSMenuItemValidation, NSStandardKeyBindingResponding, NSTextInput, NSTextInputClient, NSTextLayoutOrientationProvider, NSTouchBarDelegate, NSUserInterfaceValidations

Declaration
From- (nullable NSArray<id<QLPreviewItem>> *)quickLookPreviewableItemsInRanges:(nonnull NSArray<NSValue *> *)ranges
To- (nonnull NSArray<id<QLPreviewItem>> *)quickLookPreviewableItemsInRanges:(nonnull NSArray<NSValue *> *)ranges

NSTokenFieldCell.h
AvailabilityReplacement
FromAvailablenone
ToDeprecatedNSTokenStyleDefault

AvailabilityReplacement
FromAvailablenone
ToDeprecatedNSTokenStyleNone

AvailabilityReplacement
FromAvailablenone
ToDeprecatedNSTokenStyleRounded

NSToolbar.h
NSToolbarItem.h
Modified NSToolbarItem
Protocols
FromNSCopying, NSValidatedUserInterfaceItem
ToNSCopying, NSMenuItemValidation, NSValidatedUserInterfaceItem

AvailabilityDeprecation Message
FromAvailablenone
ToDeprecatedThis is now a method of the NSToolbarItemValidation protocol.

NSUserActivity.h
Removed -[NSResponder restoreUserActivityState:]
Removed -[NSDocument restoreUserActivityState:]
NSView.h
AvailabilityDeprecation Message
FromAvailablenone
ToDeprecatedIf a view needs display, -drawRect: or -updateLayer will be called automatically when the view is able to draw. To check whether a view is in a window, call -window. To check whether a view is hidden, call -isHiddenOrHasHiddenAncestor.

AvailabilityDeprecation Message
FromAvailablenone
ToDeprecatedTo draw, subclass NSView and implement -drawRect:; AppKit's automatic deferred display mechanism will call -drawRect: as necessary to display the view.

AvailabilityDeprecation Message
FromAvailablenone
ToDeprecatedTo draw, subclass NSView and implement -drawRect:; AppKit's automatic deferred display mechanism will call -drawRect: as necessary to display the view.

AvailabilityDeprecation Message
FromAvailablenone
ToDeprecatedTo draw, subclass NSView and implement -drawRect:; AppKit's automatic deferred display mechanism will call -drawRect: as necessary to display the view.

AvailabilityDeprecation Message
FromAvailablenone
ToDeprecatedUse NSScrollView to achieve scrolling views.

AvailabilityDeprecation Message
FromAvailablenone
ToDeprecatedThis is now a method of the NSViewLayerContentScaleDelegate protocol.

AvailabilityDeprecation Message
FromAvailablenone
ToDeprecatedThis is now a method of the NSViewToolTipOwner protocol.

AvailabilityDeprecation Message
FromAvailablenone
ToDeprecatedThis is never invoked and the NSView implementation does nothing

NSViewController.h
Protocols
FromNSCoding, NSExtensionRequestHandling, NSSeguePerforming, NSUserInterfaceItemIdentification
ToNSEditor, NSExtensionRequestHandling, NSSeguePerforming, NSUserInterfaceItemIdentification

NSVisualEffectView.h
AvailabilityDeprecation Message
FromAvailablenone
ToDeprecatedUse a specific semantic material instead.

AvailabilityDeprecation Message
FromAvailablenone
ToDeprecatedUse a semantic material instead. To force the appearance of a view hierarchy, set the `appearance` property to an appropriate NSAppearance value.

AvailabilityDeprecation Message
FromAvailablenone
ToDeprecatedUse a semantic material instead. To force the appearance of a view hierarchy, set the `appearance` property to an appropriate NSAppearance value.

AvailabilityDeprecation Message
FromAvailablenone
ToDeprecatedUse a semantic material instead. To force the appearance of a view hierarchy, set the `appearance` property to an appropriate NSAppearance value.

AvailabilityDeprecation Message
FromAvailablenone
ToDeprecatedUse a semantic material instead. To force the appearance of a view hierarchy, set the `appearance` property to an appropriate NSAppearance value.

NSWindow.h
Removed NSWindowFullScreenButton
Removed NSUnscaledWindowMask
Added NSUnscaledWindowMask
AvailabilityDeprecation Message
FromAvailablenone
ToDeprecatedTextured window style should no longer be used

Modified NSWindow
Protocols
FromNSAccessibility, NSAccessibilityElement, NSAnimatablePropertyContainer, NSAppearanceCustomization, NSUserInterfaceItemIdentification, NSUserInterfaceValidations
ToNSAccessibility, NSAccessibilityElement, NSAnimatablePropertyContainer, NSAppearanceCustomization, NSMenuItemValidation, NSUserInterfaceItemIdentification, NSUserInterfaceValidations

Declaration
From@property (readonly, copy, nonnull) NSString *stringWithSavedFrame
To@property (readonly, copy, nonnull) NSWindowPersistableFrameDescriptor stringWithSavedFrame

Declaration
From- (void)setFrameFromString:(nonnull NSString *)string
To- (void)setFrameFromString:(nonnull NSWindowPersistableFrameDescriptor)string

AvailabilityDeprecation Message
FromAvailablenone
ToDeprecatedUse +[NSAnimationContext runAnimationGroup:completionHandler:] to perform atomic updates across runloop invocations.

AvailabilityDeprecation Message
FromAvailablenone
ToDeprecatedUse +[NSAnimationContext runAnimationGroup:completionHandler:] to perform atomic updates across runloop invocations.

AvailabilityDeprecation Message
FromAvailablenone
ToDeprecatedUse +[NSAnimationContext runAnimationGroup:completionHandler:] to perform atomic updates across runloop invocations.

AvailabilityDeprecation Message
FromAvailablenone
ToDeprecatedAllow AppKit's automatic deferred display mechanism to take care of flushing any graphics contexts as needed.

AvailabilityDeprecation Message
FromAvailablenone
ToDeprecatedAllow AppKit's automatic deferred display mechanism to take care of flushing any graphics contexts as needed.

AvailabilityDeprecation Message
FromAvailablenone
ToDeprecatedUse +[NSAnimationContext runAnimationGroup:completionHandler:] to temporarily prevent AppKit's automatic deferred display mechanism from drawing.

AvailabilityDeprecation Message
FromAvailablenone
ToDeprecatedAdd instances of NSView to display content in a window.

AvailabilityDeprecation Message
FromAvailablenone
ToDeprecatedThis property does not do anything and should not be used

Availability
FromAvailable
ToDeprecated

Availability
FromAvailable
ToDeprecated

Availability
FromAvailable
ToDeprecated

AvailabilityDeprecation Message
FromAvailablenone
ToDeprecatedThis property does not do anything and should not be used

AvailabilityDeprecation Message
FromAvailablenone
ToDeprecatedThis property does not do anything and should not be used

Availability
FromAvailable
ToDeprecated

NSWorkspace.h
Added NSFileManager (NSWorkspaceAuthorization)