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

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

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

1、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)。

2、 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值的影響。

3、什麼狀況下的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}

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

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值。

5、遇到的另一個與安全區域無關的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;