Mac Catalyst、iOS13 - UIScene

场景只有iPad和macOS下才可用,场景可以理解为窗口(这时候UIWindow将理解为UIView++),一个场景(窗口)对应一个Scene Delegate对象,建议每个Scene Delegate类对应一个UIViewController

默认的info.plist配置(如不需要多场景,建议删除此配置,应用程序的生命周期将变为由AppDelegate管理)

MacCatalyst - Default info plist.png
  • Enable Multiple Windows:如果需要多场景(窗口),需要把此值设为YES,否则无法使用多场景

  • Configuration Name:配置名,可理解为场景的标识符(必填项)

  • Delegate Class Name:场景对应的代理对象类,每新建一个场景,都会创建一个新的代理对象(必填项)

  • Storyboard Name:场景将自动生成此Storyboard里的Initial View Controller(默认视图控制器),如不设置,则需要在Scene Delegate里创建UIWindow和UIViewController对象(选填项)

  • Class Name:自定义UIScene子类,默认为UIWindowScene,一般不需要更改(选填项)

多场景配置

MacCatalyst - Custom info plist.png
<key>UIApplicationSceneManifest</key>
<dict>
    <key>UIApplicationSupportsMultipleScenes</key>
    <true/>
    <key>UISceneConfigurations</key>
    <dict>
        <key>UIWindowSceneSessionRoleApplication</key>
        <array>
            <dict>
                <key>UISceneConfigurationName</key>
                <string>Default Configuration</string>
                <key>UISceneDelegateClassName</key>
                <string>SceneDelegate</string>
                <key>UISceneStoryboardFile</key>
                <string>Main</string>
            </dict>
            <dict>
                <key>UISceneConfigurationName</key>
                <string>Other Configuration</string>
                <key>UISceneDelegateClassName</key>
                <string>OtherSceneDelegate</string>
                <key>UISceneStoryboardFile</key>
                <string>Other</string>
            </dict>
        </array>
    </dict>
</dict>

AppDelegate.m 修改

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
    // 兼容iOS13之前版本
    if (@available(iOS 13.0, *)) { } else {
        UIStoryboard *storyboard            = [UIStoryboard storyboardWithName:@"Main" bundle:nil];
        UIViewController *viewController    = [storyboard instantiateInitialViewController];
        self.window.rootViewController      = viewController;
    }
    return YES;
}

- (UISceneConfiguration *)application:(UIApplication *)application configurationForConnectingSceneSession:(UISceneSession *)connectingSceneSession options:(UISceneConnectionOptions *)options API_AVAILABLE(ios(13.0)) {
    // 应用程序正常退出/全部的窗口被正常关闭后再启动才会进入此方法
    NSUserActivity *userActivity    = options.userActivities.anyObject;
    NSString *activityType          = userActivity.activityType;
    UISceneSessionRole role         = connectingSceneSession.role;
    // 假如activityType为空,表示是刚启动的,否则是新创建的场景
    if (activityType == nil) {
        activityType                = @"Default Configuration";
        role                        = UIWindowSceneSessionRoleApplication;
    }
    return [[UISceneConfiguration alloc] initWithName:activityType sessionRole:role];
}

OtherSceneDelegate.h 需要遵循<UIWindowSceneDelegate>协议(OtherSceneDelegate.m的内容和SceneDelegate.m一样)

#import <UIKit/UIKit.h>
@interface OtherSceneDelegate : UIResponder <UIWindowSceneDelegate>
@property (strong, nonatomic) UIWindow * window;
@end

Other.storyboard 新增一个视图控制器并设置Is Initial View Controller

MacCatalyst - Initial view controller.png

创建(激活)场景

NSUserActivity *userActivity    = [[NSUserActivity alloc] initWithActivityType:@"Other Configuration"];
UIApplication *app              = [UIApplication sharedApplication];
[app requestSceneSessionActivation:nil
                      userActivity:userActivity
                           options:nil
                      errorHandler:nil];

(Show Other Scene为按钮,点击后执行上面的代码显示右边的窗口)

macOS下效果:

MacCatalyst - Show scene.png

