《iOS 11 安全區域適配總結》

本文來自於騰訊Bugly公眾號（weixinBugly），作者：sonialiu，未經作者同意，請勿轉載，原文地址：http://mp.weixin.qq.com/s/W1_0VrchCO50owhJNmJnuQ

| 導語 本文主要是對iOS 11下企鵝 FM APP中tableView內容下移20pt或下移64pt的問題適配的一個總結。內容包括五個部分：問題的原因分析、adjustContentInset屬性的計算方式、什麼情況下的tableView會發生內容下移、有哪些解決方法、解決這個問題時遇到的另外一個小問題。

一、iOS 11下APP中tableView內容下移20pt或下移64pt的原因分析

問題如下圖所示：
http://img.blog.csdn.net/20170926095658997?watermark/2/text/aHR0cDovL2Jsb2cuY3Nkbi5uZXQvVGVuY2VudF9CdWdseQ==/font/5a6L5L2T/fontsize/400/fill/I0JBQkFCMA==/dissolve/70/gravity/SouthEast

1. 原因分析

原因是iOS 11中Controller的automaticallyAdjustsScrollViewInsets屬性被廢棄了，所以當tableView超出安全區域時系統自動調整了SafeAreaInsets值，進而影響adjustedContentInset值，在iOS 11中決定tableView的內容與邊緣距離的是adjustedContentInset屬性，而不是contentInset。adjustedContentInset的計算方式見本文第二部分內容。因為系統對adjustedContentInset值進行了調整，所以導致tableView的內容到邊緣的距離發生了變化，導致tableView下移了20pt（statusbar高度）或64pt（navigationbar高度）。

如果你的APP中使用的是自定義的navigationbar，隱藏掉系統的navigationbar，並且tableView的frame為(0,0,SCREENWIDTH, SCREENHEIGHT)開始，那麼系統會自動調整SafeAreaInsets值為(20,0,0,0)，如果使用了系統的navigationbar，那麼SafeAreaInsets值為(64,0,0,0)，如果也使用了系統的tabbar，那麼SafeAreaInsets值為(64,0,49,0)。關於什麼情況下會發生內容下移的問題，本文第三部分有介紹。

2. 安全區域的概念

系統自動調整tableView內容偏移量，是根據安全區域來調整的。安全區域是iOS 11新提出的，如下圖所示：
http://img.blog.csdn.net/20170926100519768?watermark/2/text/aHR0cDovL2Jsb2cuY3Nkbi5uZXQvVGVuY2VudF9CdWdseQ==/font/5a6L5L2T/fontsize/400/fill/I0JBQkFCMA==/dissolve/70/gravity/SouthEast

安全區域幫助我們將view放置在整個屏幕的可視的部分。即使把navigationbar設置為透明的，系統也認為安全區域是從navigationbar的bottom開始，保證不被系統的狀態欄、或導航欄覆蓋。可以使用additionalSafeAreaInsets去擴展安全區域使它包括自定義的content在界面上。每個view都可以改變安全區域嵌入的大小，Controller也可以。

safeAreaInsets屬性反映了一個view距離該view的安全區域的邊距。對於一個Controller的根視圖而言，SafeAreaInsets值包括了被statusbar和其他可視的bars覆蓋的區域和其他通過additionalSafeAreaInsets自定義的insets值。view層次中的其它view，SafeAreaInsets值反映了該view被覆蓋的部分。如果一個view全部在它父視圖的安全區域內，則SafeAreaInsets值為(0,0,0,0)。

二、 adjustContentInset屬性的計算方式

首先看scrollView在iOS11新增的兩個屬性：adjustContentInset 和 contentInsetAdjustmentBehavior。

/* Configure the behavior of adjustedContentInset.

Default is UIScrollViewContentInsetAdjustmentAutomatic.
*/@property(nonatomic) UIScrollViewContentInsetAdjustmentBehavior contentInsetAdjustmentBehavior
adjustContentInset表示contentView.frame.origin偏移了scrollview.frame.origin多少；是系統計算得來的，計算方式由contentInsetAdjustmentBehavior決定。有以下幾種計算方式：

1.UIScrollViewContentInsetAdjustmentAutomatic：如果scrollview在一個automaticallyAdjustsScrollViewContentInset = YES的controller上，並且這個Controller包含在一個navigation controller中，這種情況下會設置在top & bottom上 adjustedContentInset = safeAreaInset + contentInset不管是否滾動。其他情況下與UIScrollViewContentInsetAdjustmentScrollableAxes相同

2.UIScrollViewContentInsetAdjustmentScrollableAxes: 在可滾動方向上adjustedContentInset = safeAreaInset + contentInset，在不可滾動方向上adjustedContentInset = contentInset；依賴於scrollEnabled和alwaysBounceHorizontal / vertical = YES，scrollEnabled預設為yes，所以大多數情況下，計算方式還是adjustedContentInset = safeAreaInset + contentInset

3.UIScrollViewContentInsetAdjustmentNever: adjustedContentInset = contentInset

4.UIScrollViewContentInsetAdjustmentAlways: adjustedContentInset = safeAreaInset + contentInset

