Xamarin.Forms 现已开启对 UWP 的支持

Xamarin.Forms 现已升级到 2.0.0.6482 , 正式开启了对 UWP 的支持.

要创建 UWP 项目, 必须是 VS2015, WIN8.1 下也可以, 但是只有 Windows 10 Mobile 的模拟器可用, Windows 10 的模拟器, 必须在 WIN 10 下.

以下简称

Xamarin.Forms 为 XF,

Caliburn.Micro 为 CM

创建 XF支持的 UWP 项目

XF的项目模板, 当前没有加入 UWP , 需要手动创建 UWP 项目.

过程如下:

1, 添加一个 UWP 项目

2,添加 Xamarin.Forms 2.0.0.6482 的 Nuget 引用

3, 设置 UWP 项目的部署属性

4, 将 XF PCL 或 Shared 项目引用到 UWP 项目中.

5, 编辑 UWP 项目的 App.xmal.cs , 在 OnLanched 方法中加入 (红色部分):

 rootFrame.NavigationFailed += OnNavigationFailed;
2 Xamarin.Forms.Forms.Init (e);

6, 修改 MainPage.xaml, 红色部分为变更

 <forms:WindowsPage
     x:Class="Notification.UWP.MainPage"
     xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
     xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
     xmlns:local="using:Notification.UWP"
     xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
     xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
     xmlns:forms="using:Xamarin.Forms.Platform.UWP"
     mc:Ignorable="d">

     <Grid Background="{ThemeResource ApplicationPageBackgroundThemeBrush}">

     </Grid>
 </forms:WindowsPage>

7, 修改 MainPage.xaml.cs, 加入红色部分, Notification.App 是 XF 项目的 App

     public sealed partial class MainPage {
         public MainPage() {
             this.InitializeComponent();
             this.LoadApplication(new Notification.App());
         }
     }

OK, 一个 XF 支持的 UWP 就建好了.

添加 Caliburn.Micro 的支持

CM 3.0 版以经集成了对 XF 项目的支持, 具体可参考:

Xamarin 的 MVVM 之 Caliburn.Micro

CM 3.0 中也加入了对 UWP 的支持,  具体可参考示例:

https://github.com/Caliburn-Micro/Caliburn.Micro/tree/3.0.0/samples/Caliburn.Micro.HelloUWP/Caliburn.Micro.HelloUWP

这里要讲一下, 如何把 UWP / XF / CM 这三个东西加起来.

1, 修改 UWP 项目下的 App.xaml, 红色部分为变更部分

1 <cm:CaliburnApplication
     x:Class="Notification.UWP.App"
     xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
     xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
5     xmlns:local="using:Notification.UWP"
6     xmlns:cm="using:Caliburn.Micro"
     RequestedTheme="Dark">

9 </cm:CaliburnApplication>

2, 修改 UWP 项目下的 App.xaml.cs , 红色部分为变更

     public sealed partial class App {
         private WinRTContainer _container;
         private IEventAggregator _eventAggregator;

         public App() {
             InitializeComponent();
         }

         protected override void Configure() {
             _container = new WinRTContainer();
             _container.RegisterWinRTServices();

             _eventAggregator = _container.GetInstance<IEventAggregator>();
         }

         protected override IEnumerable<Assembly> SelectAssemblies() {
20             return new[]
21             {
22                 GetType().GetTypeInfo().Assembly,
23                 typeof (Notification.App).GetTypeInfo().Assembly
24             };
25         }

         protected override void OnLaunched(LaunchActivatedEventArgs args) {

             this.DisplayRootView<MainPage>();
             if (args.PreviousExecutionState == ApplicationExecutionState.Terminated) {
                 //_eventAggregator.PublishOnUIThread(new ResumeStateMessage());
             }
         }

         protected override void OnSuspending(object sender, SuspendingEventArgs e) {
             //_eventAggregator.PublishOnUIThread(new SuspendStateMessage(e.SuspendingOperation));
         }

         protected override object GetInstance(Type service, string key) {
             return _container.GetInstance(service, key);
         }

         protected override IEnumerable<object> GetAllInstances(Type service) {
             return _container.GetAllInstances(service);
         }

         protected override void BuildUp(object instance) {
             _container.BuildUp(instance);
         }
     }

