@capgo/background-geolocation 7.0.14 → 7.0.19

package/android/src/main/java/com/capgo/capacitor_background_geolocation/BackgroundGeolocationService.java

@@ -22,358 +22,296 @@ import com.getcapacitor.Logger;
 // added, and demoted when the last background watcher is removed.
 public class BackgroundGeolocationService extends Service {
 
-  static final String ACTION_BROADCAST =
-    (BackgroundGeolocationService.class.getPackage().getName() + ".broadcast");
-  private final IBinder binder = new LocalBinder();
-
-  private static final double EARTH_RADIUS_M = 6371000;
-
-  // Must be unique for this application.
-  private static final int NOTIFICATION_ID = 28351;
-
-  private String callbackId;
-
-  private LocationManager client;
-  private LocationListener locationCallback;
-  private MediaPlayer mediaPlayer;
-  private double[][] route;
-  private double distanceThreshold;
-  private boolean isOffRoute;
-
-  @Override
-  public IBinder onBind(Intent intent) {
-    return binder;
-  }
-
-  // Some devices allow a foreground service to outlive the application's main
-  // activity, leading to nasty crashes as reported in issue #59. If we learn
-  // that the application has been killed, all watchers are stopped and the
-  // service is terminated immediately.
-  @Override
-  public boolean onUnbind(Intent intent) {
-    if (client != null && locationCallback != null) {
-      client.removeUpdates(locationCallback);
-    }
-    releaseMediaPlayer();
-    stopSelf();
-    return false;
-  }
-
-  @Override
-  public void onDestroy() {
-    if (client != null && locationCallback != null) {
-      client.removeUpdates(locationCallback);
-    }
-    super.onDestroy();
-    releaseMediaPlayer();
-  }
+    static final String ACTION_BROADCAST = (BackgroundGeolocationService.class.getPackage().getName() + ".broadcast");
+    private final IBinder binder = new LocalBinder();
 
-  private void releaseMediaPlayer() {
-    if (mediaPlayer == null) {
-      return;
-    }
-    try {
-      if (mediaPlayer.isPlaying()) {
-        mediaPlayer.stop();
-      }
-      mediaPlayer.release();
-    } catch (Exception e) {
-      Logger.error("Error releasing MediaPlayer", e);
-    }
-    mediaPlayer = null;
-  }
-
-  // Handles requests from the activity.
-  public class LocalBinder extends Binder {
-
-    void start(
-      final String id,
-      final String notificationTitle,
-      final String notificationMessage,
-      float distanceFilter
-    ) {
-      releaseMediaPlayer();
-      client = (LocationManager) getSystemService(Context.LOCATION_SERVICE);
-      callbackId = id;
-
-      locationCallback = location -> {
-        if (mediaPlayer != null) {
-          double[] point = { location.getLongitude(), location.getLatitude() };
-          var offRoute = distancePointToRoute(point) > distanceThreshold;
-          if (offRoute == true && isOffRoute == false) {
-            mediaPlayer.start();
-          }
-          isOffRoute = offRoute;
-        }
-        Intent intent = new Intent(ACTION_BROADCAST);
-        intent.putExtra("location", location);
-        intent.putExtra("id", callbackId);
-        LocalBroadcastManager.getInstance(
-          getApplicationContext()
-        ).sendBroadcast(intent);
-      };
-
-      try {
-        client.requestLocationUpdates(
-          LocationManager.GPS_PROVIDER,
-          1000,
-          distanceFilter,
-          locationCallback
-        );
-      } catch (SecurityException ignore) {
-        // According to Android Studio, this method can throw a Security Exception if
-        // permissions are not yet granted. Rather than check the permissions, which is fiddly,
-        // we simply ignore the exception.
-      }
-
-      // Promote the service to the foreground if necessary.
-      // Ideally we would only call 'startForeground' if the service is not already
-      // foregrounded. Unfortunately, 'getForegroundServiceType' was only introduced
-      // in API level 29 and seems to behave weirdly, as reported in #120. However,
-      // it appears that 'startForeground' is idempotent, so we just call it repeatedly
-      // each time a background watcher is added.
-      try {
-        // This method has been known to fail due to weird
-        // permission bugs, so we prevent any exceptions from
-        // crashing the app. See issue #86.
-        startForeground(
-          NOTIFICATION_ID,
-          createBackgroundNotification(notificationTitle, notificationMessage)
-        );
-      } catch (Exception exception) {
-        Logger.error("Failed to foreground service", exception);
-      }
-    }
+    private static final double EARTH_RADIUS_M = 6371000;
 
-    String stop() {
-      client.removeUpdates(locationCallback);
-      stopForeground(true);
-      stopSelf();
-      releaseMediaPlayer();
-      return callbackId;
+    // Must be unique for this application.
+    private static final int NOTIFICATION_ID = 28351;
+
+    private String callbackId;
+
+    private LocationManager client;
+    private LocationListener locationCallback;
+    private MediaPlayer mediaPlayer;
+    private double[][] route;
+    private double distanceThreshold;
+    private boolean isOffRoute;
+
+    @Override
+    public IBinder onBind(Intent intent) {
+        return binder;
     }
 
-    void setPlannedRoute(
-      String filePath,
-      double[][] routeCoordinates,
-      float distance
-    ) {
-      route = routeCoordinates;
-      distanceThreshold = distance;
-      isOffRoute = true;
-      try {
-        if (mediaPlayer != null) {
-          return;
+    // Some devices allow a foreground service to outlive the application's main
+    // activity, leading to nasty crashes as reported in issue #59. If we learn
+    // that the application has been killed, all watchers are stopped and the
+    // service is terminated immediately.
+    @Override
+    public boolean onUnbind(Intent intent) {
+        if (client != null && locationCallback != null) {
+            client.removeUpdates(locationCallback);
         }
-        mediaPlayer = new MediaPlayer();
-        AssetManager am = getApplicationContext().getResources().getAssets();
-        AssetFileDescriptor assetFileDescriptor = am.openFd(
-          "public/" + filePath
-        );
-
-        mediaPlayer.setDataSource(
-          assetFileDescriptor.getFileDescriptor(),
-          assetFileDescriptor.getStartOffset(),
-          assetFileDescriptor.getLength()
-        );
-        mediaPlayer.setLooping(false);
-
-        mediaPlayer.setOnErrorListener((mp, what, extra) -> {
-          Logger.error("MediaPlayer error: what=" + what + ", extra=" + extra);
-          releaseMediaPlayer();
-          return true; // Indicate we handled the error
-        });
-
-        mediaPlayer.prepareAsync();
-      } catch (Exception e) {
-        Logger.error("PlaySound: Unexpected error", e);
         releaseMediaPlayer();
-      }
-    }
-  }
-
-  private Notification createBackgroundNotification(
-    String backgroundTitle,
-    String backgroundMessage
-  ) {
-    Notification.Builder builder = new Notification.Builder(
-      getApplicationContext()
-    )
-      .setContentTitle(backgroundTitle)
-      .setContentText(backgroundMessage)
-      .setOngoing(true)
-      .setPriority(Notification.PRIORITY_HIGH)
-      .setWhen(System.currentTimeMillis());
-
-    try {
-      String name = getAppString(
-        "capacitor_background_geolocation_notification_icon",
-        "mipmap/ic_launcher",
-        getApplicationContext()
-      );
-      String[] parts = name.split("/");
-      // It is actually necessary to set a valid icon for the notification to behave
-      // correctly when tapped. If there is no icon specified, tapping it will open the
-      // app's settings, rather than bringing the application to the foreground.
-      builder.setSmallIcon(
-        getAppResourceIdentifier(parts[1], parts[0], getApplicationContext())
-      );
-    } catch (Exception e) {
-      Logger.error("Could not set notification icon", e);
+        stopSelf();
+        return false;
     }
 
-    try {
-      String color = getAppString(
-        "capacitor_background_geolocation_notification_color",
-        null,
-        getApplicationContext()
-      );
-      if (color != null) {
-        builder.setColor(Color.parseColor(color));
-      }
-    } catch (Exception e) {
-      Logger.error("Could not set notification color", e);
+    @Override
+    public void onDestroy() {
+        if (client != null && locationCallback != null) {
+            client.removeUpdates(locationCallback);
+        }
+        super.onDestroy();
+        releaseMediaPlayer();
     }
 
-    Intent launchIntent = getApplicationContext()
-      .getPackageManager()
-      .getLaunchIntentForPackage(getApplicationContext().getPackageName());
-    if (launchIntent != null) {
-      launchIntent.addFlags(Intent.FLAG_ACTIVITY_REORDER_TO_FRONT);
-      builder.setContentIntent(
-        PendingIntent.getActivity(
-          getApplicationContext(),
-          0,
-          launchIntent,
-          PendingIntent.FLAG_CANCEL_CURRENT | PendingIntent.FLAG_IMMUTABLE
-        )
-      );
+    private void releaseMediaPlayer() {
+        if (mediaPlayer == null) {
+            return;
+        }
+        try {
+            if (mediaPlayer.isPlaying()) {
+                mediaPlayer.stop();
+            }
+            mediaPlayer.release();
+        } catch (Exception e) {
+            Logger.error("Error releasing MediaPlayer", e);
+        }
+        mediaPlayer = null;
     }
 
-    // Set the Channel ID for Android O.
-    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
-      builder.setChannelId(
-        BackgroundGeolocationService.class.getPackage().getName()
-      );
+    // Handles requests from the activity.
+    public class LocalBinder extends Binder {
+
+        void start(final String id, final String notificationTitle, final String notificationMessage, float distanceFilter) {
+            releaseMediaPlayer();
+            client = (LocationManager) getSystemService(Context.LOCATION_SERVICE);
+            callbackId = id;
+
+            locationCallback = (location) -> {
+                if (mediaPlayer != null) {
+                    double[] point = { location.getLongitude(), location.getLatitude() };
+                    var offRoute = distancePointToRoute(point) > distanceThreshold;
+                    if (offRoute == true && isOffRoute == false) {
+                        mediaPlayer.start();
+                    }
+                    isOffRoute = offRoute;
+                }
+                Intent intent = new Intent(ACTION_BROADCAST);
+                intent.putExtra("location", location);
+                intent.putExtra("id", callbackId);
+                LocalBroadcastManager.getInstance(getApplicationContext()).sendBroadcast(intent);
+            };
+
+            try {
+                client.requestLocationUpdates(LocationManager.GPS_PROVIDER, 1000, distanceFilter, locationCallback);
+            } catch (SecurityException ignore) {
+                // According to Android Studio, this method can throw a Security Exception if
+                // permissions are not yet granted. Rather than check the permissions, which is fiddly,
+                // we simply ignore the exception.
+            }
+
+            // Promote the service to the foreground if necessary.
+            // Ideally we would only call 'startForeground' if the service is not already
+            // foregrounded. Unfortunately, 'getForegroundServiceType' was only introduced
+            // in API level 29 and seems to behave weirdly, as reported in #120. However,
+            // it appears that 'startForeground' is idempotent, so we just call it repeatedly
+            // each time a background watcher is added.
+            try {
+                // This method has been known to fail due to weird
+                // permission bugs, so we prevent any exceptions from
+                // crashing the app. See issue #86.
+                startForeground(NOTIFICATION_ID, createBackgroundNotification(notificationTitle, notificationMessage));
+            } catch (Exception exception) {
+                Logger.error("Failed to foreground service", exception);
+            }
+        }
+
+        String stop() {
+            client.removeUpdates(locationCallback);
+            stopForeground(true);
+            stopSelf();
+            releaseMediaPlayer();
+            return callbackId;
+        }
+
+        void setPlannedRoute(String filePath, double[][] routeCoordinates, float distance) {
+            route = routeCoordinates;
+            distanceThreshold = distance;
+            isOffRoute = true;
+            try {
+                if (mediaPlayer != null) {
+                    return;
+                }
+                mediaPlayer = new MediaPlayer();
+                AssetManager am = getApplicationContext().getResources().getAssets();
+                AssetFileDescriptor assetFileDescriptor = am.openFd("public/" + filePath);
+
+                mediaPlayer.setDataSource(
+                    assetFileDescriptor.getFileDescriptor(),
+                    assetFileDescriptor.getStartOffset(),
+                    assetFileDescriptor.getLength()
+                );
+                mediaPlayer.setLooping(false);
+
+                mediaPlayer.setOnErrorListener((mp, what, extra) -> {
+                    Logger.error("MediaPlayer error: what=" + what + ", extra=" + extra);
+                    releaseMediaPlayer();
+                    return true; // Indicate we handled the error
+                });
+
+                mediaPlayer.prepareAsync();
+            } catch (Exception e) {
+                Logger.error("PlaySound: Unexpected error", e);
+                releaseMediaPlayer();
+            }
+        }
     }
 
-    return builder.build();
-  }
-
-  // Gets the identifier of the app's resource by name, returning 0 if not found.
-  private static int getAppResourceIdentifier(
-    String name,
-    String defType,
-    Context context
-  ) {
-    return context
-      .getResources()
-      .getIdentifier(name, defType, context.getPackageName());
-  }
-
-  // Gets a string from the app's strings.xml file, resorting to a fallback if it is not defined.
-  public static String getAppString(
-    String name,
-    String fallback,
-    Context context
-  ) {
-    int id = getAppResourceIdentifier(name, "string", context);
-    return id == 0 ? fallback : context.getString(id);
-  }
-
-  private static double haversine(double[] point1, double[] point2) {
-    double lon1 = point1[0];
-    double lat1 = point1[1];
-    double lon2 = point2[0];
-    double lat2 = point2[1];
-
-    double dLat = Math.toRadians(lat2 - lat1);
-    double dLon = Math.toRadians(lon2 - lon1);
-
-    double a =
-      Math.sin(dLat / 2) * Math.sin(dLat / 2) +
-      Math.cos(Math.toRadians(lat1)) *
-      Math.cos(Math.toRadians(lat2)) *
-      Math.sin(dLon / 2) *
-      Math.sin(dLon / 2);
-
-    double c = 2 * Math.atan2(Math.sqrt(a), Math.sqrt(1 - a));
-
-    return EARTH_RADIUS_M * c;
-  }
-
-  private static double distancePointToLineSegment(
-    double[] point,
-    double[] lineStart,
-    double[] lineEnd
-  ) {
-    // Calculate the distances between the three points using Haversine
-    double dist_A_B = haversine(point, lineStart);
-    double dist_A_C = haversine(point, lineEnd);
-    double dist_B_C = haversine(lineStart, lineEnd);
-
-    // Handle the edge case where the line segment is a single point
-    if (dist_B_C == 0) {
-      return dist_A_B;
+    private Notification createBackgroundNotification(String backgroundTitle, String backgroundMessage) {
+        Notification.Builder builder = new Notification.Builder(getApplicationContext())
+            .setContentTitle(backgroundTitle)
+            .setContentText(backgroundMessage)
+            .setOngoing(true)
+            .setPriority(Notification.PRIORITY_HIGH)
+            .setWhen(System.currentTimeMillis());
+
+        try {
+            String name = getAppString("capacitor_background_geolocation_notification_icon", "mipmap/ic_launcher", getApplicationContext());
+            String[] parts = name.split("/");
+            // It is actually necessary to set a valid icon for the notification to behave
+            // correctly when tapped. If there is no icon specified, tapping it will open the
+            // app's settings, rather than bringing the application to the foreground.
+            builder.setSmallIcon(getAppResourceIdentifier(parts[1], parts[0], getApplicationContext()));
+        } catch (Exception e) {
+            Logger.error("Could not set notification icon", e);
+        }
+
+        try {
+            String color = getAppString("capacitor_background_geolocation_notification_color", null, getApplicationContext());
+            if (color != null) {
+                builder.setColor(Color.parseColor(color));
+            }
+        } catch (Exception e) {
+            Logger.error("Could not set notification color", e);
+        }
+
+        Intent launchIntent = getApplicationContext()
+            .getPackageManager()
+            .getLaunchIntentForPackage(getApplicationContext().getPackageName());
+        if (launchIntent != null) {
+            launchIntent.addFlags(Intent.FLAG_ACTIVITY_REORDER_TO_FRONT);
+            builder.setContentIntent(
+                PendingIntent.getActivity(
+                    getApplicationContext(),
+                    0,
+                    launchIntent,
+                    PendingIntent.FLAG_CANCEL_CURRENT | PendingIntent.FLAG_IMMUTABLE
+                )
+            );
+        }
+
+        // Set the Channel ID for Android O.
+        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
+            builder.setChannelId(BackgroundGeolocationService.class.getPackage().getName());
+        }
+
+        return builder.build();
     }
 
-    // Check if the angles at the line segment's endpoints are obtuse.
-    // We use the Law of Cosines (c^2 = a^2 + b^2 - 2ab*cos(C))
-    // If cos(C) < 0, the angle is obtuse.
-
-    // Angle at B (lineStart)
-    // Use a small epsilon to handle floating point inaccuracies in division by zero
-    double cos_B =
-      (Math.pow(dist_A_B, 2) + Math.pow(dist_B_C, 2) - Math.pow(dist_A_C, 2)) /
-      (2 * dist_A_B * dist_B_C);
-    if (cos_B < 0) {
-      return dist_A_B;
+    // Gets the identifier of the app's resource by name, returning 0 if not found.
+    private static int getAppResourceIdentifier(String name, String defType, Context context) {
+        return context.getResources().getIdentifier(name, defType, context.getPackageName());
     }
 
-    // Angle at C (lineEnd)
-    double cos_C =
-      (Math.pow(dist_A_C, 2) + Math.pow(dist_B_C, 2) - Math.pow(dist_A_B, 2)) /
-      (2 * dist_A_C * dist_B_C);
-    if (cos_C < 0) {
-      return dist_A_C;
+    // Gets a string from the app's strings.xml file, resorting to a fallback if it is not defined.
+    public static String getAppString(String name, String fallback, Context context) {
+        int id = getAppResourceIdentifier(name, "string", context);
+        return id == 0 ? fallback : context.getString(id);
     }
 
-    // If both angles are acute, the closest point is on the line segment itself.
-    // We can calculate the distance (height of the triangle) using its area.
-
-    // 1. Calculate the semi-perimeter of the triangle ABC
-    double s = (dist_A_B + dist_A_C + dist_B_C) / 2;
-
-    // 2. Calculate the area using Heron's formula
-    double area = Math.sqrt(
-      Math.max(0, s * (s - dist_A_B) * (s - dist_A_C) * (s - dist_B_C))
-    );
-
-    // 3. The distance is the height of the triangle from point A to the base BC
-    // Area = 0.5 * base * height  =>  height = 2 * Area / base
-    return (2 * area) / dist_B_C;
-  }
-
-  public double distancePointToRoute(double[] point) {
-    // If the polyline has less than 2 points, we can't form a segment.
-    if (this.route.length < 2) {
-      if (this.route.length == 1) {
-        return haversine(point, this.route[0]);
-      }
-      return Double.POSITIVE_INFINITY; // No line segments to measure against
+    private static double haversine(double[] point1, double[] point2) {
+        double lon1 = point1[0];
+        double lat1 = point1[1];
+        double lon2 = point2[0];
+        double lat2 = point2[1];
+
+        double dLat = Math.toRadians(lat2 - lat1);
+        double dLon = Math.toRadians(lon2 - lon1);
+
+        double a =
+            Math.sin(dLat / 2) * Math.sin(dLat / 2) +
+            Math.cos(Math.toRadians(lat1)) * Math.cos(Math.toRadians(lat2)) * Math.sin(dLon / 2) * Math.sin(dLon / 2);
+
+        double c = 2 * Math.atan2(Math.sqrt(a), Math.sqrt(1 - a));
+
+        return EARTH_RADIUS_M * c;
     }
 
-    double minDistance = Double.POSITIVE_INFINITY;
+    private static double distancePointToLineSegment(double[] point, double[] lineStart, double[] lineEnd) {
+        // Calculate the distances between the three points using Haversine
+        double dist_A_B = haversine(point, lineStart);
+        double dist_A_C = haversine(point, lineEnd);
+        double dist_B_C = haversine(lineStart, lineEnd);
+
+        // Handle the edge case where the line segment is a single point
+        if (dist_B_C == 0) {
+            return dist_A_B;
+        }
+
+        // Check if the angles at the line segment's endpoints are obtuse.
+        // We use the Law of Cosines (c^2 = a^2 + b^2 - 2ab*cos(C))
+        // If cos(C) < 0, the angle is obtuse.
+
+        // Angle at B (lineStart)
+        // Use a small epsilon to handle floating point inaccuracies in division by zero
+        double cos_B = (Math.pow(dist_A_B, 2) + Math.pow(dist_B_C, 2) - Math.pow(dist_A_C, 2)) / (2 * dist_A_B * dist_B_C);
+        if (cos_B < 0) {
+            return dist_A_B;
+        }
 
-    for (int i = 0; i < this.route.length - 1; i++) {
-      double[] lineStart = this.route[i];
-      double[] lineEnd = this.route[i + 1];
-      double distance = distancePointToLineSegment(point, lineStart, lineEnd);
-      if (distance < minDistance) {
-        minDistance = distance;
-      }
+        // Angle at C (lineEnd)
+        double cos_C = (Math.pow(dist_A_C, 2) + Math.pow(dist_B_C, 2) - Math.pow(dist_A_B, 2)) / (2 * dist_A_C * dist_B_C);
+        if (cos_C < 0) {
+            return dist_A_C;
+        }
+
+        // If both angles are acute, the closest point is on the line segment itself.
+        // We can calculate the distance (height of the triangle) using its area.
+
+        // 1. Calculate the semi-perimeter of the triangle ABC
+        double s = (dist_A_B + dist_A_C + dist_B_C) / 2;
+
+        // 2. Calculate the area using Heron's formula
+        double area = Math.sqrt(Math.max(0, s * (s - dist_A_B) * (s - dist_A_C) * (s - dist_B_C)));
+
+        // 3. The distance is the height of the triangle from point A to the base BC
+        // Area = 0.5 * base * height  =>  height = 2 * Area / base
+        return (2 * area) / dist_B_C;
     }
 
-    return minDistance;
-  }
+    public double distancePointToRoute(double[] point) {
+        // If the polyline has less than 2 points, we can't form a segment.
+        if (this.route.length < 2) {
+            if (this.route.length == 1) {
+                return haversine(point, this.route[0]);
+            }
+            return Double.POSITIVE_INFINITY; // No line segments to measure against
+        }
+
+        double minDistance = Double.POSITIVE_INFINITY;
+
+        for (int i = 0; i < this.route.length - 1; i++) {
+            double[] lineStart = this.route[i];
+            double[] lineEnd = this.route[i + 1];
+            double distance = distancePointToLineSegment(point, lineStart, lineEnd);
+            if (distance < minDistance) {
+                minDistance = distance;
+            }
+        }
+
+        return minDistance;
+    }
 }