Grundlegendes zu nativen Forceios-Anwendungen

Lernziele

Mit Trail Together einem Dozenten folgen

Möchten Sie bei diesem Schritt einem Experten folgen? Schauen Sie sich dieses Video an, das Teil der Reihe "Trail Together" ist.

(Dieser Clip beginnt bei Minute 14:49, für den Fall, dass Sie zurückspringen und den Anfang des Schritts noch einmal sehen möchten.)

Übersicht über den Anwendungs-Flow

Das folgende Diagramm veranschaulicht den Flow beim Hochfahren für eine native Anwendung mit dem umfassenden SDK-Manager: MobileSyncSDKManager. Dieser Manager ermöglicht die Authentifizierung und umfasst Offline-Funktionen des Mobile SDK.

Standardmäßig verwenden native forceios-Anwendungen MobileSyncSDKManager, eine spezielle Unterklasse von SalesforceManager, um das Mobile SDK zu initialisieren. Diese Klasse stellt die gesamte Palette von Mobile SDK-Funktionen zur Verfügung.

Anwendungsstart-Flow

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

MobileSyncSDKManager.shared

In Swift-Anwendungen ab iOS 13 übernimmt SceneDelegate die zentrale Rolle als Manager von SwiftUI-Ansichten. SceneDelegate verarbeitet die Lebenszyklusereignisse einer Szene wie z. B. 

• Verbindung mit der Anwendung herstellen
• In den Vordergrund oder in den Hintergrund treten
• Aktiv oder inaktiv werden
• Größe ändern

Sie können Ihre SceneDelegate-Klasse anpassen, um Ihre eigene Behandlung für diese Ereignisse hinzuzufügen. Die Vorlagenanwendung macht es Ihnen sogar besonders leicht, denn sie bietet Kommentare in wichtigen Ereignishandlern, die Ihnen sagen, wie Sie vorgehen müssen.

In Mobile SDK-Begriffen ist die SceneDelegate-Klasse der Ort, an dem Ihre benutzerdefinierten Ressourcen die Steuerung übernehmen. Die Vorlagenanwendung verwendet SceneDelegate für Folgendes: 

• Anzeigen des Salesforce-Anmeldebildschirms bei Bedarf, entweder bevor sich ein Benutzer angemeldet hat oder immer dann, wenn sich ein Benutzer abmeldet
• Zurücksetzen des Ansichtszustands, wenn sich der aktuelle Benutzer abmeldet
• Importieren von Konfigurationsdateien für die Offline-Funktionen von SmartStore und Mobile Sync
• Festlegen der Stammansicht des Fensters auf die erste benutzerdefinierte Ansicht in der Anwendung

Werfen wir doch mal einen Blick auf den Quellcode, um zu sehen, wie die Anwendung ihre Ansichten darstellt.

1. Öffnen Sie in Xcode die Datei "SceneDelegate.swift".
2. Ganz oben in der Klasse sehen Sie die erste Funktionsdefinition.

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

   Diese Methode ist die erste Station für jede Szene, die initialisiert werden soll. Die ersten drei Zeilen sind Bausteincode. Sie "verbinden" die Szene mit der Anwendung, d. h. sie fügen die Szene an ein Anwendungsfenster an, damit sie angezeigt werden kann. Die letzte Anweisung in dieser Methode konfiguriert die AuthHelper-Klasse des Mobile SDK, um Benachrichtigungen über Änderungen des aktuellen Benutzers zu behandeln. Der Handler selbst ist der interne Block innerhalb des Aufrufs der Methode AuthHelper.registerBlock(_:). Er ruft zwei benutzerdefinierte private Methoden auf: resetViewState(_:) und setupRootViewController(). Die Methode resetViewState(_:) stellt die ursprüngliche Startbedingung Ihrer Anwendung wieder her, indem sie alle vorhandenen Ansichtszustände entfernt und dann die ursprüngliche Stammansicht wiederherstellt. Wir gehen in Kürze auf setupRootViewController() ein.
3. Suchen Sie nach "func initializeAppViewState". Sehen Sie sich in dieser Implementierung der Methode die vorletzte Zeile an:

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

   Dieser Code legt die Eigenschaft self.window?.rootViewController auf ein neu erstelltes InitialViewController-Objekt fest. Die InitialViewController-Klasse ist in ihrer Anwendung definiert, ziemlich spärlich und langweilig. Diese Ansicht, die als erste angezeigt wird, ist lediglich ein Container für die Salesforce-Bildschirme für Anmeldung und Autorisierung. Das ist alles, was Sie darüber wissen müssen. Diese Methode wird vom Ereignishandler sceneWillEnterForeground aufgerufen.
4. Suchen Sie nach "func setupRootViewController". Die Implementierung geschieht wie folgt:

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

Die Methode setupRootViewController() führt einige wichtige Einrichtungsschritte durch.

• Sie lädt Konfigurationsdateien für die Offline-Funktionen von SmartStore und Mobile Sync.
• Sie legt das Stammansichtssteuerfeld des Fensters auf AccountsListView fest, eine benutzerdefinierte SwiftUI-Ansicht, die eine Liste von Accountnamen aus der Organisation des Benutzers anzeigt.

Ihr Stammansichtssteuerfeld ist der Ausgangspunkt für die Inhalte Ihrer Anwendung. Um diese Wahl für iOS zu verdeutlichen, erstellt setupRootViewController() ein UIHostingController-Objekt und initialisiert dessen rootView-Eigenschaft mit einer Instanz der ersten Ansicht Ihrer Anwendung. Wenn dies geschieht, geht die Steuerung der Anwendung an Ihren benutzerdefinierten Code über. Sie können View- und Model-Klassen aus der Vorlagenanwendung wiederverwenden oder durch eigene Lösungen ersetzen. Wie im nächsten Abschnitt erörtert, rufen Sie weiterhin Mobile SDK-APIs auf, um auf Salesforce-Ressourcen zuzugreifen. Aber von diesem Punkt an gehören Flow, Inhalt und Absicht der Anwendung ganz Ihnen. Seien Sie kreativ! 

Ressourcen