A, 这个 App 只是一个 partial 的, 不在是从 Application 继承过来的.

B, OnLaunched 方法中 需要 Xamarin.Forms.Init

C, 然后 DisplayRootView MainPage, 这个 MainPage 不是按 CM 的 MVVM 处理的, 只是 XF 页面展示的一个容器.

D, 重写 SelectAssemblies 方法, 返回 UWP 项目的 Assembly 和 XF 项目的 Assembly .

这里返回 XF 项目的 Assembly, 是因为 View / Model 在 XF 项目中定义, 如果不返回它 , 就无法和将 XF 中的 View 和 Model 关联起来.

3, 修改 MainPage.xaml.cs , 红色部分为变更

         public MainPage() {
             this.InitializeComponent();
             this.LoadApplication(new Notification.App(IoC.Get<WinRTContainer>()));
         }

Notication.App 的构造函数接收一个 SimpleContainer 的参数, WinRTContainer 是 UWP 下的 SimpleContainer 的实现.

4, 看一下 Notification.App (XF PCL / Shared 项目) 的定义:

    public class App : FormsApplication {

        private SimpleContainer Container = null;

        public App(SimpleContainer container) {

            this.Container = container;

            this.Container
                .Singleton<HomeViewModel>()
                .Singleton<MasterViewModel>();

            this.DisplayRootView<HomeView>();
        }

        protected override void PrepareViewFirst(NavigationPage navigationPage) {
            this.Container.Instance<INavigationService>(new NavigationPageAdapter(navigationPage));
        }
    }

SimpleContainer  为 CM 自带的 IoC .

OK, 做完这一步, XF / UWP / CM 这三个东西就揉进一起了.

应用 Caliburn.Micro 的多视图功能

CM 支技多个 View 使用同一个 Model, 官方档只对这个功能只是用了一小段进行描述, 具体参见:

http://caliburnmicro.com/documentation/composition

搜索 : Multiple Views over the Same ViewModel

也可参考:

如何利用 CM 实现多视图切换

简单来说, 就是利用 AttachedProperty : View.Context 来传递一个标识符, 跟据这个标识符加载对应的视图, 如果找不到, 则使用默认的视图.

比如这个 MasterView.xaml 即默认的视图.

如果 View.Context 设为 Windows , 就会去加载 Master/Windows.xaml.

如果 View.Context 为 IOS, 但是不存在 Master/IOS.xaml , 就会默认使用 MasterView.xaml

这是 CM 的一个约定.

XF 项目的目标就是一次编写, 同时生成支持 IOS / Android / WP (SL) / UWP 的 APP.

各个平台的最终表现出什么样的用户界面 , 是由封装在不同 Xamarin.Forms.Platform 中的 Renderer 来负责呈现的.

IOS / Android 有先天的优势, 即使不怎么改, 也不会太丑, 但是 WP , 甚至新的 UWP 项目, 都需要后天的费工费时的一点一点的润色.

在给 WP / UWP 润色的同时, 又不想对 IOS / Android 有影响, CM 的多视图支持是不一个不错的选择.

嗯, 费话了一堆, 看看处理办法吧, 修改 XF 项目的 App.cs

         public App(SimpleContainer container) {

             this.Container = container;

             this.Container
                 .Singleton<HomeViewModel>()
                 .Singleton<MasterViewModel>();

 9             var f = ViewLocator.LocateTypeForModelType;
10             ViewLocator.LocateTypeForModelType = (type, bindable, context) => {
11                 return f(type, bindable, context ?? Device.OS) ?? f(type, bindable, context);
12             };

             this.DisplayRootView<HomeView>();
         }

