Concepto de aplicaciones nativas forceios

Objetivos de aprendizaje

Siga el proceso con Trail Together

¿Desea seguir el proceso con un experto a medida que realiza este paso? Mire este video que forma parte de la serie Trail Together.

(Este video comienza en el minuto 14:49, en caso de que desee rebobinar y mirar el comienzo del paso nuevamente).

Descripción general del flujo de aplicación

El siguiente diagrama ilustra el flujo de inicio para una aplicación nativa utilizando el gestor de SDK más completo, MobileSyncSDKManager. Este gestor activa la autenticación e incluye las funciones de Mobile SDK sin conexión.

De forma predeterminada, las aplicaciones nativas forceios utilizan MobileSyncSDKManager, una subclase especializada de SalesforceManager, para inicializar Mobile SDK. Esta clase activa la gama completa de funciones de Mobile SDK.

Flujo de inicio de aplicación

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

MobileSyncSDKManager.shared

En aplicaciones Swift para iOS 13 y versiones posteriores, SceneDelegate ocupa el primer plano como gestor de vistas de SwiftUI. SceneDelegate controla los eventos del ciclo de vida de una escena, como 

• La conexión a la aplicación
• El ingreso del frente o del fondo
• La activación o desactivación
• El cambio de tamaño

Puede personalizar su clase SceneDelegate para agregar su propia gestión de estos eventos. De hecho, la aplicación de plantilla le facilita la tarea, ya que proporciona comentarios en controladores de eventos importantes que le indican cómo proceder.

En términos de Mobile SDK, SceneDelegate es donde los recursos personales toman el control. La aplicación de plantilla utiliza SceneDelegate para: 

• Publicar la pantalla de inicio de sesión de Salesforce cuando es necesario, antes de que el usuario haya iniciado sesión o cada vez que la cierra.
• Restablecer el estado de vista cuando el usuario actual cierra sesión.
• Importar archivos de configuración para las funciones de SmartStore y Mobile Sync sin conexión.
• Establecer la vista raíz de la ventana en la primera vista personalizada en la aplicación.

Vamos a examinar el código abierto para comprobar cómo muestra la aplicación sus vistas.

1. En Xcode, abra el archivo SceneDelegate.swift.
2. Junto a la parte superior de la clase, puede ver la definición de la primera función.

   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()
           } 
       })
   }

   Este método es la primera parada para las escenas que se inicializan. Las primeras tres líneas son código reutilizado. "Conectan" la escena a la aplicación; en otras palabras, adjuntan la escena a una ventana de la aplicación para que pueda verse. La declaración final de este método configura la clase AuthHelper de Mobile SDK para controlar las notificaciones de cambio de usuario actual. El controlador en sí mismo es el bloque interno dentro de la llamada al método AuthHelper.registerBlock(_:). Llama dos métodos privados personalizados: resetViewState(_:) y setupRootViewController(). El método resetViewState(_:) restaura su aplicación a su estado inicial perfecto al eliminar los estados de vista existentes y, luego, restaurar la vista raíz original. Ahondaremos en setupRootViewController() en breve.
3. Busque "func initializeAppViewState”. En la implementación de este método, examine la anteúltima línea:

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

   Este código establece la propiedad self.window?.rootViewController en un objeto InitialViewController recién creado. La clase InitialViewController se define en la aplicación y es bastante escasa y aburrida. Esta vista, que es la primera en mostrarse, es solo un contenedor para las pantallas de inicio de sesión de Salesforce. Esto en todo cuanto necesita saber al respecto. Este método se llama desde el controlador de eventos sceneWillEnterForeground.
4. Busque “func setupRootViewController”. Se implementa del modo siguiente:

   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()
       )
   }

El método setupRootViewController() realiza un par de pasos de configuración importantes.

• Carga archivos de configuración para las funciones de SmartStore y Mobile Sync sin conexión.
• Establece el controlador de vista raíz de la ventana en AccountsListView, una vista de SwiftUI personalizada que muestra una lista de nombres de cuentas de la organización del usuario.

El controlador de vista raíz es el punto de partida del contenido de su aplicación. Para que esta elección sea clara para iOS, setupRootViewController() crea un objeto UIHostingController e inicializa su propiedad rootView a una instancia de la primera vista de su aplicación. Cuando esto sucede, el control de la aplicación pasa a su código personalizado. Luego, puede reutilizar clases de modelos y vistas de la aplicación de plantilla o reemplazarlas con sus propias soluciones. En la siguiente sesión, aún llamará a API de Mobile SDK para acceder a recursos de Salesforce. Pero a partir de este punto, el flujo, el contenido y la intención de la aplicación dependen de usted. ¡Sea creativo! 

Recursos