README.md

Android Components > Libraries > Push-Firebase

A concept-push implementation using Firebase Cloud Messaging (FCM).

This implementation of concept-push uses Firebase Cloud Messaging. It can be used by Android devices that are supposed by Google Play Services.

Usage

Add the push service for providing the encrypted messages:

class FirebasePush : AbstractFirebasePushService()

Expose the service in the AndroidManifest.xml:

<service android:name=".push.FirebasePush">
    <intent-filter>
        <action android:name="com.google.firebase.MESSAGING_EVENT" />
    </intent-filter>
</service>

The service can be started/stopped directly if required:

val service = FirebasePush()

serivce.start()
serivce.stop()

See feature-push for more details on how to use the service with Autopush.

Setting up the dependency

Use Gradle to download the library from maven.mozilla.org (Setup repository):

implementation "org.mozilla.components:lib-push-firebase:{latest-version}"

Adding Firebase Support

Extend AbstractFirebasePushService with your own class:

class FirebasePush : AbstractFirebasePushService()

Place your keys file (google-services.json) for FCM in the app module of the project.

Optionally, add meta tags to your AndroidManifest.xml to disable the push service from automatically starting. This is not support ed yet (see #2603).

See the concept-push documentation for generic examples of using the API of components implementing concept-push.

License

This Source Code Form is subject to the terms of the Mozilla Public
License, v. 2.0. If a copy of the MPL was not distributed with this
file, You can obtain one at http://mozilla.org/MPL/2.0/