Fire timers in the background via NSTimer (#23674)
Fire timers in the background via NSTimer (#23674)

Summary:
This PR is a follow-up to #21211 by request of hramos to incorporate some additional crash fixes / synchronization edge cases found in our production testing.  What follows is largely a copy of the original PR description from #21211 - see that PR for original discussion thread as well as context on why this replacement PR was needed.

This PR is a minimalistic change to RCTTiming that causes it to switch exclusively to NSTimer (i.e., the 'sleep timer') in order to continue triggering timers when the app has moved to the background.

Many people have expressed a desire for background timer support on iOS. (See #1282, #167, and #16493). In our app — a podcast/audio player — we use background timers to ensure that we never lose track of the user's playback position, should the app crash or be terminated by the OS.

The RCTTimer module uses a RN-managed CADisplayLink if the next requested timer is less than a second away; otherwise, it switches to an NSTimer (which is refers to as a 'sleep timer' in source). The RN-managed CADisplayLink is always disabled when the app goes to the background (and thus cannot be used); however, the NSTimer will still issue its callbacks in the background.

This PR adds a flag to track whether the app is in the background, and if so, all timers are routed through NSTimer until the app returns to the foreground. vishnevskiy at Discord opened a similar PR (#16493) that implements a drop-in for CADisplayLink which falls back to NSTimer, but I decided to incorporate the background-NSTimer logic directly into RCTTimer, since NSTimer is already in use.

It's worth noting that the background NSTimer may not fire as often as requested — it may give the appearance of lagging depending upon your app's priority in the background. For our audio app, NSTimer fires exactly on schedule if there's an open AVAudioSession and audio is playing; if audio is not playing, it fires about half as often as requested, which is still adequate for networking polling and other tasks.

It's worth noting that background timers only function as long as an app is actually running in the background. Apple offers a variety of Background Modes (which can be toggled in the Capabilities section of the target inspector in Xcode), and the app will need to be legitimately using one of these modes in order for this change to provide any value — otherwise it will be terminated within a couple of seconds of moving to the background.

The good thing about this change is that for apps that do perform essential computation in support of their Background Mode, they can now use `setTimeout` and `setInterval` without problem — whereas in the past, neither would ever trigger their callback until the app returns to the foreground.
Pull Request resolved: https://github.com/facebook/react-native/pull/23674

Differential Revision: D14621326

Pulled By: shergin

fbshipit-source-id: c76e060ad2c662c140d7d2f4fb5aaa7094032515

myntra/react-native,myntra/react-native,exponent/react-native,myntra/react-native,hammerandchisel/react-native,javache/react-native,myntra/react-native,facebook/react-native,exponentjs/react-native,exponent/react-native,hammerandchisel/react-native,arthuralee/react-native,myntra/react-native,exponent/react-native,hammerandchisel/react-native,exponentjs/react-native,javache/react-native,janicduplessis/react-native,pandiaraj44/react-native,exponentjs/react-native,myntra/react-native,arthuralee/react-native,hoangpham95/react-native,exponentjs/react-native,hoangpham95/react-native,hammerandchisel/react-native,hoangpham95/react-native,exponent/react-native,myntra/react-native,arthuralee/react-native,facebook/react-native,hoangpham95/react-native,exponentjs/react-native,janicduplessis/react-native,hammerandchisel/react-native,pandiaraj44/react-native,javache/react-native,pandiaraj44/react-native,javache/react-native,pandiaraj44/react-native,facebook/react-native,janicduplessis/react-native,exponent/react-native,facebook/react-native,exponent/react-native,hammerandchisel/react-native,javache/react-native,janicduplessis/react-native,myntra/react-native,pandiaraj44/react-native,facebook/react-native,hammerandchisel/react-native,hoangpham95/react-native,exponentjs/react-native,pandiaraj44/react-native,pandiaraj44/react-native,javache/react-native,janicduplessis/react-native,arthuralee/react-native,janicduplessis/react-native,hoangpham95/react-native,hammerandchisel/react-native,exponentjs/react-native,arthuralee/react-native,janicduplessis/react-native,facebook/react-native,facebook/react-native,javache/react-native,myntra/react-native,javache/react-native,javache/react-native,exponent/react-native,hoangpham95/react-native,pandiaraj44/react-native,janicduplessis/react-native,facebook/react-native,hoangpham95/react-native,exponent/react-native,facebook/react-native,exponentjs/react-native