iOS UI状态保存和恢复(二)

avatar
奇舞团移动端团队 @奇舞团

级别: ★★☆☆☆
标签:「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,并重写相应的保存与恢复方法

  1. storyboard实例化的控制器设置恢复标识

storyboard设置restorationIdentifier

  1. 代码设置恢复标识
self.restorationIdentifier = NSStringFromClass(self.class);

注意:

所有通向ViewController B的视图控制器必须具有还原标识符(包括初始的UINavigationController,UITabBarController),否则状态还原将无法工作。即:需要设置restorationIdentifier

嵌套控制器的恢复

方案一

  1. 设置ViewController中定义的restorationClass属性。
 //! 设置恢复标识
self.restorationIdentifier = NSStringFromClass(self.class);
//! 设置用于恢复的类
self.restorationClass = self.class;

restorationClass:Class的实例对象,APP状态恢复的时候负责重新创建当前的控制器 ,需要实现定义在UIStateRestoring.h中的UIViewControllerRestoration协议。restorationClass可以是当前控制器也可以是其他对象,只要实现了UIViewControllerRestoration协议即可。

  1. 在指定的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 短信验证码倒计时按钮
奇舞周刊