Cómo descartar un método en Xcode

Question

Tenemos nuestra biblioteca que enviamos a nuestros clientes, y me gustaría marcar algunos métodos como "en desuso" porque los hemos cambiado (como lo hace Apple en el SDK de iPhone).

que he visto la macro __OSX_AVAILABLE_BUT_DEPRECATED pre-procesador, que está asignada a __AVAILABILITY_INTERNAL, que se asigna a __attribute__((deprecated)) ...

Bueno, yo estoy un poco confundido con estas cosas!

¿Alguien sabe algo al respecto?

Answer 1

__attribute__((deprecated)) es gcc way (también supported in clang) de marcar una función/método como obsoleto. Cuando uno está marcado como "obsoleto", se producirá una advertencia cada vez que alguien lo llame.

La sintaxis para las funciones normales sería

__attribute__((deprecated)) 
void f(...) { 
    ... 
} 

// gcc 4.5+/clang 
__attribute__((deprecated("g has been deprecated please use g2 instead"))) 
void g(...) { 
    ... 
} 

y la de los métodos de Objective-C sería

@interface MyClass : NSObject { ... } 
-(void)f:(id)x __attribute__((deprecated)); 
... 
@end 

También puede marcar toda la clase como obsoletos con

__attribute__((deprecated)) 
@interface DeprecatedClass : NSObject { ... } 
... 
@end 

---

Apple también proporciona el encabezado <AvailabilityMacros.h> que proporciona las macros DEPRECATED_ATTRIBUTE y DEPRECATED_MSG_ATTRIBUTE (msg) que se expanden a los atributos anteriores, o nada si el compilador no admite atributos. Tenga en cuenta que este encabezado no existe fuera de OS X/iOS.

---

Nota al margen, si está utilizando Swift se utiliza el @available attribute desaprobar un elemento, por ejemplo,

@available(*, deprecated=2.0, message="no longer needed") 
func f() { 
    ... 
} 

Answer 2

También puede utilizar más legible definirDEPRECATED_ATTRIBUTE

Se define en usr/include/AvailabilityMacros.h:

#define DEPRECATED_ATTRIBUTE  __attribute__((deprecated)) 
#define DEPRECATED_MSG_ATTRIBUTE(msg) __attribute((deprecated((msg)))) 

Objective-C métodos ejemplo:

@interface MyClass : NSObject { ... } 
-(void)foo:(id)x DEPRECATED_ATTRIBUTE; 

// If you want to specify deprecated message: 
-(void)bar:(id)x DEPRECATED_MSG_ATTRIBUTE("Use baz: method instead."); 
... 
@end 

También puede marcar toda la clase como en desuso:

DEPRECATED_ATTRIBUTE 
@interface DeprecatedClass : NSObject { ... } 
... 
@end 

Answer 3

Si está utilizando C++ 14 en su proyecto Xcode, también puede utilizar el atributo [[deprecated]] o [[deprecated("reason")]] que ahora es parte de la lengua.

ver documentación: http://en.cppreference.com/w/cpp/language/attributes