https://github.com/ole/swiftui-view-lifecycle

Observe how different SwiftUI container views affect state and lifecycle events (onAppear, onDisappear).
https://github.com/ole/swiftui-view-lifecycle

swiftui

Last synced: 7 days ago
JSON representation

Observe how different SwiftUI container views affect state and lifecycle events (onAppear, onDisappear).

• Host: GitHub
• URL: https://github.com/ole/swiftui-view-lifecycle
• Owner: ole
• License: mit
• Created: 2022-12-07T17:25:40.000Z (about 2 years ago)
• Default Branch: main
• Last Pushed: 2023-03-18T15:10:12.000Z (almost 2 years ago)
• Last Synced: 2024-11-17T05:02:50.558Z (about 1 month ago)
• Topics: swiftui
• Language: Swift
• Homepage: https://oleb.net/2022/swiftui-view-lifecycle/
• Size: 3.46 MB
• Stars: 378
• Watchers: 5
• Forks: 18
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.md

Awesome Lists containing this project

README

        
#  SwiftUI View Lifecycle

An iOS and macOS app that demonstrates how different SwiftUI constructs and SwiftUI container views affect:

- the lifetime of `@State`

- the firing of events such as `onAppear` and `onDisappear`

By [Ole Begemann](https://oleb.net), 2022

[SwiftUI View Lifecycle app on GitHub](https://github.com/ole/swiftui-view-lifecycle>)


My article introducing the app: [Understanding View Lifecycles (2022-12-15)](https://oleb.net/2022/swiftui-view-lifecycle/)

## Usage

1. Open the project in Xcode.

2. Run the app on the iOS simulator, an iOS device, or on macOS.

3. Click through the list of examples and observe the timestamps when certain lifecycle events happened.

## Requirements

Requires iOS 16 or macOS 13.

## Screenshots

### iPhone



### iPad



### Mac



## The `LifecycleMonitor` view

All examples use one or more [`LifecycleMonitor`](https://github.com/ole/swiftui-view-lifecycle/blob/main/ViewLifecycle/LifecycleMonitor.swift) views as their content. The view below tracks its lifecycle events and displays them as constantly-updating timestamps. For example, this view got created 1:26 minutes ago, which is also when its `@State` got created. Its `.onAppear` and `.onDisappear` actions were last called 15 and 47 seconds ago, respectively:



As you interact with the app, e.g. by scrolling through a `List`, you’ll see these timestamps update (or not, depending on the container view). Pay special attention to resets of the `@State` field because this means that the view got destroyed and recreated, losing all of its internal state.

The view’s background color is set to a random color when its `@State` is created, so color changes are another indication that the view identity has changed.

## License

[MIT license](LICENSE.md)