valence_push
Opt-in Firebase Messaging transport for valence. Android is the tested host
platform; Firebase delivery still needs a maintainer project. iOS is experimental
and untested. See Remote push
for native setup, background callbacks, privacy, images and acceptance checks.
Install valence_push: ^0.4.0-beta.1 only in hosts that use remote push. Keep
firebase_core: ^4.14.0 and firebase_messaging: ^16.7.0 as direct app dependencies
when importing them. Initialize Firebase, register the top-level background callback,
then pass createFirebasePush() (import package:valence_push/valence_push.dart)
to Valence.open. Replace the old no-argument ValencePush() constructor.
ValencePush.handleBackground stays in core and accepts the existing data map.
Custom transports now exchange ValencePushMessage instead of RemoteMessage.
Preserve notification envelope presence through hasNotification, even for empty
notifications, so notification messages never trigger data-only sync hints.
Core-only hosts keep valence without this package. They need no Firebase setup;
local notifications and badges remain core dependencies. Installing this package
includes the native Firebase SDKs even when no Dart code invokes them. Review
native auto-init and consent settings; a false Dart flag cannot remove those SDKs.
No SDK-version bump, wire/schema change, signing change or delivery guarantee is added.
In this monorepo, pubspec_overrides.yaml resolves the unpublished sibling core.
Pub consumers use the versioned dependency; the override is not part of the upload.
Run flutter pub get, flutter test, dart analyze --fatal-infos . here. The publish
dry run uses the local override and reports a dependency-override hint; the upload
excludes that file. Before publishing the adapter, publish core and repeat the
checks against its published version.
import 'package:flutter/widgets.dart';
import 'package:firebase_core/firebase_core.dart';
import 'package:firebase_messaging/firebase_messaging.dart';
import 'package:valence/valence.dart';
import 'package:valence_push/valence_push.dart';
import 'push_background.dart';
import 'valence/config.g.dart';
Future<Valence> openPushHost() async {
WidgetsFlutterBinding.ensureInitialized();
await Firebase.initializeApp();
FirebaseMessaging.onBackgroundMessage(pushBackgroundMessage);
return Valence.open(valenceConfig, push: createFirebasePush());
}
Libraries
- valence_push
- Opt-in Firebase Messaging transport for Valence.