級別: ★★☆☆☆
標簽:「iOS」「UIStateRestoration」
作者: 沐靈洛
審校: QiShare團隊
前言:上篇我們介紹了UI狀態保存和恢復的流程,
UIStateRestoration
協議類的方法,適用場景,調試策略以及UIApplication、UIViewController、UIView關于UIStateRestoration
協議所提供的接口方法。
本篇文章將介紹我們如何實現UI狀態保存和恢復。
在AppDelegate.m中設置UI的狀態可以恢復和保存
- (BOOL)application:(UIApplication *)application shouldRestoreApplicationState:(NSCoder *)coder {
return YES;
}
- (BOOL)application:(UIApplication *)application shouldSaveApplicationState:(NSCoder *)coder {
return YES;
}
相應的UIViewController中重寫以下方法
//進入后臺時調用;使用此方法保存我們需要下次恢復的數據。
- (void)encodeRestorableStateWithCoder:(NSCoder *)coder; {
[super encodeRestorableStateWithCoder:coder];
//保存數據的代碼寫在這里
[coder encodeObject: _nameTextField.text ?: @"" forKey:nameKey];
}
//進入前臺時調用;使用此方法恢復數據,并展示。
- (void)decodeRestorableStateWithCoder:(NSCoder *)coder; {
[super decodeRestorableStateWithCoder:coder];
self.name = [NSString stringWithString:[coder decodeObjectForKey:nameKey]];
_nameTextField.text = self.name;
}
設置完這兩項,真的就可以了嗎?我們可能會發現新建一個工程,直接使用自帶的ViewController打個斷點,發現成功調用UIViewController中重寫的encodeRestorableStateWithCoder
和decodeRestorableStateWithCoder
方法,進行了數據的保存。但是使用UINavigationController 或者UITabBarController進行多層嵌套后,以上方法卻沒有被調用。其實這一切只是因為Xcode給我配置的初始項目中,ViewController是主window的根控制器,不存在UITabBarController或UINavigationController的嵌套,界面展示的控制器顯示單一,也不會存在多層,并且此ViewController還是直接從故事版實例化的。
場景2:
主window的根控制器為以ViewController A 初始化的一個UINavigationController,在ViewController A中有一個按鈕點擊跳轉進入ViewController B,此時使用調試方法,讓程序退出。再次啟動UI狀態是否恢復到ViewController B。
按照場景2,我們需要恢復到ViewController B,若不管中間的控制器ViewController A,NavigationController便會斷層,顯示這不是我們想要的;所以我們需要在應用重啟時,不僅還原ViewController B,還希望ViewController A按照層級還原,如若ViewController A中還有要恢復的數據,也一并恢復。
嵌套控制器設置
逐層設置restorationIdentifier
,并重寫相應的保存與恢復方法
- storyboard實例化的控制器設置恢復標識
- 代碼設置恢復標識
self.restorationIdentifier = NSStringFromClass(self.class);
注意:
所有通向ViewController B的視圖控制器必須具有還原標識符(包括初始的UINavigationController,UITabBarController),否則狀態還原將無法工作。即:需要設置
restorationIdentifier
。
嵌套控制器的恢復
方案一
- 設置ViewController中定義的
restorationClass
屬性。
//! 設置恢復標識
self.restorationIdentifier = NSStringFromClass(self.class);
//! 設置用于恢復的類
self.restorationClass = self.class;
restorationClass
:Class的實例對象,APP狀態恢復的時候負責重新創建當前的控制器 ,需要實現定義在UIStateRestoring.h中的UIViewControllerRestoration
協議。restorationClass
可以是當前控制器也可以是其他對象,只要實現了UIViewControllerRestoration
協議即可。
- 在指定的
restorationClass
中恢復當前控制器。
+ (nullable UIViewController *) viewControllerWithRestorationIdentifierPath:(NSArray<NSString *> *)identifierComponents coder:(NSCoder *)coder {
//! identifierComponents返回的就是我們之前設置的restorationIdentifier
PersonDetailController *ctrl = [[PersonDetailController alloc]init];
ctrl.restorationIdentifier = identifierComponents.lastObject;
ctrl.restorationClass = [self class];
return ctrl;
}
總結:多層控制器,每層控制器都需要在所屬的類中設置restorationClass
同時必須實現UIViewControllerRestoration
方法,兩者缺一不可。
方案二
多層級嵌套時,每個控制器中不需要單獨設置restorationClass
,或者每個控制都沒有指定restorationClass
時。則需要實現UIApplication對于UIStateRestoration協議所實現接口方法,讓我們可以在恢復期間創建每個層級的控制器。
- (UIViewController *)application:(UIApplication *)application viewControllerWithRestorationIdentifierPath:(NSArray<NSString *> *)identifierComponents coder:(NSCoder *)coder {
UIViewController *vc;
UIStoryboard *storyboard = [coder decodeObjectForKey:UIStateRestorationViewControllerStoryboardKey];
if (storyboard){
return nil;
} else {
vc = [[NSClassFromString(identifierComponents.lastObject) alloc]init];
}
return vc;
}
上述代碼中,為什么從storyboard恢復的部分,就直接返回nil了呢?為什么不使用如下方式把控制器實例化完成呢?:
vc = [storyboard instantiateViewControllerWithIdentifier:identifierComponents.lastObject];
vc.restorationIdentifier = [identifierComponents lastObject];
vc.restorationClass = NSClassFromString(identifierComponents.lastObject);
在筆者的親測過程中發現這樣做會多實例化一次vc對象,會影響vc界面恢復的數據展示。這是因為來自storyboard的視圖,會由UIKIT 自動幫我們查找和創建視圖控制器。
總結:多層控制器統一在AppDelegate中實現各個層級控制器的恢復,比較方便。
注意:
1.通向ViewController B的視圖控制器若實現restorationClass和UIViewControllerRestoration組合后,則不會調用UIApplication對于UIStateRestoration協議所實現接口方法,否則恢復時回調用。
2.如果我們沒有指明,恢復每一個控制器時 用于創建此控制器的對象所屬的類,則必須在AppDelegate中實現此方法,讓我們可以在恢復期間創建一個新的控制器。
3.來自故事版的視圖,恢復時會由UIKIT 自動幫我們查找和創建視圖控制器。
至此我們的應用應該具備簡單UI的狀態恢復和保存功能。下篇文章我們將介紹UIStateRestoration
協議類中的UIDataSourceModelAssociation
協議。
QIRestorationDemo地址
推薦文章:
iOS UI狀態保存和恢復(一)
Swift 運算符
iOS 中精確定時的常用方法
Sign In With Apple(一)
算法小專欄:動態規劃(一)
Dart基礎(一)
Dart基礎(二)
Dart基礎(三)
Dart基礎(四)
iOS 短信驗證碼倒計時按鈕