NS for iOS Devs — View Lifecycle
By: Candost Dağdeviren
Tags: Software, iOS App Development, Best Practices, iOS, Software Development

Photo by Matt Antonioli on Unsplash

Read this post in a better format on my website.

The next thing after learning Application Lifecycle, the view lifecycle holds an important position in every iOS developer’s life.

Each view is created either using storyboards, xibs, or using a programmatic approach. Independent from the approach, truly understanding when the view is created, loaded, appeared, or destroyed helps us to understand our approach deeply while developing the screen designs, animations, and even business logic.

Ok, but why do we need to know?

When we think of the application lifecycle, we easily see that there are certain things happening as the application goes to background, suspended, etc. Whenever the user interacts with the app, some certain action happens and the state of the app may change. However, the state of a view may change with any user interaction or any change in the app’s data.

On the other hand, we might need to manipulate the user interface when there is a certain state transition in the view. For example, if we would like to use custom views and set them to UIViewController ’s view, we have to do it in a loadView method. Or, if our design requires us to have minor differences between landscape and portrait mode, we need to know when we can make this change in the code. Therefore, understanding all lifecycle methods not only helps us in code but also enables us to be more creative and implement an advanced user interface.

What do we need to know?

In order to use the view in suitable positions, we need to know when the view is created, loaded, appeared, changed, disappeared, and terminated. Subclasses of UIViewController is responsible for managing the views (aka. UIView s). View controller has one root view which is a UIView instance. The important thing here is how do they work together.

UIViewController handles all the magic behind UIView while UIView just represents the screen and some content to the user. UIViewController tells the root UIView object when to come to the screen. First, the view controller creates its root view and loads it. After loading, it tells the view to appear on the screen, and disappear when necessary.

Furthermore, a view controller might be a child of another view controller. So, the lifecycle of the view controller not only cares about its root view, but it also includes the relationship with other view controllers like does it moved to the parent view controller or not.

Lastly, the view controller’s root view (aka. UIView) has its own content and lifecycle. The root view has its subviews like buttons, labels, switches, or other UIView subclasses. The lifecycle of the subviews is in most cases not considered by every developer. But there is one common case which is embedding a view controller into another. In this case, we need to imitate the lifecycle actions for both view controller’s views and call proper methods when necessary.

How do we get notified about lifecycle events?

UIViewController has a lot of methods to inform us when some certain action happened. For example, we can override viewDidLoad method to do some actions right after loading the view. Or use loadView method to replace UIViewController’s root UIView with our custom UIView class.

We’ll take a look at the relationships between the combination of views and view controllers to learn the current state. Instead of focusing too much on what each method does, we’ll take a look at what is important for each method and when to use them.

UIView — UIViewController Relationship

loadView : This is where the root view of the view controller is loaded. view property of UIViewController is nil at the moment.

We need to override this method if we want to create a custom view and set it to view property. If the Interface Builder is used to create the view and initialize the view controller, this method must not be overridden. Once we override this method, we have to initialize our custom view and set it to view property of UIViewController and never call super.loadView because it creates the view by itself and assigns to view . Lastly, we shouldn’t call this method directly.

viewDidLoad : This is called only once after creating the view and loading it into memory. But the bounds of the view is not defined yet. We generally override this method to initialize the objects which the view controller will use. We shouldn't forget to call super when we override.

: This is called only once after creating the view and loading it into memory. But the of the view is not defined yet. We generally override this method to initialize the objects which the view controller will use. We shouldn't forget to call super when we override. viewWillAppear(_:) : This method is called right before the view will appear on the screen. When this is called, the view’s bounds are defined but the orientation is not set yet. We need to be careful while using appear methods since they will be called every time the view comes to the screen. Similarly, we shouldn’t forget to call super.

: This method is called right before the view will appear on the screen. When this is called, the view’s bounds are defined but the orientation is not set yet. We need to be careful while using appear methods since they will be called every time the view comes to the screen. Similarly, we shouldn’t forget to call super. viewDidAppear(_:) : This method is called right after the view is visible to the user. It’s a good place to start animations. Same as before, we shouldn’t forget to call super.

: This method is called right after the view is visible to the user. It’s a good place to start animations. Same as before, we shouldn’t forget to call super. viewWillLayoutSubviews : This is the first place to learn the bounds of the view in the lifecycle. This is called also right before layoutSubviews method is triggered in UIView . This is also called when the subviews of the root view are loaded. For example; this is called when the cells of the collection view are loaded.

