Prism.Core 7.0.0.124-pre

Prism is a fully open source version of the Prism guidance originally produced by Microsoft Patterns & Practices.  Prism provides an implementation of a collection of design patterns that are helpful in writing well structured and maintainable XAML applications, including MVVM, dependency injection, commanding, event aggregation, and more. Prism's core functionality is a shared code base in a Portable Class Library targeting these platforms; WPF, Windows 10 UWP, and Xamarin Forms. Features that need to be platform specific are implemented in the respective libraries for the target platform.

This is a prerelease version of Prism.Core.
There is a newer version of this package available.
See the version list below for details.
Install-Package Prism.Core -Version 7.0.0.124-pre
dotnet add package Prism.Core --version 7.0.0.124-pre
<PackageReference Include="Prism.Core" Version="7.0.0.124-pre" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add Prism.Core --version 7.0.0.124-pre
The NuGet Team does not provide support for this client. Please contact its maintainers for support.

Release Notes

## Prism.Core
* .NET Standard Support
* Added method to clear all errors on ErrorsContainer
* Add capability to DelegateCommand's ObservesProperty to observe properties of complex types
Example:
`ObservesProperty(() => Property.NestedProperty.NestedPoperty)`

## Prism.Forms
* Fixed #683: .NET Standard support
* Fixed #765: Deep linking within a NavigationPage results in an incorrect ContentPage Title on Android
* Fixed #1008: NavigationParameters: Not possible to specify parent type as generic parameter T
* Fixed #1024: XF: NavigationService swallowing Exceptions
* Fixed #1025: Xamarin.Forms deprecated the Device.OS property in favor of the RuntimePlatform property.
* Fixed #1027: Support macOS
* Fixed #1044: When Detail of MasterDetailPage is null, Modal Navigation is possible
* Fixed #1045: When calling NavigateAsync with NavigationPage, old page's Destroy on the stack is not called
* Fixed #1046: When calling DeepLink from Navigation Stack, the second page becomes Modal navigation
* Fixed #1054: When deep linking within NavigationPage, page order is reversed
* Fixed #1063: Master of MasterDetailPage will not be destroyed
* Fixed #1085: Error occurs if null path is specified in EventToCommandBehavior
* Fixed #1089: DebugLogger does not work in nuget-package
* Fixed #1132: Prism Forms Modularity extension methods
* Fixed #1133: IModuleCatalog AddModule returns wrong type
* Fixed #1139: Modularity Enhancements
* Fixed #1076: IActiveAware not working when ContentPage (as child of a TabbedPage) is wrapped into a NavigationPage

**IDeviceService**
* deprecated OnPlatform methods
* added DeviceRuntimePlatform property - this mimics the XF API and returns a string
* added RuntimePlatform property which returns an Enum of type RuntimePlatform and wraps the XF string-based values

**Container Extensions**
* deprecated the RegisterTypeForNavigationOnPlatform signature that requires explicit platform parameters
* added new signature that accepts new IPlatform objects
Example:
```
Container.RegisterTypeForNavigationOnPlatform<MainPage, MainPageViewModel>("Main",
new Platform<MainPage_Android>(RuntimePlatform.Android),
new Platform<MainPage_iOS>(RuntimePlatform.iOS));
```

# TabbedPage Navigation Behavior Change - BREAKING
## Current Behavior (v6.3.0)
`NavigateAsync("TabbedPage/ViewA/ViewB")` will select the tab ViewA in the TabbedPage if it exists, then continue navigating.  If ViewA does not exist as a tab, then you will continue to navigate as expected.

`NavigateAsync("TabbedPage/NavigationPage/ViewA/ViewB")` would search the TabbedPage for the first instance of a tab that was a NavigationPage, then navigate within the Navigation page the remaining ViewA and ViewB pages.  This provided the ability to deep link into a tab's nested navigation page, but there was no way to opt-out of this behavior.

Also, the INavigationAware methods did not get called to all tabs meaning that you would be responsible for forwarding any parameters to all your tabs.

## New Behavior
`NavigateAsync("TabbedPage/ViewA/ViewB")` will **no longer** select any tabs, but rather continue processing the navigation as separate pages on the navigation stack.

If you wish to select a tab, you will now use a parameter called "selectedTab" to indicate which tab you would like to select.

`NavigateAsync("TabbedPage?selectedTab=MiddleTab/ViewA/ViewB")`

This will navigate to the TabbedPage, selected the "MiddleTab" and continue navigating ViewA and ViewB onto the navigation stack.

For tabs that are wrapped inside a NavigationPage, you can use the "|" symbol to indicate the hierarchy.

`NavigateAsync("TabbedPage?selectedTab=NavigationPage|MiddleTab")`

There is a constant in the `KnownNavigationParameters` called `SelectedTab` that you can use instead of a string.

`NavigateAsync($"TabbedPage?{KnownNavigationParameters.SelectedTab}=MiddleTab")`