當contentInsetAdjustmentBehavior設置為UIScrollViewContentInsetAdjustmentNever的時候，adjustContentInset值不受SafeAreaInset值的影響。

三、什麼情況下的tableView會發生上述問題

如果設置了automaticallyAdjustsScrollViewInsets = YES，那麼不會發生問題，一直都是由系統來調整內容的偏移量。

接下來排查下自己的項目中哪些頁面會發生以上問題。

當tableView的frame超出安全區域範圍時，系統會自動調整內容的位置，SafeAreaInsets值會不為0，於是影響tableView的adjustContentInset值，於是影響tableView的內容展示，導致tableView的content下移了SafeAreaInsets的距離。SafeAreaInsets值為0時，是正常的情況。

需要瞭解每個頁面的結構，看tableView是否被系統的statusbar或navigationbar覆蓋，如果被覆蓋的話，則會發生下移。也可以通過tableview.safeAreaInsets的值來確認是因為安全區域的問題導致的內容下移。

如下代碼片段，可以看出系統對tableView向下調整了20pt的距離，因為tableView超出了安全區域範圍，被statusbar覆蓋。

tableview.contentInset: {64, 0, 60, 0}

tableview.safeAreaInsets: {20, 0, 0, 0}

tableview.adjustedContentInset: {84, 0, 60, 0}

四、這個問題的解決方法有哪些？

1. 重新設置tableView的contentInset值，來抵消掉SafeAreaInset值，因為內容偏移量 = contentInset + SafeAreaInset；

如果之前自己設置了contentInset值為(64,0,0,0),現在系統又設置了SafeAreaInsets值為(64,0,0,0)，那麼tableView內容下移了64pt，這種情況下，可以設置contentInset值為(0,0,0,0)，也就是遵從系統的設置了。

2. 設置tableView的contentInsetAdjustmentBehavior屬性

如果不需要系統為你設置邊緣距離，可以做以下設置：

 //如果iOS的系統是11.0，會有這樣一個巨集定義“#define __IPHONE_11_0  110000”；如果系統版本低於11.0則沒有這個巨集定義#ifdef __IPHONE_11_0   
if ([tableView respondsToSelector:@selector(setContentInsetAdjustmentBehavior:)]) {
    tableView.contentInsetAdjustmentBehavior = UIScrollViewContentInsetAdjustmentNever;
}
#endif

contentInsetAdjustmentBehavior屬性也是用來取代automaticallyAdjustsScrollViewInsets屬性的，推薦使用這種方式。

3. 通過設置iOS 11新增的屬性addtionalSafeAreaInset；

iOS 11之前，大家是通過將Controller的automaticallyAdjustsScrollViewInsets屬性設置為NO，來禁止系統對tableView調整contentInsets的。如果還是想從Controller級別解決問題，那麼可以通過設置Controller的additionalSafeAreaInsets屬性，如果SafeAreaInset值為(20,0,0,0)，那麼設置additionalSafeAreaInsets屬性值為(-20,0,0,0)，則SafeAreaInsets不會對adjustedContentInset值產生影響，tableView內容不會顯示異常。這裡需要註意的是addtionalSafeAreaInset是Controller的屬性，要知道SafeAreaInset的值是由哪個Controller引起的，可能是由自己的Controller調整的，可能是navigationController調整的。是由哪個Controller調整的，則設置哪個Controller的addtionalSafeAreaInset值來抵消掉SafeAreaInset值。

五、遇到的另外一個與安全區域無關的tableView內容下移的問題

我的作品頁面的tableView下移了約40pt，這裡是否跟安全區域有關呢？
http://img.blog.csdn.net/20170926100650727?watermark/2/text/aHR0cDovL2Jsb2cuY3Nkbi5uZXQvVGVuY2VudF9CdWdseQ==/font/5a6L5L2T/fontsize/400/fill/I0JBQkFCMA==/dissolve/70/gravity/SouthEast

查了下頁面結構，tableView的父視圖的frame在navigationbar的bottom之下，tableView在父視圖的安全區域內，列印出來tableView的SafeAreaInset值也是(0，0，0，0);所以不是安全區域導致的內容下移。

經過查看代碼，發現tableView的style:UITableViewStyleGrouped類型，預設tableView開頭和結尾是有間距的，不需要這個間距的話，可以通過實現heightForHeaderInSection方法（返回一個較小值：0.1）和viewForHeaderInSection（返回一個view）來去除頭部的留白，底部同理。

iOS 11上發生tableView頂部有留白，原因是代碼中只實現了heightForHeaderInSection方法，而沒有實現viewForHeaderInSection方法。那樣寫是不規範的，只實現高度，而沒有實現view，但代碼這樣寫在iOS 11之前是沒有問題的，iOS 11之後應該是由於開啟了估算行高機制引起了bug。添加上viewForHeaderInSection方法後，問題就解決了。或者添加以下代碼關閉估算行高，問題也得到解決。

self.tableView.estimatedRowHeight = 0;

self.tableView.estimatedSectionHeaderHeight = 0;

self.tableView.estimatedSectionFooterHeight = 0;