Skip to content

Upgrading from Template 10 Nuget Nuget 1.0 to 1.1

Jerry Nixon edited this page Jan 23, 2016 · 12 revisions

Congratulations, you are about to upgrade to the best build of Template 10. 1.1.0+ includes legacy 10240 support and 10586 support. There are a few steps you need to follow in the upgrade.

##Step by step

  1. Update Windows 10 to 1511, UWP 10586 (your project can still target 10240).
  2. Install the Windows 10586 SDK to Visual Studio 2015 {any edition} Update 1.
  3. Use NuGet to upgrade Template 10 v1.0.* to v1.1.* in your project(s).
  4. In Project/Resources delete your "Behaviors SDK (XAML)" or "BehaviorsXamlSDKManaged" reference.
  5. In Project.JSON change "Newtonsoft.Json": "7.0.1" to "Newtonsoft.Json": "8.0.0".
  6. Add Microsoft.Xaml.Behaviors.Uwp.Managed through Nuget, if you use behaviors.
  7. Select your project, and click the Refresh button in the Solution Explorer (this helps).
  8. (custom) Look at the breaking changes below. You may need to update your view-models.
  9. Clean and rebuild.

Congratulations, you have upgraded to the best build of Template 10!

Please note that if you use behaviors, you need to add the behaviors SDK reference to your Project.JSON file. Yes, Blend does this for you, but you should do it manually if you aren't using Blend.

"Microsoft.Xaml.Behaviors.Uwp.Managed": "1.0.3",

##Read me What's new in version 1.1.0?

##About version 1.1.0 It's worth pointing out that because of breaking changes, we skipped version 1.0.9. This makes existing templates that reference 1.0.* in their Project.JSON not experience negative side-effects, unless they manually upgrade by following the instructions in this document.

##Breaking changes Read about breaking changes in version 1.1.1

  1. In Shell.xaml.cs public Shell(NavigationService navigationService) -> public Shell(INavigationService navigationService)
  2. In any view-model void OnNavigatedTo -> Task OnNavigatedToAsync (you might need return Task.CompletedTask;)
  3. In any view-model void OnNavigatingFrom -> Task OnNavigatingFromAsync (you might need return Task.CompletedTask;)
  4. If you use it, the INavigable implementation for a custom ViewModelBase reflects the changes above.
  5. If you use it, rename Bootstrapper.OnPrelaunch to Bootstapper.OnPrelaunchAsync
  6. If you use it, the Bootstapper.OnResuming() override has a changed method signature.

// please add other breaking changes if you find them. This is a wiki.

Clone this wiki locally