Як позначити метод, як застарілий у Objective-C 2.0?

Я є частиною команди, яка розробляє досить великий додаток для 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?

Синтаксис депресації

Синтаксис надається для позначення методів як застарілих:

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

або:

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

ІМХО, простіше написати __депресовано:

- (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 __ ((застаріле ("Ваше повідомлення йде тут")))

Практичний приклад, з Мантії

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