Compreender aplicativos nativos forceios

Objetivos de aprendizagem

Acompanhar com o Trail Together

Deseja acompanhar um especialista enquanto trabalha nesta etapa? Veja este vídeo que faz parte da série Trail Together.

(Este clipe começa na marca dos 14:49 minutos, caso você queira retroceder e ver o início da etapa novamente.)

Visão geral do fluxo do aplicativo

O diagrama a seguir ilustra o fluxo de inicialização para um aplicativo nativo usando o gerenciador de SDK mais abrangente, MobileSyncSDKManager. Esse gerenciador permite a autenticação e inclui os recursos offline do Mobile SDK.

Por padrão, os aplicativos nativos do forceios usam MobileSyncSDKManager, uma subclasse especializada do SalesforceManager, para inicializar o Mobile SDK. Essa classe habilita a gama completa de recursos do Mobile SDK.

Fluxo de inicialização do aplicativo

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

MobileSyncSDKManager.shared

Em aplicativos Swift para iOS 13 e posteriores, SceneDelegate assume o controle como o gerenciador de visualizações SwiftUI. SceneDelegate trata dos eventos do ciclo de vida de uma cena, como 

• Conectar-se ao aplicativo
• Entrar em primeiro plano ou no fundo
• Tornar-se ativo ou inativo
• Redimensionar

Você pode personalizar sua classe SceneDelegate para adicionar seu próprio tratamento para esses eventos. Na verdade, o aplicativo de modelo facilita essa operação. Ele fornece comentários em grandes manipuladores de eventos que indicam como proceder.

No que diz respeito ao Mobile SDK, SceneDelegate é onde seus recursos personalizados assumem o controle. O aplicativo de modelo usa SceneDelegate para: 

• Publicar a tela de login do Salesforce quando necessário: antes que um usuário faça login ou sempre que um usuário faça logout.
• Reiniciar o estado de exibição quando o usuário atual fizer logout.
• Importar arquivos de configuração para os recursos offline SmartStore e Sincronização móvel.
• Definir a exibição raiz da janela para a primeira exibição personalizada no aplicativo.

Vejamos o código-fonte para ver como o aplicativo mostra seus modos de exibição.

1. No Xcode, abra o arquivo SceneDelegate.swift.
2. Perto da parte superior da classe, você pode ver a definição da primeira função.

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

   Esse método é a primeira parada de todas as cenas que estão sendo inicializadas. As três primeiras linhas representam código padronizado. Elas "conectam" a cena ao aplicativo, ou seja, anexam a cena a uma janela do aplicativo para que ela possa ser exibida. A instrução final nesse método configura a classe AuthHelper do Mobile SDK para tratar das notificações atuais de alteração do usuário. O próprio manipulador é o bloco interno dentro da chamada do método AuthHelper.registerBlock(_:). Ele chama dois métodos privados personalizados: resetViewState(_:) e setupRootViewController(). O método resetViewState(_:) restaura seu aplicativo à sua condição de inicialização perfeita, retirando qualquer estado de exibição existente e, em seguida, restaurando a exibição raiz original. Vamos nos aprofundar em setupRootViewController() em breve.
3. Procure "func initializeAppViewState”. Nessa implementação do método, veja a penúltima linha:

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

   Esse código define a propriedade self.window?.rootViewController como um objeto InitialViewController recém-criado. A classe InitialViewController é definida em seu aplicativo e é meio simples e sem graça. Esse modo de exibição, que é o primeiro a aparecer, é um simples contêiner para as telas de login e autorização do Salesforce. Isso é tudo o que você precisa saber. Esse método é chamado no manipulador de eventos sceneWillEnterForeground.
4. Procure “func setupRootViewController”. Ele é implantado da seguinte forma:

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

O método setupRootViewController() executa algumas etapas significativas de configuração.

• Ele carrega arquivos de configuração para os recursos offline SmartStore e Sincronização móvel.
• Ele define o controlador de exibição raiz da janela para AccountsListView, uma visualização SwiftUI personalizada que mostra uma lista de nomes de conta da organização do usuário.

Seu controlador de exibição raiz é o ponto de partida do conteúdo do seu aplicativo. Para deixar essa escolha clara para o iOS, setupRootViewController() cria um objeto UIHostingController e inicializa sua propriedade rootView para uma instância da primeira exibição do seu aplicativo. Quando isso acontece, o controle do aplicativo passa para o código personalizado. Você pode reutilizar classes de exibição e de modelo do aplicativo de modelo ou substituí-las por suas próprias soluções. De acordo com o que é discutido na próxima seção, você ainda chamará APIs do Mobile SDK para acessar recursos do Salesforce. Mas, a partir desse ponto, o fluxo, o conteúdo e a intenção do aplicativo são todos seus. Seja criativo! 

Recursos