iOS常见系统宏 ing...

未完，以后遇见新的继续加
2018.12.4 增加9，10，11。最近几个月真的是忙，公司有毒。几个项目一起搞，还只有我一个人。

1. 方法在Mac和iOS上使用的最低版本

   • @avalibale同步判断当前iOS系统是否满足需求。 ==这个方法可能用到==

     if (@available(iOS 11, *)) { // >= 11
         NSLog(@"XXX1");
     } else if (@available(iOS 10, *)) { //>= 10
         NSLog(@"XXX2");
     } else { // < 10
         NSLog(@"XXX3");
     }  
     

   • 如果是对方法的声明 添加API_AVAILABLE(macos(10.5),ios(11)) ，就不用再方法里面做系统版本判断了，错用会有警告提示。

2. 方法在哪个版本弃用了

   • NS_DEPRECATED_IOS(2_0,6_0) 前面2_0代表iOS系统，表示这个方法被引用时的iOS版本，后面6_0代表iOS系统，表示这个方法被弃用时的iOS版本。被弃用并不是指这个方法就不存在，它会告诉用户去使用新方法

3. 方法被弃用了 ==这个方法可能用到==

   • DEPRECATED_ATTRIBUTE 它会告诉编译器该方法被弃用了

   • DEPRECATED_MSG_ATTRIBUTE(s) 它会告诉编译器该方法被弃用了，后面s 代表提示

   • __deprecated_msg(_msg) 它会告诉编译器该方法被弃用了，后面_msg代表提示

4. 判断当前设备是模拟器还是真机

   #if TARGET_IPHONE_SIMULATOR
   // 模拟器
   #elif TARGET_OS_IPHONE
   // 真机
   #endif
   

5. 判断当前设备系统

   #if __IPHONE_OS_VERSION_MAX_ALLOWED >= __IPHONE_8_0
       // 这里写设备系统大于8.0 以上的代码
   #else
       // 这里写设备系统小于8.0以上的代码
   #endif
   
   
   #if __IPHONE_OS_VERSION_MIN_REQUIRED <= __IPHONE_7_0
       // 这里写设备系统小于7.0以上的代码
   #else
       // 这里写设备系统大于7.0以上的代码
   #endif
   

6. 日志输出

   #ifdef DEBUG
   #define HTLog(...) NSLog(__VA_ARGS__)
   #else
   #define HTLog(...)
   #endif
   //此示例的DEBUG不唯一，如果定义了多个target可以去自定义
   

7. 指定初始化方法NS_DESIGNATED_INITIALIZER

   即接收参数最多的那个初始化方法，其他初始化方法调用它即可，这样设计的目的是为了保证所有初始化方法都正确地初始化实例变量。
   在方法后面加上NS_DESIGNATED_INITIALIZER宏即可。这样，当你子类化这个类时，在子类的初始化方法里如果没有正确地调用父类的designated initializer，编译器就会给出警告。
   实例代码：

   @interface WKWebView : UIView
   - (instancetype)initWithFrame:(CGRect)frame configuration:(WKWebViewConfiguration *)configuration NS_DESIGNATED_INITIALIZER;
   - (nullable instancetype)initWithCoder:(NSCoder *)coder NS_DESIGNATED_INITIALIZER;
   @end
   

8. 申明子类如果重写该方法，必须调用该父类方法 NS_REQUIRES_SUPER
   在子类重写的父类方法中，必须调用[super functionName],否则编译器会发出警告

9. __has_include：用来检查Frameworks是否引入某个类

   #if __has_include()
   #import 
   #import 
   #import 
   #elif __has_include()
   #import 
   #import 
   #import 
   #else
   #import "YYMemoryCache.h"
   #import "YYDiskCache.h"
   #import "YYKVStorage.h"
   #endif
   

10. 接口中 nullable 的是少数,一般都为nonnull,为了防止写一大堆 nonnull，Foundation提供了一对宏NS_ASSUME_NONNULL_BEGIN、NS_ASSUME_NONNULL_END，包在里面的对象默认加 nonnull 修饰符，如果是nullable的,只需要把 nullable 的指出来就行

    NS_ASSUME_NONNULL_BEGIN
    @interface YYCache : NSObject
    ...
    - (nullable instancetype)initWithName:(NSString *)name;
    ...
    @end
    NS_ASSUME_NONNULL_END
    

11. UNAVAILABLE_ATTRIBUTE告诉编译器该方法失效

    • 系统中的定义：
      #define UNAVAILABLE_ATTRIBUTE __attribute__((unavailable))

    • attribute是Clang提供的一种源码注解，方便开发者向编译器表达某种要求,括号里是传达某种命令. 为方便使用，一些常用属性也被Cocoa定义成宏, 比如UNAVAILABLE_ATTRIBUTE、NS_CLASS_AVAILABLE_IOS(9_0). unavailable告诉编译器该方法失效. 在封装单例或初始化某个类前必须做一些事时,对一些方法禁用是非常不错的选择. 还可以给个message提示:

      + (instancetype)alloc __attribute__((unavailable("alloc方法不可用，请用initWithName:")));
      - (instancetype)init __attribute__((unavailable("init方法不可用，请用initWithName:")));
      + (instancetype)new __attribute__((unavailable("new方法不可用，请用initWithName:")));
      - (instancetype)copy __attribute__((unavailable("copy方法不可用，请用initWithName:")));