Compréhension des applications natives Forceios

Objectifs de formation

Vidéo de démonstration Trail Together

Vous souhaitez être guidé pas à pas par un expert pendant que vous travaillez sur cette étape ? Regardez cette vidéo qui fait partie de la série Trail Together.

(Ce clip commence à 14 min 49 s, au cas où vous voudriez revenir en arrière et regarder à nouveau le début de l’étape.)

Vue d'ensemble du flux de l'application

Le diagramme suivant illustre le flux de démarrage d’une application native utilisant le gestionnaire de kit de développement le plus complet, MobileSyncSDKManager. Ce gestionnaire active l’authentification et inclut les fonctionnalités hors ligne du kit de développement mobile.

Par défaut, les applications natives forceios utilisent MobileSyncSDKManager, une sous-classe spécialisée de SalesforceManager, pour initialiser le kit de développement mobile. Cette classe donne accès à l’ensemble des fonctionnalités du kit de développement mobile.

Flux de lancement de l'application

override init() {
    super.init()
    MobileSyncSDKManager.initializeSDK()
}

MobileSyncSDKManager.shared

Dans les applications Swift pour iOS 13 et versions ultérieures, la classe SceneDelegate occupe une place centrale en tant que gestionnaire des vues SwiftUI. SceneDelegate traite les événements du cycle de vie d’une scène, tels que : 

• la connexion à l’application ;
• l’accès au premier plan ou à l’arrière-plan ;
• la gestion de l’activation ou de la désactivation ;
• le redimensionnement.

Vous pouvez personnaliser votre classe SceneDelegate en déterminant vous-même la manière dont ces événements sont gérés. L’application modèle vous facilite même la tâche : elle fournit des commentaires dans les principaux gestionnaires d’événements qui vous indiquent comment procéder.

Dans le kit de développement mobile, la classe SceneDelegate est l’élément permettant à vos ressources personnalisées de prendre le contrôle. L’application modèle utilise SceneDelegate pour réaliser les actions suivantes : 

• Afficher la page de connexion à Salesforce lorsque cela est nécessaire (avant qu’un utilisateur ne se connecte ou à chaque fois qu’il se déconnecte).
• Réinitialiser l’état de vue lorsque l’utilisateur actuel se déconnecte.
• Importer les fichiers de configuration relatifs aux fonctionnalités hors ligne de SmartStore et Mobile Sync.
• Définir la vue racine de la fenêtre sur la première vue personnalisée de l’application.

Examinons le code source pour déterminer comment l’application affiche ses vues.

1. Dans Xcode, ouvrez le fichier SceneDelegate.swift.
2. En haut de la classe, vous pouvez voir la première définition de fonction.

   func scene(_ scene: UIScene, willConnectTo session: UISceneSession, options connectionOptions: UIScene.ConnectionOptions) {
       guard let windowScene = (scene as? UIWindowScene) else { return }
       self.window = UIWindow(frame: windowScene.coordinateSpace.bounds)
       self.window?.windowScene = windowScene
       AuthHelper.registerBlock(forCurrentUserChangeNotifications: {
           self.resetViewState {
               self.setupRootViewController()
           } 
       })
   }

   Cette méthode constitue la première étape par laquelle passent les scènes en cours d’initialisation. Les trois premières lignes consistent en du code standard. Elles « connectent » la scène à l’application ; en d’autres termes, elles relient la scène à une fenêtre d’application afin qu’elle puisse être affichée. L’instruction finale de cette méthode configure la classe AuthHelper du kit de développement mobile pour qu’elle traite les notifications de modification de l’utilisateur actuel. Le gestionnaire en lui-même constitue le bloc interne dans l’appel de méthode AuthHelper.registerBlock(_:). Il appelle deux méthodes privées personnalisées : resetViewState(_:) et setupRootViewController(). La méthode resetViewState(_:) restaure votre application dans un état parfait, tel qu’il était au démarrage, en supprimant tout état de vue existant, puis en restaurant la vue racine d’origine. Nous étudierons setupRootViewController() dans un instant.
3. Recherchez « func initializeAppViewState ». Dans cette implémentation de méthode, observez l’avant-dernière ligne :

   self.window?.rootViewController = InitialViewController(nibName: nil, bundle: nil)

   Ce code définit la propriété self.window?.rootViewController sur un objet InitialViewController venant d’être créé. La classe InitialViewController est définie dans votre application, elle est plutôt rare et sans intérêt. En effet, cette vue, qui est la première affichée, sert simplement de conteneur pour les écrans de connexion de Salesforce. Voilà tout ce que vous devez savoir. Cette méthode est appelée à partir du gestionnaire d’événements sceneWillEnterForeground.
4. Recherchez « func setupRootViewController ». Il est implémenté comme suit :

   func setupRootViewController() {
       // Setup store based on config userstore.json
       MobileSyncSDKManager.shared.setupUserStoreFromDefaultConfig()
       // Setup syncs based on config usersyncs.json
       MobileSyncSDKManager.shared.setupUserSyncsFromDefaultConfig()
       self.window?.rootViewController = UIHostingController(
           rootView: AccountsListView()
       )
   }

La méthode setupRootViewController() réalise plusieurs étapes de configuration importantes.

• Elle charge les fichiers de configuration relatifs aux fonctionnalités hors ligne SmartStore et Mobile Sync.
• Elle définit le contrôleur de vue racine de la fenêtre sur AccountsListView, une vue SwiftUI personnalisée affichant une liste des noms des comptes de l’organisation de l’utilisateur.

Votre contrôleur de vue racine constitue le point de départ du contenu de votre application. Pour indiquer cela de manière claire à iOS, setupRootViewController() crée un objet UIHostingController et initialise sa propriété rootView sur une instance de la première vue de votre application. Le contrôle de l’application est ensuite transmis à votre code personnalisé. Vous pouvez réutiliser les classes de vue et de modèle de l’application modèle ou les remplacer par vos propres solutions. Comme expliqué dans la section suivante, vous appellerez toujours les API du kit de développement mobile pour accéder aux ressources Salesforce. Toutefois, à ce stade, vous êtes désormais le seul à gérer le flux, le contenu et le rôle de l’application. Faites preuve de créativité. 

Ressources