iPadOS下效果:

MacCatalyst - Show scene iPad.png

关闭场景(例如在UIViewController实例里)

UIApplication *app = [UIApplication sharedApplication];
[app requestSceneSessionDestruction:self.view.window.windowScene.session
                            options:nil
                       errorHandler:nil];

激活(前置)已有的场景

UIApplication *app      = [UIApplication sharedApplication];
NSArray *openSessions   = app.openSessions.allObjects;
for (UISceneSession *session in openSessions) {
    if ([session.configuration.name isEqualToString:@"Other Configuration"]) {
        [app requestSceneSessionActivation:session
                              userActivity:nil
                                   options:nil
                              errorHandler:nil];
    }
}

假如info.plist的场景配置不设置Storyboard Name,则需要自行创建窗口和视图控制器

// OtherSceneDelegate.m

- (void)scene:(UIScene *)scene willConnectToSession:(UISceneSession *)session options:(UISceneConnectionOptions *)connectionOptions API_AVAILABLE(ios(13.0)) {
    UIStoryboard *storyboard            = [UIStoryboard storyboardWithName:@"Other" bundle:nil];
    UIViewController *viewController    = [storyboard instantiateInitialViewController];
    UIWindowScene *windowScene          = (UIWindowScene *)scene;
    UIWindow *window                    = [[UIWindow alloc] initWithWindowScene:windowScene];
    self.window                         = window;
    window.rootViewController           = viewController;
    [window makeKeyAndVisible];
}

恢复场景

场景(窗口)在程序意外退出后,重启时会调用Scene Delegate里的 - (void)scene:(UIScene *)scene willConnectToSession:(UISceneSession *)session options:(UISceneConnectionOptions *)connectionOptions 方法以重新连接(恢复)场景,每一个场景都有一个唯一标识符(session.persistentIdentifier),假如遇到意外退出恢复时会带上旧的标识符,可通过使用此标识符保存或读取数据

macOS上运行的问题

窗口全部关闭后点击程序坞(Dock)上的图标,控制台会出现警告或应用程序Crash

*** Assertion failure in -[UINSApplicationDelegate applicationShouldHandleReopen:hasVisibleWindows:], /AppleInternal/BuildRoot/Library/Caches/com.apple.xbs/Sources/UIKitCore/UIKit-3920.40.401/UIKitMacHelper/App/UINSApplicationDelegate.m:886

[xpc.exceptions] <NSXPCConnection: 0x60000300c7e0> connection to service on pid 6151 named com.apple.uikitsystemapp.services: Exception caught during invocation of reply block to message 'createNewSceneOfSize:background:persistenceIdentifier:completionHandler:'.

Ignored Exception: -[UINSApplicationDelegate applicationShouldHandleReopen:hasVisibleWindows:]_block_invoke: _createNewForegroundSceneWithCompletionHandler Completion handler arrived off the main thread.

解决方法:通过添加AppKit插件解决,详情请参阅《Mac Catalyst - macOS AppKit 插件》

生命周期

-[AppDelegate application:didFinishLaunchingWithOptions:]
-[AppDelegate application:configurationForConnectingSceneSession:options:] 
-[SceneDelegate scene:willConnectToSession:options:]
-[SceneDelegate sceneWillEnterForeground:]
-[SceneDelegate sceneDidBecomeActive:]

// 关闭后...
-[SceneDelegate sceneWillResignActive:]
-[SceneDelegate sceneDidEnterBackground:]
-[SceneDelegate sceneDidDisconnect:]
-[AppDelegate application:didDiscardSceneSessions:]
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 214,904评论 6 497
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 91,581评论 3 389
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 160,527评论 0 350
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 57,463评论 1 288
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 66,546评论 6 386
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 50,572评论 1 293
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,582评论 3 414
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 38,330评论 0 270
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,776评论 1 307
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 37,087评论 2 330
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 39,257评论 1 344
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 34,923评论 5 338
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 40,571评论 3 322
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 31,192评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,436评论 1 268
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 47,145评论 2 366
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 44,127评论 2 352

推荐阅读更多精彩内容