: This is the first place to learn the bounds of the view in the lifecycle. This is called also right before method is triggered in . This is also called when the subviews of the root view are loaded. For example; this is called when the cells of the collection view are loaded. viewDidLayoutSubviews : This is called right after layoutSubviews called. The subviews have been set and size, position, and constraints are applied.

viewWillLayoutSubviews and viewDidLayoutSubviews are also called when the orientation of the screen changed between portrait and landscape modes. So the key point is, whenever the bounds of the view are updated or the view layout is recalculated, both methods will be called. Similarly, we shouldn’t forget to call super at some point in these methods.

viewWillDisappear(_:) : This is called when the view is about to disappear from the screen. One thing we can do here is saving the user data to not lose anything important. Another thing we might be canceling network requests. We can override this method also if we want to handover first responder jobs to another view when the view disappears.

: This is called when the view is about to disappear from the screen. One thing we can do here is saving the user data to not lose anything important. Another thing we might be canceling network requests. We can override this method also if we want to handover first responder jobs to another view when the view disappears. viewDidDisappear(_:) : This is called when the view is disappeared from the screen. The view is removed from the view hierarchy at the moment.

Complete lifecycle of a View in ViewController

We took a look at the most common relationship, view, and view controller relationship which was also a default one implemented by UIKit. But the view controller not only gets in a relationship with a view but also with other view controllers like a child and parent.

UIViewController — UIViewController Relationship

Understanding this relationship and lifecycle of view controller are important things if we embed one view controller to another. Because we might need to manually call some lifecycle methods to inform the system about the state. Let’s have an example of adding and removing child view controllers.

Let’s examine what are we doing about lifecycle. After creating view controllers we add the child to the parent. This addition automatically calls childViewController.willMove(toParent: parentViewController) for us. So, we don’t need to call it manually. Then, we need to add the child view controller’s view to the parent’s view in order to have a child-parent relationship for views. The system will load both views and will add one to another with our call addSubview . Then we inform the system by calling didMove(toParent:) and the system will handle the rest for displaying the view controller and calling the view controller’s necessary methods in its lifecycle like viewDidLoad , viewDidAppear etc.

On the other side, while removing the child view controller from the parent, we have to call willMove(toParent:) method with nil to inform the system about the child view controller is going to be removed from the parent. Then, we remove its view and later itself from the parent. As we see, we don’t need to call didMove(toParent:) method while we’re removing it. removeFromParent method automatically calls that method for us.

Additionally, we can override both willMove(toParent:) and didMove(toParent:) . If we need to know in a view controller that it’s been added as a child to another view controller, we can override these methods and implement our custom actions.

Parent and child view controller relationships are common. It’s important to understand the lifecycle of both view controllers in order to call the necessary method at a certain point. If we forget to call one method, we might lead to some memory problems inside the app. Now, we came to the last point — the relationship between the view and its subviews and lifecycle methods.

View — View (Subviews) Relationship

In this relationship, most of the lifecycle is handled automatically by the system, and no need for calling some methods like parent and child view controllers relationship. For example, even if we try to call willRemoveSubview method, it does nothing. The default implementation is empty. The system calls the below functions only to inform us when something is changed. There are not so many things to talk about. Learning that we have the place to detect when the subview is added or the view is added as subview or moved to window opens up the opportunities for implementing extra actions during those phases.

Here are the mentioned lifecycle methods for UIView :

didAddSubview(_:)

willRemoveSubview(_:)

willMove(toSuperView:)

didMoveToSuperview

willMove(toWindow:)

didMoveToWindow

The only importing thing to know here is removeFromSuperview method. We can call this if we want to remove the view from its parent. Calling this method removes all constraints in the view and in its subtrees. We shouldn’t call this method inside the view’s draw(_:) method.

Last Words

Only knowing one of the applications, view controller, view lifecycles is not enough to understand the whole picture and develop a great overview of iOS applications. Grasping the use of lifecycle methods is important to take appropriate actions in certain places especially working with custom implementations of UIKit classes. Now we know the lifecycles, we can truly understand what is going on behind the scenes in the system and intervene when necessary.

Which strategies do you follow while working with view lifecycle? What do you think about the importance of the view and view controller relationships? Should Apple gives more freedom to manipulate lifecycle or do you find some workarounds to make these kinds of wishes happen? Let me know your thoughts, comments, or feedback on Twitter @candostEN.