[置顶] Avaliability.h(译)

 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以前的<Availability.h>中是不存在的。所以，用于以前的版本的时候，这将是不正确的。

        在源代码中使用 *_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_0      1000

#define __MAC_10_1      1010

#define __MAC_10_2      1020

#define __MAC_10_3      1030

#define __MAC_10_4      1040

#define __MAC_10_5      1050

#define __MAC_10_6      1060

#define __MAC_NA        9999  /* not available */

#define __IPHONE_2_0     20000  

#define __IPHONE_2_1     20100  

#define __IPHONE_2_2     20200  

#define __IPHONE_3_0     30000  

#define __IPHONE_NA      99999 /* not available */

#include<AvailabilityInternal.h>

#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

#elif defined(__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__ */