Initial commit

Author: jfversluis

.github/FUNDING.yml

@@ -0,0 +1 @@
+github: jfversluis

.github/workflows/ci-sample.yml

@@ -16,4 +16,4 @@ jobs:
     steps:
     - uses: actions/checkout@v4
     - name: Build
-      run: dotnet build samples\Plugin.Maui.Feature.Sample.sln -c Release
+      run: dotnet build samples\Plugin.Maui.MessagingCenter.Sample.sln -c Release

.github/workflows/ci.yml

@@ -16,4 +16,4 @@ jobs:
     steps:
     - uses: actions/checkout@v4
     - name: Build
-      run: dotnet build src\Plugin.Maui.Feature.sln -c Release
+      run: dotnet build src\Plugin.Maui.MessagingCenter.sln -c Release

.github/workflows/release-nuget.yml

@@ -22,8 +22,8 @@ jobs:
           $version="${{github.ref_name}}".TrimStart("v")
           "version-without-v=$version" | Out-File -FilePath $env:GITHUB_OUTPUT -Append
       - name: Pack
-        run: dotnet pack src\Plugin.Maui.Feature.sln -c Release -p:PackageVersion=${{ steps.get_version.outputs.version-without-v }}
+        run: dotnet pack src\Plugin.Maui.MessagingCenter.sln -c Release -p:PackageVersion=${{ steps.get_version.outputs.version-without-v }}
       - name: Push
-        run: dotnet nuget push src\Plugin.Maui.Feature\bin\Release\Plugin.Maui.Feature.${{ steps.get_version.outputs.version-without-v }}.nupkg -s https://api.nuget.org/v3/index.json -k ${{ secrets.NUGET_API_KEY }}
+        run: dotnet nuget push src\Plugin.Maui.MessagingCenter\bin\Release\Plugin.Maui.MessagingCenter.${{ steps.get_version.outputs.version-without-v }}.nupkg -s https://api.nuget.org/v3/index.json -k ${{ secrets.NUGET_API_KEY }}
         env:
           GITHUB_TOKEN: ${{ secrets.NUGET_API_KEY }}

LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2023 Author Name
+Copyright (c) 2024 Gerald Versluis
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

README.md

@@ -1,54 +1,27 @@
-# Plugin.Maui.Feature Template
+![](nuget.png)
+# Plugin.Maui.MessagingCenter
 
-The `Plugin.Maui.Feature` repository is a template repository that can be used to bootstrap your own .NET MAUI plugin project. You can use this project structure as a blueprint for your own work.
+`Plugin.Maui.MessagingCenter` provides a drop-in compatible replacement for the .NET MAUI MessagingCenter which has been deprecated and removed.
 
