Xamarin.Android.Service 1.0.0

Dyme Xamarin Forms Android Service

What is it?

• A background/foreground/service/notification for Xamarin Android projects (its what you might consider a background service, but its called a foreground service, and includes a notification that the user can interact with and monitor).
• A Nuget package for Xamarin Forms projects.

Pre-Setup

You must add the Foreground Service Permission to your Android app's manifest...

<uses-permission android:name="android.permission.FOREGROUND_SERVICE" />

Implementations

There are several ways that you can implement the service.

Basic Implementation

This is if you just want a simple notification that lives beyond the lifetime of your application.

// Create and start a service...
_service = await ServiceManager.Start("My Service", "Hello world!");

// Stop the service...
_simpleService.StopService(removeNotification: true);

Full Implementation

If you want to perform tasks from within the service.

1. Implement the ISimpleService interface.

public class MyService : ISimpleService
{
    public void OnExecuteAction(string actionName, IList<string> args)
    {
        // Event handler for actions declared in the "SimpleServiceOptions"
    }

    public void OnStart(SimpleServiceCore core)
    {
        // Called when the service starts
    }

    public void OnStop(IList<string> args)
    {
        // Called when the service is stopped
    }

    public void OnTapNotification()
    {
        // Called when the user taps the notification
    }
}

2. Pass your service class in with the Start method

// Create and start a service...
_service = await ServiceManager.Start<MyService>("My Service", "Hello world!");