/Prism

Prism is a framework for building loosely coupled, maintainable, and testable XAML applications in WPF, Windows 10 UWP, and Xamarin Forms.

Primary LanguageC#OtherNOASSERTION

Prism

Prism is a framework for building loosely coupled, maintainable, and testable XAML applications in WPF, Windows 10 UWP, and Xamarin Forms. Separate releases are available for each platform and those will be developed on independent timelines. 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, commands, EventAggregator, and others. Prism's core functionality is a shared code base in a Portable Class Library targeting these platforms. Those things that need to be platform specific are implemented in the respective libraries for the target platform. Prism also provides great integration of these patterns with the target platform. For example, Prism for UWP and Xamarin Forms allows you to use an abstraction for navigation that is unit testable, but that layers on top of the platform concepts and APIs for navigation so that you can fully leverage what the platform itself has to offer, but done in the MVVM way.

Prism 6 is a fully open source version of the Prism guidance originally produced by Microsoft patterns & practices. The core team members were all part of the P&P team that developed Prism 1 through 5, and the effort has now been turned over to the open source community to keep it alive and thriving to support the .NET community. There are thousands of companies who have adopted previous versions of Prism for WPF, Silverlight, and Windows Runtime, and we hope they will continue to move along with us as we continue to evolve and enhance the framework to keep pace with current platform capabilities and requirements.

At the current time, we have no plans to create new versions of the library for Silverlight or for Windows 8/8.1/WP8.1. For those you can still use the previous releases from Microsoft P&P here and here. If there is enough interest and contributors to do the work, we can consider it, but it is not on our roadmap for now.

Build Status

Status
Full Build Build Status
Prism.Core Build Status
Prism.Wpf Build Status
Prism.Windows Build Status
Prism.Forms Build Status

Support

Help Support Prism

As most of you know, it takes a lot of time and effort for our small team to manage and maintain Prism in our spare time. Even though Prism is open source and hosted on GitHub, there are a number of costs associated with maintaining a project such as Prism. If you would like to help support us, the easiest thing you can do is become a Patron and watch our Pluralsight courses on Prism.

By becoming a Patron and subscribing to the Prism Library, you will receive a number of benefits depending on your level of support.

Basic - $1+ per month

  • Receive all Prism Library news and announcements, such as new release information and blogs posts.
  • Gives you access to our community Slack channel where you can ask questions and get help from the community and the Prism Library project maintainers (when available).

Premium - $5+ per month

  • Gives you access to members only video tutorials.
  • A Prism sticker

Platinum - $10+ per month

  • Early access to Visual Studio productivity tools.
  • Early access to video tutorials
  • Receive priority response on all GitHub issues.
  • Gives you access to a private Slack channel where you can ask questions and get help directly from Prism Library project maintainers.

By watching our courses, not only do you help support the project financially, but you might also learn something along the way. We believe this is a win-win for everyone.

We appreciate your support.

NuGet Packages

Official Prism releases are available on NuGet. Prism also has a MyGet feed which will be updated with each merged PR. If you want to take advantage of a new feature as soon as it's merged into the code base, or if there is a critical bug you need fixed we invite you to try the packages on this feed. Our feed is a public feed in the MyGet Gallery.

Simply add https://www.myget.org/F/prism/api/v3/index.json as a package source to either Visual Studio or Visual Studio for Mac.

Core Packages

These are the base packages for each platform, together with the Prism's Core assembly as a cross-platform PCL.

Platform Assembly Package NuGet MyGet
PCL Prism.dll Prism.Core CoreNuGetShield CoreMyGetShield
WPF Prism.Wpf.dll Prism.Wpf WpfNuGetShield WpfMyGetShield
Xamarin.Forms Prism.Forms.dll Prism.Forms FormsNuGetShield FormsMyGetShield
Windows 10 UWP Prism.Windows.dll Prism.Windows UWPNuGetShield UWPMyGetShield

Container-specific packages

Each supported IoC container has its own package assisting in the setup and usage of that container together with Prism. The assembly is named using this convention: Prism.Container.Platform.dll, e.g. Prism.Unity.Wpf.dll. Starting with version 7.0, Prism is moving to separate packages for each platform. Be sure to install the package for the Container and the Platform of your choice.

NOTE: MEF is supported with WPF for compatibility with previous versions. It will not be added to Windows 10 UWP or Xamarin Forms.

WPF

Package NuGet MyGet
Prism.Autofac* AutofacWpfNuGetShield AutofacWpfMyGetShield
Prism.DryIoc DryIocWpfNuGetShield DryIocWpfMyGetShield
Prism.Mef* MefWpfNuGetShield N/A
Prism.Ninject NinjectWpfNuGetShield NinjectWpfMyGetShield
Prism.StructureMap StructureMapWpfNuGetShield StructureMapWpfMyGetShield
Prism.Unity UnityWpfNuGetShield UnityWpfMyGetShield

UWP

Package NuGet MyGet
Prism.DryIoc.Windows DryIocUWPNuGetShield DryIocUWPMyGetShield
Prism.Unity.Windows UnityUWPNuGetShield UnityUWPMyGetShield

Xamarin Forms

Package NuGet MyGet
Prism.Autofac.Forms* AutofacFormsNuGetShield AutofacFormsMyGetShield
Prism.DryIoc.Forms DryIocFormsNuGetShield DryIocFormsMyGetShield
Prism.Ninject.Forms* NinjectFormsNuGetShield N/A
Prism.Unity.Forms UnityFormsNuGetShield UnityFormsMyGetShield

Package Notices

  • Autofac will be removed following the 7.1 release due to it's inability to support Prism Modularity.
  • MEF is no longer supported in Prism 7 as it is not truly a DI Container and lacks the performance that developers deserve.
  • Ninject for Xamarin Forms has been discontinued due in Prism 7 to an incompatibility of the container with Xamarin Targets.
  • For developers using Unity with Prism 6, take note that the new Unity maintainer has made major breaking changes. This includes changing namespaces and the package structure. These changes were NOT made by the Prism team nor do we have any control over it. When upgrading to Prism 7 you will need to uninstall the existing Unity package as we now reference the Unity.Container NuGet.

NuGet package tree

A detailed overview of each assembly per package is available here.

Prism Template Pack

Prism now integrates with Visual Studio and Xamarin Studio to enable a highly productive developer workflow for creating WPF, UWP, and native iOS and Android applications using Xamarin.Forms. Jump start your Prism apps with code snippets, item templates, and project templates for your IDE of choice.

Visual Studio Gallery

The Prism Template Pack is available on the Visual Studio Gallery. To install, just go to Visual Studio -> Tools -> Extensions and Updates... then search for Prism in the online gallery:

Visual Studio Gallery

Visual Studio for Mac Addin

The Prism Template Studio and Developer Toolkit is available from the Visual Studio Mac Extensions Gallery.

Plugins

There are certain things that cannot be added directly into Prism for various reasons. To handle these common tasks such as supporting PopupPage's in Xamarin Forms, there are Prism Plugins. You can find a number of Plugins available on NuGet from our maintainer @DanJSiegel.

Samples

We have both a development sandbox (frequently changing) and stable samples for using Prism with WPF, UWP and Xamarin Forms. An overview of the samples can be found here.

Contributing

We strongly encourage you to get involved and help us evolve the code base.

  • You can see what our expectations are for pull requests here.

.NET Foundation

This project is part of the .NET Foundation.