前言
最近封装AFN的时候发现在.h文件中总是出现这种警告:
这个东西虽然不影响编译和运行,但看起来总让人不舒服。
为什么会出现这种警告?
我们都知道在swift中,可以使用!和?来表示一个对象是optional的还是non-optional,如view?和view!。而在Objective-C中则没有这一区分,view既可表示这个对象是optional,也可表示是non-optioanl。这样就会造成一个问题:在Swift与Objective-C混编时,Swift编译器并不知道一个Objective-C对象到底是optional还是non-optional,因此这种情况下编译器会隐式地将Objective-C的对象当成是non-optional。
为了解决这个问题,苹果在Xcode 6.3引入了一个Objective-C的新特性:nullability annotations。这一新特性的核心是两个新的类型注释:__nullable和__nonnull。从字面上我们可以猜到,__nullable表示对象可以是NULL或nil,而__nonnull表示对象不应该为空。当我们不遵循这一规则时,编译器就会给出警告。
——摘自会报编译器警告的Xcode 6.3新特性:Nullability Annotations
如何解决这些警告?
根据Xcode的提示一个一个fix?可是可以但未免太繁琐。苹果为开发者提供了两个宏:
NS_ASSUME_NONNULL_BEGIN
NS_ASSUME_NONNULL_END
在这两个宏里的参数默认不可空,如果想改成可空,可以添加nullable
,如:
- (nullable NSURLSessionDataTask *)GET:(NSString *)URLString
parameters:(nullable id)parameters
progress:(nullable void (^)(NSProgress *downloadProgress))downloadProgress
success:(nullable void (^)(NSURLSessionDataTask *task, id _Nullable responseObject))success
failure:(nullable void (^)(NSURLSessionDataTask * _Nullable task, NSError *error))failure;
其中URLString
不可空(默认nonnull
),parameters
和downloadProgress
等用nullable
修饰的可空。
如果给URLString
赋值nil,Xcode会警告:
如何使用?
这是最关键的。
我觉得参考优秀开源库是比较实在的方法,比如AFNetworking
就大量用到NS_ASSUME_NONNULL_BEGIN
和NS_ASSUME_NONNULL_END
,你可以看看AFHTTPSessionManager.h
这个文件是怎么使用那两个宏的:
NS_ASSUME_NONNULL_BEGIN
@interface AFHTTPSessionManager : AFURLSessionManager <NSSecureCoding, NSCopying>
- (nullable NSURLSessionDataTask *)GET:(NSString *)URLString
parameters:(nullable id)parameters
progress:(nullable void (^)(NSProgress *downloadProgress))downloadProgress
success:(nullable void (^)(NSURLSessionDataTask *task, id _Nullable responseObject))success
failure:(nullable void (^)(NSURLSessionDataTask * _Nullable task, NSError *error))failure;
@end
NS_ASSUME_NONNULL_END
其实不只是AFHTTPSessionManager .h
文件,AFNetworking中的其他头文件如AFNetworkReachabilityManager.h
等也是这样处理的:
在@interface
前加上NS_ASSUME_NONNULL_BEGIN
,在@end
后加上NS_ASSUME_NONNULL_END
,可空的参数就给它加上nullable
。
更多相关知识可以查阅官方文档:
https://developer.apple.com/swift/blog/?id=25
2018年2月11日更新
如果你觉得AFN不够有说服力,那你可以看下苹果自己的API,比如UISwitch
:
NS_ASSUME_NONNULL_BEGIN
NS_CLASS_AVAILABLE_IOS(2_0) __TVOS_PROHIBITED @interface UISwitch : UIControl <NSCoding>
@property(nullable, nonatomic, strong) UIColor *onTintColor NS_AVAILABLE_IOS(5_0) UI_APPEARANCE_SELECTOR;
@property(null_resettable, nonatomic, strong) UIColor *tintColor NS_AVAILABLE_IOS(6_0);
@property(nullable, nonatomic, strong) UIColor *thumbTintColor NS_AVAILABLE_IOS(6_0) UI_APPEARANCE_SELECTOR;
@property(nullable, nonatomic, strong) UIImage *onImage NS_AVAILABLE_IOS(6_0) UI_APPEARANCE_SELECTOR;
@property(nullable, nonatomic, strong) UIImage *offImage NS_AVAILABLE_IOS(6_0) UI_APPEARANCE_SELECTOR;
@property(nonatomic,getter=isOn) BOOL on;
- (instancetype)initWithFrame:(CGRect)frame NS_DESIGNATED_INITIALIZER; // This class enforces a size appropriate for the control, and so the frame size is ignored.
- (nullable instancetype)initWithCoder:(NSCoder *)aDecoder NS_DESIGNATED_INITIALIZER;
- (void)setOn:(BOOL)on animated:(BOOL)animated; // does not send action
@end
NS_ASSUME_NONNULL_END
注意看它是怎么使用NS_ASSUME_NONNULL_BEGIN
和NS_ASSUME_NONNULL_END
的。
网友评论