如何在Objective-C 2.0中将方法标记为不推荐使用？

我是开发相当大的iPad应用程序的团队的一员，因此我们创建了许多不同的类。麻烦的是有些方法现在已经过时了，我不想简单地删除它们，因为我知道整个系统的某些部分都在使用这些方法...但是有更好的（较新的）变体应该使用相反（一些旧的实际上调用了新的，但是整个类的接口变得混乱了）。

有没有一种方法可以将某些方法标记为已折旧（例如@deprecated在Java和[Obsolete].NET中）。

我看到苹果使用Availability.h并具有诸如

__OSX_AVAILABLE_BUT_DEPRECATED(__MAC_NA,__MAC_NA,__IPHONE_2_0,__IPHONE_3_0);

...这是唯一的方法（+ App Store安全吗？）还是有其他替代方法会在Xcode中标记警告？

弃用语法

提供了语法以将方法标记为已弃用：

@interface SomeClass
-method __attribute__((deprecated));
@end

要么：

#include <AvailabilityMacros.h>
@interface SomeClass
-method DEPRECATED_ATTRIBUTE;  // or some other deployment-target-specific macro
@end

恕我直言，编写__deprecated更容易：

- (void)myDeprecatedMethod __deprecated;
- (int)methodNameDeprecated:(int)param __deprecated;

在班上也可以

__deprecated
@interface MyDeprecatedClass

  // ... some properties and methods ...

@end

如果要使用弃用标志提供其他消息，则可以使用以下标志。

@property (strong, nonatomic) NSString *catName
                    __deprecated_msg("use name instead.");

//  -- Or -- 
@property (strong, nonatomic) NSString *catName
                    DEPRECATED_MSG_ATTRIBUTE("use name instead.");

//  -- Or -- 
@property (strong, nonatomic) NSString *catName
                    __attribute__((deprecated("use name instead.")));

使用上面提到的标志，您可以告诉您为什么要弃用或开发人员将来应该使用什么方法。

要将方法标记为不推荐使用，请使用__attribute __（（deprecated（“您的消息在此处”）））

一个实际的例子，来自Mantle

@interface NSValueTransformer (UnavailableMTLPredefinedTransformerAdditions)

+ (NSValueTransformer *)mtl_externalRepresentationTransformerWithModelClass:(Class)modelClass __attribute__((deprecated("Replaced by +mtl_JSONDictionaryTransformerWithModelClass:")));
+ (NSValueTransformer *)mtl_externalRepresentationArrayTransformerWithModelClass:(Class)modelClass __attribute__((deprecated("Replaced by +mtl_JSONArrayTransformerWithModelClass:")));

@end

使用deprecated属性：

- (int)bar: (int)x __attribute__((deprecated));