Cordova原生插件

(后台获取)Background Fetch

2017-06-29  本文已影响84人  待花谢花开

Background Fetch

iOS后台获取实现。 请参阅: https://developer.apple.com/reference/uikit/uiapplication#1657399 iOS后台获取是一个基本的API,它每15分钟(在用户黄金时段)唤醒您的应用程序,并为您的应用程序提供30秒 的后台运行时间。 当后台获取事件发生时,此插件将执行您提供的callbackFn。 没有办法提高获取事件发生的速率,此插件将速率设置为UIApplicationBackgroundFetchIntervalMinimum的最常见的可能值 - iOS会根据设备使用情况和时间自动确定速率(即:fetch- 在黄金时段时间约为15分钟,假设睡眠时间较短,例如上午3点)。(简而言之就是app在打开app之前就进行后台获取数据) 有关详细信息,请参阅 https://github.com/transistorsoft/cordova-plugin-background-fetch
Repo(备用): https://github.com/transistorsoft/cordova-plugin-background-fetch

Installation(安装)

1.安装Cordova和Ionic插件:

$ ionic cordova plugin add cordova-plugin-background-fetch
$ npm install --save @ionic-native/background-fetch

2.添加插件到app's module

Supported platforms(支持平台)

iOS

Usage(用法)

import { BackgroundFetch, BackgroundFetchConfig } from '@ionic-native/background-fetch';


constructor(private backgroundFetch: BackgroundFetch) {

  const config: BackgroundFetchConfig = {
    stopOnTerminate: false, // Set true to cease background-fetch from operating after user "closes" the app. Defaults to true.
  };

  backgroundFetch.configure(config)
     .then(() => {
         console.log('Background Fetch initialized');

         this.backgroundFetch.finish();

     })
     .catch(e => console.log('Error initializing background fetch', e));

  // Start the background-fetch API. Your callbackFn provided to #configure will be executed each time a background-fetch event occurs. NOTE the #configure method automatically calls #start. You do not have to call this method after you #configure the plugin
  backgroundFetch.start();

  // Stop the background-fetch API from firing fetch events. Your callbackFn provided to #configure will no longer be executed.
  backgroundFetch.stop();

}

Instance Members(实例成员)

configure(config)

配置插件的fetch callbackFn

参数 类型 详情
config BackgroundFetchConfig 插件配置

****Returns:** Promise<any>

start()

启动background-fetch API。 每次发生后台获取事件时,#configure提供的CallbackFn将被执行。 注意#configure方法自动调用start。 配置插件后,您不必调用此方法
****Returns:** Promise<any>

stop()

停止后台获取API从触发获取事件。 您提供给#configure的callbackFn将不再执行。
****Returns:** Promise<any>

finish()

您必须在提交给#configure的fetch callbackFn中调用此方法,以向iOS发出您的撷取操作已完成。 iOS只提供30秒的后台时间来获取事件 - 如果超过这30秒,iOS会杀死你的应用程序。
status()

返回后台获取的状态
****Returns:** Promise<any>

BackgroundFetchConfig

参数 类型 详情

设置true以在用户关闭应用程序后停止后台运行。 默认为true。(可选)

上一篇下一篇

猜你喜欢

热点阅读