Availability.h
/*
* Copyright (c) 2007-2009 by Apple Inc.. All rights reserved.
*
* @APPLE_LICENSE_HEADER_START@
*
*这个文件包含源码或者在对于原代码修改的定义,适用于苹果共有资源许可第2.0版。
*你在使用此文件时必须遵守协议，请在http://www.opensource.apple.com/apsl/
*获取协议的拷贝，在使用本文件之前阅读它。
*
*源代码和所有的软件在协议下的发布时遵守""的AS IS"的原则的：没有任何的警告，不包含任何的明示或者暗示，
*同时Apple特此声明这一类的保证，包括不对出售的做任何的限制和保证。
*对于特定的用途，是不受干扰和侵权的。
*请在当前的协议下阅读特定语言赋予的权力和限制
*
* @APPLE_LICENSE_HEADER_END@
*/
#ifndef__AVAILABILITY__
#define__AVAILABILITY__
/*
这些宏都是用在头文件种。它们是作用于和系统版本有关的函数声明或者函数，如果它们是可用的就标示它们首次有效的方法；或者被抛弃的函数。
MAC OS和iOS有不同的版本号，OSX_AVALIABALE_STARTING()这个宏可以标识MAC OS和IOS
比如：_OSX_AVALABLE(_MAC_10_2,_IPHONE_2_0)表示这个函数可用的最低的版本是MAC OS X 10.2和IOS 2.0.
如果一个函数在一个平台上可用，在另一个不可用，会加上_NA(not applicable)这个属性。
比如: _OSX_AVALIBLE_STARTING(_MAC_10_3,_IPHONE_NA)标识最低可用于MAC OS的版本是
MAC OS 10.3，在IOS平台上不可用。
有时，一个函数/方法被抛弃了。这表示苹果推不推荐使用者再使用这个函数，或者有更好的替代的函数。
被抛弃的方法／函数，可以被标记为：
_OSX_AVAILABLE_BUT_DEPRECATED()的宏，表示该函数／方法是可用的，但是也是被抛弃了的。
比如说：
_OSX_AVAILABLE_BUT_DEPRECATED(__MAC_10_0,__MAC_10_5,__IPHONE_NA,__IPHONE_NA)，表示在在MAC10.0的时候被引入了，
在MAC 10.5的时候被抛弃了。在IOS平台中这个函数是不可用的。
为了这些宏正常的使用，程序必须指定程序的系统版本。为编译器的指定最低的系统版本：当在MAC OS下编译程序的时候，表示为
－mmacos-version-min = 10.x，
当在IOS下编译程序的时候表示为-miphone-version-min=1.x.x。最高的编译版本是很少需要，
但是可以通过命令行：MAC OS下形如，-D__MAC_OS_X_VERSION_MAX_ALLOWED=10xx，
IOS下形如，__IPHONE_OS_VERSION_MAX_ALLOWED = 1xxx .
例子：
一个函数在MAC OS X 10.5及其以后版本可用，但是在IOS下是不可用的。
extern void mymacfunc() __OSX_AVAILABLE_STARTING(__MAC_10_5,__IPHONE_NA);
一个OC函数在MAC OS X 10.5及其以后版本可用，但是在IOS下是不可用的。
@interface MyClass : NSObject
-(void) mymacmethod __OSX_AVAILABLE_STARTING(__MAC_10_5,__IPHONE_NA);
@end 一个枚举变量在IOS 2.1及其以后版本可用，但是在MAC OS中是不可用的
#if __IPHONE_OS_VERSION_MIN_REQUIRED >= 20100 enum { myEnum = 1 }; #endif
笔记：这个枚举在MAC OS平台上是起作用的因为
__IPHONE_OS_VERSION_MIN_REQUIRED没有定义，这个值为0,所以＃if 0>20100为错。同时，我们用20100代替__IPHone_2_1是安全的，
__IPHONE_2_1在2.1SDK以前的中是不存在的。所以，用于以前的版本的时候，这将是不正确的。
在源代码中使用*_VERSION_MIN_REQUIRED也是可能的，使某个源代码在目标的系统下是可编译的。最好是不要用
_MAC_*和__IPHONE_*宏来做比较，而是用他们的所定义的值。这是因为在低版本的环境中没用定义那个宏。
在C的预编译中这个宏将表示为0,这将导致在＃if表达式中造成错误。
#ifdef __MAC_OS_X_VERSION_MIN_REQUIRED
// code only compiled when targeting Mac OS X and not iPhone
// note use of 1050 instead of __MAC_10_5
#if __MAC_OS_X_VERSION_MIN_REQUIRED < 1050
//在这里编写适用于雪豹系统之前的版本的代码
#else
//在这里编写适用于雪豹系统之后的版本的代码
#endif
#endif
*/
#define__MAC_10_01000
#define__MAC_10_11010
#define__MAC_10_21020
#define__MAC_10_31030
#define__MAC_10_41040
#define__MAC_10_51050
#define__MAC_10_61060
#define__MAC_NA9999/* not available */
#define__IPHONE_2_020000
#define__IPHONE_2_120100
#define__IPHONE_2_220200
#define__IPHONE_3_030000
#define__IPHONE_NA99999/* not available */
#include
#ifdef__IPHONE_OS_VERSION_MIN_REQUIRED
#define __OSX_AVAILABLE_STARTING(_mac, _iphone) __AVAILABILITY_INTERNAL##_iphone
#define __OSX_AVAILABLE_BUT_DEPRECATED(_macIntro, _macDep, _iphoneIntro, _iphoneDep) \
__AVAILABILITY_INTERNAL##_iphoneIntro##_DEP##_iphoneDep
#elifdefined(__MAC_OS_X_VERSION_MIN_REQUIRED)
#define __OSX_AVAILABLE_STARTING(_mac, _iphone) __AVAILABILITY_INTERNAL##_mac
#define __OSX_AVAILABLE_BUT_DEPRECATED(_macIntro, _macDep, _iphoneIntro, _iphoneDep) \
__AVAILABILITY_INTERNAL##_macIntro##_DEP##_macDep
#else
#define __OSX_AVAILABLE_STARTING(_mac, _iphone)
#define __OSX_AVAILABLE_BUT_DEPRECATED(_macIntro, _macDep, _iphoneIntro, _iphoneDep)
#endif
#endif/* __AVAILABILITY__ */
网友评论