在 App 的构造函数, DisplayRootView 之前, 先保存 ViewLocator.LocateTypeForModelType 到一个变量, 它是一个 Func ,

然后重写这个 Func

如果 context 为 null, 就取 Device.OS 的值.

如果跟据 指定的 conetxt 找不到视图, 就取默认的视图.

OK, 多视图的功能也完成了!

当前 XF 对 UWP 的支持还有 BUG........期待完善...

题外, 如何使用 Caliburn.Micro 对 MasterDetailPage / TabbedPage 进行 MVVM 绑定

首先, 添加一个 ViewLocatorPage, 继承自 ContentPage, 使用 CM 进行绑定

     public class ViewLocatorPage : ContentPage {

         public static readonly BindableProperty VMProperty = BindableProperty.Create<ViewLocatorPage, Screen>(p => p.VM, null, propertyChanged: VMChanged);

         public Screen VM {
             get {
                 return (Screen)this.GetValue(VMProperty);
             }
             set {
                 this.SetValue(VMProperty, value);
             }
         }

         private static void VMChanged(BindableObject bindable, object oldValue, object newValue) {
             if (newValue == null)
                 return;

             var vm = (Screen)newValue;
             //var view = vm.GetView();
             var vmView = ViewLocator.LocateForModel(vm, null, null);
             if (vmView == null)
                 throw new Exception("没有找到视图");
             ViewModelBinder.Bind(vm, vmView, null);

             var activator = vm as IActivate;
             if (activator != null)
                 activator.Activate();

             var page = (ViewLocatorPage)bindable;
             if (null != (ContentPage)vmView) {
                 var vp = (ContentPage)vmView;
                 page.Content = vp.Content;
                 if (vp.ToolbarItems != null)
                     foreach (var t in vp.ToolbarItems)
                         page.ToolbarItems.Add(t);
             } else if (null != (Xamarin.Forms.View)vmView) {
                 page.Content = (Xamarin.Forms.View)vmView;
             }
         }

     }

对 MasterDetailPage 绑定:

 <?xml version="1.0" encoding="utf-8" ?>
 <MasterDetailPage xmlns="http://xamarin.com/schemas/2014/forms"
              xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
              xmlns:cal="clr-namespace:Caliburn.Micro.Xamarin.Forms;assembly=Caliburn.Micro.Platform.Xamarin.Forms"
              x:Class="Notification.Views.HomeView"
              xmlns:local="clr-namespace:Notification;assembly=Notification"
                   Title="Notification Test"
             >

   <MasterDetailPage.Master>
     <local:ViewLocatorPage Title="TTT" VM="{Binding}" BindingContext="{Binding MasterPage}" />
   </MasterDetailPage.Master>

   <MasterDetailPage.Detail Title="AAA">
     <ContentPage Title="BBB"></ContentPage>
   </MasterDetailPage.Detail>
 </MasterDetailPage>

注意, 一定要使用 BindingContext, MasterPager 为 Model 中的一个属性.

对 TabbedPage 绑定:

 <?xml version="1.0" encoding="utf-8" ?>
 <TabbedPage xmlns="http://xamarin.com/schemas/2014/forms"
             xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
             x:Class="Discuz.Views.TabView"
             xmlns:cal="clr-namespace:Caliburn.Micro.Xamarin.Forms;assembly=Caliburn.Micro.Platform.Xamarin.Forms"
             xmlns:local="clr-namespace:Discuz;assembly=Discuz"
             ItemsSource="{Binding Datas}"
             Title="蓝色理想"
             BackgroundColor="#1e5263"
             Padding="0"
             >

   <TabbedPage.ItemTemplate>
     <DataTemplate>
       <local:ViewLocatorPage Title="{Binding DisplayName}" VM="{Binding}" />
     </DataTemplate>
   </TabbedPage.ItemTemplate>

 </TabbedPage>

---------------------------

完, 源码:

https://github.com/gruan01/Xamarin-Example/tree/master/Notification.UWP