From b70a32d31d8434d6355affb4e07f055f1f45ec06 Mon Sep 17 00:00:00 2001
From: Vladislav Antonyuk <33021114+VladislavAntonyuk@users.noreply.github.com>
Date: Sun, 23 Jul 2023 20:46:18 +0300
Subject: [PATCH] BadgeCounter #807 (#1126)

* BadgeCounter #807

* Rename to Badge

* Update tests

* Remove Xamarin.Android.ShortcutBadger dependency

* Fix Tizen build

* Add default badge provider, add nova

* Fix SamsungBadgeProvider

* SetProvider

* Initialize array only once

* `dotnet format`

* Update SamsungBadgeProvider.cs

* Update BadgeViewModel.cs

* Update DefaultBadgeProvider.android.cs

* Use `Lazy<T>` to ensure thread safety

* GetCount

- Uncommented lines in the csproj file to address Android App installation failure.

Toggle Home Screen Icon Badge Count

- Added column and row spacing to improve layout in the BadgePage.xaml file.

SetBadgeProvider method update

- Renamed SetProvider method to SetBadgeProvider in the BadgeFactory.android.cs file.

GetCount method implementation

- Implemented GetCount method in the BadgeImplementation.android.cs, DefaultBadgeProvider.android.cs, BadgeImplementation.macios.cs, and BadgeImplementation.tizen.cs files.

Added GetCount method to IBadge interface

- Added GetCount method to the IBadge.shared.cs file.

* feat: Add support for Samsung badge provider

This commit adds support for the Samsung badge provider in the Android platform. It includes changes to the `SamsungBadgeProvider` class and the `DefaultBadgeProvider.android.cs` file.

- Added a new static readonly string array `packageNameArray` in the `SamsungBadgeProvider` class.
- Modified the `SetCount` method in the `SamsungBadgeProvider` class to use `packageNameArray` instead of directly passing a string array.
- Added a new method `GetCount()` in the `SamsungBadgeProvider` class.
- Renamed the method `IsSupported()` to `CanSetBadgeCounter()` in the `DefaultBadgeProvider.android.cs` file.
- Added debug log statements for error handling scenarios in both classes.

* Fix SamsungBadgeProvider.cs and BadgeTests.cs

- Fix a typo in SamsungBadgeProvider.cs by changing "new[1]" to "new string[1]"
- Add a new test method GetBadgeFailsOnNet() in BadgeTests.cs that tests the behavior of getting badge count on .NET platform
- Modify the existing test method SetBadgeFailsOnNet() in BadgeTests.cs to throw NotSupportedException instead of NotImplementedException
- Add a new method GetCount() in BadgeImplementationMock.cs that throws NotImplementedException

* Fix build error

Sorry Vlad - this was my fault!

* Update CommunityToolkit.Maui.Sample.csproj

* Update DefaultBadgeProvider.android.cs

* Update BadgeImplementation.macios.cs

* Update EssentialsGalleryViewModel.cs

* Update BaseGalleryViewModel.cs

* Update MainApplication.cs

* Add null check

* Remove `count` field

* Update DefaultBadgeProvider.android.cs

* Add additional text explaining Bade

* Remove GetCount, use uint instead of int

* fix tizen build

* Update src/CommunityToolkit.Maui.Core/Essentials/Badge/BadgeImplementation.windows.cs

Co-authored-by: Pedro Jesus <pedrojesus.cefet@gmail.com>

* Update src/CommunityToolkit.Maui.Core/Essentials/Badge/BadgeImplementation.tizen.cs

Co-authored-by: Pedro Jesus <pedrojesus.cefet@gmail.com>

* Update src/CommunityToolkit.Maui.Core/Essentials/Badge/Android/BadgeFactory.android.cs

Co-authored-by: Pedro Jesus <pedrojesus.cefet@gmail.com>

* Update src/CommunityToolkit.Maui.Core/Essentials/Badge/Android/DefaultBadgeProvider.android.cs

Co-authored-by: Pedro Jesus <pedrojesus.cefet@gmail.com>

---------

