Merge branch 'master' into adding-Mvux-ListView-app

DevTKSS · web-flow · commit d08ba176b8e5 · 2026-03-14T16:40:52.000+01:00
diff --git a/README.md b/README.md
diff --git a/docs/articles/.attachments/IRouteNotifyer.gif b/docs/articles/.attachments/IRouteNotifyer.gif
diff --git a/docs/articles/.attachments/SimpleMemberSelectionApp.png b/docs/articles/.attachments/SimpleMemberSelectionApp.png
diff --git a/docs/articles/de/HowTo-Adding-New-VM-Class-Record-de.md b/docs/articles/de/HowTo-Adding-New-VM-Class-Record-de.md
@@ -36,6 +36,14 @@ Um ein für Mvux passendes Model zu erstellen:
 
 ![Umbenennen-Klasse-zu-Mvux-Model](../.attachments/renaming-class-to-record-mvux.png)
 
+> [!NOTE]
+> In Mvux werden Models als `record`-Typen definiert, um Unveränderlichkeit und wertbasierte Gleichheit zu nutzen, was für die Zustandsverwaltung in Anwendungen vorteilhaft ist.
+> Die Verwendung von `partial` ist in Mvux Models unerlässlich, um die vom Framework bereitgestellten Code-Generierungsfunktionen zu ermöglichen, wie z.B. automatische Eigenschaftsänderungsbenachrichtigungen und andere Reduzierungen von Boilerplate-Code.
+> [!CAUTION]
+> Genau wie bei regulären C#-Klassen können auch Mvux Models oder Services primäre Konstruktoren haben, die standardmäßig die Parameter als Eigenschaften des Record-Typs erzeugen.
+> Ein potenzieller Nachteil dabei ist, dass ein `INavigator`-Parameter im primären Konstruktor ebenfalls eine Eigenschaft des Models wäre, was normalerweise nicht das ist, was wir als Teil der öffentlichen API unseres Models wollen.
+> Du solltest bevorzugen, diese Service-definierenden Parameter in einem sekundären Konstruktor zu definieren und sie als `private readonly` Felder zu behalten.
+
 ### [Ein ViewModel erstellen](#tab/create-mvvm-viewmodel)
 
 Um ein für Mvvm passendes ViewModel zu erstellen:
@@ -47,3 +55,6 @@ Um ein für Mvvm passendes ViewModel zu erstellen:
 ![Konvertieren-Klasse-zu-ViewModel-Mvvm](../.attachments/converting-class-to-vm-mvvm.png)
 
 ---
+
+> [!NOTE]
+> Du kannst in Uno ViewModels oder Models frei den primären Konstruktor verwenden, beachte jedoch, dass bei Verwendung von `Uno.Extensions.Navigation` keine Parameter im *Page*-Konstruktor erlaubt sind.
diff --git a/docs/articles/de/Introduction-de.md b/docs/articles/de/Introduction-de.md
@@ -29,9 +29,21 @@ Hier ein schneller Überblick über die enthaltenen Samples. Detaillierte Infos
 
 ### XamlNavigationApp (Mvux)
 
