Introduction
Xamarin.Forms code runs on multiple platforms - each of which has its own filesystem. This means that reading and writing files is most easily done using the native file APIs on each platform. Alternatively, embedded resources are a simpler solution to distribute data files with an app.
Firebase
Firebase gives you functionality like analytics, databases, messaging and crash reporting so you can move quickly and focus on your users.
Firebase is a back-end platform for building Web, Android, and iOS applications. It offers real-time database, different APIs, multiple authentication types and hosting platform. This is an introductory tutorial, which covers the basics of the Firebase platform and explains how to deal with its various components and sub-components.
Build apps with Firebase
- Real-time Database
- Storage
- Notifications
- Authentication
- Hosting
Prerequisites
- Visual Studio 2017 or Later(Windows or Mac)
Setting up a Xamarin.Forms Project
Start by creating a new Xamarin.Forms project. You’ll learn more by going through the steps yourself or download the source from the following GitHub link -
Visual Studio 2019 has more options in the opening window. Clone or check out the code from any repository or, open a project or solution for your computer.
Now, you need to click "Create a new project".
Now, filter by Project Type: Mobile.
Choose the Mobile App (Xamarin. forms) project under C# and Mobile.
Name your app. You probably want your project and solution to use the same name as your app. Put it on your preferred location for projects and click "Create".
Now, select the blank app and target platforms - Android, iOS and Windows (UWP).
Subsequently, go to the solution. In there, you get all the files and sources of your project (.NET Standard). Now, select XAML page and double-click to open the MainPage.Xaml page.
You now have a basic Xamarin.Forms app. Click the "Play" button to try it out.
Create a project in Firebase
In this step, create a project in Firebase. Go to the following link.
Click "Add Project".
Now, give the project a name and select your country. Then, read the terms. Afterward, click "Create project".
Now, your project is ready, click "Continue".
In this step, choose Database under the Project Overview. Now, click "Create database".
In this step, write the read and write rules.
- {
-
- "rules": {
- ".read": "auth==null",
- ".write":"auth==null"
- }
- }
Now, your Firebase Realtime Database is ready. You can use your database API URI here.
Setting up the User Interface
Go to MainPage.Xaml and write the following code.
MainPage.xaml
- <?xml version="1.0" encoding="utf-8" ?>
- <ContentPage xmlns="http://xamarin.com/schemas/2014/forms"
- xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
- xmlns:local="clr-namespace:XamarinFirebase"
- x:Class="XamarinFirebase.MainPage">
-
- <StackLayout>
- <StackLayout>
- <StackLayout HorizontalOptions="Center" VerticalOptions="Start">
- <Image x:Name="imgBanner" Source="banner.png" ></Image>
- <Image Margin="0,0,0,10" HeightRequest="100" Source="firebase.png" ></Image>
- <Label Margin="0,0,0,10" Text="Firebase Realtime Database" FontAttributes="Bold" FontSize="Large" TextColor="Gray" HorizontalTextAlignment="Center" ></Label>
- <Entry x:Name="txtId" Placeholder="ID"></Entry>
- <Entry x:Name="txtName" Placeholder="Enter Name"></Entry>
- <StackLayout HorizontalOptions="CenterAndExpand" Orientation="Horizontal">
- <Button x:Name="btnAdd" WidthRequest="200" Text="Add" Clicked="BtnAdd_Clicked"/>
- <Button x:Name="btnRetrive" WidthRequest="200" Text="Retrive" Clicked="BtnRetrive_Clicked"/>
- </StackLayout>
- <StackLayout HorizontalOptions="CenterAndExpand" Orientation="Horizontal">
- <Button x:Name="btnUpdate" WidthRequest="200" Text="Update" Clicked="BtnUpdate_Clicked" />
- <Button x:Name="btnDelete" WidthRequest="200" Text="Delete" Clicked="BtnDelete_Clicked" />
- </StackLayout>
-
- <ListView x:Name="lstPersons">
- <ListView.ItemTemplate>
- <DataTemplate>
- <TextCell Text="{Binding Name}"></TextCell>
- </DataTemplate>
- </ListView.ItemTemplate>
- </ListView>
- </StackLayout>
- </StackLayout>
- </StackLayout>
-
- </ContentPage>
Click the "Play" button to try it out.
NuGet Packages
Now, add the following NuGet packages.
Add FirebaseDatabase.net NuGet
Go to Solution Explorer and select your solution. Right-click and select "Manage NuGet Packages for Solution". Search for "FirebaseDatabase.net" and add Package. Remember to install it for each project (.NET Standard, Android, iOS, and UWP).
Create a Model
In this step, you can create a model for deserializing your response.
Person.cs
- namespace XamarinFirebase.Model
- {
- public class Person
- {
- public int PersonId { get; set; }
- public string Name { get; set; }
- }
- }
Connect Firebase
Now, write the following code to connect to your Firebase Realtime Database.
- using Firebase.Database;
- using Firebase.Database.Query;
-
- FirebaseClient firebase = new FirebaseClient("https://xamarinfirebase-xxxxx.firebaseio.com/");
-
Read All
Now, write the code to read all data from Firebase Realtime Database.
FirebaseHelper.cs
- public async Task<List<Person>> GetAllPersons()
- {
-
- return (await firebase
- .Child("Persons")
- .OnceAsync<Person>()).Select(item => new Person
- {
- Name = item.Object.Name,
- PersonId = item.Object.PersonId
- }).ToList();
- }
MainPage.Xaml.cs
- FirebaseHelper firebaseHelper = new FirebaseHelper();
- public MainPage()
- {
- InitializeComponent();
- }
-
- protected async override void OnAppearing()
- {
-
- base.OnAppearing();
- var allPersons = await firebaseHelper.GetAllPersons();
- lstPersons.ItemsSource = allPersons;
- }
Click the "Play" button to try it out.
Insert
Now, write the following code to insert data into Firebase Realtime Database.
- public async Task AddPerson(int personId,string name)
- {
-
- await firebase
- .Child("Persons")
- .PostAsync(new Person() { PersonId=personId, Name = name });
- }
-
- private async void BtnAdd_Clicked(object sender, EventArgs e)
- {
- await firebaseHelper.AddPerson(Convert.ToInt32(txtId.Text), txtName.Text);
- txtId.Text = string.Empty;
- txtName.Text = string.Empty;
- await DisplayAlert("Success", "Person Added Successfully", "OK");
- var allPersons = await firebaseHelper.GetAllPersons();
- lstPersons.ItemsSource = allPersons;
- }
Click the "Play" button to try it out.
Read
Now, write the following code to read data from Firebase Realtime Database.
- public async Task<Person> GetPerson(int personId)
- {
- var allPersons = await GetAllPersons();
- await firebase
- .Child("Persons")
- .OnceAsync<Person>();
- return allPersons.Where(a => a.PersonId == personId).FirstOrDefault();
- }
-
- private async void BtnRetrive_Clicked(object sender, EventArgs e)
- {
- var person = await firebaseHelper.GetPerson(Convert.ToInt32(txtId.Text));
- if(person!=null)
- {
- txtId.Text = person.PersonId.ToString();
- txtName.Text = person.Name;
- await DisplayAlert("Success", "Person Retrive Successfully", "OK");
-
- }
- else
- {
- await DisplayAlert("Success", "No Person Available", "OK");
- }
-
- }
Click the "Play" button to try it out.
Update
Now, write the following code to update data to Firebase Realtime Database.
- public async Task UpdatePerson(int personId, string name)
- {
- var toUpdatePerson = (await firebase
- .Child("Persons")
- .OnceAsync<Person>()).Where(a => a.Object.PersonId == personId).FirstOrDefault();
-
- await firebase
- .Child("Persons")
- .Child(toUpdatePerson.Key)
- .PutAsync(new Person() { PersonId = personId, Name = name });
- }
-
- private async void BtnUpdate_Clicked(object sender, EventArgs e)
- {
- await firebaseHelper.UpdatePerson(Convert.ToInt32(txtId.Text), txtName.Text);
- txtId.Text = string.Empty;
- txtName.Text = string.Empty;
- await DisplayAlert("Success", "Person Updated Successfully", "OK");
- var allPersons = await firebaseHelper.GetAllPersons();
- lstPersons.ItemsSource = allPersons;
- }
Click the Play button to try it out.
Delete
Now, write the following code to delete data from Firebase Realtime Database.
- public async Task DeletePerson(int personId)
- {
- var toDeletePerson = (await firebase
- .Child("Persons")
- .OnceAsync<Person>()).Where(a => a.Object.PersonId == personId).FirstOrDefault();
- await firebase.Child("Persons").Child(toDeletePerson.Key).DeleteAsync();
-
- }
-
-
- private async void BtnDelete_Clicked(object sender, EventArgs e)
- {
- await firebaseHelper.DeletePerson(Convert.ToInt32(txtId.Text));
- await DisplayAlert("Success", "Person Deleted Successfully", "OK");
- var allPersons = await firebaseHelper.GetAllPersons();
- lstPersons.ItemsSource = allPersons;
- }
Click the Play button to try it out.
Full code
FirebaseHelper.cs
- using XamarinFirebase.Model;
- using Firebase.Database;
- using Firebase.Database.Query;
- using System.Linq;
- using System.Threading.Tasks;
- using Newtonsoft.Json;
- namespace XamarinFirebase.Helper
- {
-
- public class FirebaseHelper
- {
- FirebaseClient firebase = new FirebaseClient("https://xamarinfirebase-909d2.firebaseio.com/");
-
- public async Task<List<Person>> GetAllPersons()
- {
-
- return (await firebase
- .Child("Persons")
- .OnceAsync<Person>()).Select(item => new Person
- {
- Name = item.Object.Name,
- PersonId = item.Object.PersonId
- }).ToList();
- }
-
- public async Task AddPerson(int personId,string name)
- {
-
- await firebase
- .Child("Persons")
- .PostAsync(new Person() { PersonId=personId, Name = name });
- }
-
- public async Task<Person> GetPerson(int personId)
- {
- var allPersons = await GetAllPersons();
- await firebase
- .Child("Persons")
- .OnceAsync<Person>();
- return allPersons.Where(a => a.PersonId == personId).FirstOrDefault();
- }
-
- public async Task UpdatePerson(int personId, string name)
- {
- var toUpdatePerson = (await firebase
- .Child("Persons")
- .OnceAsync<Person>()).Where(a => a.Object.PersonId == personId).FirstOrDefault();
-
- await firebase
- .Child("Persons")
- .Child(toUpdatePerson.Key)
- .PutAsync(new Person() { PersonId = personId, Name = name });
- }
-
- public async Task DeletePerson(int personId)
- {
- var toDeletePerson = (await firebase
- .Child("Persons")
- .OnceAsync<Person>()).Where(a => a.Object.PersonId == personId).FirstOrDefault();
- await firebase.Child("Persons").Child(toDeletePerson.Key).DeleteAsync();
-
- }
- }
-
- }
MainPage.Xaml.cs
- using XamarinFirebase.Helper;
- using XamarinFirebase.Model;
-
- namespace XamarinFirebase
- {
- public partial class MainPage : ContentPage
- {
- FirebaseHelper firebaseHelper = new FirebaseHelper();
- public MainPage()
- {
- InitializeComponent();
- }
-
- protected async override void OnAppearing()
- {
-
- base.OnAppearing();
- var allPersons = await firebaseHelper.GetAllPersons();
- lstPersons.ItemsSource = allPersons;
- }
-
- private async void BtnAdd_Clicked(object sender, EventArgs e)
- {
- await firebaseHelper.AddPerson(Convert.ToInt32(txtId.Text), txtName.Text);
- txtId.Text = string.Empty;
- txtName.Text = string.Empty;
- await DisplayAlert("Success", "Person Added Successfully", "OK");
- var allPersons = await firebaseHelper.GetAllPersons();
- lstPersons.ItemsSource = allPersons;
- }
-
- private async void BtnRetrive_Clicked(object sender, EventArgs e)
- {
- var person = await firebaseHelper.GetPerson(Convert.ToInt32(txtId.Text));
- if(person!=null)
- {
- txtId.Text = person.PersonId.ToString();
- txtName.Text = person.Name;
- await DisplayAlert("Success", "Person Retrive Successfully", "OK");
-
- }
- else
- {
- await DisplayAlert("Success", "No Person Available", "OK");
- }
-
- }
-
- private async void BtnUpdate_Clicked(object sender, EventArgs e)
- {
- await firebaseHelper.UpdatePerson(Convert.ToInt32(txtId.Text), txtName.Text);
- txtId.Text = string.Empty;
- txtName.Text = string.Empty;
- await DisplayAlert("Success", "Person Updated Successfully", "OK");
- var allPersons = await firebaseHelper.GetAllPersons();
- lstPersons.ItemsSource = allPersons;
- }
-
- private async void BtnDelete_Clicked(object sender, EventArgs e)
- {
- await firebaseHelper.DeletePerson(Convert.ToInt32(txtId.Text));
- await DisplayAlert("Success", "Person Deleted Successfully", "OK");
- var allPersons = await firebaseHelper.GetAllPersons();
- lstPersons.ItemsSource = allPersons;
- }
- }
- }
I hope you have understood, how to use Firebase Realtime Database with CRUD Operations in Xamarin.Forms. Thanks for reading. Please share your comments and feedback.
Happy Coding :)