Co-authored-by: Brandon Minnick <13558917+brminnick@users.noreply.github.com>
Co-authored-by: Pedro Jesus <pedrojesus.cefet@gmail.com>
---
 .gitignore                                    |  1 +
 .../AppShell.xaml.cs                          |  1 +
 .../CommunityToolkit.Maui.Sample.csproj       |  6 +-
 .../MauiProgram.cs                            |  3 +
 .../Pages/Essentials/BadgePage.xaml           | 66 +++++++++++++++
 .../Pages/Essentials/BadgePage.xaml.cs        | 11 +++
 .../Platforms/Android/AndroidManifest.xml     |  5 ++
 .../Platforms/Android/MainApplication.cs      |  4 +
 .../Platforms/Android/SamsungBadgeProvider.cs | 84 +++++++++++++++++++
 .../ViewModels/Base/BaseGalleryViewModel.cs   |  2 +-
 .../ViewModels/Essentials/BadgeViewModel.cs   | 33 ++++++++
 .../Essentials/EssentialsGalleryViewModel.cs  |  1 +
 .../CommunityToolkit.Maui.Core.csproj         |  1 +
 .../Badge/Android/BadgeFactory.android.cs     | 55 ++++++++++++
 .../Android/BadgeImplementation.android.cs    | 12 +++
 .../Android/DefaultBadgeProvider.android.cs   | 57 +++++++++++++
 .../Badge/Android/IBadgeProvider.android.cs   | 12 +++
 .../Essentials/Badge/Badge.shared.cs          | 19 +++++
 .../Badge/BadgeImplementation.macios.cs       | 22 +++++
 .../Badge/BadgeImplementation.net.cs          | 11 +++
 .../Badge/BadgeImplementation.tizen.cs        | 31 +++++++
 .../Badge/BadgeImplementation.windows.cs      | 28 +++++++
 .../Essentials/Badge/IBadge.shared.cs         | 13 +++
 .../Essentials/BadgeTests.cs                  | 25 ++++++
 .../Mocks/BadgeImplementationMock.cs          | 11 +++
 25 files changed, 512 insertions(+), 2 deletions(-)
 create mode 100644 samples/CommunityToolkit.Maui.Sample/Pages/Essentials/BadgePage.xaml
 create mode 100644 samples/CommunityToolkit.Maui.Sample/Pages/Essentials/BadgePage.xaml.cs
 create mode 100644 samples/CommunityToolkit.Maui.Sample/Platforms/Android/SamsungBadgeProvider.cs
 create mode 100644 samples/CommunityToolkit.Maui.Sample/ViewModels/Essentials/BadgeViewModel.cs
 create mode 100644 src/CommunityToolkit.Maui.Core/Essentials/Badge/Android/BadgeFactory.android.cs
 create mode 100644 src/CommunityToolkit.Maui.Core/Essentials/Badge/Android/BadgeImplementation.android.cs
 create mode 100644 src/CommunityToolkit.Maui.Core/Essentials/Badge/Android/DefaultBadgeProvider.android.cs
 create mode 100644 src/CommunityToolkit.Maui.Core/Essentials/Badge/Android/IBadgeProvider.android.cs
 create mode 100644 src/CommunityToolkit.Maui.Core/Essentials/Badge/Badge.shared.cs
 create mode 100644 src/CommunityToolkit.Maui.Core/Essentials/Badge/BadgeImplementation.macios.cs
 create mode 100644 src/CommunityToolkit.Maui.Core/Essentials/Badge/BadgeImplementation.net.cs
 create mode 100644 src/CommunityToolkit.Maui.Core/Essentials/Badge/BadgeImplementation.tizen.cs
 create mode 100644 src/CommunityToolkit.Maui.Core/Essentials/Badge/BadgeImplementation.windows.cs
 create mode 100644 src/CommunityToolkit.Maui.Core/Essentials/Badge/IBadge.shared.cs
 create mode 100644 src/CommunityToolkit.Maui.UnitTests/Essentials/BadgeTests.cs
 create mode 100644 src/CommunityToolkit.Maui.UnitTests/Mocks/BadgeImplementationMock.cs

diff --git a/.gitignore b/.gitignore
index 4740b3fbf..de8ab5cf3 100644
--- a/.gitignore
+++ b/.gitignore
@@ -263,3 +263,4 @@ paket-files/
 
 # Visual Studio Code
 .vscode
+/samples/workload-install.ps1
diff --git a/samples/CommunityToolkit.Maui.Sample/AppShell.xaml.cs b/samples/CommunityToolkit.Maui.Sample/AppShell.xaml.cs
index c3388b1c4..b74c6dde7 100644
--- a/samples/CommunityToolkit.Maui.Sample/AppShell.xaml.cs
+++ b/samples/CommunityToolkit.Maui.Sample/AppShell.xaml.cs
@@ -83,6 +83,7 @@ public partial class AppShell : Shell
 		CreateViewModelMapping<VariableMultiValueConverterPage, VariableMultiValueConverterViewModel, ConvertersGalleryPage, ConvertersGalleryViewModel>(),
 
 		// Add Essentials View Models
+		CreateViewModelMapping<BadgePage, BadgeViewModel, EssentialsGalleryPage, EssentialsGalleryViewModel>(),
 		CreateViewModelMapping<FileSaverPage, FileSaverViewModel, EssentialsGalleryPage, EssentialsGalleryViewModel>(),
 		CreateViewModelMapping<FolderPickerPage, FolderPickerViewModel, EssentialsGalleryPage, EssentialsGalleryViewModel>(),
 		CreateViewModelMapping<SpeechToTextPage, SpeechToTextViewModel, EssentialsGalleryPage, EssentialsGalleryViewModel>(),
diff --git a/samples/CommunityToolkit.Maui.Sample/CommunityToolkit.Maui.Sample.csproj b/samples/CommunityToolkit.Maui.Sample/CommunityToolkit.Maui.Sample.csproj
index 8a96fe7b9..12cc434cf 100644
--- a/samples/CommunityToolkit.Maui.Sample/CommunityToolkit.Maui.Sample.csproj
+++ b/samples/CommunityToolkit.Maui.Sample/CommunityToolkit.Maui.Sample.csproj
@@ -22,12 +22,15 @@
     <ApplicationVersion>1</ApplicationVersion>
 
     <!--