-- [NavigationView in MVUX oder MVVM + XAML](xref:DevTKSS.Uno.ExtensionsNavigation.Overview.de)
+- [NavigationView in MVUX oder MVVM + XAML - Übersicht](xref:DevTKSS.Uno.ExtensionsNavigation.Overview.de) - [Showcase Video ansehen auf Youtube](https://youtu.be/vVvnK02r2ug)
+- [Definieren des UI mit einer NavigationView](xref:DevTKSS.Uno.ExtensionsNavigation.HowTo-Defining-UI.de) - [Tutorial ansehen auf Youtube](https://youtu.be/knt2oOjHH30)
+- [Reagieren auf Routen Änderungen](xref:DevTKSS.Uno.ExtensionsNavigation.HowTo-ChangeRoutes.de) - [Tutorial ansehen auf Youtube](https://youtu.be/RZ3RirA7jhk)
 - [Zum Quellcode](https://github.com/DevTKSS/DevTKSS.Uno.SampleApps/blob/master/src/DevTKSS.Uno.XamlNavigationApp/)
 
+### SimpleMemberSelectionApp
+
+- **YouTube Video:** [How To: Binden von ListState und ImmutableList zu FeedView & ListView im UI](https://youtu.be/wOsSlv1YFic)
+- [Zum Quellcode](https://github.com/DevTKSS/DevTKSS.Uno.SampleApps/blob/master/src/DevTKSS.Uno.SimpleMemberSelectionApp/)
+
+### MvuxListApp
+
+- **YouTube Video:** [HowTo: Mvux ListState - Binden unseres UI an das Selected Item](https://youtu.be/UUa2VymR8hM)
+- [Zum Quellcode](https://github.com/DevTKSS/DevTKSS.Uno.SampleApps/blob/master/src/DevTKSS.Uno.MvuxListApp/)
+
 ---
 
 ## Weitere Ressourcen
diff --git a/docs/articles/de/MvuxGallery-Overview-de.md b/docs/articles/de/MvuxGallery-Overview-de.md
@@ -79,7 +79,7 @@ Hier ist eine Liste von Steuerelementen und Funktionen, die Sie in der MvuxGalle
 
 - Lokalisierung
   - **IStringLocalizer**
-    - Ressourcenwörterbücher (*Ich empfehle, diese Links mit Visual Studio 2022 zu durchsuchen*)
+    - Ressourcenwörterbücher (*Ich empfehle, diese Links mit Visual Studio 2022/2026 zu durchsuchen*)
       - [en](https://github.com/DevTKSS/DevTKSS.Uno.SampleApps/blob/master/src/DevTKSS.Uno.Samples.MvuxGallery/Strings/en/Resources.resw)
       - [de](https://github.com/DevTKSS/DevTKSS.Uno.SampleApps/blob/master/src/DevTKSS.Uno.Samples.MvuxGallery/Strings/de/Resources.resw)
     - Bindung des aktuellen Werts in `IState<string>` und zur entsprechenden Ansicht
diff --git a/docs/articles/de/Navigation/HowTo-UpgradeExistingApp-de.md b/docs/articles/de/Navigation/HowTo-UpgradeExistingApp-de.md
@@ -36,6 +36,10 @@ In der Projektdatei, zu erkennen an der Endung `.csproj`, brauchst du dafür neb
 
 > [!TIP]
 > Das `Toolkit` Feature wird nur benötigt, wenn Navigations-Steuerelemente wie `TabBar` oder `DrawerControl` verwendet werden sollen.
+> [!NOTE]
+> Wir benötigen grundsätzlich das `Hosting` Feature und die `DependencyInjection` Funktionalität in unserer Anwendung zu verwenden.
+> Ich sage hier absichtlich "grundsätzlich", da ich bspw. in der hier enthaltenen `MvuxGallery` und `SimpleMemberSelectionApp` Anwendungen das `Hosting` Feature entfernt habe, die App erstellt habe und entgegen der offiziellen Dokumentation ich keine Probleme feststellen konnte.
+> Alle DI Parameter wurden korrekt aufgelöst und ich war weiterhin im stande `ConfigureServices` für die Registrierung von bspw. `KeyedService` in der zugehörigen `App.xaml.cs` Datei mit dem [![Uno.Sdk 6.3.28](https://img.shields.io/badge/Uno.Sdk-6.3.28-blue)](https://www.nuget.org/packages/Uno.Sdk/6.3.28) zu verwenden.
 
 ## App.xaml.cs Konfiguration
 
diff --git a/docs/articles/en/HowTo-Adding-New-VM-Class-Record-en.md b/docs/articles/en/HowTo-Adding-New-VM-Class-Record-en.md
@@ -4,7 +4,7 @@ uid: DevTKSS.Uno.Setup.HowTo-AddingNew-VM-Class-Record.en
 
 ## How To: Create a ViewModel or Model from Classes
 
-In this guide, we will look at how to create a new class element in Visual Studio and then create either a ViewModel or a Model for use in an Uno Platform application with **MVUX**.
+In this guide, we will look at how to create a new class element in Visual Studio and then create either a ViewModel or a Model for use in an Uno Platform application.
 
 For the following steps, let's assume the page that the element to be created belongs to is called **SamplePage.xaml**
 
@@ -16,9 +16,10 @@ For the following steps, let's assume the page that the element to be created be
    ![Adding-new-Item-to-sln](../.attachments/Adding-new-Item-to-sln-en.png)
 
 2. **Create a Class element:**
-   1. Select the **`Class`** element in the list and name it according to the following scheme:
+   1. Select the **`Class`** element in the list and name it according to the naming conventions:
+
+   Your application uses:
 
-   **Your application uses:**
    - **Mvvm:** `SampleViewModel.cs`
    - **Mvux:** `SampleModel.cs`
 
@@ -36,6 +37,14 @@ To create a Model suitable for Mvux:
 
 ![Renaming-Class-to-Mvux-Model](../.attachments/renaming-class-to-record-mvux.png)
 
+> [!NOTE]
+> In Mvux, Models are defined as `record` types to leverage immutability and value-based equality, which are beneficial for state management in applications.
+> Using `partial` is essential in Mvux Models to enable code generation features provided by the framework, such as automatic property change notifications and other boilerplate code reductions.
+> [!CAUTION]
+> Just like in regular C# classes, Mvux Models or Services can also have primary constructors, which will by default produce the parameters as properties of the record type.
+> A potential downside of this is, that a `INavigator` parameter in the primary constructor would also be a property of the Model, which is not what we normally want as part of our Model's public API.
+> You should prefer defining those Service defining parameters in a secondary constructor and keep them as `private readonly` fields.
+
 ### [Create a ViewModel](#tab/create-mvvm-viewmodel)
 
 To create a ViewModel suitable for Mvvm:
@@ -47,3 +56,6 @@ To create a ViewModel suitable for Mvvm:
 ![Converting-Class-to-ViewModel-Mvvm](../.attachments/converting-class-to-vm-mvvm.png)
 
 ---
+
+> [!NOTE]
+> You are free to use the primary constructor in Uno ViewModels or Models, but note that using `Uno.Extensions.Navigation` you can not have parameters in the *page* constructor.
diff --git a/docs/articles/en/Introduction-en.md b/docs/articles/en/Introduction-en.md
@@ -29,9 +29,21 @@ Here is a quick overview of the included samples. You can find detailed informat
 
 ### XamlNavigationApp (Mvux)
 
-- [NavigationView in MVUX or MVVM + XAML](xref:DevTKSS.Uno.ExtensionsNavigation.Overview.en)
+- [NavigationView in MVUX or MVVM + XAML - Overview](xref:DevTKSS.Uno.ExtensionsNavigation.Overview.en) - [Watch Showcase Video on Youtube](https://youtu.be/vVvnK02r2ug)
+- [Defining UI with a NavigationView](xref:DevTKSS.Uno.ExtensionsNavigation.HowTo-Defining-UI.en) - [Watch Tutorial on Youtube](https://youtu.be/knt2oOjHH30)
+- [Responding to Route Changes](xref:DevTKSS.Uno.ExtensionsNavigation.HowTo-ChangeRoutes.en) - [Watch Tutorial on Youtube](https://youtu.be/RZ3RirA7jhk)
 - [View Source Code](https://github.com/DevTKSS/DevTKSS.Uno.SampleApps/blob/master/src/DevTKSS.Uno.XamlNavigationApp/)
 
+### SimpleMemberSelectionApp
+
+- **YouTube Video:** [How To: Binding ListState and ImmutableList to FeedView & ListView in UI](https://youtu.be/wOsSlv1YFic)
+- [View Source Code](https://github.com/DevTKSS/DevTKSS.Uno.SampleApps/blob/master/src/DevTKSS.Uno.SimpleMemberSelectionApp/)
+
+### MvuxListApp
+
+- **YouTube Video:** [HowTo: Mvux ListState - Binding our UI to the Selected Item](https://youtu.be/UUa2VymR8hM)
+- [View Source Code](https://github.com/DevTKSS/DevTKSS.Uno.SampleApps/blob/master/src/DevTKSS.Uno.MvuxListApp/)
+
 ---
 
 ## Additional Resources
diff --git a/docs/articles/en/MvuxGallery-Overview-en.md b/docs/articles/en/MvuxGallery-Overview-en.md
@@ -75,7 +75,7 @@ Here is a list of Controls and Features you can explore in the MvuxGallery App w
 
 - Localization
   - **IStringLocalizer**
-    - Resources Dictionaries (*I recommend to lookup those links using Visual Studio 2022*)
+    - Resources Dictionaries (*I recommend to lookup those links using Visual Studio 2022/2026*)
       - [en](https://github.com/DevTKSS/DevTKSS.Uno.SampleApps/blob/master/src/DevTKSS.Uno.Samples.MvuxGallery/Strings/en/)
       - [de](https://github.com/DevTKSS/DevTKSS.Uno.SampleApps/blob/master/src/DevTKSS.Uno.Samples.MvuxGallery/Strings/de/)
     - Binding current value in `IState<string>` and to corresponding View
diff --git a/docs/articles/en/Navigation/HowTo-UpgradeExistingApp-en.md b/docs/articles/en/Navigation/HowTo-UpgradeExistingApp-en.md
@@ -36,6 +36,10 @@ In the project file, recognizable by the `.csproj` extension, you need the follo
 
 > [!TIP]
 > The `Toolkit` feature is only required to use navigation controls like `TabBar` or `DrawerControl`.
+> [!NOTE]
+> In general we need the `Hosting` feature to use `DependencyInjection` in our app.
+> I say "in general" because, for example, in the included `MvuxGallery` and `SimpleMemberSelectionApp` I removed the `Hosting` feature, created the app, and contrary to the official documentation I couldn't find any problems.
+> All DI parameters were resolved correctly and I was still able to use `ConfigureServices` with `KeyedService` Registration in the corresponding `App.xaml.cs` file with the [![Uno.Sdk 6.3.28](https://img.shields.io/badge/Uno.Sdk-6.3.28-blue)](https://www.nuget.org/packages/Uno.Sdk/6.3.28).
 
 ## App.xaml.cs Configuration
 
diff --git a/src/DevTKSS.Uno.Samples.MvuxGallery/ReadMe.md b/src/DevTKSS.Uno.Samples.MvuxGallery/ReadMe.md
@@ -15,7 +15,7 @@ You are not required to have any prior knowledge of the Uno Platform or Mvux to
 ## Documentation and Tutorials of the DevTKSS.Uno.SampleApps
 
 * [Discover the DevTKSS.Uno.SampleApps Repository on GitHub](https://github.com/DevTKSS/DevTKSS.Uno.SampleApps)
-* [Explore the DevTKSS.Uno.SampleApps Documentation in the Browser](https://devtkss.github.io/DevTKSS.Uno.SampleApps/doc)
+* [Explore the DevTKSS.Uno.SampleApps Documentation in the Browser](https://devtkss.github.io/DevTKSS.Uno.SampleApps/)
 
 ## Official Documentation links
 
diff --git a/src/DevTKSS.Uno.SimpleMemberSelectionApp/Presentation/DashboardModel.cs b/src/DevTKSS.Uno.SimpleMemberSelectionApp/Presentation/DashboardModel.cs
@@ -15,10 +15,29 @@ public DashboardModel()
             "Tom"
         ]);
 
+    /// <summary>
+    /// Prefer using Statefull Properties, if your really expect changes to happen, which you want the UI/View Layer to become updated with.<br/>
+    /// This Example without us expecting any changes, would not make sense in real-world Applications,<br/>
+    /// instead you could connect the lamda function to be fed by a <see cref="IStringLocalizer" /> and rely on always current Title for your Dashboard.
+    /// </summary>
     public IState<string> DashboardTitle => State<string>.Value(this, () => "Hallo vom Dashboard");
 
+    /// <summary>
+    /// Use the <c>.Async</c>-Operator, whenever you need asyncronous initialization, like if your App needs to request its Value from an external API.<br/>
+    /// The <c>.Selection(ListState<T>)</c>-Operator will get called everytime, either the User selects a displayed Item in the View or if you call the <c>ListState<T>.TrySelectAsync(T,CancellationToken)</c> in the Model itself and provide the value to the given recipient <see cref="State<T>" />.
+    /// </summary>
     public IListState<string> Members => ListState.Async(this, GetMembers)
-                                                   .Selection(SelectedMember);
+                                                   .Selection(AsyncSelectedMember);
+
+    /// <summary>
+    /// Use the <c>.Value</c>-Operator, whenever you load data from <see cref="IOptions<{T}>" /> or a static Collection like we do here, for synchronous Initialization of the Value.
+    /// The <c>.Selection(ListState<T>)</c>-Operator will get called everytime, either the User selects a displayed Item in the View or if you call the <c>ListState<T>.TrySelectAsync(T,CancellationToken)</c> in the Model itself and provide the value to the given recipient <see cref="State<T>" />.
+    /// </summary>
+    public IListState<string> AsyncMembers => ListState.Value(this, () => _listMembers)
+                                                        .Selection(SelectedMember);
+
 
     public IState<string> SelectedMember => State<string>.Empty(this);
+    
+    public IState<string> AsyncSelectedMember => State<string>.Empty(this);
 }
diff --git a/src/DevTKSS.Uno.SimpleMemberSelectionApp/ReadMe.de.md b/src/DevTKSS.Uno.SimpleMemberSelectionApp/ReadMe.de.md
@@ -17,6 +17,13 @@ Weitere Informationen zur Verwendung des Uno.Sdk oder zum Aktualisieren der Uno
 Diese Beispiel-App  hat bisher kein dokumentiertes Tutorial, aber du kannst dir schon den auf YouTube verfügbaren Video-Guide ansehen:
 [How To: Binden von ListState und ImmutableList zu FeedView & ListView im UI | Uno Community Tutorial](https://youtu.be/wOsSlv1YFic)
 
+### Source Code
+
+| View | ViewModel |
+| --- | --- |
+| [Main Page](./Presentation/MainPage.xaml) | [Main Model](./Presentation/MainModel.cs)
+| [Dashboard Page](./Presentation/DashboardPage.xaml) | [Dashboard Model](./Presentation/DashboardModel.cs)
+
 ## Mitwirken
 
-Wenn du zu diesem Beispiel beitragen möchtest, wirf einen Blick auf das [GitHub repository](https://github.com/DevTKSS/DevTKSS.Uno.SampleApps)
+Wenn du zu diesem Beispiel beitragen möchtest, wirf einen Blick auf die [CONTRIBUTING Guidelines](https://github.com/DevTKSS/DevTKSS.Uno.SampleApps/blob/master/CONTRIBUTING.md)
diff --git a/src/DevTKSS.Uno.SimpleMemberSelectionApp/ReadMe.en.md b/src/DevTKSS.Uno.SimpleMemberSelectionApp/ReadMe.en.md
@@ -15,8 +15,18 @@ For more information on how to use the Uno.Sdk or upgrade Uno Platform packages
 ## Tutorial to follow along with this sample
 
 This sample app has no Documented Tutorial by now, but you can check out the Video Guide already available on YouTube:
-[How To: Binden von ListState und ImmutableList zu FeedView & ListView im UI | Uno Community Tutorial](https://youtu.be/wOsSlv1YFic) (Deutsch => Switch on Subtitles for English)
+[How To: Binding to ListState with an ImmutableList from FeedView & ListView in UI](https://youtu.be/wOsSlv1YFic) (Deutsch => Switch on Subtitles for English)
+
+> [!NOTE]
+> The Video for the Tutorial is until now only available in German Localization, so we recommend activating automatic Sub-Titles on YouTube until there is an English Version available.
+
+### Source Code
+
+| View | ViewModel |
+| --- | --- |
+| [Main Page](./Presentation/MainPage.xaml) | [Main Model](./Presentation/MainModel.cs)
+| [Dashboard Page](./Presentation/DashboardPage.xaml) | [Dashboard Model](./Presentation/DashboardModel.cs)
 
 ## Contributing
 
-If you want to contribute to this sample, please check out the [GitHub repository](https://github.com/DevTKSS/DevTKSS.Uno.SampleApps)
+If you want to contribute to this sample, please check out the [CONTRIBUTING Guidelines](https://github.com/DevTKSS/DevTKSS.Uno.SampleApps/blob/master/CONTRIBUTING.md)
diff --git a/src/DevTKSS.Uno.XamlNavigationApp/ReadMe.de.md b/src/DevTKSS.Uno.XamlNavigationApp/ReadMe.de.md
@@ -14,13 +14,36 @@ Weitere Informationen zur Verwendung des Uno.Sdk oder zum Aktualisieren der Uno
 
 ## Tutorial zum Mitmachen
 
-Diese Beispiel-App ist Teil eines Community-Tutorial-Videos, das dich durch den Prozess des Aufbaus einer XAML-Navigations-App mit der Uno Platform führt.
+Diese Beispiel-App ist Teil eines Community-Tutorial-Videos, das dich durch den Prozess des Aufbaus einer XAML-Navigations-App und Mvux mit der Uno Platform führt.
 
-Bitte wähle die Sprache deiner Wahl, um dem Tutorial zu folgen:
+### Xaml Navigation Tutorials
 
-- [Deutsch](../../docs/articles/de/Navigation/Extensions-Navigation-de.md)
-- [Englisch](../../docs/articles/en/Navigation/HowTo-Defining-UI-NavigationView-en.md)
+- [Tutorial Teil 1: Erstellen des UI mit einer NavigationView in Xaml](https://devtkss.github.io/DevTKSS.Uno.SampleApps/articles/de/Navigation/HowTo-Defining-UI-NavigationView-de.html)
+- [Tutorial Teil 2: Registrieren und Verwalten von Routen](https://devtkss.github.io/DevTKSS.Uno.SampleApps/articles/de/Navigation/HowTo-RegisterRoutes-de.html)
+- [Tutorial Teil 3: Navigation im Model oder ViewModel](https://devtkss.github.io/DevTKSS.Uno.SampleApps/articles/de/Navigation/HowTo-ModelDefinition-de.html)
+- YouTube Video: [How To: Navigation mit NavigationView in MVUX und XAML](https://youtu.be/knt2oOjHH30) *(Umfasst alle 3 Teile)*
+
+#### Source Code Links (Xaml Navigation)
+
+| View | Mvux Model |
+| --- | --- |
+| [Main Page](./Presentation/MainPage.cs) | [Main Model](./Presentation/MainModel.cs) |
+| [Dashboard Page](./Presentation/DashboardPage.cs) | [Dashboard Model](./Presentation/DashboardModel.cs) |
+| [Second Page](./Presentation/SecondPage.cs) | [Second Model](./Presentation/SecondModel.cs) |
+
+- [Route Registration (App.xaml.cs)](./App.xaml.cs)
+
+### Verwendung von IRouteNotifier in MVUX Model Tutorial
+
+- [Tutorial: Reagieren auf Routen Änderungen](https://devtkss.github.io/DevTKSS.Uno.SampleApps/articles/de/Navigation/HowTo-ChangeRoutes-de.html)
+- YouTube Video: [How To: Einbinden des IRouteNotifier mit dem RouteChanged Event](https://youtu.be/RZ3RirA7jhk)
+
+#### Source Code Links (IRouteNotifier)
+
+| View | Mvux Model |
+| --- | --- |
+| [Main Page](./Presentation/MainPage.cs) | [Main Model](./Presentation/MainModel.cs) |
 
 ## Mitwirken
 
-Wenn du zu diesem Beispiel beitragen möchtest, wirf einen Blick auf das [GitHub repository](https://github.com/DevTKSS/DevTKSS.Uno.SampleApps)
+Wenn du zu diesem Beispiel beitragen möchtest, wirf einen Blick auf die [CONTRIBUTING Guidelines](https://github.com/DevTKSS/DevTKSS.Uno.SampleApps/blob/master/CONTRIBUTING.md)
diff --git a/src/DevTKSS.Uno.XamlNavigationApp/ReadMe.en.md b/src/DevTKSS.Uno.XamlNavigationApp/ReadMe.en.md
