Skip to content

A lightweight controller for managing transitions between "unauthenticated" and "authenticated" interfaces on iOS, written in Swift.

License

Notifications You must be signed in to change notification settings

cgossain/AppController

Repository files navigation

AppController

AppController was originaly inspired by the architecture described in this blog post.

The AppController is a lightweight controller for managing transitions between "unauthenticated" and "authenticated" interfaces on iOS. Many apps implement this lazily by presenting an authentication sheet above the main app interface. This is fine for some applications, however if you're looking for something more robust, the structure implemented by AppController offers a clean and clear separation of concerns between interfaces for each authentication state. It manages interface transitions using Apple approved view controller containment API, and removes the unused view hierarchy from memory once the transition is complete.

By keeping your "unauthenticated" and "authenticated" view hierarchies completely separate, you can write cleaner code and build more compelling onboarding experiences.

The included example project showcases the core functionality of this library.

CI Status Version License Platform

Requirements

  • iOS 10.3
  • Swift 5.0

Installation

AppController is available through CocoaPods. To install it, simply add the following line to your Podfile:

pod "AppController"

Usage

AppControllerInterfaceProviding

AppControllerInterfaceProviding is a protocol that vends your view hierarchies for the unauthenticated and authenticated states. It also provides configuration settings for the transition.

class MyAwesomeInterfaceProvider: AppControllerInterfaceProviding {

    func configuration(for appController: AppController, traitCollection: UITraitCollection) -> AppController.Configuration {
      // return a configuration model for the transition
      // note that the default configuration is being returned here, but it can be further configured
      return AppController.Configuration()
    }

    func loggedOutInterfaceViewController(for appController: AppController) -> UIViewController {
        // create and return your logged out interface view controller
        let welcomeViewController = WelcomeViewController()
        return welcomeViewController
    }

    func loggedInInterfaceViewController(for appController: AppController) -> UIViewController {
        // create and return your logged in interface view controller
        let tabBarController = UITabBarController()
        return tabBarController
    }

    func isInitiallyLoggedIn(for: AppController) -> Bool {
        // return `true` if the "logged in" interface should be initially loaded instead
        return false
    }

}

AppViewController

AppViewController is a custom container view controller where transitions between your unauthenticated and authenticated states are performed.

You do not need to interact with this view controller directly.

AppController

AppController is the object that manages the entire transition.

You create an instance of AppController, and then call its installRootViewController(in:) method passing in your window object. This installs an instance of AppViewController (that is managed by the AppController) as the root view controller of your window object.

import UIKit
import AppController

@UIApplicationMain
class AppDelegate: UIResponder, UIApplicationDelegate {

    var window: UIWindow?
    let myAwesomeInterfaceProvider = MyAwesomeInterfaceProvider()

    lazy var appController: AppController = {
        let controller = AppController(interfaceProvider: self.myAwesomeInterfaceProvider)

        // do stuff just before login transition...
        controller.willLoginHandler = { [unowned self] (targetViewController) in

        }

        // do stuff right after login transition...
        controller.didLoginHandler = { [unowned self] in

        }

        // do stuff just before logout transition...
        controller.willLogoutHandler = { [unowned self] (targetViewController) in

        }

        // do stuff right after logout transition...
        controller.didLogoutHandler = { [unowned self] in

        }

        return controller
    }()

    func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplicationLaunchOptionsKey: Any]?) -> Bool {
        let myWindow = UIWindow()
        window = myWindow

        // install the app controllers' root view controller as the root view controller of the window
        appController.installRootViewController(in: myWindow)

        return true
    }

}

Performing the Transitions

Transition to the authenticated view hierarchy:

AppController.login()

Transition to the unauthenticated view hierarchy:

AppController.logout()

Storyboard Support

If you use a storyboard file, you can easily configure the AppController to use it. Just ensure the initialViewController is an AppViewController, and add Storyboard IDs for you're "logged out" and "logged in" interfaces contained in storyboard file.

import UIKit
import AppController

@UIApplicationMain
class AppDelegate: UIResponder, UIApplicationDelegate {

    var window: UIWindow?

    lazy var appController: AppController = {
        return AppController(storyboardName: "Main", loggedOutInterfaceID: "<Storyboad ID of `unauthenticated` view hierarchy>", loggedInInterfaceID: "<Storyboad ID of `authenticated` view hierarchy>")
    }()

    func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplicationLaunchOptionsKey: Any]?) -> Bool {
        // install the app controllers' root view controller as the root view controller of the window
        appController.installRootViewController(in: window!)

        return true
    }

}

Author

Christian Gossain, cgossain@gmail.com

License

AppController is available under the MIT license. See the LICENSE file for more info.

About

A lightweight controller for managing transitions between "unauthenticated" and "authenticated" interfaces on iOS, written in Swift.

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published