Wie kann ich die markieren-Funktion als deprecated in einer iOS-Objective-C header-Datei?

Ich vermute, es gibt nur einige Stichwörter, die ich bleiben kann nach der Funktion irgendwo?

Möchte ich für eine compiler-Warnung generiert werden, sollte jemand versuchen, und verwenden Sie die Funktion veraltet, ähnlich wie das Verhalten gesehen in apples APIs.

Hey gs - guten Kommentar. Ich dachte eigentlich das gerade jetzt!

InformationsquelleAutor Nick Cartwright | 2009-09-18

61

Versuchen Sie, ein Attribut, das Ihre Methode Erklärung:
```
- (void)fooBar __attribute__ ((deprecated));
```
Entnommen hier.
- Sieht aus wie ziemlich hässliche syntax, aber wenn es funktioniert, es funktioniert! Dank Tim.
- Sie können #define VERALTET _____Attribut_____ ((deprecated))
- - (void)fooBar DEPRECATED_ATTRIBUTE; für mich funktioniert. Ich glaube nicht, müssen Sie die #define-wie von Denis vorgeschlagen wird, ist es bereits definiert, AFAIK
- oder Sie können einfach verwenden __veraltet
- Huh. Anhängen __deprecated um eine Methode Erklärung funktioniert auch, und ich habe keine Ahnung, warum. Danke für die Anregung, @ArtFeel - haben Sie zufällig wissen, wo das definiert ist?
- diese definiert in cdefs.h
- Genial, vielen Dank. Funktioniert wie ich es erwartet hatte - ein #define dem Attribut.
- Genial, nur mit __deprecated - Werke für @property zu. Danke.
InformationsquelleAutor Tim
7

Tim ' s Antwort tatsächlich produzieren eine compiler-Warnung; die anderen Versionen sind nur Kommentare, die keine Wirkung w.r.t. die compiler.

Wenn man sich in /usr/include/AvailabilityMacros.h, Sie werden sehen, wie Apple dies tut. Dieser header verwendet __attribute__((deprecated)) und __attribute__((unavailable)) je nachdem, ob die API ist vorhanden, aber veraltet, oder wurde tatsächlich entfernt vom OS.

InformationsquelleAutor Chris Parker
5

Statt __attribute__((deprecated)), die Sie verwenden können, verwenden Sie die Makros definiert, die in <cdefs.h>:
```
- (void)fooBar __deprecated;
//Or better:
- (void)fooBar __deprecated_msg("Use barFoo instead.");
```
Oder Sie können die Makros definiert, die in <AvailabilityMacros.h>:
```
- (void)fooBar DEPRECATED_ATTRIBUTE;
//Or better:
- (void)fooBar DEPRECATED_MSG_ATTRIBUTE("Use barFoo instead.");
```
Wenn Sie mit Objective-C, macht es keinen Unterschied, wie Sie gehen, um mit einem modernen compiler, so dass Sie gehen können für Apple-kurze syntax __deprecated_msg(). Aber wenn Sie C für cross-Plattform -, dann DEPRECATED_MSG_ATTRIBUTE() verwendet die optimale Verfügbarkeit Definitionen (zum Beispiel, es unterstützt GCC3.1).

InformationsquelleAutor Cœur
2

Vom Apple SFAuthorization.h:
```
/*!
DEPRECATED: Use obtainWithRight:flags:error:
@method permitWithRight:flags:
@abstract Call permitWithRight to gain a right to have
          access to a privilege operation.
@param rightName The name of an authorization right.
@param flags Authorization flags.
*/
- (OSStatus)permitWithRight:(AuthorizationString)rightName
                      flags:(AuthorizationFlags)flags;
```
Wenn Sie nicht über eine automatisierte Dokumentation builder ich würde sagen, so etwas ist genug:
```
- (void)doSomething;           /* DEPRECATED */
```
- Danke für den Kommentar. Wenn ich die 'permitWithRight' - Funktion in SFAuthorization, bekomme ich einen compiler-Warnung... gibt es eine Möglichkeit zum hinzufügen einer deprecation flag zu geben, dass der compiler Warnungen?
- Sie könnten die Verwendung der Präprozessor-Befehl #Warnung, aber es ist nicht standard und wird wahrscheinlich nicht in allen Compilern. Siehe stackoverflow.com/questions/171435/...
InformationsquelleAutor Georg Schölly
2

Könnte man auch Folgen der HeaderDoc Handbuch. Wo diese syntax wird verwendet:
```
/*!
 * @abstract Foo is good for bar.
 *
 * @deprecated in version 2.0
 */
```
InformationsquelleAutor PeyloW

Schreibe einen Kommentar

Du musst angemeldet sein, um einen Kommentar abzugeben.