flutter_fgbg

KO | EN

gitlite — search

#hacktoberfest #react #llm #android #machine-learning #linux #docker #macos #windows #cli #awesome-list #vue #ios #open-source

(★ 92)

Flutter plugin to detect when app(not Flutter container) goes to background or foreground

파일 탐색기

최종 버전 다운로드 (.zip)

- .gitignore
- build.gradle
- settings.gradle
- - .gitignore
  - build.gradle.kts
  - gradle.properties
  - settings.gradle.kts
- - .gitignore
  - Podfile
  - Podfile.lock
- - main.dart
- - widget_test.dart
- .gitignore
- analysis_options.yaml
- pubspec.lock
- pubspec.yaml
- README.md
- - Package.swift
- .gitignore
- flutter_fgbg.podspec
- flutter_fgbg.dart
.fvmrc
.gitignore
.metadata
analysis_options.yaml
CHANGELOG.md
LICENSE
pubspec.yaml
README.md

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Flutter Foreground/Background Event Notifier

Flutter plugin to detect when app(not Flutter container) goes to background or foreground.

## Why

Flutter has [WidgetsBindingObserver](https://api.flutter.dev/flutter/widgets/WidgetsBindingObserver-class.html) to get notified when app changes its state from active to inactive states and back. But it actually includes the state changes of the embedding Activity/ViewController as well. So if you have a plugin that opens a new activity/view controller or in iOS if you start a FaceID prompt then WidgetsBindingObserver will report as the app is inactive/resumed.

This plugin on the other hand reports the events only at app level. Since most apps need only background/foreground events this plugin is implemented with just those events. In iOS, plugin reports `didEnterBackgroundNotification` and `willEnterForegroundNotification` notifications and in Android, plugin reports these using `androidx.lifecycle:lifecycle-process` package. In other platforms plugin fallbacks to `AppLifecycleListener` API for signals.

Checkout `example/` project to see the differences in action.

## Getting Started

Add to your pubpsec:

```shell
flutter pub add flutter_fgbg
```

Do a clean build to integrate the plugin native code to app. Otherwise you might encounter `MissingPluginException`.

Use the built in Widget:

```dart
FGBGNotifier(
    onEvent: (event) {
        print(event); // FGBGType.foreground or FGBGType.background
    },
    child: ...,
)
```

Or consume the event stream directly:

```dart
import 'package:flutter_fgbg/flutter_fgbg.dart';

StreamSubscription<FGBGType> subscription;

...
// in initState
subscription = FGBGEvents.instance.stream.listen((event) {
    print(event); // FGBGType.foreground or FGBGType.background
});

// in dispose
subscription.cancel();
```

## Caveats

In newer Android versions and `image_picker` library, picking an image will open a different app this will make Flutter app switch to background/foreground and `flutter_fgbg` will report this. At the moment there is no solution to this since the API is working as intented. Tracking the issue [here](https://github.com/ajinasokan/flutter_fgbg/issues/5).

As a work around you can use `FGBGEvents.ignoreWhile` API like this:

```dart
FGBGEvents.ignoreWhile(() async {
    await picker.pickImage(source: ImageSource.gallery);
    // or do something else that can put app to background but don't want to be handled by flutter_fgbg
});
```

flutter_fgbg

파일 탐색기

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

flutter_fgbg

파일 탐색기

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README