级别: ★★☆☆☆
标签:「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 短信验证码倒计时按钮