-Learn how to get started with your plugin in this [YouTube video](https://www.youtube.com/watch?v=ZCQrlGT7MhI&list=PLfbOp004UaYVgzmTBNVI0ql2qF0LhSEU1&index=27).
+Please note that you probably want to adopt the [MVVM Toolkit Messenger](https://learn.microsoft.com/dotnet/communitytoolkit/mvvm/messenger) APIs as they provide more functionality.
 
-This template contains:
+> [!IMPORTANT]  
+> This library is meant to make the migration from Xamarin.Forms to .NET MAUI easier, not to provide a long-term solution.
 
-- A [sample .NET MAUI app](samples) where you can demonstrate how your plugin works and test your plugin with while developing
-- The [source](src) of the plugin
-- A boilerplate [README file](README_Feature.md) you can use (don't forget to rename to `README.md` and remove this one!)
-- [GitHub Actions for CI](.github/workflows) of the library and the sample app
-- [GitHub Action for releasing](.github/workflows) your package to NuGet
-- A [generic icon](nuget.png) for your project, feel free to adapt and be creative!
-- A [.editorconfig](.editorconfig) file to standardize the code syntax. Feel free to adapt or remove.
-- The [LICENSE](LICENSE) file with the MIT license. If you want this to be different, please change it. At the very least add your name in there!
+## Install Plugin
 
-## Getting Started
+[![NuGet](https://img.shields.io/nuget/v/Plugin.Maui.MessagingCenter.svg?label=NuGet)](https://www.nuget.org/packages/Plugin.Maui.MessagingCenter/)
 
-1. Create your own GitHub repository from this one by clicking the "Use this template" button and then "Create a new repository". More information in the [documentation](https://docs.github.com/repositories/creating-and-managing-repositories/creating-a-repository-from-a-template). After that, clone the repo to your local machine.
+Available on [NuGet](http://www.nuget.org/packages/Plugin.Maui.MessagingCenter).
 
-2. Replace all occurrences of `Plugin.Maui.Feature` with whatever your feature or functionality will be. For instance: `Plugin.Maui.ScreenBrightness` or `Plugin.Maui.Audio`. Of course the name can be anything, but to make it more discoverable it could be a great choice to stick to this naming scheme. You can easily do this with your favorite text-editor and do a replace all on all files.
+Install with the dotnet CLI: `dotnet add package Plugin.Maui.MessagingCenter`, or through the NuGet Package Manager in Visual Studio.
 
-   2.1 Don't forget to also rename the files and folders on your filesystem.
+## API Usage
 
-3. In the csproj file of the plugin project (under `src`), make sure that you replace all relevant values to your project. This means the author of this project, the description of the project, the target framework (.NET 7, 8 or something else). If you don't want to or can't support a certain platform, remove that target platform altogether.
+After you have installed this library, you can either add the using statement at the top of each file where you are using MessagingCenter (`using Plugin.Maui.MessagingCenter;`), or opt for a [global using](https://learn.microsoft.com/dotnet/csharp/language-reference/keywords/using-directive#global-modifier) statement so you only need to do it once.
 
-4. Delete this `README.md` file and rename `README_Feature.md` to `README.md`. Fill that README file with all the relevant details of your project.
+The API can be used the same as the .NET MAUI MessagingCenter APIs. You probably came here because you are already using the MessagingCenter in your .NET MAUI app, so you probably don't need more explanation. If you do need a reference, please find the documentation on the .NET MAUI MessagingCenter [here](https://learn.microsoft.com/dotnet/maui/fundamentals/messagingcenter) and the MVVM Toolkit Messenger [here](https://learn.microsoft.com/dotnet/communitytoolkit/mvvm/messenger).
 
-5. Check the LICENSE file if this reflects the license that you want to distribute your project under. At the very least add your name there and the current year we live in.
+## Acknowledgements
 
-6. Create a nice icon in the `nuget.png` file that will show up on nuget.org and in the NuGet manager in Visual Studio.
-
-7. Write your plugin code (under `src`) and add samples to the .NET MAUI sample app (under `samples` folder)
-
-8. Make super sure that your package won't show up as `Plugin.Maui.Feature` on NuGet! If one does, you owe me a drink!
-
-9. Publish your package to NuGet, a nice guide to do that can be found [here](https://learn.microsoft.com/nuget/nuget-org/publish-a-package). Also see [Publish to NuGet](#publish-to-nuget) below.
-
-10. Enjoy life as a .NET MAUI plugin author! ✨
-
-As an example of all of this you can have a look at:
-
-- [Plugin.Maui.Audio](https://github.com/jfversluis/Plugin.Maui.Audio)
-- [Plugin.Maui.Pedometer](https://github.com/jfversluis/Plugin.Maui.Pedometer)
-- [Plugin.Maui.ScreenBrightness](https://github.com/jfversluis/Plugin.Maui.ScreenBrightness)
-
-## Publish to NuGet
-
-If you want to publish your package to NuGet, you totally can! Included in this template are a couple of GitHub Actions. One of them goes of when you create a new tag with this pattern: `v1.0.0` or `v1.0.0-preview1`. Obviously the `1.0.0` part can be determined by you as you see fit, as long as you follow the pattern of 3 integers separated by dots.
-
-You will also want to set a secret for this repository which contains your NuGet API key. Follow the documentation on that [here](https://docs.github.com/actions/security-guides/encrypted-secrets#creating-encrypted-secrets-for-a-repository), and add a secret with the key `NUGET_API_KEY` and value of your NuGet API key. The API key should be authorized to push a NuGet package with the given identifier. 
-
-From there, after [creating a GitHub release](https://docs.github.com/repositories/releasing-projects-on-github/managing-releases-in-a-repository) your plugin will be automatically released on NuGet!
+The bubble icon has kindly been provided by [Smashicons](https://www.freepik.com/icon/chat_134719#fromView=keyword&page=1&position=1&uuid=c6e6ca66-ab2d-44de-85e9-6138fbc90df6)

README_Feature.md

@@ -2,9 +2,9 @@ Microsoft Visual Studio Solution File, Format Version 12.00
 # Visual Studio Version 17
 VisualStudioVersion = 17.0.31611.283
 MinimumVisualStudioVersion = 10.0.40219.1
-Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Plugin.Maui.Feature.Sample", "Plugin.Maui.Feature.Sample\Plugin.Maui.Feature.Sample.csproj", "{490BB138-9606-4FFF-8AAD-841C5B1ED059}"
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Plugin.Maui.MessagingCenter.Sample", "Plugin.Maui.MessagingCenter.Sample\Plugin.Maui.MessagingCenter.Sample.csproj", "{490BB138-9606-4FFF-8AAD-841C5B1ED059}"
 EndProject
-Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Plugin.Maui.Feature", "..\src\Plugin.Maui.Feature\Plugin.Maui.Feature.csproj", "{B60F3174-E978-4F2B-B117-F6F0327594C8}"
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Plugin.Maui.MessagingCenter", "..\src\Plugin.Maui.MessagingCenter\Plugin.Maui.MessagingCenter.csproj", "{B60F3174-E978-4F2B-B117-F6F0327594C8}"
 
 EndProject
 Global

nuget.png

@@ -1,7 +1,7 @@
 <?xml version = "1.0" encoding = "UTF-8" ?>
 <Application xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
              xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
-             x:Class="Plugin.Maui.Feature.Sample.App">
+             x:Class="Plugin.Maui.MessagingCenter.Sample.App">
     <Application.Resources>
         <ResourceDictionary>
             <ResourceDictionary.MergedDictionaries>

samples/Plugin.Maui.Feature.Sample/MainPage.xaml

@@ -1,4 +1,4 @@
-namespace Plugin.Maui.Feature.Sample;
+namespace Plugin.Maui.MessagingCenter.Sample;
 
 public partial class App : Application
 {

samples/Plugin.Maui.Feature.Sample/MainPage.xaml.cs

@@ -1,9 +1,9 @@
 <?xml version="1.0" encoding="UTF-8" ?>
 <Shell
-    x:Class="Plugin.Maui.Feature.Sample.AppShell"
+    x:Class="Plugin.Maui.MessagingCenter.Sample.AppShell"
     xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
     xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
-    xmlns:pages="clr-namespace:Plugin.Maui.Feature.Sample"
+    xmlns:pages="clr-namespace:Plugin.Maui.MessagingCenter.Sample"
     Shell.FlyoutBehavior="Disabled">
 
     <ShellContent

samples/Plugin.Maui.Feature.Sample.sln renamed to samples/Plugin.Maui.MessagingCenter.Sample.sln

@@ -1,4 +1,4 @@
-namespace Plugin.Maui.Feature.Sample;
+namespace Plugin.Maui.MessagingCenter.Sample;
 
 public partial class AppShell : Shell
 {

samples/Plugin.Maui.Feature.Sample/App.xaml renamed to samples/Plugin.Maui.MessagingCenter.Sample/App.xaml

@@ -0,0 +1,20 @@
+<?xml version="1.0" encoding="utf-8" ?>
+<ContentPage xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
+             xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
+             x:Class="Plugin.Maui.MessagingCenter.Sample.MainPage"
+             Title="MessagingCenter Plugin">
+
+    <VerticalStackLayout
+        HorizontalOptions="Center" VerticalOptions="Center"
+        Spacing="10">
+
+    <Button
+        Text="Subscribe" Clicked="Subscribe_Clicked" />
+
+    <Button
+        Text="Unsubscribe" Clicked="Unsubscribe_Clicked" />
+
+    <Button
+        Text="Send Hi Message" Clicked="Button_Clicked" />
+    </VerticalStackLayout>
+</ContentPage>

samples/Plugin.Maui.Feature.Sample/App.xaml.cs renamed to samples/Plugin.Maui.MessagingCenter.Sample/App.xaml.cs

@@ -0,0 +1,28 @@
+namespace Plugin.Maui.MessagingCenter.Sample;
+
+public partial class MainPage : ContentPage
+{
+	public MainPage()
+	{
+		InitializeComponent();
+	}
+
+	private void Button_Clicked(object sender, EventArgs e)
+	{
+		MessagingCenter.Send<MainPage>(this, "Hi");
+	}
+
+	private void Subscribe_Clicked(object sender, EventArgs e)
+	{
+		MessagingCenter.Subscribe<MainPage>(this, "Hi", (sender) =>
+		{
+			// Do something whenever the "Hi" message is received
+			DisplayAlert("Message Received", "Hi", "OK");
+		});
+	}
+
+	private void Unsubscribe_Clicked(object sender, EventArgs e)
+	{
+		MessagingCenter.Unsubscribe<MainPage>(this, "Hi");
+	}
+}

samples/Plugin.Maui.Feature.Sample/AppShell.xaml renamed to samples/Plugin.Maui.MessagingCenter.Sample/AppShell.xaml

@@ -1,7 +1,6 @@
 using Microsoft.Extensions.DependencyInjection;
-using Plugin.Maui.Feature;
 
-namespace Plugin.Maui.Feature.Sample;
+namespace Plugin.Maui.MessagingCenter.Sample;
 
 public static class MauiProgram
 {
@@ -16,9 +15,6 @@ public static MauiApp CreateMauiApp()
 				fonts.AddFont("OpenSans-Semibold.ttf", "OpenSansSemibold");
 			});
 
-		builder.Services.AddTransient<MainPage>();
-		builder.Services.AddSingleton<IFeature>(Feature.Default);
-
 		return builder.Build();
 	}
 }

samples/Plugin.Maui.Feature.Sample/AppShell.xaml.cs renamed to samples/Plugin.Maui.MessagingCenter.Sample/AppShell.xaml.cs

@@ -2,7 +2,7 @@
 using Android.Content.PM;
 using Android.OS;
 
-namespace Plugin.Maui.Feature.Sample;
+namespace Plugin.Maui.MessagingCenter.Sample;
 
 [Activity(Theme = "@style/Maui.SplashTheme", MainLauncher = true, ConfigurationChanges = ConfigChanges.ScreenSize | ConfigChanges.Orientation | ConfigChanges.UiMode | ConfigChanges.ScreenLayout | ConfigChanges.SmallestScreenSize | ConfigChanges.Density)]
 public class MainActivity : MauiAppCompatActivity

samples/Plugin.Maui.MessagingCenter.Sample/MainPage.xaml

@@ -1,7 +1,7 @@
 using Android.App;
 using Android.Runtime;
 
-namespace Plugin.Maui.Feature.Sample;
+namespace Plugin.Maui.MessagingCenter.Sample;
 
 [Application]
 public class MainApplication : MauiApplication

samples/Plugin.Maui.MessagingCenter.Sample/MainPage.xaml.cs

@@ -1,6 +1,6 @@
 using Foundation;
 
-namespace Plugin.Maui.Feature.Sample;
+namespace Plugin.Maui.MessagingCenter.Sample;
 
 [Register("AppDelegate")]
 public class AppDelegate : MauiUIApplicationDelegate