Lifecycle Module

Usage

The Lifecycle module automatically tracks app lifecycle events and associated data. The launch event is triggered when the library is loaded for the first time, sleep event on UIApplicationWillResignActive notification and wake event on UIApplicationDidBecomeActive.

Usage of this module is recommended if you are using Adobe Analytics. Otherwise, it is optional, but the additional events captured (launch/wake/sleep) may be useful to you for other vendor implementations.

The following platforms are supported:

• iOS
• tvOS
• watchOS
• macOS

Requirements

If the UIKit dependency is added to the target app, no further configuration or implementation is necessary. For other platform builds (watchOS, macOS), the Lifecycle module functions may be triggered manually (see API Reference).

Install

Install the Lifecycle module with Swift Package Manager, CocoaPods or Carthage.

Swift Package Manager (Recommended)

Supported in version 1.9.0+, the Swift Package Manager is the recommended and simplest way to install the Tealium Swift library:

1. In your Xcode project, select File > Swift Packages > Add Package Dependency
2. Enter the repository URL: https://github.com/tealium/tealium-swift
3. Configure the version rules. Typically, "Up to next major" is recommended. If the current Tealium Swift library version does not appears in the list, then reset your Swift package cache.
4. Select the Lifecycle module from the list of modules to install and add it each of your app targets in your Xcode project, under Frameworks > Libraries & Embedded Content

Learn more about the Swift Package Manager installation for iOS.

CocoaPods

To install the Lifecycle module with CocoaPods, add the following pod to your Podfile:

pod 'tealium-swift/Lifecycle'

Learn more about the CocoaPods installation for iOS.

Carthage

To install the Lifecycle module with Carthage, following these steps:

1. Go to the app target’s General configuration page in Xcode.

2. Add the following framework to the Embedded Binaries section:

   TealiumLifecycle.framework
   

3. To import the Lifecycle library, add the following import statement to your project:

   import TealiumLifecycle
   

Learn more about the Carthage installation for iOS.

Configure

To instantiate the Lifecycle module, you must specify it in your TealiumConfig object when initializing the SDK:

import TealiumCore
import TealiumInAppPurchase

let config = TealiumConfig(account: "ACCOUNT",
                           profile: "PROFILE",
                           environment: "ENVIRONMENT",
                           datasource: "DATASOURCE")

config.collectors = [Collectors.Lifecycle]
tealium = Tealium(config: config) { _ in }

Review the Collectors documentation to understand how to correctly specify the collectors you require.

Data Layer

The following variables are transmitted with each tracking call while the module is enabled:

Crash Detection

The Lifecycle module performs basic crash detection, but does not collect any details about the cause of the crash. It records a crash whenever a lifecycle launch event is seen, without a preceding sleep event.

Normally, when an app is closed by the user, a notification from the OS triggers a lifecycle sleep event, but if the app crashes, there is no time for this to happen, and thus, no sleep event takes place. On the subsequent launch after the crash, the lifecycle_diddetectcrash variable is set to true, and the lifecycle_totalcrashcount variable is incremented by 1.

If you require more advanced crash detection, our Crash Reporter module provides full details of each crash, and the reasons for the crash. This is currently supported on iOS only.

API Reference

You only need to use the following API methods if you are targeting a platform that doesn’t support UIKit.

launchDetected()

Updates lifecycle records with a launch event and trigger a lifecycle event dispatch.

func someMethodCalledAtLaunchTime {
    tealium?.lifecycle?.launchDetected()

}

wakeDetected()

Updates lifecycle records with a wake event and trigger a lifecycle event dispatch.

func someMethodCalledWhenAppStarts {
    tealium?.lifecycle?.wakeDetected()

}

wakeDetected() calls are safely added after a launchDetected() in the same function. The module only accepts a single launch event per instantiated instance.

sleepDetected()

Update lifecycle records with a sleep event and trigger a lifecycle event dispatch.

func someMethodCalledBeforeAppTerminated {
    tealium?.lifecycle?.sleepDetected()
}

dictionary

Property that provides read-only access to the lifecycle data as a [String: Any] dictionary.

// retrieves the total wake count from the lifecycle data dictionary
let wakeCount = tealium?.lifecycle?.dictionary?["lifecycle_totalwakecount"]