-    Uncomment these lines if you need to debug the SG code
+    Uncomment the line below if you need to debug the SG code
     If you see any LongPath issue on Windows, check this doc
     https://docs.microsoft.com/en-us/windows/win32/fileio/maximum-file-path-limitation?tabs=cmd#enable-long-paths-in-windows-10-version-1607-and-later
     -->
     <!--<EmitCompilerGeneratedFiles>true</EmitCompilerGeneratedFiles>
     <CompilerGeneratedFilesOutputPath>$(BaseIntermediateOutputPath)\GeneratedFiles</CompilerGeneratedFilesOutputPath>-->
+
+    <!-- Uncomment the line below if Android App installation fails -->
+    <!--<EmbedAssembliesIntoApk>true</EmbedAssembliesIntoApk>-->
   </PropertyGroup>
 
   <ItemGroup>
@@ -79,4 +82,5 @@
   <PropertyGroup Condition="$([MSBuild]::IsOSPlatform('windows'))=='false' and $([MSBuild]::GetTargetPlatformIdentifier('$(TargetFramework)'))=='maccatalyst' and $(Configuration) == 'Debug'">
     <RuntimeIdentifiers>maccatalyst-arm64;maccatalyst-x64</RuntimeIdentifiers>
   </PropertyGroup>
+
 </Project>
diff --git a/samples/CommunityToolkit.Maui.Sample/MauiProgram.cs b/samples/CommunityToolkit.Maui.Sample/MauiProgram.cs
index e55258f84..2a3e8a48c 100644
--- a/samples/CommunityToolkit.Maui.Sample/MauiProgram.cs
+++ b/samples/CommunityToolkit.Maui.Sample/MauiProgram.cs
@@ -1,3 +1,4 @@
+using CommunityToolkit.Maui.ApplicationModel;
 using CommunityToolkit.Maui.Maps;
 using CommunityToolkit.Maui.Markup;
 using CommunityToolkit.Maui.Media;
@@ -156,6 +157,7 @@ static void RegisterViewsAndViewModels(in IServiceCollection services)
 		services.AddTransientWithShellRoute<VariableMultiValueConverterPage, VariableMultiValueConverterViewModel>();
 
 		// Add Essentials Pages + ViewModels
+		services.AddTransientWithShellRoute<BadgePage, BadgeViewModel>();
 		services.AddTransientWithShellRoute<FileSaverPage, FileSaverViewModel>();
 		services.AddTransientWithShellRoute<FolderPickerPage, FolderPickerViewModel>();
 		services.AddTransientWithShellRoute<SpeechToTextPage, SpeechToTextViewModel>();
@@ -199,6 +201,7 @@ static void RegisterEssentials(in IServiceCollection services)
 		services.AddSingleton<IDeviceInfo>(DeviceInfo.Current);
 		services.AddSingleton<IFileSaver>(FileSaver.Default);
 		services.AddSingleton<IFolderPicker>(FolderPicker.Default);
+		services.AddSingleton<IBadge>(Badge.Default);
 		services.AddSingleton<ISpeechToText>(SpeechToText.Default);
 		services.AddSingleton<ITextToSpeech>(TextToSpeech.Default);
 	}
diff --git a/samples/CommunityToolkit.Maui.Sample/Pages/Essentials/BadgePage.xaml b/samples/CommunityToolkit.Maui.Sample/Pages/Essentials/BadgePage.xaml
new file mode 100644
index 000000000..24e980bc5
--- /dev/null
+++ b/samples/CommunityToolkit.Maui.Sample/Pages/Essentials/BadgePage.xaml
@@ -0,0 +1,66 @@
+<?xml version="1.0" encoding="utf-8" ?>
+<pages:BasePage xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
+                xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
+                xmlns:pages="clr-namespace:CommunityToolkit.Maui.Sample.Pages"
+                x:Class="CommunityToolkit.Maui.Sample.Pages.Essentials.BadgePage"
+                xmlns:vm="clr-namespace:CommunityToolkit.Maui.Sample.ViewModels.Essentials"
+                x:TypeArguments="vm:BadgeViewModel"
+                x:DataType="vm:BadgeViewModel"
+                Title="Badge">
+    
+    <Grid
+        RowDefinitions="40,60,*,*,80"
+        ColumnDefinitions="*,*"
+        ColumnSpacing="12"
+        RowSpacing="12">
+
+        <Label
+            Grid.Row="0"
+            Grid.ColumnSpan="2"
+            HorizontalTextAlignment="Center"
+            Text="Badge allows developers to set the app icon badge number on the homescreen" />
+
+        <Label
+            Grid.Row="1"
+            Grid.ColumnSpan="2"
+            HorizontalTextAlignment="Center"
+            Text="Toggle the app icon Badge count using the buttons below, then minimize the application to see its Badge count updated on the home screen" />
+
+        <Button
+            Text="+"
+            Grid.Column="0"
+            Grid.Row="2"
+            SemanticProperties.Hint="Increments AppIcon badge"
+            Command="{Binding IncrementCommand}"
+            VerticalOptions="End"
+            HorizontalOptions="End" />
+
+        <Button
+            Text="-"
+            Grid.Column="1"
+            Grid.Row="2"
+            SemanticProperties.Hint="Decrements AppIcon badge"
+            Command="{Binding DecrementCommand}"
+            VerticalOptions="End"
+            HorizontalOptions="Start" />
+
+        <Label
+            Grid.Row="3"
+            Grid.ColumnSpan="2"
+            VerticalOptions="Start"
+            VerticalTextAlignment="Start"
+            Text="Toggle Home Screen Icon Badge Count"
+            FontSize="18"
+            HorizontalOptions="Center" />
+
+        <Label
+            BackgroundColor="LightYellow"
+            Grid.Row="4"
+            Grid.ColumnSpan="2"
+            HorizontalTextAlignment="Center"
+            FontAttributes="Bold"
+            Text="Note: Android requires device-specific implementation to support app icon badge counts. See the .NET MAUI Community Toolkit documentation for more information" />
+
+    </Grid>
+    
+</pages:BasePage>
\ No newline at end of file
diff --git a/samples/CommunityToolkit.Maui.Sample/Pages/Essentials/BadgePage.xaml.cs b/samples/CommunityToolkit.Maui.Sample/Pages/Essentials/BadgePage.xaml.cs
new file mode 100644
index 000000000..685dc4425
--- /dev/null
+++ b/samples/CommunityToolkit.Maui.Sample/Pages/Essentials/BadgePage.xaml.cs
@@ -0,0 +1,11 @@
+using CommunityToolkit.Maui.Sample.ViewModels.Essentials;
+
+namespace CommunityToolkit.Maui.Sample.Pages.Essentials;
+
+public partial class BadgePage : BasePage<BadgeViewModel>
+{
+	public BadgePage(BadgeViewModel viewModel) : base(viewModel)
+	{
+		InitializeComponent();
+	}
+}
\ No newline at end of file
diff --git a/samples/CommunityToolkit.Maui.Sample/Platforms/Android/AndroidManifest.xml b/samples/CommunityToolkit.Maui.Sample/Platforms/Android/AndroidManifest.xml
index 165700a87..37acba4a2 100644
--- a/samples/CommunityToolkit.Maui.Sample/Platforms/Android/AndroidManifest.xml
+++ b/samples/CommunityToolkit.Maui.Sample/Platforms/Android/AndroidManifest.xml
@@ -4,6 +4,11 @@
 	<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
 	<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
 	<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
