Comment puis-je signaler une fonction comme étant dépréciée dans un fichier d'en-tête iPhone Objective C?

Question

Est-ce que quelqu'un sait comment faire cela?

Je suppose qu'il ya juste un mot clé que je peux coller après la fonction quelque part?

EDIT: Je voudrais qu'un avertissement de compilateur soit généré si quelqu'un essaie d'utiliser la fonction dépréciée, similaire au comportement observé dans les API d'Apple.

à votre santé! encoche.

Answer 1

Essayez d'ajouter un attribut à votre déclaration de méthode :

Pris d'ici.

Answer 2

La réponse de Tim produira en fait un avertissement de compilateur ; les autres versions ne sont que des commentaires qui n'ont aucun effet w.r.t. le compilateur.

Si vous regardez /usr/include/AvailabilityMacros.h, vous verrez comment Apple fait cela. Cet en-tête utilise et selon que l'API est présent mais déprécié, ou a effectivement été retiré de l'OS.

Answer 3

De SFAuthorization.h d'Apple:

Si vous n'utilisez pas un constructeur de documentation automatisée, je dirais que quelque chose comme ça suffit:

Answer 4

Vous pouvez également suivre le manuel HeaderDoc. Lorsque cette syntaxe est utilisée :