iOS UIScene 适配指南|完整迁移步骤与踩坑总结

<key>UIApplicationSceneManifest</key><dict>    <key>UIApplicationSupportsMultipleScenes</key>    <false/>     <key>UISceneConfigurations</key>    <dict>        <key>UIWindowSceneSessionRoleApplication</key>        <array>            <dict>                <key>UISceneConfigurationName</key>                <string>Default Configuration</string>                <key>UISceneDelegateClassName</key>                <string>$(PRODUCT_MODULE_NAME).SceneDelegate</string>                <key>UISceneStoryboardFile</key>                <string>Main</string>             </dict>        </array>    </dict></dict>

// swift @available(iOS 13.0, *)func application(_ application: UIApplication, configurationForConnecting connectingSceneSession: UISceneSession, options: UIScene.ConnectionOptions) -> UISceneConfiguration {    var sceneConfiguration = UISceneConfiguration(name: "Default Configuration", sessionRole: connectingSceneSession.role)    sceneConfiguration.delegateClass = SceneDelegate.self    // 如果使用 storyboard 创建根控制器，则需要指定对应的故事板    sceneConfiguration.storyboard = UIStoryboard.init(name: "Main", bundle: Bundle.main)    return sceneConfiguration}// oc- (UISceneConfiguration *)application:(UIApplication *)application configurationForConnectingSceneSession:(UISceneSession *)connectingSceneSession options:(UISceneConnectionOptions *)options API_AVAILABLE(ios(13.0)) {    UISceneConfiguration *sceneConfiguration = [[UISceneConfiguration alloc] initWithName:@"Default Configuration" sessionRole:connectingSceneSession.role];    sceneConfiguration.delegateClass = SceneDelegate.class;    sceneConfiguration.storyboard = [UIStoryboard storyboardWithName:@"Main" bundle:NSBundle.mainBundle];    return sceneConfiguration;}

#import <UIKit/UIKit.h>API_AVAILABLE(ios(13.0))@interfaceSceneDelegate : UIResponder <UIWindowSceneDelegate>@property (strong, nonatomic) UIWindow * window;@end@implementationSceneDelegate- (void)scene:(UIScene *)scene willConnectToSession:(UISceneSession *)session options:(UISceneConnectionOptions *)connectionOptions {    UIWindowScene *wSence = (UIWindowScene *)scene;    if (![wSence isKindOfClass:UIWindowScene.class]) {        return;    }    self.window = [[UIWindow alloc] initWithWindowScene:wSence];    self.window.backgroundColor = UIColor.whiteColor;    self.window.rootViewController = [YourRootViewController new];    [self.window makeKeyAndVisible];    // 处理通过 URL / Universal Link / Shortcut 冷启动场景    [self handleConnectionOptions: connectionOptions]}@end

@interfaceAppDelegate : UIResponder <UIApplicationDelegate>// 失效，请勿继续使用@property (strong, nonatomic) UIWindow * window;@end@implementationAppDelegate- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {    if (@available(iOS 13.0, *)) {        // iOS 13+ window 由 SceneDelegate 创建        // UI 初始化迁移至 - (void)scene:(UIScene *)scene willConnectToSession:(UISceneSession *)session options:(UISceneConnectionOptions *)connectionOptions    } else {        self.window = [[UIWindow alloc] initWithFrame:[UIScreen mainScreen].bounds];        UIViewController *root = [ViewController new]; // Your ViewController        self.window.rootViewController = root;        [self.window makeKeyAndVisible];    }    return YES;}- (void)applicationDidBecomeActive:(UIApplication *)application {    // 迁移至 - (void)sceneDidBecomeActive:(UIScene *)scene}- (void)applicationWillResignActive:(UIApplication *)application {    // 迁移至 - (void)sceneWillResignActive:(UIScene *)scene}- (void)applicationWillEnterForeground:(UIApplication *)application {    // 迁移至 - (void)sceneWillEnterForeground:(UIScene *)scene}- (void)applicationDidEnterBackground:(UIApplication *)application {    // 迁移至 - (void)sceneDidEnterBackground:(UIScene *)scene}@end

- (void)scene:(UIScene *)scene willConnectToSession:(UISceneSession *)session options:(UISceneConnectionOptions *)connectionOptions {    UIOpenURLContext *URLContext = connectionOptions.URLContexts.anyObject;    if (URLContext) {        // 处理 URLContext.URL    }    NSUserActivity *userActivity = connectionOptions.userActivities.anyObject;    if (userActivity.activityType == NSUserActivityTypeBrowsingWeb) {        // 处理 Universal Link    }    UIApplicationShortcutItem *shortcutItem = connectionOptions.shortcutItem;    if (shortcutItem) {        // 处理 Shortcut    }}

- (void)scene:(UIScene *)scene openURLContexts:(NSSet<UIOpenURLContext *> *)URLContexts {    // 处理 URLContext.URL}- (void)scene:(UIScene *)scene continueUserActivity:(NSUserActivity *)userActivity {    // 处理 Universal Link}- (void)windowScene:(UIWindowScene *)windowScene performActionForShortcutItem:(UIApplicationShortcutItem *)shortcutItem completionHandler:(void (^)(BOOL))completionHandler {    // 处理 Shortcut}

There is no scene delegate set. A scene delegate class must be specified to use a main storyboard file.

static NSString * const kDefaultSceneConfigurationName = @"Default Configuration";@implementation UIApplication(YourPrefix)- (nullable UIWindow *)yourPrefix_window {    UIWindow *window = nil;    if (@available(iOS 13.0, *)) {        UIWindowScene *dwScene = [self yourPrefix_defaultScene];        id<UIWindowSceneDelegate> wDelegate = (id<UIWindowSceneDelegate>)dwScene.delegate;        if ([wDelegate respondsToSelector:@selector(window)]) {            window = wDelegate.window;        }    } else {        window = self.delegate.window;    }    return window;}- (nullable UIWindowScene *)yourPrefix_defaultScene API_AVAILABLE(ios(13.0)) {    NSAssert(NSThread.isMainThread, @"Must be called on main thread");    UIWindowScene *dwScene = nil;    UIWindowScene *activeScene = nil;    if (!self.supportsMultipleScenes) {        UIScene *scene = self.connectedScenes.anyObject;        if ([scene isKindOfClass:UIWindowScene.class]) {            dwScene = (UIWindowScene *)scene;        }    } else {        for (UIScene *scene in self.connectedScenes) {            if (![scene isKindOfClass:UIWindowScene.class]) {                continue;            }            if (scene.activationState != UISceneActivationStateForegroundActive) {                continue;            }            UIWindowScene *ws = (UIWindowScene *)scene;            if (!activeScene) {                activeScene = ws;            }            if ([ws.session.configuration.name isEqualToString:kDefaultSceneConfigurationName]) {                dwScene = ws;                break;            }        }        if (!dwScene) {            dwScene = activeScene;        }    }    return dwScene;}@end

- (instancetype)initWithWindowScene:(UIWindowScene *)windowScene;

// 如果设置为 nil，窗口就不会显示在任何屏幕上// 切换 UIWindowScene 可能是一个比较耗性能的操作，所以尽量别在对性能要求比较高的代码里去做这个事情。@property(nullable, nonatomic, weak) UIWindowScene *windowScene API_AVAILABLE(ios(13.0)) API_UNAVAILABLE(watchos);