Skip to content

Lets rethink about how we watch for firestore document changes on android.

Notifications You must be signed in to change notification settings

horaciocome1/fireflow

Repository files navigation

fireflow

License API

Getting Started

Android library that aims to hide Firebase Firestore listener implementation and expose only a Kotlin Flow of specified type. ;)
Works for ColletionReferences, Queries, and DocumentReferences.

Pre-requisites

Check the pre-requisites for Firebase Firestore and for Kotlin Flow on respective documentation.
Be familiar with Kotlin Coroutines.
Based on versions 24.0.0 and 1.4.1 of firebase-firestore-ktx and kotlinx-coroutines-play-services respectively

Adding to your project

Lets start by adding a corresponding repository in your root build.gradle file.

allprojects {
    repositories {
        ..
        maven { url 'https://jitpack.io' }
    }
}

The next task is to add the dependency to your app build.gradle file.

dependencies {
    ..
    implementation 'com.github.horaciocome1:fireflow:$VERSION'
}

Now you ready to go.
You might want to sync your project first. ;)

How to use

without fireflow

val db = FirebaseFirestore.getInstance()
val ref = db.collection("posts")
ref.addSnapshotListener { snapshot, error ->
    if (error != null) {
        // handle
    } else if (snapshot != null) {
        val posts = snapshot.toObjects(Post::class.java)
        // set posts to UI
    }
}

with fireflow

val db = FirebaseFirestore.getInstance()
db.collection("posts").asFlow<Post>().collect { posts ->
    // set posts to UI
}

You can also specify a coroutineContext. Default is Dispatchers.IO.

val db = FirebaseFirestore.getInstance()
db.collection("posts").asFlow<Post>(coroutineContext = Dispatchers.Main).collect { posts ->
   // set posts to UI
}

You can also read documents as flows

val db = FirebaseFirestore.getInstance()
db.collection("posts").document("1")
    .asFlow<Post>().collect { post ->
        // set post to UI
    }

You can also serve as livedata (if you are using Jetpack Lifecycle)

val db = FirebaseFirestore.getInstance()
db.collection("posts").document("1")
    .asFlow<Post>()
    .asLivedata()

You can also get the snapshot itself ("we never know ...")

val db = FirebaseFirestore.getInstance()
db.collection("posts").document("1")
    .snapshotAsFlow().collect { snapshot ->
        // handle
    }

Troubleshooting

There is no Java support.
For other things please open an Issue or reach me via [email protected]

Licenses

Copyright 2021 Horácio Flávio Comé Júnior

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

   http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

Not maintained by us

Firebase Firestore is a product from Google.
Kotlin is a product from Jetbrains.

How to contribute

We open to suggestions of any kind. Email me, open pull requests, etc.

More

Hope you development experience gets smootherrrrr.
If you want to see another utility please check my work on Recyclerview.
Simple RecyclerView Listener
Simple RecyclerView Adapter