Configure pausesLocationUpdatesAutomatically in iOS (Fixes Issue#951, Supersedes PR#992)

.github/workflows/location-prepare.yaml

@@ -53,7 +53,13 @@ jobs:
       - name: Set up Flutter
         uses: subosito/flutter-action@v2
         with:
-          flutter-version: 3.27.x
+          flutter-version: ${{ matrix.flutter-version }}
+
+      - name: Set up Melos
+        run: dart pub global activate melos ^3.0.0
+
+      - name: melos bootstrap
+        run: melos bootstrap
 
       - name: Set up Java
         uses: actions/setup-java@v4
@@ -80,7 +86,13 @@ jobs:
       - name: Set up Flutter
         uses: subosito/flutter-action@v2
         with:
-          flutter-version: 3.27.x
+          flutter-version: ${{ matrix.flutter-version }}
+
+      - name: Set up Melos
+        run: dart pub global activate melos ^3.0.0
+
+      - name: melos bootstrap
+        run: melos bootstrap
 
       - name: Install tools
         run: brew install clang-format

packages/location/example/lib/change_settings.dart

@@ -19,6 +19,7 @@ class _ChangeSettingsState extends State<ChangeSettings> {
   );
 
   LocationAccuracy _locationAccuracy = LocationAccuracy.high;
+  bool _pausesLocationUpdatesAutomatically = true;
 
   @override
   void dispose() {
@@ -83,6 +84,34 @@ class _ChangeSettingsState extends State<ChangeSettings> {
                 child: Text('Powersave'),
               ),
             ],
+            decoration: const InputDecoration(
+              labelText: 'LocationAccuracy',
+            ),
+          ),
+          const SizedBox(height: 4),
+          DropdownButtonFormField<bool>(
+            value: _pausesLocationUpdatesAutomatically,
+            onChanged: (value) {
+              if (value == null) {
+                return;
+              }
+              setState(() {
+                _pausesLocationUpdatesAutomatically = value;
+              });
+            },
+            items: const <DropdownMenuItem<bool>>[
+              DropdownMenuItem(
+                value: true,
+                child: Text('True'),
+              ),
+              DropdownMenuItem(
+                value: false,
+                child: Text('False'),
+              ),
+            ],
+            decoration: const InputDecoration(
+              labelText: 'PausesLocationUpdatesAutomatically',
+            ),
           ),
           const SizedBox(height: 4),
           ElevatedButton(
@@ -91,6 +120,8 @@ class _ChangeSettingsState extends State<ChangeSettings> {
                 accuracy: _locationAccuracy,
                 interval: int.parse(_intervalController.text),
                 distanceFilter: double.parse(_distanceFilterController.text),
+                pausesLocationUpdatesAutomatically:
+                    _pausesLocationUpdatesAutomatically,
               );
             },
             child: const Text('Change'),

packages/location/ios/Classes/LocationPlugin.m

