ฉันจะตั้งค่าสถานะวิธีที่เลิกใช้ใน Objective-C 2.0 ได้อย่างไร

ฉันเป็นส่วนหนึ่งของทีมพัฒนาแอพ iPad ที่ค่อนข้างใหญ่และมีคลาสที่แตกต่างกันมากมายที่เราสร้างขึ้นมา ปัญหาคือวิธีการบางอย่างตอนนี้ล้าสมัยไปแล้วและฉันไม่ต้องการเพียงแค่เอาออกเพราะฉันรู้ว่าบางส่วนของระบบโดยรวมใช้วิธีการ ... แต่มีตัวแปรที่ดีกว่า (ใหม่กว่า) ซึ่งควรใช้ แทน (เก่าบางคนเรียกจริง ๆ ใหม่ แต่อินเทอร์เฟซสำหรับคลาสโดยรวมจะเริ่มยุ่ง)

มีวิธีที่ฉันสามารถทำเครื่องหมายวิธีการบางอย่างเป็นค่าเสื่อมราคา (เช่น@deprecatedใน Java และ[Obsolete]ใน. NET)

ฉันเห็นว่า Apple ใช้ Availability.h และมีแท็กเช่น

__OSX_AVAILABLE_BUT_DEPRECATED(__MAC_NA,__MAC_NA,__IPHONE_2_0,__IPHONE_3_0);

... นี่เป็นวิธีเดียวที่จะทำได้ (+ เป็นที่ App Store ปลอดภัยหรือไม่) หรือมีทางเลือกอื่นที่จะตั้งค่าสถานะการเตือนใน Xcode หรือไม่

ไวยากรณ์การคัดค้าน

ไวยากรณ์ถูกจัดเตรียมเพื่อทำเครื่องหมายเมธอดว่าเลิกใช้แล้ว:

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

หรือ:

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

IMHO ง่ายต่อการเขียน __ เลิก:

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

ทำงานเกินไปในชั้นเรียน

__deprecated
@interface MyDeprecatedClass

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

@end

หากคุณต้องการให้ข้อความเพิ่มเติมด้วยการตั้งค่าสถานะการคัดค้านคุณสามารถใช้การตั้งค่าสถานะต่อไปนี้

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

เมื่อใช้การตั้งค่าสถานะที่กล่าวถึงข้างต้นคุณสามารถบอกได้ว่าทำไมคุณถึงเลิกใช้งานหรือผู้พัฒนาวิธีการใช้ในอนาคต

ในการทำเครื่องหมายวิธีที่เลิกใช้ให้ใช้__attribute __ ((เลิกใช้แล้ว ("ข้อความของคุณอยู่ที่นี่")))

ตัวอย่างการปฏิบัติจาก 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

ใช้deprecatedคุณลักษณะ:

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