iPhoneX/iOS11最新适配指南

iPhone发布会前，就隐隐感觉到一波适配工作要袭来的赶脚，果然不出所料。

新版iPhone的适配工作主要集中在iPhoneX上，相信大家已经对iPhoneX的刘海记忆深刻了，除了吐槽，留给我们的还有比较麻烦的适配工作。下面简单分享下在整理过程中发现的适配注意点。(适配工作主要在UI方面，后续发现的适配点会陆续补充到该文档中)

iPhoneX 375x812尺寸图

上下黑边问题

运行新版Xcode的iPhoneX模拟器，你可能发现之前的APP在iPhoneX屏幕没填充满，上下有黑色区域，应该是你的app之前未用LaunchScreen.Storyboard作为启动页面，可以使用LaunchScreen来当做入场页面，这样APP才会自动适配为iPhoneX的大小。或者修改Assets中的LaunchImage，添加iPhoneX的Launch图如下(1125*2436)。

LaunchImage适配

iOS11新增版本判断API

iOS11版本现在有了简单的API，不用再手写iOS版本判断了。

if (@available(iOS 11.0, *)) {

// 版本适配

}

// 或者

#ifdef __IPHONE_11_0

#endif

目前没发现有iPhoneX的机型判断API，暂时可以使用size来做代替判断。

#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的底部增加了虚拟Homeq区，由于安全区域的原因默认tabBar的高度由49变为83，增高了34，所以自定义的底部TabBar也需要需改其适配方案。

可能有部分APP使用了RN来实现页面，不要忘了在RN中修改相应NaviBar/TabBar的高度。

iPhoneX尺寸

安全区域

安全区域定义了view中可视区域的部分，帮助我们将view放置在整个屏幕的可视的部分。即使把navigationbar设置为透明的，系统也认为安全区域是从navigationbar的bottom开始的。这样保证不被系统的状态栏、或父视图提供的view如导航栏覆盖。

安全区域

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如下：

1. biometryType属性返回当前设备支持的生物学特征验证方式，他的值可以分别为typeFaceID、typeTouchID或者none。
2. localizedReason需要验证时展示在弹框上的提示信息
3. 
   
4. 
   

参考文档

https://developer.apple.com/videos/fall2017/

https://developer.apple.com/iphone/

http://www.jianshu.com/p/0ec6a98302c3

作者：fighting300

原文地址： http://fighting300.github.io/2017/09/14/iOS11-UI-adjust/

链接：http://www.jianshu.com/p/c34425442d5e

来源：简书