Skip to content
/ Prism Public
forked from PrismLibrary/Prism

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

License

Notifications You must be signed in to change notification settings

tboogh/Prism

 
 

Repository files navigation

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
Prism
Prism.Wpf
Prism.Windows
Prism.Forms

#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 watch our Pluralsight courses on Prism. 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

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 Version
PCL Prism.dll Prism.Core 21
WPF Prism.Wpf.dll Prism.Wpf 22
Xamarin.Forms Prism.Forms.dll Prism.Forms 23
Windows 10 UWP Prism.Windows.dll Prism.Windows 24

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.

Following matrix shows the platform specific support currently available.

Package Version WPF Win10 UWP Xamarin.Forms
Prism.Autofac (*) 27 X X
Prism.Autofac.Forms 32 - - X
Prism.DryIoc.Forms 33 - - X
Prism.Mef (**) 26 X - -
Prism.Ninject (*) 29 X
Prism.Ninject.Forms 31 - - X
Prism.StructureMap 28 X
Prism.Unity (*) 25 X X
Prism.Unity.Forms 30 - - X

(*) As Xamarin Forms also supports UWP now, adding Prism.Unity, Prism.Ninject, or Prism.Autofac puts in some incorrect dependencies. Therefore we created a new package for Xamarin Forms projects.

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

Note that adding the container-specific package to your project, will also pull in the correct platform-specific package and the core PCL library. E.g. when you'd like to use Unity in a WPF project, add the Prism.Unity package and the rest will be pulled in as well.

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

Xamarin Studio Addin

Installation is straightforward if you've installed Xamarin Add-ins before, just go to Xamarin Studio -> Add-In Manager... from the Menu and then search for Prism from the Gallery:

Xamarin Studio Addin Manager

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.

#Roadmap/Milestones You can check out our milestones for coming releases here.

Support

  • For general questions and support, post your questions on StackOverflow
  • You can enter bugs and feature requests in our Issues.

#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.

#Moving to Prism 6 from Previous Releases As part of taking over the code base from Microsoft and moving towards Prism 6, there are a number of breaking changes users of Prism 5 or Prism for Windows Runtime will have to deal with. Those changes are summarized below.

Current Release Notes

##Breaking Changes

  • Removed all types that were marked as "Obsolete" in Prism 5
  • Removed IView interface
  • Changed namespaces to remove Microsoft namespaces
  • Moved a number of types around to better organize and to get as much into a single Portable Class Library as possible
  • ViewModelLocator naming convention changes: [Name]View now requires [Name]ViewModel. No longer [Name]ViewViewModel

###Prism for UWP Preview

  • Prism for UWP is a port of the Prism for Windows Runtime 2.0 release
  • Removed SettingsPane functionality from PrismApplication because it is deprecated in UWP
  • Visual State management parts of VisualStateAwarePage were removed and it is now renamed to SessionStateAwarePage.

#Prism for Xamarin.Forms Preview Check out the new Prism for Xamarin.Forms Preview:

.NET Foundation

This project is part of the .NET Foundation.

About

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

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • C# 99.5%
  • PowerShell 0.5%