[tor-bugs] #24107 [Core Tor/Tor]: Write a design document for the control interface for enhanced battery awareness on Android devices

[Tor Bug Tracker & Wiki]

#24107: Write a design document for the control interface for enhanced battery
awareness on Android devices
-------------------------------------------------+-------------------------
 Reporter:  ahf                                  |          Owner:  nickm
     Type:  defect                               |         Status:
                                                 |  assigned
 Priority:  Medium                               |      Milestone:  Tor:
                                                 |  0.3.4.x-final
Component:  Core Tor/Tor                         |        Version:
 Severity:  Normal                               |     Resolution:
 Keywords:  s8-battery, s8-control, s8-201711    |  Actual Points:
  TorCoreTeam201711.1                            |
Parent ID:                                       |         Points:
 Reviewer:                                       |        Sponsor:
                                                 |  Sponsor8
-------------------------------------------------+-------------------------

Comment (by mtigas):

 This looks great to me. Don't know the specifics of Android, but what
 you've got would be super useful for the limited callbacks we get on iOS:
 https://developer.apple.com/library/content/documentation/iPhone/Conceptual/iPhoneOSProgrammingGuide/TheAppLifeCycle/TheAppLifeCycle.html#//apple_ref/doc/uid/TP40007072-CH2-SW3

 The app's `applicationWillResignActive:` or `applicationDidEnterBackground
 :` are where I'd likely call `SIGNAL SLEEP`, and likewise with
 `applicationDidBecomeActive:` and `SIGNAL WAKEUP`. (Right now I think I
 only call `SIGNAL HUP` at `applicationDidBecomeActive:` time, which
 doesn't always gracefully recover from the iOS background state. So think
 this will be very useful.)


 But yeah, LGTM (from the iOS point of view).

--
Ticket URL: <https://trac.torproject.org/projects/tor/ticket/24107#comment:6>
Tor Bug Tracker & Wiki <https://trac.torproject.org/>
The Tor Project: anonymity online