galadril / Xam.Plugin.Once

A simple Xamarin Forms library to manage one-off operations.

Xam.Plugin.Once

Just a nice and library that allows you to do something once for your Xamarin Forms project.

!!This was inspired by the Once library for Android made by jonfinerty!! https://github.com/jonfinerty/Once

---

Some things should happen once.

• Users should only get the guided tour once.
• Release notes should only pop up once every app upgrade.
• Your app should only phone home to update content once every hour.

Once provides a simple API to track whether or not your app has already performed an action within a given scope.

Setup

• Available on Nuget: https://www.nuget.org/packages/Xam.Plugin.Once

!!Install into your .net standard Forms project. !!

Usage

Here are some examples on how to use Once for Xamarin Forms:

• Only run the app intro once

            Once.Instance.RunWhen(SHOW_APP_INTRO, new Command(() => UserDialogs.Instance.Toast("Show app intro")));
 

• Only show a survey every 30 days for the first time, then after 90 days

            if(Once.Instance.LastRunAt(SHOW_SURVEY) == null)
                Once.Instance.RunWhen(SHOW_SURVEY, new Command(() => UserDialogs.Instance.Toast("Show app survey")), false, new After() {RunAfter = 30, Type = After.AfterType.Days });
            else
                Once.Instance.RunWhen(SHOW_SURVEY, new Command(() => UserDialogs.Instance.Toast("Show app survey")), false, new After() {RunAfter = 90, Type = After.AfterType.Days });
 

• Just to check if we need to show the app intro

            _ = Once.Instance.NeedsToRun(SHOW_APP_INTRO);
 

• Mark a task to done

            Once.Instance.MarkRunAsDone(SHOW_APP_CHANGELOG);
 

(see sample project for more info)

Donation

If you like to say thanks, you could always buy me a cup of coffee (/beer)!
(Thanks!)