This project is read-only.

Release Notes for Microsoft Prism for the Windows Runtime for Windows 8.1

This document contains a brief summary of Prism for the Windows including late-breaking information that is not included in the main documentation. Additional information and bug fixes delivered after release are available on the Prism Community site.

What is it?

Prism helps developers who want to create a Windows Store business app using C#, XAML, the Windows Runtime, and development patterns such as Model-View-ViewModel and event aggregation. Prism includes two libraries, a reference implementation called AdventureWorks Shopper, Quickstarts and associated documentation.

The guidance demonstrates:

Where to get it?

  • Documentation on the Windows Developer Center (includes documentation for both the associated reference implementation and the Prism libraries)
  • PDF version of the documentation
  • Source code for AdventureWorks Shopper reference implementation, Quickstarts, and Prism libraries
  • Source code for the associated Quickstarts
  • Via NuGet – use NuGet package Manager in Visual Studio and search online for Prism.StoreApps and Prism.PubSubEvents. or

What's new in this release

This release of Prism for the Windows Runtime contains many updates that help to accelerate the development of Windows Store business apps that target Windows 8.1. These include:
  • The Prism libraries, AdventureWorks Shopper reference implementation, and Quickstarts have been migrated to Windows 8.1 and Visual Studio 2013.
  • Support for extended splash screens in the Microsoft.Practices.Prism.StoreApps project.
  • Attached behaviors in the AdventureWorks Shopper reference implementation and Quickstarts have been replaced with Blend behaviors, and custom Blend behaviors.
  • New Quickstarts on displaying extended splash screens, and adding incremental loading capabilities to GridView and ListView controls.
  • Enhancements to the AdventureWorks Shopper reference implementation so that it follows the latest UX guidelines for Windows Store apps.
  • Search functionality is provided through the SearchBox control, with search suggestions being provided from the web service on demand.

The detailed change log is included at the end of this document.

System requirements

  • Windows 8.1
  • Microsoft Visual Studio 2013
  • C# and XAML

Go to Windows Store app development to download the latest tools for Windows Store app development.

The AdventureWorks Shopper Microsoft Visual Studio solution has a number of nuget package dependencies, which Visual Studio will attempt to download when the solution is first loaded. The required nuget packages are:
• Unity v3.0
• Microsoft.AspNet.WebApi.Client v4.1.0-alpha-120809
• Newtonsoft.Json v4.5.11 and v5.0.6
• Microsoft.AspNet.Mvc v4.0.20710.0
• Microsoft.AspNet.Razor v2.0.20715.0
• Microsoft.AspNet.WebApi v4.0.20710.0
• Microsoft.AspNet.WebApi.Client v4.1.0-alpha-120809
• Microsoft.AspNet.WebApi.Core v4.0.20710.0
• Microsoft.AspNet.WebApi.WebHost v4.0.20710.0
• Microsoft.AspNet.WebPages v2.0.20710.0
• Microsoft.Net.Http v2.0.20710.0
• Microsoft.Web.Infrastructure v1.0.0.0

Where to start

  • Review the AdventureWorks reference implementation. After you download the code, see Getting started with Prism library for instructions on how to compile and run the reference implementation, as well as understand the Visual Studio solution structure.
  • Review Quickstarts. The Quickstart samples focus on specific tasks such as validation, event aggregation, bootstrapping an MVVM app.
  • Create an app. If you want to create your own app using Prism see Using Prism for the Windows Runtime.
  • Explore developer tasks. Learn how the team implemented many of the tasks required to create a Windows Store app.
  • Review the documentation. The associated documentation outlines the key decisions and lessons learned to create a Windows Store business app.

Exploring the documentation

The documentation for this project is on the Windows Dev Center. You can find it using this link: You can also download a PDF version of the content at

The Documentation tab on this site contains a complete list of topics included in the documentation.


Community support is provide via the Prism for the Windows Runtime CodePlex forum.

Change Log

Global Changes

  • The Prism libraries, AdventureWorks Shopper reference implementation, and Quickstarts all target Windows 8.1.
  • References to System.Net.Http.HttpClient have been replaced with Windows.Web.Http.HttpClient.


  • The OnLaunchApplication method in the MvvmAppBase class, which should be overridden in your App class, now returns a Task, allowing it to launch a long running operation. This allows Prism to support extended splash screen scenarios. If you don’t have a long running operation to launch you should return an empty Task.
  • The InitializeFrameAsync method in the MvvmAppBase class now has a visibility of protected instead of private. This allows App classes that derive from the MvvmAppBase class to call InitializeFrameAsync in whatever activation event handler you choose to support.
  • The following classes have been deprecated due to changes in the platform:
    • FlyoutView and FlyoutService.
    • SearchPaneService and SearchQueryArguments.
    • SettingsCharmActionItem.
  • Search activation support has been removed.
  • The VisualStateAwarePage class has been updated to support the new Windows 8.1 view states (DefaultLayout, PortraitLayout, and MinimalLayout), and no longer supports the Windows 8.0 view states (FullScreenLandscape, FullScreenPortrait, Filled, Snapped).
  • The GoBackCommand has been moved into the VisualStateAwarePage class and no longer needs to be implemented in view model classes.
  • Support for extended splash screens has been added by setting the ExtendedSplashScreenFactory property in the MvvmAppBase class to a delegate that returns an instance of the extended splash screen class.

AdventureWorks Shopper reference implementation

  • The FormFieldTextBox control has been deprecated.
  • The AutoRotatingGridView custom control has been added, which is a view state detecting GridView control.
  • Attached behaviors have been replaced with Blend behaviors, and custom Blend behaviors.
  • Bottom app bars now use CommandBar and AppBarButton controls.
  • The HubPage, CategoryPage, GroupDetailPage, and SearchResultsPage perform incremental loading of data items.
  • The latest Windows UX guidelines have been applied to all pages.
  • Search:
    • Search activation support has been removed.
    • Search is now supported through the SearchBox control.
    • Search suggestions are provided from the AdventureWorks web service on demand.


  • Attached behaviors have been replaced with custom Blend behaviors.
  • Two new Quickstarts have been provided:
    • The extended splash screen Quickstart demonstrates how to display an extended splash screen that imitates the splash screen displayed by Windows, allowing an app more time to prepare its initial UI.
    • The incremental loading Quickstart demonstrates adding incremental loading capabilities to GridView and ListView controls in order to create a more responsive and useful UI when the user scrolls through large data sets.

Last edited Jan 21, 2014 at 6:28 PM by blainew, version 12


PeterKlein Feb 17, 2015 at 4:11 PM 
Is it correct that the methods "OnLaunchApplication" and "OnInitialize" are only availaible in Async versions?

I made a reference to the Prism Library via NuGet, by installing Prism.StoreApps, Prism.MVVM and Prism.PubSubEvents. All of a sudden the earlier (sync) methods seem not available anymore?

Did I make references to wrong versions of what is happening here?