如何在Objective-C 2.0中将方法标记为已弃用？

Question

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

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

我看到Apple使用Availability.h并且有标签,例如

__OSX_AVAILABLE_BUT_DEPRECATED(__MAC_NA,__MAC_NA,__IPHONE_2_0,__IPHONE_3_0);

...这是唯一的方法(+ App Store是否可以安全地执行此操作？)或者是否有替代方案会在Xcode中标记警告？

Answer 1

弃用语法

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

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

要么:

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

Answer 2

恕我直言,写__deprecated更容易:

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

也适用于课程

__deprecated
@interface MyDeprecatedClass

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

@end

Answer 3

如果要使用弃用标志提供其他消息,可以使用以下标志.

@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.")));

使用上面提到的标志,您可以了解为什么要弃用或者开发人员将来应该使用的方法.

Answer 4

要将方法标记为已弃用,请使用__attribute __((不建议使用("您的消息在此处")))

来自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

Answer 5

使用deprecated属性:

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