This will search each tab to see if it is a navigation page and if the first page on the stack matches "MiddleTab".  This is much more flexible than the existing behavior as before it would take the first instance of the NavigationPage found.  Now you can choose which tab exactly.

Some INavigationAware methods are now fired on all Tabs:
- OnNavigatingTo will be invoked on the TabbedPage and ALL TABS.
- OnNavigatedTo will be invoked on the TabbedPage and only the SELECTED TAB.
- OnNavigatedFrom will be invoked on the TabbedPage and only the SELECTED TAB.

**Note**: the parameter key `selectedTab` is now a reserved parameter name.  Similar to a reserved keyword in C#.  If you use this in your app as a key, you may experience undesired behavior.

**Note**: At this time there is no native support for deep linking into a Tab that is a navigation page.  Please let me know if you need this functionality.

NuGet packages (89)

Showing the top 5 NuGet packages that depend on Prism.Core:

Package Downloads
Prism.Wpf
Prism is a fully open source version of the Prism guidance originally produced by Microsoft Patterns & Practices. Prism provides an implementation of a collection of design patterns that are helpful in writing well structured, maintainable, and testable XAML applications, including MVVM, dependency injection, commanding, event aggregation, and more. Prism's core functionality is a shared library targeting the .NET Framework and .NET Standard. Features that need to be platform specific are implemented in the respective libraries for the target platform (WPF, Uno Platform, and Xamarin Forms). Prism.Wpf helps you more easily design and build rich, flexible, and easy to maintain Windows Presentation Foundation (WPF) desktop applications. This library provides user interface composition as well as modularity support.
Prism.Forms
Prism is a fully open source version of the Prism guidance originally produced by Microsoft Patterns & Practices. Prism provides an implementation of a collection of design patterns that are helpful in writing well structured, maintainable, and testable XAML applications, including MVVM, dependency injection, commanding, event aggregation, and more. Prism's core functionality is a shared library targeting the .NET Framework and .NET Standard. Features that need to be platform specific are implemented in the respective libraries for the target platform (WPF, Uno Platform, and Xamarin Forms). Prism for Xamarin.Forms helps you more easily design and build rich, flexible, and easy to maintain Xamarin.Forms applications. This library provides user interface composition as well as modularity support.
Prism.Windows
Prism is a fully open source version of the Prism guidance originally produced by Microsoft Patterns & Practices. Prism provides an implementation of a collection of design patterns that are helpful in writing well structured and maintainable XAML applications, including MVVM, dependency injection, commanding, event aggregation, and more. Prism.Windows contains the platform specific features for Windows 10 UWP.
Prism.Plugin.Logging.Abstractions
Provides base interfaces for more robust Prism Logging.
Aurora.Core
MVPVM Framework Core Library

GitHub repositories (35)

Showing the top 5 popular GitHub repositories that depend on Prism.Core:

Repository Stars
OptiKey/OptiKey
OptiKey - Full computer control and speech with your eyes
unoplatform/uno
Build Mobile, Desktop and WebAssembly apps with C# and XAML. Today. Open source and professionally supported.
JosefNemec/Playnite
Video game library manager with support for wide range of 3rd party libraries and game emulation support, providing one unified interface for your games.
Covid-19Radar/Covid19Radar
Open Source / i18n / iOS Android Cross Platform Contact Tracing App by exposure notification framework Xamarin App and Server Side Code
Windows-XAML/Template10
Making Windows 10 apps great again

Version History

Version Downloads Last updated
8.0.0.1909 2,543 10/21/2020
8.0.0.1850-pre 3,627 8/25/2020
8.0.0.1740-pre 9,065 5/5/2020
7.2.0.1422 600,358 11/21/2019
7.2.0.1367 309,075 7/24/2019
7.2.0.1347-pre 8,374 6/11/2019
7.2.0.1233-pre 7,443 5/6/2019
7.2.0.1038-pre 11,785 2/20/2019
7.2.0.708-pre 4,808 12/4/2018
7.1.0.431 824,819 10/15/2018
7.1.0.279-pre 3,650 9/20/2018
7.1.0.172-pre 60,344 6/15/2018
7.1.0.135-pre 3,132 5/9/2018
7.1.0.123-pre 14,011 4/2/2018
7.0.0.396 330,784 1/22/2018
7.0.0.362 24,832 1/12/2018
7.0.0.336-pre 17,437 12/7/2017
7.0.0.269-pre 36,835 11/16/2017
7.0.0.168-pre 18,011 10/13/2017
7.0.0.124-pre 6,036 10/6/2017
7.0.0-pre1 3,839 9/22/2017
6.3.0 905,394 3/25/2017
6.3.0-pre2 4,287 2/26/2017
6.3.0-pre1 18,346 11/2/2016
6.2.0 327,207 8/9/2016
6.2.0-pre1 3,263 6/21/2016
6.1.0 227,748 10/14/2015
6.0.1 37,027 9/10/2015
6.0.0 3,815 9/9/2015
5.7.0-pre3 2,834 6/25/2015
Show less