-
Notifications
You must be signed in to change notification settings - Fork 390
Upgrading from Template 10 Nuget Nuget 1.0 to 1.1
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
- Update Windows 10 to 1511, UWP 10586 (your project can still target 10240).
- Install the Windows 10586 SDK to Visual Studio 2015 {any edition} Update 1.
- Use NuGet to upgrade Template 10 v1.0.* to v1.1.* in your project(s).
- In Project/Resources delete your "Behaviors SDK (XAML)" reference.
- Add
Microsoft.Xaml.Behaviors.Uwp.Managed
through Nuget, if you use behaviors. - (custom) Look at the breaking changes below. You may need to update your view-models.
- 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 Shell.xaml.cs
public Shell(NavigationService navigationService)
->public Shell(INavigationService navigationService)
- In any view-model
void OnNavigatedTo
->Task OnNavigatedToAsync
(you might needreturn Task.CompletedTask;
) - In any view-model
void OnNavigatingFrom
->Task OnNavigatingFromAsync
(you might needreturn Task.CompletedTask;
) - If you use it, the
INavigable
implementation for a custom ViewModelBase reflects the changes above. - If you use it, rename
Bootstrapper.OnPrelaunch
toBootstapper.OnPrelaunchAsync
- 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.
- Home
- Getting Started
- Template 10 Templates
- Behaviors and Actions
- Bootstrapper
- Controls
- Converters
- Services
- Hints, tips and other documentation