Someday you go to the office and immediately you get a message from you boss that telling you the app got some weird crashes with the logs look like below:
Exception Type: EXC_CRASH (SIGKILL)
Exception Codes: 0x0000000000000000, 0x0000000000000000
Exception Note: EXC_CORPSE_NOTIFY
Termination Reason: Namespace SPRINGBOARD, Code 0x8badf00d
Termination Description: SPRINGBOARD, process-launch watchdog transgression: com.keyholetv.jp.i-keyholetv2 exhausted real (wall clock) time allowance of 20.00 seconds | | ProcessVisibility: Unknown | ProcessState: Running | WatchdogEvent: process-launch | WatchdogVisibility: Foreground | WatchdogCPUStatistics: ( | "Elapsed total CPU time (seconds): 2.910 (user 2.910, system 0.000), 7% CPU", | "Elapsed application CPU time (seconds): 0.000, 0% CPU" | )
Triggered by Thread: 0
It doesnāt indicate which line raise this crash?
0x8badf00d
definitely your app ate bad food š¤®
The exception code 0x8badf00d indicates that an application has been terminated by iOS because a watchdog timeout occurred. The application took too long to launch, terminate, or respond to system events. One common cause of this is doing synchronous networking on the main thread. Whatever operation is on Thread 0: needs to be moved to a background thread, or processed differently, so that it does not block the main thread.
This crash raised by multiple reasons, the most common cause of this problem is the app āleakingā a UIApplication background task.
let bgTaskId = UIApplication.shared.beginBackgroundTask(withName: "background-task-name") {
// Forget to call `UIApplication.shared.endBackgroundTask(_: bgTaskId)`.
}
We have to end background taks!
UIApplication.shared.endBackgroundTask(_: bgTaskId)
Thoughts about background taks
The UIApplication
background task mechanism allows you to prevent your app from being suspended for short periods of time. While the API involved is quite small, thereās still a bunch of things to watch out for:
-
The name background task is somewhat misappropriate. Specifically,
beginBackgroundTask(expirationHandler:)
doesnāt actually start any sort of background task, but rather it tells the system that you have started some ongoing work that you want to continue even if your app is in the background. You still have to write the code to create and manage that work. So itās best to think of the background task API as raising a ādonāt suspend meā assertion. -
You must end every background task that you begin. Failure to do so will result in your app being killed by the watchdog. For this reason I recommend that you attach a name to each background task you start (by calling
beginBackgroundTask(withName:expirationHandler:)
rather thanbeginBackgroundTask(expirationHandler:))
. A good name is critical for tracking down problems when things go wrong. -
WARNING Failing to end a background task is the #1 cause of background task problems on iOS. This usually involves some easy-to-overlook error in bookkeeping that results in the app begining a background task and not ending it. For example, you might have a property that stores your current background task identifier (of type
UIBackgroundTaskIdentifier
). If you accidentally creates a second background task and store it in that property without calling endBackgroundTask on the identifier thatās currently stored there, the app will āleakā a background task, something that will get it killed by the watchdog. - Background tasks can end in one of two ways:
- When your app has finished doing whatever it set out to do.
- When the system calls the taskās expiry handler.
Your code is responsible for calling
endBackgroundTask(_:)
in both cases. -
All background tasks must have an expiry handler that the system can use to ācall inā the task. The background task API allows the system to do that at any time.
-
Your expiry handler is your opportunity to clean things up. It should not return until everything is actually cleaned up. It must run quickly, that is, in less than a second or so. If it takes too long, your app will be killed by the watchdog.
-
Your expiry handler is called on the main thread.
-
The system puts strict limits on the total amount of time that you can prevent suspension using background tasks. On current systems you can expect values like:
- 3 minutes, when your app has moved from the foreground to the background
- 30 seconds, when your app was resumed in the background
-
WARNING Iām quoting these numbers just to give you a rough idea of what to expect. The target values have changed in the past and may well change in the future, and the amount of time you actually get depends on the state of the system. The thing to remember here is that the exact value doesnāt matter as long as your background tasks have a functional expiry handler.
-
You can get a rough estimate of the amount of time available to you by looking at
UIApplication
āsbackgroundTimeRemaining
property. -
IMPORTANT The value returned by
backgroundTimeRemaining
is an estimate and can change at any time. You must design your app to function correctly regardless of the value returned. Itās reasonable to use this property for debugging but we strongly recommend that you avoid using as part of your appās logic. -
WARNING Basing app behaviour on the value returned by
backgroundTimeRemaining
is the #2 cause of background task problems on iOS. -
The system does not guarantee any background task execution time. Itās possible (albeit unlikely, as covered in the next point) that youāll be unable to create a background task. And even if you do manage to create one, its expiry handler can be called at any time.
-
beginBackgroundTask(expirationHandler:)
can fail, returningUIBackgroundTaskInvalid
, to indicate that you the system is unable to create a background task. While this was a real possibility back when background tasks were first introduced, where some devices did not support multitasking, youāre unlikely to see this on modern systems. -
The background time āclockā only starts to tick when the background task becomes effective. For example, if you start a background task while the app is in the foreground and then stay in the foreground, the background task remains dormant until your app moves to the background. This can help simplify your background task tracking logic.
-
The amount of background execution time you get is a property of your app, not a property of the background tasks themselves. For example, starting two background task in a row wonāt give you 6 minutes of background execution time.
-
Notwithstanding the previous point, it can still make sense to create multiple background tasks, just to help with your tracking logic. For example, itās common to create a background task for each job being done by your app, ending the task when the job is done.
-
Do not create too many background tasks. How many is too many? Itās absolutely fine to create tens of background tasks but creating thousands is not a good idea.
-
IMPORTANT iOS 11 introduced a hard limit on the number of background task assertions a process can have (currently about 1000, but the specific value may change in the future). If you see a crash report with the exception code
0xbada5e47
, youāve hit that limit. -
Note The practical limit that youāre most likely to see here is the time taken to call your expiry handlers. The watchdog has a strict limit (a few seconds) on the total amount of time taken to run background task expiry handlers. If you have thousands of handlers, you may well run into this limit.
-
If youāre working in a context where you donāt have access to
UIApplication
(an app extension or on watchOS) you can achieve a similar effect usingperformExpiringActivity(withReason:using:)
. -
If your app āleaksā a background task, it may end up being killed by the watchdog. This results in a crash report with the exception code
0x8badf00d
(āate bad foodā). -
IMPORTANT A leaked background task is not the only reason for an
0x8badf00d
crash. You should look at the backtrace of the main thread to see if the main thread is stuck in your code, for example, in a synchronous networking request. If, however, the main thread is happily blocked in the run loop, a leaked background task should be your primary suspect. -
Prior to iOS 11 information about any outstanding background tasks would appear in the resulting crash report (look for the text
BKProcessAssertion
). This information is not included by iOS 11 and later, but you can find equivalent information in the system log. -
You can monitor your deviceās system log interactively using the Console app on macOS. The system log is also included in a sysdiagnose log, so if you have a problem that only shows up in the field you can ask the user to send you that. For more information about sysdiagnose logs, see the Bug Reporting > Profiles and Logs page.
- The system log is very noisy so itās important that you give each of your background tasks an easy-to-find name.
Ref: