Mark symbols to be deprecated

Follow list guidance at go/material-ios-lists instead. PiperOrigin-RevId: 457845049
Mu-L · Jun 28, 2022 · cc835b5 · cc835b5
1 parent b37353a
commit cc835b5
Show file tree

Hide file tree

Showing 11 changed files with 48 additions and 0 deletions.
diff --git a/src/collections/src/NICollectionViewCellFactory.h b/src/collections/src/NICollectionViewCellFactory.h
@@ -19,6 +19,9 @@
 
 #import "NICollectionViewModel.h"
 
+API_DEPRECATED_BEGIN("Follow go/material-ios-lists for list guidance instead.",
+                     ios(12, API_TO_BE_DEPRECATED))
+
 /**
  * A simple factory for creating collection view cells from objects.
  *
@@ -219,3 +222,5 @@ _model.delegate = (id)[NICollectionViewCellFactory class];
  *
  * @fn NICollectionViewCellObject::userInfo
  */
+
+API_DEPRECATED_END
diff --git a/src/collections/src/NICollectionViewModel+Private.h b/src/collections/src/NICollectionViewModel+Private.h
@@ -18,6 +18,9 @@
 
 #import "NICollectionViewModel.h"
 
+API_DEPRECATED_BEGIN("Follow go/material-ios-lists for list guidance instead.",
+                     ios(12, API_TO_BE_DEPRECATED))
+
 @interface NICollectionViewModelSection : NSObject
 
 + (id)section;
@@ -41,3 +44,5 @@
 - (NICollectionViewModelSection *)_sectionFromListArray:(NSArray *)rows;
 
 @end
+
+API_DEPRECATED_END
diff --git a/src/collections/src/NICollectionViewModel.h b/src/collections/src/NICollectionViewModel.h
@@ -20,6 +20,9 @@
 #import "NIActions.h"  /* for NIActionsDataSource */
 #import "NIPreprocessorMacros.h" /* for weak */
 
+API_DEPRECATED_BEGIN("Follow go/material-ios-lists for list guidance instead.",
+                     ios(12, API_TO_BE_DEPRECATED))
+
 @protocol NICollectionViewModelDelegate;
 
 
@@ -234,3 +237,5 @@
  *
  * @fn NICollectionViewModel::delegate
  */
+
+API_DEPRECATED_END
diff --git a/src/core/src/NIActions+Subclassing.h b/src/core/src/NIActions+Subclassing.h
@@ -16,6 +16,9 @@
 
 #import "NIActions.h"
 
+API_DEPRECATED_BEGIN("Follow go/material-ios-lists for list guidance instead.",
+                     ios(12, API_TO_BE_DEPRECATED))
+
 @interface NIObjectActions : NSObject
 
 @property (nonatomic, copy) NIActionBlock tapAction;
@@ -35,3 +38,5 @@
 - (NIObjectActions *)actionForObjectOrClassOfObject:(id<NSObject>)object;
 
 @end
+
+API_DEPRECATED_END
diff --git a/src/core/src/NIActions.h b/src/core/src/NIActions.h
@@ -16,6 +16,9 @@
 
 #import <Foundation/Foundation.h>
 
+API_DEPRECATED_BEGIN("Follow go/material-ios-lists for list guidance instead.",
+                     ios(12, API_TO_BE_DEPRECATED))
+
 /**
  * For attaching actions to objects.
  *
@@ -420,3 +423,5 @@ NIActionBlock NIPushControllerAction(Class controllerClass);
  */
 
 /**@}*/// End of Actions //////////////////////////////////////////////////////////////////////////
+
+API_DEPRECATED_END
diff --git a/src/core/src/NICommonMetrics.h b/src/core/src/NICommonMetrics.h
@@ -19,6 +19,8 @@
 
 #import "NIPreprocessorMacros.h"
 
+API_DEPRECATED_BEGIN("Use equivalent UIKit APIs instead.", ios(12, API_TO_BE_DEPRECATED))
+
 #if defined __cplusplus
 extern "C" {
 #endif
@@ -157,3 +159,5 @@ UIEdgeInsets NICellContentPadding(void)
 #endif
 
 /**@}*/// End of Common Metrics ///////////////////////////////////////////////////////////////////
+
+API_DEPRECATED_END
diff --git a/src/core/src/NIDeviceOrientation.h b/src/core/src/NIDeviceOrientation.h
@@ -21,6 +21,8 @@
 
 #import "NIPreprocessorMacros.h"
 
+API_DEPRECATED_BEGIN("Use trait collections instead.", ios(12, API_TO_BE_DEPRECATED))
+
 #if defined __cplusplus
 extern "C" {
 #endif
@@ -94,3 +96,4 @@ CGAffineTransform NIRotateTransformForOrientation(UIInterfaceOrientation orienta
 
 /**@}*/// End of Device Orientation ///////////////////////////////////////////////////////////////
 
+API_DEPRECATED_END
diff --git a/src/core/src/NIImageUtilities.h b/src/core/src/NIImageUtilities.h
@@ -17,6 +17,8 @@
 #import <Foundation/Foundation.h>
 #import <UIKit/UIKit.h>
 
+API_DEPRECATED_BEGIN("Use UIImage APIs instead.", ios(12, API_TO_BE_DEPRECATED))
+
 #if defined __cplusplus
 extern "C" {
 #endif
@@ -47,3 +49,5 @@ UIImage* NIStretchableImageFromImage(UIImage* image)
 #if defined __cplusplus
 }
 #endif
+
+API_DEPRECATED_END
diff --git a/src/core/src/NINonEmptyCollectionTesting.h b/src/core/src/NINonEmptyCollectionTesting.h
@@ -18,6 +18,8 @@
 
 #import <Foundation/Foundation.h>
 
+API_DEPRECATED_BEGIN("Use standard Foundation APIs instead.", ios(12, API_TO_BE_DEPRECATED))
+
 #if defined __cplusplus
 extern "C" {
 #endif
@@ -56,3 +58,5 @@ BOOL NIIsStringWithAnyText(id object);
 #endif
 
 /**@}*/// End of Non-Empty Collection Testing /////////////////////////////////////////////////////
+
+API_DEPRECATED_END
diff --git a/src/core/src/NIPaths.h b/src/core/src/NIPaths.h
@@ -18,6 +18,8 @@
 
 #import <Foundation/Foundation.h>
 
+API_DEPRECATED_BEGIN("Use standard Foundation APIs instead.", ios(12, API_TO_BE_DEPRECATED))
+
 #if defined __cplusplus
 extern "C" {
 #endif
@@ -67,3 +69,5 @@ NSString* NIPathForCachesResource(NSString* relativePath);
 #endif
 
 /**@}*/// End of Paths ////////////////////////////////////////////////////////////////////////////
+
+API_DEPRECATED_END
diff --git a/src/core/src/NIRuntimeClassModifications.h b/src/core/src/NIRuntimeClassModifications.h
@@ -18,6 +18,8 @@
 
 #import <Foundation/Foundation.h>
 
+API_DEPRECATED_BEGIN("Avoid swizzling unless absolutely needed.", ios(12, API_TO_BE_DEPRECATED))
+
 #if defined __cplusplus
 extern "C" {
 #endif
@@ -72,3 +74,5 @@ void NISwapClassMethods(Class cls, SEL originalSel, SEL newSel);
 #endif
 
 /**@}*/// End of Runtime Class Modifications //////////////////////////////////////////////////////
+
+API_DEPRECATED_END