Ajouter UIScene à une vielle app

 

 UIScene devient obligatoire avec IOS 27.

Plus le choix, il faut passer toutes les vielles applications à UIScene. Avec les scènes, la fenêtre principale n'est plus attachée à l'application mais à une scène. UIApplicationDelegate contient toujours la fonction de lancement didFinishLaunchingWithOptions:. C'est toujours un bon endroit pour initialiser des variables globales, et pour mettre les valeurs par défaut de NSUserDefaults.standardUserDefaults.  

On perd les fonctions applicationDidBecomeActive:, applicationWillResignActive:, applicationWillEnterForeground:, application:openURL:options:, qui se retrouvent, soit dans UISceneDelegate, soit sous forme de notification, soit les deux.

Le plus important, le point d'entrée, est le fichier Info.plist dans lequel on définit la clef UIApplicationSceneManifest. Là, deux cas, soit on a un storyboard, soit on a juste un xib.

Avec un UIStoryBoard

Presque tout se passe dans Info.plist :

<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>AppDelegate</string>

<key>UISceneStoryboardFile</key>

<string>Main</string>

</dict>

</array>

</dict>

</dict>

On définit la UISceneDelegateClassName et le UISceneStoryboardFile.

Il faut donc, évidemment, avoir un "Main.storyboard" et définir "AppDelegate" comme gérant le protocole UIWindowSceneDelegate. Le UIApplicationSupportsMultipleScenes à false est important, pour éviter plusieurs scènes de la même app.

Dans AppDelegate.h, on laisse la UIWindow, et on ajoute le protocole UIWindowSceneDelegate :

@interface AppDelegate : UIResponder

< UIApplicationDelegate,UIWindowSceneDelegate >

@property (strong, nonatomic) UIWindow *window;

@end

Après il faut revoir les fonctions spécifique à UIApplicationDelegate qui sont beaucoup remplacées par des fonctions de UIWindowSceneDelegate.

Si on utilise un xib

Si l'on choisit de ne pas avoir de storyboard, on ne met pas la clef UISceneStoryboardFile dans Info.plist :

<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>AppDelegate</string>

</dict>

</array>

</dict>

</dict>

Mais on est alors obligé de gérer à la main dans willConnectToSession, qui est une des fonctions de UIWindowSceneDelegate :

-(void)scene:(UIScene *)scene willConnectToSession:(UISceneSession *)session options:(UISceneConnectionOptions *)connectionOptions {

    NSLog(@"SCENE DELEGATE willConnectToSession");

    NSLog(@"SCENE options %@",connectionOptions);

    

    // On ne fait rien si c'est un AirPlay !

    if([session.role isEqualToString:@"UIWindowSceneSessionRoleExternalDisplayNonInteractive"])

        return;

    

    UIWindowScene *windowScene = (UIWindowScene *)scene;

    self.window = [[UIWindow alloc] initWithWindowScene:windowScene];

    self.window.rootViewController = MonViewController.new;

    [self.window makeKeyAndVisible];

        return conf;

}

Si on gère des fichiers en entrée

Les application IOS, au départ n'avaient pas d'explorateur de fichier. Pour charger un fichier, on l'ouvrait avec l'app, et la fonction openUrl: de UIApplicationDelegate était appelée. Maintenant, cette logique est transférée à l'UISceneDelegate (la fonction devient openURLContexts:). Mais si l'application n'est pas encore active, n'est pas encore connectée à une scène, la fonction openURLContexts: n'est pas appelée... Mais il y a un contexte d'URLs :

-(void)scene:(UIScene *)scene willConnectToSession:(UISceneSession *)session options:(UISceneConnectionOptions *)connectionOptions {

    NSLog(@"SCENE DELEGATE willConnectToSession");

    NSLog(@"SCENE options %@",connectionOptions);

    

    // On ne fait rien si c'est un AirPlay !

    if([session.role isEqualToString:@"UIWindowSceneSessionRoleExternalDisplayNonInteractive"])

        return;

    

    UIWindowScene *windowScene = (UIWindowScene *)scene;

    self.window = [[UIWindow alloc] initWithWindowScene:windowScene];

    self.window.rootViewController = MonViewController.new;

    [self.window makeKeyAndVisible];

    

    /*

     Si l'on importe un fichier, celui-ci doit lancer openURLContext,

     mais si l'app n'est pas démarrée, la scene n'est pas encore initialisée,

     il n'y a pas de rootViewController, et la fonction n'est donc pas appelée !

     C'est donc dans willConnectToSession qu'il faut appeler explicitement openURLContexts

     après avoir tout initialisé...

     */

    if(connectionOptions.URLContexts) {

        dispatch_after(dispatch_time(DISPATCH_TIME_NOW, 2 * NSEC_PER_SEC),

                       dispatch_get_main_queue(), ^{

            [self scene:scene openURLContexts:connectionOptions.URLContexts];

        });

    }

    return conf;

}

Attention, on ne peut pas appeler directement openURLContexts, car la scène n'existe pas encore. D'où une attente avant l'appel.

Cycle de vie

Le fichier AppDelegate.m peut gérer le cycle de vie de la scène (et donc de la fenêtre), ce qui remplace les fonctions équivalente qu'il y avait dans le délégateur de UIApplication :

- (void)scene:(UIScene *)scene willConnectToSession:(UISceneSession *)session options:(UISceneConnectionOptions *)connectionOptions {

// Use this method to optionally configure and attach the UIWindow `window` 

// to the provided UIWindowScene `scene`.

// If using a storyboard, the `window` property will automatically be initialized and attached to the scene.

// This delegate does not imply the connecting scene or session are new 

// (see `application:configurationForConnectingSceneSession` instead).

}

- (void)sceneDidDisconnect:(UIScene *)scene {

// Called as the scene is being released by the system.

// This occurs shortly after the scene enters the background, or when its session is discarded.

// Release any resources associated with this scene that can be re-created the next time the scene connects.

// The scene may re-connect later, as its session was not necessarily discarded

// (see `application:didDiscardSceneSessions` instead).

}

- (void)sceneDidBecomeActive:(UIScene *)scene {

// Called when the scene has moved from an inactive state to an active state.

// Use this method to restart any tasks that were paused (or not yet started) when the scene was inactive.

}

- (void)sceneWillResignActive:(UIScene *)scene {

// Called when the scene will move from an active state to an inactive state.

// This may occur due to temporary interruptions (ex. an incoming phone call).

}

- (void)sceneWillEnterForeground:(UIScene *)scene {

// Called as the scene transitions from the background to the foreground.

// Use this method to undo the changes made on entering the background.

}

- (void)sceneDidEnterBackground:(UIScene *)scene {

// Called as the scene transitions from the foreground to the background.

// Use this method to save data, release shared resources, and store enough scene-specific state information

// to restore the scene back to its current state.

}