[Mac] Switch from NSObject categories to forward declarations for Touch Bar support.

ui/base/cocoa/touch_bar_forward_declarations.h

 // Copyright 2016 The Chromium Authors. All rights reserved.
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
 #ifndef UI_BASE_COCOA_TOUCH_BAR_FORWARD_DECLARATIONS_H_
 #define UI_BASE_COCOA_TOUCH_BAR_FORWARD_DECLARATIONS_H_
 
 // Once Chrome no longer supports OSX 10.12.0, this file can be deleted.
 
 #import <Foundation/Foundation.h>
 
 #if !defined(MAC_OS_X_VERSION_10_12_1)
 
-// The TouchBar classes do not exist at all without the 10.12.1 SDK. When
-// compiling with older SDKs, pretend they are NSObject and add categories to
-// NSObject to expose the methods.
-// To alloc one of these classes, use -[NSClassFromString(@"..") alloc].
+#pragma clang assume_nonnull begin

[tapted, 2016/11/30 23:29:27]

I think this is OK since we're replicating a system header and want to reduce
the likelihood that we let stuff through the CQ that will break when compiling
against the authentic 10.12.1 SDK  (but if you're curious there's some active
discussion around whether we should use audited regions like this for new code
at http://go/uzjld  )

 
-// Incomplete. Add more as necessary.
+@class NSTouchBar, NSTouchBarItem;
+@protocol NSTouchBarDelegate;
 
-typedef NSObject NSCustomTouchBarItem;
-typedef NSObject NSGroupTouchBarItem;
-typedef NSObject NSTouchBar;
-typedef NSObject NSTouchBarItem;
+typedef float NSTouchBarItemPriority;
+static const NSTouchBarItemPriority NSTouchBarItemPriorityHigh = 1000;
+static const NSTouchBarItemPriority NSTouchBarItemPriorityNormal = 0;
+static const NSTouchBarItemPriority NSTouchBarItemPriorityLow = -1000;
+
 typedef NSString* NSTouchBarItemIdentifier;
+typedef NSString* NSTouchBarCustomizationIdentifier;
 
-@protocol NSTouchBarDelegate<NSObject>
+@interface NSTouchBar : NSObject<NSCoding>
+
+- (instancetype)init NS_DESIGNATED_INITIALIZER;

[tapted, 2016/11/30 23:29:27]

Internet suggests NS_DESIGNATED_INITIALIZER is XCode 6, but I'm not sure on the
SDK. https://www.chromium.org/developers/design-documents/mac-xib-files suggests
we still use XCode 5 in some places. But I _think_ this is OK now.
NS_DESIGNATED_INITIALIZER is used a lot on a lot of ios code, but
image_capture_device_manager_unittest.mm is the only occurence I could find for
MacOS code. (and it looks like official builders are happy with that).

My 10.10 SDK's NSObjCRuntime.h has this defined in any case.

+- (nullable instancetype)initWithCoder:(NSCoder*)aDecoder
+    NS_DESIGNATED_INITIALIZER;
+
+@property(copy, nullable)
+    NSTouchBarCustomizationIdentifier customizationIdentifier;
+@property(copy) NSArray* customizationAllowedItemIdentifiers;
+@property(copy) NSArray* customizationRequiredItemIdentifiers;
+@property(copy) NSArray* defaultItemIdentifiers;
+@property(copy, readonly) NSArray* itemIdentifiers;
+@property(copy, nullable) NSTouchBarItemIdentifier principalItemIdentifier;
+@property(copy) NSSet* templateItems;
+@property(nullable, weak) id<NSTouchBarDelegate> delegate;
+
+- (nullable __kindof NSTouchBarItem*)itemForIdentifier:

[tapted, 2016/11/30 23:29:27]

I think __kindof is Xcode 7 (10.11 SDK). But hopefully this is a compiler
intrinsic so isn't dependent on the SDK we link against. (i.e. the 10.10 SDK
won't have any generics and might get confused :/)

+    (NSTouchBarItemIdentifier)identifier;
+
+@property(readonly, getter=isVisible) BOOL visible;
+
 @end
 
-@interface NSObject (FakeNSCustomTouchBarItem)
-@property(readwrite, strong) NSView* view;
+@interface NSTouchBarItem : NSObject<NSCoding>
+
+- (instancetype)initWithIdentifier:(NSTouchBarItemIdentifier)identifier
+    NS_DESIGNATED_INITIALIZER;
+- (nullable instancetype)initWithCoder:(NSCoder*)coder
+    NS_DESIGNATED_INITIALIZER;
+- (instancetype)init NS_UNAVAILABLE;
+
+@property(readonly, copy) NSTouchBarItemIdentifier identifier;
+@property NSTouchBarItemPriority visibilityPriority;
+@property(readonly, nullable) NSView* view;
+@property(readonly, nullable) NSViewController* viewController;
+@property(readonly, copy) NSString* customizationLabel;
+@property(readonly, getter=isVisible) BOOL visible;
+
 @end
 
-@interface NSObject (FakeNSGroupTouchBarItem)
+@interface NSGroupTouchBarItem : NSTouchBarItem
+
 + (NSGroupTouchBarItem*)groupItemWithIdentifier:
                             (NSTouchBarItemIdentifier)identifier
                                           items:(NSArray*)items;
+
+@property(strong) NSTouchBar* groupTouchBar;
+@property(readwrite, copy, null_resettable) NSString* customizationLabel;
+
 @end
 
-@interface NSObject (FakeNSTouchBar)
-@property(copy) NSArray* defaultItemIdentifiers;
-@property(copy) NSTouchBarItemIdentifier principalItemIdentifier;
-@property(weak) id<NSTouchBarDelegate> delegate;
+@interface NSCustomTouchBarItem : NSTouchBarItem
+
+@property(readwrite, strong) __kindof NSView* view;
+@property(readwrite, strong, nullable)
+    __kindof NSViewController* viewController;
+@property(readwrite, copy, null_resettable) NSString* customizationLabel;
+
 @end
 
+@protocol NSTouchBarDelegate<NSObject>
+
+@optional
+- (nullable NSTouchBarItem*)touchBar:(NSTouchBar*)touchBar
+               makeItemForIdentifier:(NSTouchBarItemIdentifier)identifier;
+@end
+
+#pragma clang assume_nonnull end
+
 #elif MAC_OS_X_VERSION_MIN_REQUIRED < MAC_OS_X_VERSION_10_12_1
 
 // When compiling against the 10.12.1 SDK or later, just provide forward
 // declarations to suppress the partial availability warnings.
 
 @class NSCustomTouchBarItem;
 @class NSGroupTouchBarItem;
 @class NSTouchBar;
 @protocol NSTouchBarDelegate;
 @class NSTouchBarItem;
 
 #endif  // MAC_OS_X_VERSION_10_12_1
 
 #endif  // UI_BASE_COCOA_TOUCH_BAR_FORWARD_DECLARATIONS_H_