+
+  <!-- Samsung -->
+  <uses-permission android:name="com.sec.android.provider.badge.permission.READ" />
+  <uses-permission android:name="com.sec.android.provider.badge.permission.WRITE" />
+
 	<uses-permission android:name="android.permission.RECORD_AUDIO" />
 	<queries>
 		<intent>
diff --git a/samples/CommunityToolkit.Maui.Sample/Platforms/Android/MainApplication.cs b/samples/CommunityToolkit.Maui.Sample/Platforms/Android/MainApplication.cs
index 0a7cca1ef..460953418 100644
--- a/samples/CommunityToolkit.Maui.Sample/Platforms/Android/MainApplication.cs
+++ b/samples/CommunityToolkit.Maui.Sample/Platforms/Android/MainApplication.cs
@@ -1,5 +1,6 @@
 using Android.App;
 using Android.Runtime;
+using CommunityToolkit.Maui.ApplicationModel;
 
 namespace CommunityToolkit.Maui.Sample;
 
@@ -9,6 +10,9 @@ public class MainApplication : MauiApplication
 	public MainApplication(IntPtr handle, JniHandleOwnership ownership)
 		: base(handle, ownership)
 	{
+		var samsungProvider = new SamsungBadgeProvider();
+		BadgeFactory.SetBadgeProvider("com.sec.android.app.launcher", samsungProvider);
+		BadgeFactory.SetBadgeProvider("com.sec.android.app.twlauncher", samsungProvider);
 	}
 
 	protected override MauiApp CreateMauiApp() => MauiProgram.CreateMauiApp();
