Jak odrzucić metodę w Xcode

Question

Mamy naszą bibliotekę, którą wysyłamy do naszych klientów i chciałbym zaznaczyć niektóre metody jako "przestarzałe", ponieważ zmieniliśmy je (tak jak Apple w iPhone SDK).

Widziałem makro __OSX_AVAILABLE_BUT_DEPRECATED pre-procesor, który jest mapowany do __AVAILABILITY_INTERNAL, który jest mapowany do __attribute__((deprecated)) ...

Cóż, jestem nieco mylić z tych rzeczy!

Ktoś wie coś na ten temat?

Answer 1

__attribute__((deprecated)) to gcc way (również supported in clang) oznaczania funkcji/metody jako wycofanej. Kiedy ktoś zostanie oznaczony jako "przestarzały", ostrzeżenie zostanie wygenerowane za każdym razem, gdy ktoś go wywoła.

Składnia normalnych funkcji byłoby

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

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

i metod Objective-C będzie

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

Można również zaznaczyć całą klasę jako przestarzałe z

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

---

Apple również dostarcza nagłówek <AvailabilityMacros.h>, który udostępnia makra DEPRECATED_ATTRIBUTE i DEPRECATED_MSG_ATTRIBUTE (msg), które rozszerzają się do powyższych atrybutów lub nic, jeśli kompilator nie obsługuje atrybutów. Zauważ, że ten nagłówek nie istnieje poza OS X/iOS.

---

marginesie, jeśli używasz Swift użyć @available attribute aby potępiać element, na przykład

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

Answer 2

Można również użyć bardziej czytelny określićDEPRECATED_ATTRIBUTE

ona definiowana w usr/include/AvailabilityMacros.h:

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

Objective-C przykładem metody:

@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 

Można również zaznaczyć całą klasę jako przestarzałe:

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

Answer 3

Jeśli używasz C++ 14 w projekcie xcode, można również użyć atrybutu [[deprecated]] lub [[deprecated("reason")]] który jest teraz częścią języka.

patrz dokumentacja: http://en.cppreference.com/w/cpp/language/attributes