Class

UISceneConfiguration

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

Declaration

class UISceneConfiguration : NSObject

Overview

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.

Topics

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.

Relationships

Inherits From

See Also

Configuration

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
Beta
class UISceneSession

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

Beta

Beta Software

This documentation contains preliminary information about an API or technology in development. This information is subject to change, and software implemented according to this documentation should be tested with final operating system software.

Learn more about using Apple's beta software