最近接入第三方 SDK 時碰到個蛋疼的 bug。
前提:
- 當(dāng)前項目在基類 VC 中使用屬性
hidesNavigationBarWhenPush
來標(biāo)識是否顯示導(dǎo)航欄; - 基類 VC 中,在 willAppear 中使用
[self.navigationController setNavigationBarHidden:self.hidesNavigationBarWhenPush animated:animated];
來控制導(dǎo)航欄的顯示和隱藏;
Bug
- 某個 parentVC 中包含兩個 childVC,3個 VC 都使用
self. hidesNavigationBarWhenPush = NO
來顯示導(dǎo)航欄:
parentVC
parentVC 代碼如下:
- (void)viewDidLoad {
[super viewDidLoad];
self.hidesNavigationBarWhenPush = NO;
self.navigationItem.rightBarButtonItem = self.rigthBarBtnItem;
self.navigationItem.titleView = self.titleView;
[self.titleView setSelectedItemIndex:self.selectedIndex subItemIndex:0];
}
- 跳轉(zhuǎn)到第三方 SDK 的 VC 之后,pop 回 mainVC,導(dǎo)航欄就不顯示了;
-
第三方 SDK 的容器 VC 繼承自第三方 SDK 的基類VC:
VC
解決
Bug 的解決倒是很簡單,在第三方SDK的容器VC中添加:
- (void)viewWillDisappear:(BOOL)animated {
[super viewWillDisappear:animated];
// 內(nèi)部sdk直接把navigationBar隱藏了,要在pop之后顯示
self.navigationController.navigationBar.hidden = NO;
}
原因
其實原因也很簡單,就是第三方 SDK 未采用 apple 推薦的方法來控制導(dǎo)航欄的顯示和隱藏:
@property(nonatomic,getter=isNavigationBarHidden) BOOL navigationBarHidden;
- (void)setNavigationBarHidden:(BOOL)hidden animated:(BOOL)animated; // Hide or show the navigation bar. If animated, it will transition vertically using UINavigationControllerHideShowBarDuration.
從上面的說明中可以看出,Apple 很清楚地說明了只能通過 navigationBarHidden 或者 setNavigationBarHidden:animated: 來控制 navigationBar 的顯示和隱藏,兩種方式的區(qū)別在于一個能控制動畫,一個是無動畫效果的;
Apple 的這種邏輯其實也能理解,因為導(dǎo)航欄的顯示不僅僅是 navigationBar.hidden 就能決定的,比如 title 的設(shè)定、willAppear 方法中的控制、父子控制器中導(dǎo)航欄的邏輯等。雖然最終 Apple 也是通過所以 navigationBar.hidden = YES/NO 來設(shè)置的,但是 Apple 屏蔽了 Nav、TabVC、ChildVC 等許多邏輯,如果直接調(diào)用 navigationBar.hidden = YES/NO ,則會破壞內(nèi)部的邏輯順序,導(dǎo)致系統(tǒng)的導(dǎo)航欄隱藏/顯示邏輯失效,出現(xiàn)一些奇怪的 Bug;
而三方 SDK 內(nèi)部是通過 self.navigationController.navigationBar.hidden = YES
來暴力強(qiáng)制地直接隱藏了導(dǎo)航欄。
三方 SDK 這么做也有其道理,因為 SDK 會被很多公司的項目引用,難免會遇到一些不同的場景,某些場景下,如果甲方項目也沒有按照 Apple 的正規(guī)流程來設(shè)置導(dǎo)航欄的隱藏和顯示,那么就會吃屎。估計是這么做也是為了強(qiáng)制隱藏導(dǎo)航欄。
總結(jié):
- 三方SDK通過
navigationBar.hidden = YES;
隱藏了導(dǎo)航欄; - 在三方SDK的容器VC將要消失之前,設(shè)置
navigationBar.hidden = NO;
即可;
疑問:
其實這里還有個疑問,雖然設(shè)置了 navigationBar.hidden = YES;
,但是當(dāng)返回到 parentVC 時,willAppear 方法里面肯定是是會調(diào)用導(dǎo)航欄顯示代碼的:
// self.hidesNavigationBarWhenPush = NO;
[self.navigationController setNavigationBarHidden:self.hidesNavigationBarWhenPush animated:animated];
那為什么不能正常顯示呢?
接著往下看......
還沒完呢
就 bug 而言,其意義在于規(guī)范一下 navigationBar 的使用,但是這里有一個奇怪的現(xiàn)象,從前提中可知道,mainVC 中采用 childVC 的方式來組織視圖,而如果 mainVC 中去掉以下代碼:
- (void)viewDidLoad {
[super viewDidLoad];
// self.hidesNavigationBarWhenPush = NO;
self.navigationItem.rightBarButtonItem = self.rigthBarBtnItem;
self.navigationItem.titleView = self.titleView;
[self.titleView setSelectedItemIndex:self.selectedIndex subItemIndex:0];
}
這樣修改后,不需要額外代碼,Bug 就沒有了;
那么原因是什么呢?其實這個原因和上文的疑問本質(zhì)原因是一樣的,就是:
[self.navigationController setNavigationBarHidden:animated:];
方法內(nèi)部會判斷 Hidden 是否發(fā)生了改變,如果未改變,直接 return;
偽代碼如下:
- (void)setNavigationBarHidden:(BOOL)hidden animated:(BOOL)animated {
if(self.hidden == hidden) return;
// other code...
}
其實 iOS12 之后就有很多這種代碼保護(hù),比如之前碰到 App 的換膚功能,在換膚之后,View 的 backgroundColor 更新不及時。因為我們項目中自定義了 color 對象,使用同一個對象表示不同皮膚下的色值,所以很可能導(dǎo)致了系統(tǒng)出現(xiàn)以下判斷:
- (void)setBackgroundColor:(UIColor *)backgroundColor {
if(backgroundColor == self.backgroundColor) return;
// other code...
}
解決辦法就一句代碼:
view.backgroundColor = nil;
view.backgroundColor = newColor;
其實 Apple 的這種優(yōu)化代碼也很有道理,因為這樣可以避免沒有必要的重繪,提高性能,再加之這種代碼調(diào)用頻率特別高,所以一句簡單的相等判斷可以省下很多性能消耗;
所以,Apple 所認(rèn)為的正常的隱藏/顯示導(dǎo)航欄的邏輯就是通過對應(yīng)的兩個方法來操作,然后內(nèi)部自己會進(jìn)行一些邏輯判斷之后最終設(shè)置navigationBar.hidden 的值。
然鵝,當(dāng) SDK 的容器 VC 通過非常規(guī)手段設(shè)置了 navigationBar.hidden = YES;
之后,self.navigationController. navigationBarHidden
的值并沒有發(fā)生變化,即值仍為 NO,所以當(dāng) SDK 的容器 VC 在 pop 之后,parentVC 調(diào)用到setNavigationBarHidden
方法時,判斷 self.navigationController. navigationBarHidden
的值并未發(fā)生改變,最終直接 return;
而之所以去掉 parentVC 中的那段代碼(self.hidesNavigationBarWhenPush = NO;
) 能夠解決這個 Bug,就是因為
- 基類 VC 中默認(rèn) hidesNavigationBarWhenPush = YES,所以 parentVC.navigationController.navigationBarHidden = YES;
- SDKVC 中 self.navigationController.navigationBarHidden 為默認(rèn)值,即為 NO;
- 當(dāng) SDKVC 被 pop 時,parentVC 通過基類調(diào)用了 viewWillAppear 方法。因為 navigationController.navigationBarHidden 的值不一致,所以沒有直接 return,走完系統(tǒng)內(nèi)部邏輯之后,重新設(shè)置了 navigationBar.hidden = YES;
- 上一步之后,其實仍然應(yīng)該不顯示導(dǎo)航欄,但就是因為 parentVC 是通過 childVC 的形式組織 VC,所以此時 childVC 的 willAppear 方法被調(diào)用;
- childVC 中的 self.navigationController.navigationBarHidden = NO,這個值又發(fā)生了改變,所以沒有直接 return,最終設(shè)置為 navigationBar.hidden = NO; 顯示了導(dǎo)航欄;
這個過程還真的是一波三折啊,很蛋疼啊......腦殼痛????......希望我解釋清楚了......
進(jìn)而,還有一種解決辦法,在SDK的容器VC中:
- (void)viewWillAppear:(BOOL)animated {
// 調(diào)用super,內(nèi)部直接設(shè)置了navigationBar.hidden = YES;
[super viewWillAppear:animated];
/**
* apple明確指出只能使用self.navigationController.navigationBarHidden或者setNavigationBarHidden:animated:來設(shè)置導(dǎo)航欄隱藏/顯示;
* 三方SDK內(nèi)部直接設(shè)置的self.navigationController.navigationBar.hidden = YES未按照apple的正規(guī)流程來設(shè)置,這就導(dǎo)致pop之后,雖然導(dǎo)航欄隱藏/顯示狀態(tài)發(fā)生了變化,但self.navigationController.navigationBarHidden的值未發(fā)生變化;
* 系統(tǒng)內(nèi)部應(yīng)該是會對比self.navigationController.navigationBarHidden 值是否一致,如果不一致才去設(shè)置 navigationBar.hidden = self.navigationController.navigationBarHiddenl;這樣可以避免頻繁設(shè)置hidden引起的性能問題;
* 直接在disappear方法中設(shè)置navigationBar.hidden = NO可能存在潛在風(fēng)險;
* 所以,解決這個Bug的最好方式應(yīng)該是讓流程正規(guī)化;
*/
[self.navigationController setNavigationBarHidden:YES animated:YES];
// toher code...
xxxxx
}
總結(jié)
關(guān)鍵點:
-
[self.navigationController setNavigationBarHidden:animated:];
方法中會對navigationBarHidden
的值進(jìn)行對比,如果一樣,就直接return,如果不一樣,就設(shè)置self.navigationBar.hidden = self.navigationController. navigationBarHidden;
- parentVC 的 willAppear、viewDidAppear 調(diào)用順序先于 childVC,如果是在 VC 中設(shè)置導(dǎo)航欄顯示/隱藏,就會出現(xiàn) childVC 主導(dǎo)導(dǎo)航欄的效果;
最關(guān)鍵的:
self.navigationController.navigationBarHidden 是唯一的、正規(guī)的渠道來控制導(dǎo)航欄的隱藏和顯示;
有了這個意識,在 viewDidLoad,還是 willAppear 等方法中來設(shè)置這個值,就看不同 App 自己的業(yè)務(wù)邏輯了。