incubator-callback-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From shaz...@apache.org
Subject docs commit: Fixed CB-505 - Document iOS quirks for lifecycle events and specific "resign" and "active" events
Date Mon, 16 Apr 2012 20:06:03 GMT
Updated Branches:
  refs/heads/master 3253e768e -> fc6c70610


Fixed CB-505 - Document iOS quirks for lifecycle events and specific "resign" and "active"
events


Project: http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/repo
Commit: http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/commit/fc6c7061
Tree: http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/tree/fc6c7061
Diff: http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/diff/fc6c7061

Branch: refs/heads/master
Commit: fc6c706107fae6aa8c44138b5d0917b4b0dc51b2
Parents: 3253e76
Author: shazron <shazron@gmail.com>
Authored: Mon Apr 16 13:05:58 2012 -0700
Committer: shazron <shazron@gmail.com>
Committed: Mon Apr 16 13:05:58 2012 -0700

----------------------------------------------------------------------
 docs/en/edge/cordova/events/events.pause.md  |    6 ++++++
 docs/en/edge/cordova/events/events.resume.md |   10 ++++++++++
 2 files changed, 16 insertions(+), 0 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/blob/fc6c7061/docs/en/edge/cordova/events/events.pause.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/cordova/events/events.pause.md b/docs/en/edge/cordova/events/events.pause.md
index f611abe..bc2ad94 100644
--- a/docs/en/edge/cordova/events/events.pause.md
+++ b/docs/en/edge/cordova/events/events.pause.md
@@ -70,3 +70,9 @@ Full Example
 iOS Quirks
 --------------------------
 In the pause handler, any calls that go through Objective-C will not work, nor will any calls
that are interactive, like alerts. This means that you cannot call console.log (and its variants),
or any calls from Plugins or the Cordova API. These will only be processed when the app resumes
(processed on the next run-loop).
+
+- __resign__ event 
+
+    This iOS specific event is available as a variant of the **pause** event, and is often
used to detect when the "Lock" button has been pressed to lock the device when your app is
the foreground app. If your app (and device) is enabled for multi-tasking, this will be paired
with a subsequent **pause** event, but only under iOS 5 (effectively all "locked" apps in
iOS 5 that have multi-tasking enabled are put to the background). 
+    
+    Under iOS 5, if you want your app to still run when the device is locked, you will have
to disable multi-tasking (UIApplicationExitsOnSuspend - YES) for your app. This is different
when you are on iOS 4 - to have your app run when the device is locked, the multi-tasking
setting for your app does not matter.

http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/blob/fc6c7061/docs/en/edge/cordova/events/events.resume.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/cordova/events/events.resume.md b/docs/en/edge/cordova/events/events.resume.md
index 1d0e90a..6e5675b 100644
--- a/docs/en/edge/cordova/events/events.resume.md
+++ b/docs/en/edge/cordova/events/events.resume.md
@@ -66,3 +66,13 @@ Full Example
       <body onload="onLoad()">
       </body>
     </html>
+
+iOS Quirks
+--------------------------
+Any calls to console.log during your **pause** event handler will be run now when the app
resumes, see the iOS Quirks section for the **pause** event for an explanation. 
+
+- __active__ event 
+
+    This iOS specific event is available as a variant of the **resume** event, and is often
used to detect when the "Lock" button has been pressed to unlock the device when your app
is the foreground app. If your app (and device) is enabled for multi-tasking, this will be
paired with a subsequent **resume** event, but only under iOS 5 (effectively all "locked"
apps in iOS 5 that have multi-tasking enabled are put to the background). 
+    
+    Under iOS 5,  if you want your app to still run when the device is locked, you will have
to disable multi-tasking (UIApplicationExitsOnSuspend - YES) for your app. This is different
when you are on iOS 4 - to have your app run when the device is locked, the multi-tasking
setting for your app does not matter.


Mime
View raw message