iPhone发布会前,就隐隐感觉到一波适配工作要袭来的赶脚,果然不出所料。
新版iPhone的适配工作主要集中在iPhoneX上,相信大家已经对iPhoneX的刘海记忆深刻了,除了吐槽,留给我们的还有比较麻烦的适配工作。下面简单分享下在整理过程中发现的适配注意点。(适配工作主要在UI方面,后续发现的适配点会陆续补充到该文档中)
上下黑边问题
运行新版Xcode的iPhoneX模拟器,你可能发现之前的APP在iPhoneX屏幕没填充满,上下有黑色区域,应该是你的app之前未用LaunchScreen.Storyboard作为启动页面,可以使用LaunchScreen来当做入场页面,这样APP才会自动适配为iPhoneX的大小。或者修改Assets中的LaunchImage,添加iPhoneX的Launch图如下(1125*2436)。
iOS11新增版本判断API
iOS11版本现在有了简单的API,OC也开始支持swfit的@available语法,不用再手写iOS版本判断了。
if (@available(iOS 11.0, *)) {
//版本适配
}
//或者
#ifdef __IPHONE_11_0
#endif
目前没发现有iPhoneX的机型判断API,暂时可以使用size来做代替判断。
//判断是否iPhone X
#define IS_iPhoneX ([UIScreen instancesRespondToSelector:@selector(currentMode)] ? CGSizeEqualToSize(CGSizeMake(1125, 2436), [[UIScreen mainScreen] currentMode].size) : NO)
//或者
#define kDevice_iPhoneX CGSizeEqualToSize(CGSizeMake(375, 812), [[UIScreen mainScreen] bounds].size)
//或者
if ([UIScreen mainScreen].bounds.size.height == 812) {
NSLog(@"this is iPhone X");
}
UI适配
导航栏适配
iPhoneX由于多了大圆角、传感器(齐刘海)以及底部访问主屏幕的指示遮挡,所以需要注意原有这部分内容的设计。
iOS11前导航栏的高度是64,其中statusBar的高度为20,而iPhoneX的statusBar高度变为了44,如果是自定义的NaviBar,这部分需要做相应的适配。
iPhoneX的底部增加了虚拟Home区,由于安全区域的原因默认tabBar的高度由49变为83,增高了34,所以自定义的底部TabBar也需要需改其适配方案。
可能有部分APP使用了RN来实现页面,不要忘了在RN中修改相应NaviBar/TabBar的高度。
[图片上传中...(image-b5608-1526548047385-1)]
安全区域
安全区域定义了view中可视区域的部分,帮助我们将view放置在整个屏幕的可视的部分。即使把navigationbar设置为透明的,系统也认为安全区域是从navigationbar的bottom开始的。这样保证不被系统的状态栏、或父视图提供的view如导航栏覆盖。
[图片上传中...(image-7c2da3-1526548047385-0)]
iOS11的UIViewController和UIView新加了-(void)viewSafeAreaInsetsDidChange
方法,当安全区域改变后该方法会被调用。然后在该方法中根据safeAreaInses属性更新子视图中控件的布局位置。
当然如果你要改变一个UIViewController的safeAreaInsets值, 可以通过设置addtionalSafeAreaInsets
属性来实现, 例如你要自定义一些特殊的样式时。
需要注意的是viewSafeAreaInsetsDidChange在UIViewController中第一次调用的时间是在-(void)viewWillAppear:(BOOL)animated
调用之后, 在- (void)viewWillLayoutSubviews
调用之前。所以可以在viewWillAppear里设置受影响的页面的addtionalSafeAreaInsets属性。
- (void)viewSafeAreaInsetsDidChange{
[super viewSafeAreaInsetsDidChange];
if (@available(iOS 11.0, *)) {
NSLog(@"safeAreaInset list= %@",NSStringFromUIEdgeInsets(self.view.safeAreaInsets));
NSLog(@"safeAreaLayout list= %@",self.view.safeAreaLayoutGuide);
}
}
UIScrollView & UITableView
测试过程中发现tableView会有20pt/64pt的偏移,其原因是由于iOS 11废弃了UIViewController的automaticallyAdjustsScrollViewInsets属性,新增了contentInsetAdjustmentBehavior属性,所以当超出安全区域时系统自动调整了SafeAreaInsets,进而影响了adjustedContentInset,在iOS11中决定tableView内容与边缘距离的是adjustedContentInset,所以需要设置UIScrollView的contentInsetAdjustmentBehavior属性。
1.手动适配
如果你使用了UITableView、UIScrollView,可以直接使用以下代码做适配,这样系统就不会主动为你设置边缘距离,但是你可能需要手动适配UITableView的contenteInset。
#ifdef __IPHONE_11_0
// 单独作用与某个tableView
if ([tableView respondsToSelector:@selector(setContentInsetAdjustmentBehavior:)]) {
tableView.contentInsetAdjustmentBehavior = UIScrollViewContentInsetAdjustmentNever;
}
// 作用与所有的UIScrollView
UIScrollView.appearance.contentInsetAdjustmentBehavior = UIScrollViewContentInsetAdjustmentNever;
// 设置view的宽高
tableView.contentInset = UIEdgeInsetsMake(0, 0, 34, 0);
#endif
2.自动适配
设置contentInsetAdjustmentBehavior属性为UIScrollViewContentInsetAdjustmentAutomatic,则系统会自动计算contentView的偏移量。
3.设置安全区域的addtionalSafeAreaInset
某些情况下,你需要顶部区域,比如广告区域覆盖Status,则可以设置相应页面的addtionalSafeAreaInset属性,这样系统不会将safeArea上调到从status开始。这样可以提供更好的用户体验。
例如如果你的SafeAreaInset值为(44,0,0,0),则需要设置相应的additionalSafeAreaInsets值为(-44,0,0,0)。
if (@available(iOS 11.0, *)) {
self.additionalSafeAreaInsets = UIEdgeInsetsMake(-44, 0, 0, 0);
} else {
// Fallback on earlier versions
}
4.iOS11开始UITableView开启了自动估算行高,estimatedRowHeight estimatedSectionHeaderHeight estimatedSectionFooterHeight三个高度估算属性由默认的0变成了UITableViewAutomaticDimension,所以heightForHeaderInSection和viewForHeaderInSection应该一起使用,不然tableView顶部滑动的时候会有空白。
在适配过程中发现UITableView会在Header/Footer返回size为负值的情况下会(之前遗漏的bug)崩溃,这块可以自查下,而iOS11之前的版本不会。
其他方案……
另外有人对iPhoneX整个UIWindow做了内容的调整,只是UI还是有点丑,感兴趣的同学可以去看看该GitHub,不过可能这样的设计方案不会通过APPLE的审核。
API适配
LocalAuthentication 本地认证
本地认证框架提供了从具有指定安全策略(密码或生物学特征)的用户请求身份验证的功能。例如,要求用户仅使用Face ID或Touch ID进行身份验证,可使用以下代码:
let myContext = LAContext()
let myLocalizedReasonString = <#String explaining why app needs authentication#>
var authError: NSError?
if #available(iOS 8.0, macOS 10.12.1, *) {
if myContext.canEvaluatePolicy(.deviceOwnerAuthenticationWithBiometrics, error: &authError) {
myContext.evaluatePolicy(.deviceOwnerAuthenticationWithBiometrics, localizedReason: myLocalizedReasonString) { success, evaluateError in
if success {
// 用户验证通过
} else {
// 用户验证失败,处理失败信息
}
}
} else {
// 不能执行策略验证,处理验证错误信息
}
} else {
// Fallback on earlier versions
}
LAContext新增API如下:
- biometryType属性返回当前设备支持的生物学特征验证方式,他的值可以分别为typeFaceID、typeTouchID或者none。
- localizedReason需要验证时展示在弹框上的提示信息
参考文档
- https://developer.apple.com/videos/fall2017/
- https://developer.apple.com/iphone/
- https://developer.apple.com/ios/human-interface-guidelines/overview/iphone-x/
Tips
iPhone X 侧边按钮的使用方式:
- 按一下锁屏;
- 按两下 Apple Pay;
- 按三下辅助功能快捷键(比如 VoiceOver);
- 按五下 SOS;
- 短按 Siri;
- 长按关机;
- 按一下+Volume Up 截屏。