Implement cross-platform push completion handling for background tasks.

Added Display.notifyPushCompletion() to manually signal the completion of a background push task (e.g. playing audio).
On iOS, this delays the call to the system completion handler if the `ios.delayPushCompletion` or `delayPushCompletion` property is set.
On Android, this releases a partial WakeLock acquired when the push is received, preventing the device from sleeping during the task if the `android.delayPushCompletion` or `delayPushCompletion` property is set.
Updated `IOSImplementation`, `AndroidImplementation`, and `PushNotificationService` to support this logic.

Author: google-labs-jules[bot]

Ports/Android/src/com/codename1/impl/android/AndroidImplementation.java

@@ -52,7 +52,8 @@
 import android.graphics.drawable.Drawable;
 import android.media.AudioManager;
 import android.net.Uri;
-import android.os.Vibrator;
+import android.os.Vibrator;
+import android.os.PowerManager;
 import android.telephony.TelephonyManager;
 import android.util.DisplayMetrics;
 import android.util.Log;
@@ -280,6 +281,19 @@ public static void setActivity(CodenameOneActivity aActivity) {
     private int displayHeight;
     static CodenameOneActivity activity;
     static ComponentName activityComponentName;
+    private static PowerManager.WakeLock pushWakeLock;
+    public static void acquirePushWakeLock(long timeout) {
+        if (getContext() == null) return;
+        try {
+            if (pushWakeLock == null) {
+                PowerManager pm = (PowerManager) getContext().getSystemService(Context.POWER_SERVICE);
+                pushWakeLock = pm.newWakeLock(PowerManager.PARTIAL_WAKE_LOCK, "CN1:PushWakeLock");
+            }
+            pushWakeLock.acquire(timeout);
+        } catch (Exception ex) {
+            com.codename1.io.Log.e(ex);
+        }
+    }
 
     private static Context context;
     RelativeLayout relativeLayout;
@@ -2784,6 +2798,17 @@ public void exitApplication() {
     }
 
     @Override
+    @Override
+    public void notifyPushCompletion() {
+        if (pushWakeLock != null && pushWakeLock.isHeld()) {
+            try {
+                pushWakeLock.release();
+            } catch (Exception ex) {
+                com.codename1.io.Log.e(ex);
+            }
+        }
+    }
+
     public void notifyCommandBehavior(int commandBehavior) {
         if (commandBehavior == Display.COMMAND_BEHAVIOR_NATIVE) {
             if (getActivity() instanceof CodenameOneActivity) {

Ports/Android/src/com/codename1/impl/android/PushNotificationService.java

@@ -109,9 +109,17 @@ public void onDestroy() {
     public void push(final String value) {
         final PushCallback callback = getPushCallbackInstance();
         if(callback != null) {
+            AndroidImplementation.acquirePushWakeLock(30000);
             Display.getInstance().callSerially(new Runnable() {
                 public void run() {
-                    callback.push(value);
+                    try {
+                        callback.push(value);
+                    } finally {
+                        if (!"true".equals(Display.getInstance().getProperty("delayPushCompletion", "false")) &&
+                            !"true".equals(Display.getInstance().getProperty("android.delayPushCompletion", "false"))) {
+                            Display.getInstance().notifyPushCompletion();
+                        }
+                    }
                 }
             });
         } else {

Ports/iOSPort/src/com/codename1/impl/ios/IOSImplementation.java

@@ -8115,7 +8115,10 @@ public void run() {
 
                         pushCallback.push(message);
                     } finally {
-                        nativeInstance.firePushCompletionHandler();
+                        if (!"true".equals(Display.getInstance().getProperty("delayPushCompletion", "false")) &&
+                            !"true".equals(Display.getInstance().getProperty("ios.delayPushCompletion", "false"))) {
+                            nativeInstance.firePushCompletionHandler();
+                        }
                     }
                 }
             });