Information about the objects and storyboard for UKit to use when creating a particular scene.


class UISceneConfiguration : NSObject


Use a UISceneConfiguration object to specify information that UIKit can use to create a new scene for your app. Specifically, you must provide the class of the specific scene you want, the class of the scene delegate object your app uses to manage scenes of that type, and a storyboard containing the scene's initial view controller.

When the user requests a new instance of your app's user interface, UIKit looks in your app's Info.plist file for the configuration data it needs to create the corresponding scene object. It then packages that information into a UISceneConfiguration object and delivers it as part of the session it passes to the application(_:configurationForConnecting:options:) method of your app delegate. You can accept that configuration data as is or create a return a new UISceneConfiguration object with a different set of configuration details.


Creating a Configuration Object

init(name: String?, sessionRole: UISceneSession.Role)

Creates a scene-configuration object with the specified role and app-specific name.

Specifying the Scene Creation Details

var sceneClass: AnyClass?

The class of the scene object that you want UIKit to create.

var delegateClass: AnyClass?

The class of the custom delegate object that you want UIKit to create.

var storyboard: UIStoryboard?

The storyboard object containing your scene's initial view controller.

Getting the Configuration Attributes

var name: String?

The app-specific name assigned to the scene configuration.

var role: UISceneSession.Role

The role assigned to the scene configuration.

struct UISceneSession.Role

Constants indicating the possible roles for a scene.


Inherits From

See Also


Specifying the Scenes Your App Supports

Tell the system about your app’s scenes, including the objects you use to manage each scene and its initial user interface.

property list key UIApplicationSceneManifest

The information about the app's scene-based life-cycle support.

Name: Application Scene Manifest
class UISceneSession

An object containing information about one of your app's scenes.