Android platform specific code<\/strong><\/p>\nThe first thing we’ll need to do is edit the Platforms\/Android\/MainApplication.cs file. We need to start by adding a notification channel which will be displayed in the statusbar and act as the interaction point with our foreground service. <\/p>\n
The first thing we need is a channel id, this is a unique identifier within our application to denote the notification channel we’ll want to communicate with. It’s possible for us to have multiple notification channels, but in this instance we’ll just use the one. So in MainApplication add<\/p>\n
\r\npublic static readonly string ChannelId = "exampleServiceChannel";\r\n<\/pre>\nNext, override OnCreate so it looks like this<\/p>\n
\r\npublic override void OnCreate()\r\n{\r\n base.OnCreate();\r\n\r\n if (Build.VERSION.SdkInt >= BuildVersionCodes.O)\r\n {\r\n#pragma warning disable CA1416\r\n var serviceChannel =\r\n new NotificationChannel(ChannelId, "Example Service Channel", NotificationImportance.Default);\r\n\r\n if (GetSystemService(NotificationService) is NotificationManager manager)\r\n {\r\n manager.CreateNotificationChannel(serviceChannel);\r\n }\r\n#pragma warning restore CA1416\r\n }\r\n}\r\n<\/pre>\nAs you can see, this code is targeting API >= 21 (Oreo). We create a NotificationChannel<\/em> with the ChannelId<\/em> we declare earlier. The notification has a name “Example Service Channel” and an importance level. This needs to be set to Low<\/em> or higher. If we set it anything above Low<\/em> we’ll hear a sound when the notification is sent\/updated. Whilst the user can disable this, you may or may not prefer a low importance so your service is less intrusive. Ofcourse it’s all dependent upon your requirements.<\/p>\nBefore we get to the foreground service itself, let’s update the MainActivity.cs to handler our IMessenger<\/em> messages from the UI.<\/p>\nIn the MainActivity constructor add the following<\/p>\n
\r\nvar messenger = MauiApplication.Current.Services.GetService<IMessenger>();\r\n\r\nmessenger.Register<MessageData>(this, (recipient, message) =>\r\n{\r\n if (message.Start)\r\n {\r\n StartService(message.Message);\r\n }\r\n else\r\n {\r\n StopService();\r\n }\r\n});\r\n<\/pre>\nThis is just some plumbing code, basically when we press the start service button we’ll receive a message with Start<\/em> as true and a message from our entry control. Obviously if we get start true we’ll call StartService and if not, we’ll call StopService. <\/p>\nHere’s the start and stop service code<\/p>\n
\r\nprivate void StartService(string input)\r\n{\r\n var serviceIntent = new Intent(this, typeof(ExampleService));\r\n serviceIntent.PutExtra("inputExtra", input);\r\n\r\n StartService(serviceIntent);\r\n}\r\n\r\nprivate void StopService()\r\n{\r\n var serviceIntent = new Intent(this, typeof(ExampleService));\r\n StopService(serviceIntent);\r\n}\r\n<\/pre>\nStart service is passed the entry text and creates an intent associated with our service code (ExampleService). We add a key\/value in the PutExtra<\/em> method. The key is whatever we want and obviously the value is whatever we want to associated with the key. This will be handled via our service, so the key would best be a const in a real world application.<\/p>\nThe StartService(serviceIntent)<\/em> call is used on an activity that is already in the foreground – so in our case to be able to press the button the application must be in the foreground. If your application might be in the background you can call StartForegroundService(serviceIntent)<\/em> to both force the application into the foreground and start the service.<\/p>\nTwo more things before we get to the service code. The service will require a small icon, so create the folder Platforms\/Android\/Resources\/drawable and add a .PNG into this. Mine’s named AppIcon.png as it’s a duplicate of the actual application icon.<\/p>\n
Now we need to declare the requirement of the user permission FOREGROUND_SERVICE, so edit the AndroindManifest.xml file and add the following within the manifest section<\/p>\n
\r\n<uses-permission android:name="android.permission.FOREGROUND_SERVICE"\/>\r\n<\/pre>\nThe Service code<\/strong><\/p>\nTo recap, at this point we have a basic user interface, which allows us to start and stop a service. We have a notification channel created along with the code for starting and stopping a service. We now need the service. Mine’s named ExampleService.cs and is within the Platforms\/Android folder alongside the MainActivity.cs etc.<\/p>\n
Create a basic service with the following code<\/p>\n
\r\n[Service]\r\ninternal class ExampleService : Service\r\n{\r\n public override IBinder OnBind(Intent intent)\r\n {\r\n return null;\r\n }\r\n}\r\n<\/pre>\nand here’s the usings, just in case you need to check<\/p>\n
\r\nusing Android.App;\r\nusing Android.Content;\r\nusing Android.OS;\r\nusing AndroidX.Core.App;\r\n<\/pre>\nWe’re not using the OnBind method which is used for “Bound Services” so simply return null here. We’ll also need the Service<\/em> attribute on the class to register our service.<\/p>\nWe now need to override the OnStartCommand which will get information for the key\/value we added in the MainActivity (via PutExtra). We’ll also want to create an Intent back to our MainActivity so when the user clicks on the notification it can bring the application back into the foreground. Hence we create the notificationIntent<\/em>. <\/p>\nThe NotificationCompat.Builder<\/em> needs to use the same channel id that we want to send messages to and it requires a PendingIntent within the builder. In the builder we must<\/strong> supply the icon image via SetSmallIcon<\/em> and we’ll need the content title set. You can see we’re sending the message to the SetContentText<\/em>. <\/p>\nFinally, unless we’re aiming to reuse this notification we call Build<\/em> on it and pass this along with an id to the StartForeground<\/em>.<\/p>\n\r\npublic override StartCommandResult OnStartCommand(Intent intent, StartCommandFlags flags, int startId)\r\n{\r\n var input = intent.GetStringExtra("inputExtra");\r\n\r\n var notificationIntent = new Intent(this, typeof(MainActivity));\r\n var pendingIntent = PendingIntent.GetActivity(this, 0, notificationIntent, 0);\r\n\r\n var notification = new NotificationCompat.Builder(this, MainApplication.ChannelId)\r\n .SetContentTitle("Example Service")\r\n .SetContentText(input)\r\n .SetSmallIcon(Resource.Drawable.AppIcon)\r\n .SetContentIntent(pendingIntent)\r\n .Build();\r\n\r\n StartForeground(1, notification);\r\n\r\n return StartCommandResult.NotSticky;\r\n}\r\n<\/pre>\nIf we are intending to send multiple messages you would want to create the notification (without the Build<\/em> call) and reuse this to update a notification channel, hence you’d call Build<\/em> within StartForeground<\/em> code, like this<\/p>\n\r\nvar notification = new NotificationCompat.Builder(this, MainApplication.ChannelId)\r\n .SetContentTitle("Example Service")\r\n .SetContentText(input)\r\n .SetSmallIcon(Resource.Drawable.AppIcon)\r\n .SetContentIntent(pendingIntent)\r\n\r\nStartForeground(1, notification.Build());\r\n<\/pre>\nIf we imagine that after StartForeground<\/em> we start some task, for example downloading a file, then remember this should be run on a background thread and it could then update the notification before again calling the StartForeground(1, notification.Build())<\/em> code, ofcourse assuming you’re running the process from the service.<\/p>\nFinally this method returns StartCommandResult.NotSticky<\/em>. This tells the OS to not bother recreating the application if (for example) the device runs out of memory. StartCommandResult.Sticky<\/em> is used to tell the OS to recreate the service when it has enough memory. There’s also the option StartCommandResult.RedeliverIntent<\/em> which is like the NotSticky<\/em> but if the service is killed before calling stopSelf()<\/em> for a given intent then the intent will be re-delivered until it completes.<\/p>\nReferences<\/strong><\/p>\nThis code presented here is based on How to Start a Foreground Service in Android (With Notification Channels)<\/a> but translated to C# and MAUI code.<\/p>\n","protected":false},"excerpt":{"rendered":"In some situations you’ll want to keep some part of your application running even if the main application goes to sleep. For example the Android Clock applet when started will keep running even if you essentially close the Clock applet. It will display an icon in the status bar at the top right of the […]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"closed","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_jetpack_memberships_contains_paid_content":false,"footnotes":""},"categories":[120,330],"tags":[],"class_list":["post-9845","post","type-post","status-publish","format-standard","hentry","category-android","category-maui"],"jetpack_sharing_enabled":true,"jetpack_featured_media_url":"","_links":{"self":[{"href":"https:\/\/putridparrot.com\/blog\/wp-json\/wp\/v2\/posts\/9845","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/putridparrot.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/putridparrot.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/putridparrot.com\/blog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/putridparrot.com\/blog\/wp-json\/wp\/v2\/comments?post=9845"}],"version-history":[{"count":5,"href":"https:\/\/putridparrot.com\/blog\/wp-json\/wp\/v2\/posts\/9845\/revisions"}],"predecessor-version":[{"id":10096,"href":"https:\/\/putridparrot.com\/blog\/wp-json\/wp\/v2\/posts\/9845\/revisions\/10096"}],"wp:attachment":[{"href":"https:\/\/putridparrot.com\/blog\/wp-json\/wp\/v2\/media?parent=9845"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/putridparrot.com\/blog\/wp-json\/wp\/v2\/categories?post=9845"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/putridparrot.com\/blog\/wp-json\/wp\/v2\/tags?post=9845"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}