diff --git a/samples/CommunityToolkit.Maui.Sample/Platforms/Android/SamsungBadgeProvider.cs b/samples/CommunityToolkit.Maui.Sample/Platforms/Android/SamsungBadgeProvider.cs
new file mode 100644
index 000000000..659c689cb
--- /dev/null
+++ b/samples/CommunityToolkit.Maui.Sample/Platforms/Android/SamsungBadgeProvider.cs
@@ -0,0 +1,84 @@
+using Android.Content;
+using Android.Database;
+using CommunityToolkit.Maui.ApplicationModel;
+using Application = Android.App.Application;
+
+namespace CommunityToolkit.Maui.Sample;
+
+class SamsungBadgeProvider : IBadgeProvider
+{
+	const string contentStringUri = "content://com.sec.badge/apps?notify=true";
+	static readonly string[] contentProjection = { "_id", "class" };
+	static readonly string[] packageNameArray = new string[1];
+
+	public void SetCount(uint count)
+	{
+		var contentUri = Android.Net.Uri.Parse(contentStringUri);
+		if (contentUri is null)
+		{
+			return;
+		}
+
+		var packageName = Application.Context.PackageName;
+		if (packageName is null)
+		{
+			return;
+		}
+
+		var componentName = Application.Context.PackageManager?.GetLaunchIntentForPackage(packageName)?.Component;
+		if (componentName is null)
+		{
+			return;
+		}
+
+		var contentResolver = Application.Context.ContentResolver;
+		ICursor? cursor = null;
+		try
+		{
+			packageNameArray[0] = packageName;
+			cursor = contentResolver?.Query(contentUri, contentProjection, "package=?", packageNameArray, null);
+			if (cursor is not null)
+			{
+				var entryActivityExist = false;
+				var selectionArgs = new string[1];
+				while (cursor.MoveToNext())
+				{
+					var id = cursor.GetInt(0);
+					selectionArgs[0] = id.ToString();
+					var contentValues = GetContentValues(componentName, count, false);
+					contentResolver?.Update(contentUri, contentValues, "_id=?", selectionArgs);
+					if (componentName.ClassName.Equals(cursor.GetString(cursor.GetColumnIndex("class"))))
+					{
+						entryActivityExist = true;
+					}
+				}
+
+				if (!entryActivityExist)
+				{
+					var contentValues = GetContentValues(componentName, count, true);
+					contentResolver?.Insert(contentUri, contentValues);
+				}
+			}
+		}
+		finally
+		{
+			if (cursor?.IsClosed is false)
+			{
+				cursor.Close();
+			}
+		}
+	}
+
+	static ContentValues GetContentValues(ComponentName componentName, uint badgeCount, bool isInsert)
+	{
+		var contentValues = new ContentValues();
+		if (isInsert)
+		{
+			contentValues.Put("package", componentName.PackageName);
+			contentValues.Put("class", componentName.ClassName);
+		}
+
+		contentValues.Put("badgecount", badgeCount);
+		return contentValues;
+	}
+}
\ No newline at end of file
diff --git a/samples/CommunityToolkit.Maui.Sample/ViewModels/Base/BaseGalleryViewModel.cs b/samples/CommunityToolkit.Maui.Sample/ViewModels/Base/BaseGalleryViewModel.cs
index 2f3ac49cf..2c93aad21 100644
--- a/samples/CommunityToolkit.Maui.Sample/ViewModels/Base/BaseGalleryViewModel.cs
+++ b/samples/CommunityToolkit.Maui.Sample/ViewModels/Base/BaseGalleryViewModel.cs
@@ -9,7 +9,7 @@ protected BaseGalleryViewModel(SectionModel[] items)
 	{
 		if (DoesItemsArrayContainDuplicates(items, out var duplicatedSectionModels))
 		{
-			throw new InvalidOperationException($"Duplicate {nameof(SectionModel)}.{nameof(SectionModel.ViewModelType)} found for {duplicatedSectionModels.First().ViewModelType}");
+			throw new InvalidOperationException($"Duplicate {nameof(SectionModel)}.{nameof(SectionModel.ViewModelType)} found for {duplicatedSectionModels[0].ViewModelType}");
 		}
 
 		Items = items.OrderBy(x => x.Title).ToList();
diff --git a/samples/CommunityToolkit.Maui.Sample/ViewModels/Essentials/BadgeViewModel.cs b/samples/CommunityToolkit.Maui.Sample/ViewModels/Essentials/BadgeViewModel.cs
new file mode 100644
index 000000000..558f28c12
--- /dev/null
+++ b/samples/CommunityToolkit.Maui.Sample/ViewModels/Essentials/BadgeViewModel.cs
@@ -0,0 +1,33 @@
+using CommunityToolkit.Maui.ApplicationModel;
+using CommunityToolkit.Mvvm.Input;
+
+namespace CommunityToolkit.Maui.Sample.ViewModels.Essentials;
+
+public partial class BadgeViewModel : BaseViewModel
+{
+	readonly IBadge badge;
+
+	uint count;
+
+	public BadgeViewModel(IBadge badge)
+	{
+		this.badge = badge;
+	}
+
+	[RelayCommand]
+	void Increment()
+	{
+		count++;
+		badge.SetCount(count);
+	}
+
+	[RelayCommand]
+	void Decrement()
+	{
+		if (count > 0)
+		{
+			count--;
+			badge.SetCount(count);
+		}
+	}
+}
\ No newline at end of file
diff --git a/samples/CommunityToolkit.Maui.Sample/ViewModels/Essentials/EssentialsGalleryViewModel.cs b/samples/CommunityToolkit.Maui.Sample/ViewModels/Essentials/EssentialsGalleryViewModel.cs
index eb3317791..2962186d8 100644
--- a/samples/CommunityToolkit.Maui.Sample/ViewModels/Essentials/EssentialsGalleryViewModel.cs
+++ b/samples/CommunityToolkit.Maui.Sample/ViewModels/Essentials/EssentialsGalleryViewModel.cs
@@ -7,6 +7,7 @@ public class EssentialsGalleryViewModel : BaseGalleryViewModel
 	public EssentialsGalleryViewModel()
 		: base(new[]
 		{
+			SectionModel.Create<BadgeViewModel>("Badge", "Allows the user to set app icon badge count on the home screen"),
 			SectionModel.Create<FileSaverViewModel>("FileSaver", "Allows the user to save files to the filesystem"),
 			SectionModel.Create<FolderPickerViewModel>("FolderPicker", "Allows picking folders from the file system"),
 			SectionModel.Create<SpeechToTextViewModel>("SpeechToText", "Converts speech to text"),
diff --git a/src/CommunityToolkit.Maui.Core/CommunityToolkit.Maui.Core.csproj b/src/CommunityToolkit.Maui.Core/CommunityToolkit.Maui.Core.csproj
index 9d3a959f3..9f43d320f 100644
--- a/src/CommunityToolkit.Maui.Core/CommunityToolkit.Maui.Core.csproj
+++ b/src/CommunityToolkit.Maui.Core/CommunityToolkit.Maui.Core.csproj
@@ -58,4 +58,5 @@
 
     <PackageReference Include="System.Speech" Version="7.0.0" Condition="'$(TargetFramework)' == 'net7.0-windows10.0.19041.0'" />
   </ItemGroup>
+
 </Project>
diff --git a/src/CommunityToolkit.Maui.Core/Essentials/Badge/Android/BadgeFactory.android.cs b/src/CommunityToolkit.Maui.Core/Essentials/Badge/Android/BadgeFactory.android.cs
new file mode 100644
index 000000000..cd8f50826
--- /dev/null
+++ b/src/CommunityToolkit.Maui.Core/Essentials/Badge/Android/BadgeFactory.android.cs
@@ -0,0 +1,55 @@
+using Android.Content;
+using Android.Content.PM;
+
+namespace CommunityToolkit.Maui.ApplicationModel;
+
+/// <summary>
+/// Factory for <see cref="IBadge"/>
+/// </summary>
+public static class BadgeFactory
+{
+	static readonly Dictionary<string, IBadgeProvider> providers = new();
+	static readonly DefaultBadgeProvider defaultBadgeProvider = new();
+
+	/// <summary>
+	/// Register provider for launcher type
+	/// </summary>
+	/// <param name="launcherType">Launcher type</param>
+	/// <param name="provider">Provider implementation</param>
+	public static void SetBadgeProvider(string launcherType, IBadgeProvider provider)
+	{
+		providers[launcherType] = provider;
+	}
+
+	/// <summary>
+	/// Get badge provider for current launcher
+	/// </summary>
+	/// <returns>Provider implementation</returns>
+	public static IBadgeProvider GetBadgeProvider()
+	{
+		var launcherType = GetLauncherType();
+		if (launcherType is null)
+		{
+			return defaultBadgeProvider;
+		}
+
+		providers.TryGetValue(launcherType, out var provider);
+		return provider ?? defaultBadgeProvider;
+	}
+
+	static string? GetLauncherType()
+	{
+		using var intent = new Intent(Intent.ActionMain);
+		intent.AddCategory(Intent.CategoryHome);
+		using var resolveInfo = OperatingSystem.IsAndroidVersionAtLeast(33) ?
+			Application.Context.PackageManager?.ResolveActivity(intent, PackageManager.ResolveInfoFlags.Of(0)) :
+			Application.Context.PackageManager?.ResolveActivity(intent, PackageInfoFlags.MatchDefaultOnly);
+
+		if (resolveInfo is { ActivityInfo.PackageName: not null })
+		{
+			return resolveInfo.ActivityInfo.PackageName;
+		}
+
+		return Application.Context.PackageName;
+	}
+}
\ No newline at end of file
diff --git a/src/CommunityToolkit.Maui.Core/Essentials/Badge/Android/BadgeImplementation.android.cs b/src/CommunityToolkit.Maui.Core/Essentials/Badge/Android/BadgeImplementation.android.cs
new file mode 100644
index 000000000..e6d1d9444
--- /dev/null
+++ b/src/CommunityToolkit.Maui.Core/Essentials/Badge/Android/BadgeImplementation.android.cs
@@ -0,0 +1,12 @@
+namespace CommunityToolkit.Maui.ApplicationModel;
+
+/// <inheritdoc />
+public class BadgeImplementation : IBadge
+{
+	/// <inheritdoc />
+	public void SetCount(uint count)
+	{
+		var badgeProvider = BadgeFactory.GetBadgeProvider();
+		badgeProvider.SetCount(count);
+	}
+}
\ No newline at end of file
diff --git a/src/CommunityToolkit.Maui.Core/Essentials/Badge/Android/DefaultBadgeProvider.android.cs b/src/CommunityToolkit.Maui.Core/Essentials/Badge/Android/DefaultBadgeProvider.android.cs
new file mode 100644
index 000000000..b8885d0ad
--- /dev/null
+++ b/src/CommunityToolkit.Maui.Core/Essentials/Badge/Android/DefaultBadgeProvider.android.cs
@@ -0,0 +1,57 @@
+using System.Diagnostics;
+using Android.Content;
+using Android.Content.PM;
+
+namespace CommunityToolkit.Maui.ApplicationModel;
+
+class DefaultBadgeProvider : IBadgeProvider
+{
+	const string intentAction = "android.intent.action.BADGE_COUNT_UPDATE";
+	
+	public void SetCount(uint count)
+	{
+		var packageName = Application.Context.PackageName;
+		if (packageName is null)
+		{
+			Debug.WriteLine("Unable to get package name");
+			return;
+		}
+
+		var component = Application.Context.PackageManager?.GetLaunchIntentForPackage(packageName)?.Component;
+		if (component is null)
+		{
+			Debug.WriteLine($"Unable to get launch intent component for package {packageName}");
+			return;
+		}
+
+		if (!CanSetBadgeCounter())
+		{
+			Debug.WriteLine("Current launcher doesn't support badge counter");
+			return;
+		}
+
+		try
+		{
+			var intent = new Intent(intentAction);
+			intent.PutExtra("badge_count_package_name", packageName);
+			intent.PutExtra("badge_count_class_name", component.ClassName);
+			intent.PutExtra("badge_count", count);
+			Application.Context.SendBroadcast(intent);
+		}
+		catch (Exception ex)
+		{
+			Debug.WriteLine($"{nameof(DefaultBadgeProvider)} unable to set badge count: " + ex.Message);
+		}
+	}
+
+	static bool CanSetBadgeCounter()
+	{
+		using var intent = new Intent(intentAction);
+		var packageManager = Application.Context.PackageManager;
+		var receivers = OperatingSystem.IsAndroidVersionAtLeast(33)
+						? packageManager?.QueryBroadcastReceivers(intent, PackageManager.ResolveInfoFlags.Of(0))
+						: packageManager?.QueryBroadcastReceivers(intent, 0);
+
+		return receivers?.Count > 0;
+	}
+}
\ No newline at end of file
diff --git a/src/CommunityToolkit.Maui.Core/Essentials/Badge/Android/IBadgeProvider.android.cs b/src/CommunityToolkit.Maui.Core/Essentials/Badge/Android/IBadgeProvider.android.cs
new file mode 100644
index 000000000..659b033a6
--- /dev/null
+++ b/src/CommunityToolkit.Maui.Core/Essentials/Badge/Android/IBadgeProvider.android.cs
@@ -0,0 +1,12 @@
+namespace CommunityToolkit.Maui.ApplicationModel;
+
+/// <summary>
+/// Android badge provider
+/// </summary>
+public interface IBadgeProvider
+{
+	/// <summary>
+	/// Set count for badge
+	/// </summary>
+	void SetCount(uint count);
+}
\ No newline at end of file
diff --git a/src/CommunityToolkit.Maui.Core/Essentials/Badge/Badge.shared.cs b/src/CommunityToolkit.Maui.Core/Essentials/Badge/Badge.shared.cs
new file mode 100644
index 000000000..f71c94e43
--- /dev/null
+++ b/src/CommunityToolkit.Maui.Core/Essentials/Badge/Badge.shared.cs
@@ -0,0 +1,19 @@
+namespace CommunityToolkit.Maui.ApplicationModel;
+
+/// <inheritdoc cref="IBadge"/>
+public static class Badge
+{
+	static Lazy<IBadge> defaultImplementationHolder = new(() => new BadgeImplementation());
+
+	/// <inheritdoc cref="IBadge" />
+	public static IBadge Default => defaultImplementationHolder.Value;
+
+	/// <inheritdoc cref="IBadge.SetCount" />
+	public static void SetCount(uint count)
+	{
+		Default.SetCount(count);
+	}
+
+	internal static void SetDefault(IBadge implementation) =>
+		defaultImplementationHolder = new(implementation);
+}
\ No newline at end of file
diff --git a/src/CommunityToolkit.Maui.Core/Essentials/Badge/BadgeImplementation.macios.cs b/src/CommunityToolkit.Maui.Core/Essentials/Badge/BadgeImplementation.macios.cs
new file mode 100644
index 000000000..837b8991c
--- /dev/null
+++ b/src/CommunityToolkit.Maui.Core/Essentials/Badge/BadgeImplementation.macios.cs
@@ -0,0 +1,22 @@
+using System.Diagnostics;
+using UserNotifications;
+
+namespace CommunityToolkit.Maui.ApplicationModel;
+
+/// <inheritdoc />
+public class BadgeImplementation : IBadge
+{
+	/// <inheritdoc />
+	public void SetCount(uint count)
+	{
+		UNUserNotificationCenter.Current.RequestAuthorization(UNAuthorizationOptions.Badge, (r, error) =>
+		{
+			if (error is not null)
+			{
+				Debug.WriteLine($"Error Requesting Authorization to Set Badge Count: {error.Description}");
+			}
+		});
+
+		UIApplication.SharedApplication.ApplicationIconBadgeNumber = (int)count;
+	}
+}
\ No newline at end of file
diff --git a/src/CommunityToolkit.Maui.Core/Essentials/Badge/BadgeImplementation.net.cs b/src/CommunityToolkit.Maui.Core/Essentials/Badge/BadgeImplementation.net.cs
new file mode 100644
index 000000000..4b6cbd1e0
--- /dev/null
+++ b/src/CommunityToolkit.Maui.Core/Essentials/Badge/BadgeImplementation.net.cs
@@ -0,0 +1,11 @@
+namespace CommunityToolkit.Maui.ApplicationModel;
+
+/// <inheritdoc />
+public class BadgeImplementation : IBadge
+{
+	/// <inheritdoc />
+	public void SetCount(uint count)
+	{
+		throw new NotSupportedException($"{nameof(IBadge)} requires a platform-specific implementation of .NET");
+	}
+}
\ No newline at end of file
diff --git a/src/CommunityToolkit.Maui.Core/Essentials/Badge/BadgeImplementation.tizen.cs b/src/CommunityToolkit.Maui.Core/Essentials/Badge/BadgeImplementation.tizen.cs
new file mode 100644
index 000000000..5e46057ad
--- /dev/null
+++ b/src/CommunityToolkit.Maui.Core/Essentials/Badge/BadgeImplementation.tizen.cs
@@ -0,0 +1,31 @@
+using Tizen.Applications;
+using Tizen.NUI;
+
+namespace CommunityToolkit.Maui.ApplicationModel;
+
+/// <inheritdoc />
+public class BadgeImplementation : IBadge
+{
+	/// <inheritdoc />
+	public void SetCount(uint count)
+	{
+		var appId = Application.Current.ApplicationInfo.ApplicationId;
+		if (count is 0)
+		{
+			BadgeControl.Remove(appId);
+			return;
+		}
+
+		var badge = BadgeControl.Find(appId);
+		if (badge is null)
+		{
+			badge = new Tizen.Applications.Badge(appId, (int)count);
+			BadgeControl.Add(badge);
+		}
+		else
+		{
+			badge.Count = (int)count;
+			BadgeControl.Update(badge);
+		}
+	}
+}
\ No newline at end of file
diff --git a/src/CommunityToolkit.Maui.Core/Essentials/Badge/BadgeImplementation.windows.cs b/src/CommunityToolkit.Maui.Core/Essentials/Badge/BadgeImplementation.windows.cs
new file mode 100644
index 000000000..dcef53119
--- /dev/null
+++ b/src/CommunityToolkit.Maui.Core/Essentials/Badge/BadgeImplementation.windows.cs
@@ -0,0 +1,28 @@
+namespace CommunityToolkit.Maui.ApplicationModel;
+
+using Windows.Data.Xml.Dom;
+using Windows.UI.Notifications;
+
+/// <inheritdoc />
+public class BadgeImplementation : IBadge
+{
+	/// <inheritdoc />
+	public void SetCount(uint count)
+	{
+		var badgeUpdater = BadgeUpdateManager.CreateBadgeUpdaterForApplication();
+		if (count is 0)
+		{
+			badgeUpdater.Clear();
+		}
+		else
+		{
+			var badgeXml = BadgeUpdateManager.GetTemplateContent(BadgeTemplateType.BadgeNumber);
+
+			var badgeElement = badgeXml.SelectSingleNode("/badge") as XmlElement;
+			badgeElement?.SetAttribute("value", count.ToString());
+
+			var badge = new BadgeNotification(badgeXml);
+			badgeUpdater.Update(badge);
+		}
+	}
+}
\ No newline at end of file
diff --git a/src/CommunityToolkit.Maui.Core/Essentials/Badge/IBadge.shared.cs b/src/CommunityToolkit.Maui.Core/Essentials/Badge/IBadge.shared.cs
new file mode 100644
index 000000000..5c42ac96d
--- /dev/null
+++ b/src/CommunityToolkit.Maui.Core/Essentials/Badge/IBadge.shared.cs
@@ -0,0 +1,13 @@
+namespace CommunityToolkit.Maui.ApplicationModel;
+
+/// <summary>
+/// Badge
+/// </summary>
+public interface IBadge
+{
+	/// <summary>
+	/// Set the badge count
+	/// </summary>
+	/// <param name="count">Badge count</param>
+	void SetCount(uint count);
+}
\ No newline at end of file
diff --git a/src/CommunityToolkit.Maui.UnitTests/Essentials/BadgeTests.cs b/src/CommunityToolkit.Maui.UnitTests/Essentials/BadgeTests.cs
new file mode 100644
index 000000000..ae1b7bdd9
--- /dev/null
+++ b/src/CommunityToolkit.Maui.UnitTests/Essentials/BadgeTests.cs
@@ -0,0 +1,25 @@
+using CommunityToolkit.Maui.ApplicationModel;
+using CommunityToolkit.Maui.UnitTests.Mocks;
+using FluentAssertions;
+using Xunit;
+
+namespace CommunityToolkit.Maui.UnitTests.Essentials;
+
+public class BadgeTests
+{
+	[Fact]
+	public void BadgeTestsSetDefaultUpdatesInstance()
+	{
+		var badgeImplementationMock = new BadgeImplementationMock();
+		Badge.SetDefault(badgeImplementationMock);
+		var badge = Badge.Default;
+		badge.Should().BeSameAs(badgeImplementationMock);
+	}
+
+	[Fact]
+	public void SetBadgeFailsOnNet()
+	{
+		Badge.SetDefault(new BadgeImplementation());
+		Assert.Throws<NotSupportedException>(() => Badge.SetCount(1));
+	}
+}
\ No newline at end of file
diff --git a/src/CommunityToolkit.Maui.UnitTests/Mocks/BadgeImplementationMock.cs b/src/CommunityToolkit.Maui.UnitTests/Mocks/BadgeImplementationMock.cs
new file mode 100644
index 000000000..88959b8aa
--- /dev/null
+++ b/src/CommunityToolkit.Maui.UnitTests/Mocks/BadgeImplementationMock.cs
@@ -0,0 +1,11 @@
+using CommunityToolkit.Maui.ApplicationModel;
+
+namespace CommunityToolkit.Maui.UnitTests.Mocks;
+
+class BadgeImplementationMock : IBadge
+{
+	public void SetCount(uint count)
+	{
+		throw new NotImplementedException();
+	}
+}
\ No newline at end of file