Comment marquer une méthode comme obsolète dans Objective-C 2.0?

Je fais partie d'une équipe développant une application iPad assez volumineuse et nous avons créé de nombreuses classes différentes. Le problème est que certaines des méthodes sont maintenant à peu près obsolètes et je ne veux pas simplement les supprimer, car je sais que certaines parties du système global utilisent les méthodes ... mais il existe de meilleures variantes (plus récentes) disponibles qui devraient être utilisées à la place (certains des anciens appellent en fait les nouveaux, mais l'interface de classe globale devient désordonnée).

Existe-t-il un moyen de marquer certaines méthodes comme dépréciées (comme @deprecateden Java et [Obsolete]en .NET).

Je vois qu'Apple utilise Availability.h et a des balises telles que

__OSX_AVAILABLE_BUT_DEPRECATED(__MAC_NA,__MAC_NA,__IPHONE_2_0,__IPHONE_3_0);

... est-ce la seule façon de le faire (+ est-ce que l'App Store est sûr de le faire?) ou existe-t-il des alternatives qui signaleront un avertissement dans Xcode?

Syntaxe de dépréciation

La syntaxe est fournie pour marquer les méthodes comme obsolètes:

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

ou:

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

À mon humble avis, il est plus facile d'écrire __deprecated:

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

Fonctionne aussi sur les classes

__deprecated
@interface MyDeprecatedClass

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

@end

Si vous souhaitez donner un message supplémentaire avec l'indicateur d'obsolescence, vous pouvez utiliser les indicateurs suivants.

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

En utilisant les indicateurs mentionnés ci-dessus, vous pouvez dire pourquoi vous vous désapprouvez ou quelle méthode le développeur devrait utiliser à l'avenir.

Pour marquer une méthode comme obsolète, utilisez __attribute __ ((deprecated ("Your message going here")))

Un exemple pratique, de 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

Utilisez l' deprecatedattribut:

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