Update docs

Author: christocracy

CHANGELOG.md

@@ -1,4 +1,5 @@
 ## 0.5.0 - 2020-01-03
+* [Added] [Android] New option `forceAlarmManager` for bypassing `JobScheduler` mechanism in favour of `AlarmManager` for more precise scheduling task execution.
 * [Changed] Migrate iOS deprecated "background-fetch" API to new [BGTaskScheduler](https://developer.apple.com/documentation/backgroundtasks/bgtaskscheduler?language=objc).  See new required steps in iOS Setup.
 * [Added] Added new `BackgroundFetch.scheduleTask` method for scheduling custom "onehot" and periodic tasks in addition to the default fetch-task.
 ```dart
@@ -37,8 +38,29 @@ BackgroundFetch.configure(BackgroundFetchConfig(
   print("[BackgroundFetch] taskId: $taskId");
   BackgroundFetch.finish(taskId);  // <-- [NEW] Provided taskId to #finish method.
 });
+```
+
+And with the Headless Task, as well:
+```dart
+/// This "Headless Task" is run when app is terminated.
+void backgroundFetchHeadlessTask(String taskId) async {  // <-- 1.  Headless task receives String taskId
+  print("[BackgroundFetch] Headless event received: $taskId");
+  
+  BackgroundFetch.finish(taskId);  // <-- 2.  #finish with taskId here as well.
+}
+
+void main() {
+  // Enable integration testing with the Flutter Driver extension.
+  // See https://flutter.io/testing/ for more info.
+  runApp(new MyApp());
+
+  // Register to receive BackgroundFetch events after app is terminated.
+  // Requires {stopOnTerminate: false, enableHeadless: true}
+  BackgroundFetch.registerHeadlessTask(backgroundFetchHeadlessTask);
+}
 ``` 
 
+
 ## 0.4.0 - 2019-12-17
 * [Changed] Upgrade to new Flutter Plugin API "V2".  Requires flutter sdk version 1.12.  See [Upgrading pre 1.12 Android Projects](https://github.com/flutter/flutter/wiki/Upgrading-pre-1.12-Android-projects)
 

example/android/app/src/main/java/com/transistorsoft/flutter/backgroundfetch/backgroundfetchexample/Application.java

@@ -15,7 +15,7 @@ public class Application  extends FlutterApplication {
     @Override
     public void onCreate() {
 
-        // Strict mode.
+        /// Test Strict mode.
         /*
         StrictMode.setThreadPolicy(new StrictMode.ThreadPolicy.Builder()
                 .detectDiskReads()
@@ -34,8 +34,10 @@ public void onCreate() {
 
         super.onCreate();
 
-        Log.d("TSBackgroundFetch", "*********************** MainApplication");
-
+        ///
+        /// TEST onInitialized callback for custom MethodChannel
+        ///
+        /*
         HeadlessTask.onInitialized(new HeadlessTask.OnInitializedCallback() {
             @Override
             public void onInitialized(FlutterEngine engine) {
@@ -49,10 +51,7 @@ public void onMethodCall(@NonNull MethodCall call, @NonNull MethodChannel.Result
                 });
             }
         });
-
-
-        //MethodChannel(engine.dartExecutor.binaryMessenger, CHANNEL).setMethodCallHandler { call, result ->
-        //        handleMethod(call, result, this)
+        */
 
     }
 }

example/ios/Runner.xcodeproj/xcshareddata/xcschemes/Runner.xcscheme

@@ -27,8 +27,6 @@
       selectedDebuggerIdentifier = "Xcode.DebuggerFoundation.Debugger.LLDB"
       selectedLauncherIdentifier = "Xcode.DebuggerFoundation.Launcher.LLDB"
       shouldUseLaunchSchemeArgsEnv = "YES">
-      <Testables>
-      </Testables>
       <MacroExpansion>
          <BuildableReference
             BuildableIdentifier = "primary"
@@ -38,8 +36,8 @@
             ReferencedContainer = "container:Runner.xcodeproj">
          </BuildableReference>
       </MacroExpansion>
-      <AdditionalOptions>
-      </AdditionalOptions>
+      <Testables>
+      </Testables>
    </TestAction>
    <LaunchAction
       buildConfiguration = "Debug"
@@ -61,8 +59,6 @@
             ReferencedContainer = "container:Runner.xcodeproj">
          </BuildableReference>
       </BuildableProductRunnable>
-      <AdditionalOptions>
-      </AdditionalOptions>
    </LaunchAction>
    <ProfileAction
       buildConfiguration = "Release"

example/lib/main.dart

@@ -8,14 +8,11 @@ import 'package:background_fetch/background_fetch.dart';
 
 const EVENTS_KEY = "fetch_events";
 
-const MethodChannel _methodChannel = const MethodChannel("channel_foo");
-
 
 /// This "Headless Task" is run when app is terminated.
 void backgroundFetchHeadlessTask(String taskId) async {
   print("[BackgroundFetch] Headless event received: $taskId");
   DateTime timestamp = DateTime.now();
-  _methodChannel.invokeMethod('test');
 
   SharedPreferences prefs = await SharedPreferences.getInstance();
 
@@ -32,17 +29,16 @@ void backgroundFetchHeadlessTask(String taskId) async {
 
   BackgroundFetch.finish(taskId);
 
-  /*
-  BackgroundFetch.scheduleTask(TaskConfig(
-      taskId: "foo",
-      delay: 5000,
-      periodic: false,
-      forceAlarmManager: true,
-      stopOnTerminate: false,
-      enableHeadless: true
-  ));
-
-   */
+  if (taskId == 'flutter_background_fetch') {
+    BackgroundFetch.scheduleTask(TaskConfig(
+        taskId: "foo",
+        delay: 5000,
+        periodic: false,
+        forceAlarmManager: true,
+        stopOnTerminate: false,
+        enableHeadless: true
+    ));
+  }
 }
 
 void main() {

help/INSTALL-IOS.md

@@ -42,7 +42,7 @@ __Note:__ The SDK *automatically* registers its required fetch-task **`com.trans
   .
   // [BackgroundFetch] Register your custom Background Processing task(s)
   TSBackgroundFetch *fetch = [TSBackgroundFetch sharedInstance];
-  [fetch registerBackgroundProcessingTask:@"com.foo.customtask"];
+  [fetch registerBGProcessingTask:@"com.foo.customtask"];
   .
   .
   .  

ios/Classes/BackgroundFetchPlugin.m

@@ -101,7 +101,8 @@ -(void) start:(FlutterResult)result {
 
     [fetchManager status:^(UIBackgroundRefreshStatus status) {
         if (status == UIBackgroundRefreshStatusAvailable) {
-            NSError *error = [fetchManager start:BACKGROUND_FETCH_TASK_ID];
+            [fetchManager addListener:PLUGIN_ID callback:[self createCallback]];
+            NSError *error = [fetchManager start:PLUGIN_ID];
             if (!error) {
                 result(@(status));
             } else {
@@ -116,8 +117,12 @@ -(void) start:(FlutterResult)result {
 
 -(void) stop:(NSString*)taskId result:(FlutterResult)result {
     TSBackgroundFetch *fetchManager = [TSBackgroundFetch sharedInstance];
-    if (!taskId) { taskId = BACKGROUND_FETCH_TASK_ID; }
-    [fetchManager stop:taskId];
+    if (!taskId) {
+        [fetchManager removeListener:PLUGIN_ID];
+        [fetchManager stop:nil];
+    } else {
+        [fetchManager stop:taskId];
+    }
     [self status:result];
 }
 

ios/TSBackgroundFetch.framework/TSBackgroundFetch

@@ -52,9 +52,9 @@ class _AbstractTaskConfig {
   /// import 'package:background_fetch/background_fetch.dart';
   ///
   /// // This "Headless Task" is run when app is terminated.
-  /// void backgroundFetchHeadlessTask() async {
-  ///   print('[BackgroundFetch] Headless event received.');
-  ///   BackgroundFetch.finish();
+  /// void backgroundFetchHeadlessTask(String taskId) async {
+  ///   print("[BackgroundFetch] Headless event received: $taskId");
+  ///   BackgroundFetch.finish(taskId);
   /// }
   ///
   /// void main() {
@@ -365,7 +365,7 @@ class BackgroundFetch {
   ///   print('[BackgroundFetch] Event received.');
   ///   // IMPORTANT:  You must signal completion of your fetch task or the OS could punish your app for
   ///   // spending much time in the background.
-  ///   BackgroundFetch.finish(BackgroundFetch.FETCH_RESULT_NEW_DATA);
+  ///   BackgroundFetch.finish(taskId);
   /// })
   /// ```
   static Future<int> configure(