@@ -60,13 +60,17 @@ - (void)initLocation {
     self.clLocationManager = [[CLLocationManager alloc] init];
     self.clLocationManager.delegate = self;
     self.clLocationManager.desiredAccuracy = kCLLocationAccuracyBest;
+    self.clLocationManager.pausesLocationUpdatesAutomatically = true;
   }
 }
 
 - (void)handleMethodCall:(FlutterMethodCall *)call
                   result:(FlutterResult)result {
   [self initLocation];
   if ([call.method isEqualToString:@"changeSettings"]) {
+#ifdef DEBUG
+    NSLog(@"[Location] changeSettings(%@)", call.arguments);
+#endif
     if ([CLLocationManager locationServicesEnabled]) {
       CLLocationAccuracy reducedAccuracy = kCLLocationAccuracyHundredMeters;
       if (@available(iOS 14, *)) {
@@ -88,6 +92,9 @@ - (void)handleMethodCall:(FlutterMethodCall *)call
         distanceFilter = kCLDistanceFilterNone;
       }
       self.clLocationManager.distanceFilter = distanceFilter;
+      self.clLocationManager.pausesLocationUpdatesAutomatically =
+          [dictionary[call.arguments[@"pausesLocationUpdatesAutomatically"]]
+              boolValue];
       result(@1);
     }
   } else if ([call.method isEqualToString:@"isBackgroundModeEnabled"]) {

packages/location/lib/location.dart

@@ -23,19 +23,23 @@ class Location implements LocationPlatform {
   ///
   /// The [accuracy] argument is controlling the precision of the
   /// [LocationData]. The [interval] and [distanceFilter] are controlling how
-  /// often a new location is sent through [onLocationChanged].
+  /// often a new location is sent through [onLocationChanged]. The
+  /// [pausesLocationUpdatesAutomatically] argument indicates whether the
+  /// underlying location manager object may pause location updates.
   ///
   /// [interval] and [distanceFilter] are not used on web.
   @override
   Future<bool> changeSettings({
     LocationAccuracy? accuracy = LocationAccuracy.high,
     int? interval = 1000,
     double? distanceFilter = 0,
+    bool? pausesLocationUpdatesAutomatically = true,
   }) {
     return LocationPlatform.instance.changeSettings(
       accuracy: accuracy,
       interval: interval,
       distanceFilter: distanceFilter,
+      pausesLocationUpdatesAutomatically: pausesLocationUpdatesAutomatically,
     );
   }
 

packages/location/pubspec.yaml

@@ -1,6 +1,6 @@
 name: location
 description: Cross-platform plugin for easy access to device's location in real-time.
-version: 8.0.0
+version: 8.0.1
 homepage: https://docs.page/Lyokone/flutterlocation
 repository: https://github.com/Lyokone/flutterlocation
 issue_tracker: https://github.com/Lyokone/flutterlocation/issues

packages/location/test/location_test.mocks.dart

@@ -35,12 +35,15 @@ class MockLocation extends _i1.Mock implements _i3.Location {
   _i4.Future<bool> changeSettings(
           {_i2.LocationAccuracy? accuracy = _i2.LocationAccuracy.high,
           int? interval = 1000,
-          double? distanceFilter = 0.0}) =>
+          double? distanceFilter = 0.0,
+          bool? pausesLocationUpdatesAutomatically = true}) =>
       (super.noSuchMethod(
           Invocation.method(#changeSettings, [], {
             #accuracy: accuracy,
             #interval: interval,
-            #distanceFilter: distanceFilter
+            #distanceFilter: distanceFilter,
+            #pausesLocationUpdatesAutomatically:
+                pausesLocationUpdatesAutomatically
           }),
           returnValue: Future<bool>.value(false)) as _i4.Future<bool>);
   @override

packages/location_platform_interface/lib/location_platform_interface.dart

@@ -38,11 +38,14 @@ class LocationPlatform extends PlatformInterface {
   ///
   /// The [accuracy] argument is controlling the precision of the
   /// [LocationData]. The [interval] and [distanceFilter] are controlling how
-  /// often a new location is sent through [onLocationChanged].
+  /// often a new location is sent through [onLocationChanged]. The
+  /// [pausesLocationUpdatesAutomatically] argument indicates whether the
+  /// underlying location manager object may pause location updates.
   Future<bool> changeSettings({
     LocationAccuracy? accuracy,
     int? interval,
     double? distanceFilter,
+    bool? pausesLocationUpdatesAutomatically,
   }) {
     throw UnimplementedError();
   }

packages/location_platform_interface/lib/src/method_channel_location.dart

@@ -35,19 +35,24 @@ class MethodChannelLocation extends LocationPlatform {
   ///
   /// The [accuracy] argument is controlling the precision of the
   /// [LocationData]. The [interval] and [distanceFilter] are controlling how
-  /// often a new location is sent through [onLocationChanged].
+  /// often a new location is sent through [onLocationChanged]. The
+  /// [pausesLocationUpdatesAutomatically] argument indicates whether the
+  /// underlying location manager object may pause location updates.
   @override
   Future<bool> changeSettings({
     LocationAccuracy? accuracy = LocationAccuracy.high,
     int? interval = 1000,
     double? distanceFilter = 0,
+    bool? pausesLocationUpdatesAutomatically = true,
   }) async {
     final result = await _methodChannel!.invokeMethod(
       'changeSettings',
       <String, dynamic>{
         'accuracy': accuracy!.index,
         'interval': interval,
         'distanceFilter': distanceFilter,
+        'pausesLocationUpdatesAutomatically':
+            pausesLocationUpdatesAutomatically,
       },
     );
 

packages/location_platform_interface/pubspec.yaml

@@ -1,6 +1,6 @@
 name: location_platform_interface
 description: A common platform interface for the location plugin.
-version: 6.0.0
+version: 6.0.1
 homepage: https://github.com/Lyokone/flutterlocation
 
 environment:

packages/location_platform_interface/test/method_channel_location_test.dart

@@ -66,6 +66,7 @@ void main() {
           'accuracy': LocationAccuracy.high.index,
           'interval': 1000,
           'distanceFilter': 0,
+          'pausesLocationUpdatesAutomatically': true,
         },
       ),
     ]);

packages/location_web/lib/location_web.dart

@@ -26,6 +26,7 @@ class LocationWebPlugin extends LocationPlatform {
     LocationAccuracy? accuracy,
     int? interval,
     double? distanceFilter,
+    bool? pausesLocationUpdatesAutomatically,
   }) async {
     _accuracy = accuracy;
     return true;