Added configurable requiresExternalPower and requiresNetworkConnectivity params

.gitignore

@@ -12,3 +12,5 @@ ios/.generated
 pubspec.lock
 doc/
 build/
+example/.flutter-plugins-dependencies
+example/ios/Flutter/flutter_export_environment.sh

ios/Classes/BackgroundFetchPlugin.m

@@ -142,10 +142,14 @@ - (void) scheduleTask:(NSDictionary*)config result:(FlutterResult)result {
     long delayMS = [[config objectForKey:@"delay"] longValue];
     NSTimeInterval delay = delayMS / 1000;
     BOOL periodic = [[config objectForKey:@"periodic"] boolValue];
+    BOOL requiresExternalPower = [[config objectForKey:@"requiresCharging"] boolValue];
+    BOOL requiresNetworkConnectivity = [[config objectForKey:@"requiresNetworkConnectivity"] boolValue];
 
     NSError *error = [[TSBackgroundFetch sharedInstance] scheduleProcessingTaskWithIdentifier:taskId
                                                                                         delay:delay
                                                                                      periodic:periodic
+                                                                                     requiresExternalPower:requiresExternalPower
+                                                                                     requiresNetworkConnectivity:requiresNetworkConnectivity
                                                                                      callback:[self createCallback]];
     if (!error) {
         result(@(YES));

ios/TSBackgroundFetch.framework/Headers/TSBackgroundFetch.h

@@ -25,7 +25,7 @@
 
 -(void) configure:(NSTimeInterval)delay callback:(void(^)(UIBackgroundRefreshStatus status))callback;
 
--(NSError*) scheduleProcessingTaskWithIdentifier:(NSString*)identifier delay:(NSTimeInterval)delay periodic:(BOOL)periodic callback:(void (^)(NSString* taskId))callback;
+-(NSError*) scheduleProcessingTaskWithIdentifier:(NSString*)identifier delay:(NSTimeInterval)delay periodic:(BOOL)periodic requiresExternalPower:(BOOL)requiresExternalPower requiresNetworkConnectivity:(BOOL)requiresNetworkConnectivity callback:(void (^)(NSString* taskId))callback;
 
 -(void) addListener:(NSString*)componentName callback:(void (^)(NSString* componentName))callback;
 -(void) removeListener:(NSString*)componentName;

lib/background_fetch.dart

@@ -105,7 +105,9 @@ class _AbstractTaskConfig {
   bool requiresStorageNotLow;
 
   ///
-  /// [Android only] Specify that to run this job, the device must be charging (or be a non-battery-powered device connected to permanent power, such as Android TV devices). This defaults to false.
+  /// Specify that to run this job, the device must be charging (or be a non-battery-powered device connected to permanent power, such as Android TV devices). This defaults to [false].
+  /// 
+  /// This will use the [requiresCharging] param on Android and [requiresExternalPower] param on iOS.
   ///
   bool requiresCharging;
 
@@ -118,6 +120,12 @@ class _AbstractTaskConfig {
   ///
   bool requiresDeviceIdle;
 
+  ///
+  /// [iOS only] When set true, ensure that this job will run only when device is has network connectivity.
+  ///
+  /// The default state is false: that is, the job can run even if device does not have network connectivity.
+  bool requiresNetworkConnectivity;
+
   _AbstractTaskConfig(
       {this.stopOnTerminate,
       this.startOnBoot,
@@ -127,7 +135,8 @@ class _AbstractTaskConfig {
       this.requiresBatteryNotLow,
       this.requiresStorageNotLow,
       this.requiresCharging,
-      this.requiresDeviceIdle});
+      this.requiresDeviceIdle,
+      this.requiresNetworkConnectivity = false});
 
   Map<String, dynamic> toMap() {
     Map<String, dynamic> config = {};
@@ -145,6 +154,7 @@ class _AbstractTaskConfig {
     if (requiresCharging != null) config['requiresCharging'] = requiresCharging;
     if (requiresDeviceIdle != null)
       config['requiresDeviceIdle'] = requiresDeviceIdle;
+    config['requiresNetworkConnectivity'] = requiresNetworkConnectivity ?? false;
     return config;
   }
 }
@@ -225,6 +235,8 @@ class TaskConfig extends _AbstractTaskConfig {
     bool requiresStorageNotLow,
     bool requiresCharging,
     bool requiresDeviceIdle,
+    bool requiresExternalPower,
+    bool requiresNetworkConnectivity,
   }) : super(
             stopOnTerminate: stopOnTerminate,
             startOnBoot: startOnBoot,
@@ -234,13 +246,16 @@ class TaskConfig extends _AbstractTaskConfig {
             requiresBatteryNotLow: requiresBatteryNotLow,
             requiresStorageNotLow: requiresStorageNotLow,
             requiresCharging: requiresCharging,
-            requiresDeviceIdle: requiresDeviceIdle);
+            requiresDeviceIdle: requiresDeviceIdle,
+            requiresNetworkConnectivity: requiresNetworkConnectivity);
 
   Map<String, dynamic> toMap() {
     Map<String, dynamic> config = super.toMap();
     config['taskId'] = this.taskId;
     config['delay'] = this.delay;
     config['periodic'] = this.periodic;
+    config['requiresCharging'] = this.requiresCharging ?? false;
+    config['requiresNetworkConnectivity'] = this.requiresNetworkConnectivity ?? false;
     return config;
   }
 }