云中客

梦想有多大,就能走多远

  博客园 :: 首页 :: 博问 :: 闪存 :: 新随笔 :: 联系 :: 订阅 订阅 :: 管理 ::
  119 随笔 :: 4 文章 :: 170 评论 :: 0 引用

通过本文你将学会如下内容:

1,如何使用Xamarin开发跨平台(Windows,Android,iOS)应用。

2,如何使用微软的登录界面登入Microsoft账号。

3,如何使用Outlook邮箱API。

4,了解MVVM思想。

5,了解Prism框架。

原代码地址:https://github.com/NewBLife/MyOutlook

Xamarin概述

Xamarin由开源项目Mono发展而来,是一套跨平台的移动开发工具,开发人员可以使用 C# 为iOS,Android, Mac以及Windows开发原生应用,比Hybrid App性能更好。基本思想就是将与平台无关的逻辑代码使用C# Portable Class Libraries类库实现,与平台相关部分单独实现。2015年被微软收购,现在Visual Studio全面支持Xamarin开发并且免费。

mobile application development platform

Xamarin.Forms 是由Xamarin提供的一个创建跨平台用户界面的开源库,通过Xamarin.Forms 可以一次编码生成基于各个移动平台(iOS, Android, Windows Phone)的应用界面。

Prism概述

Prism是8年前由微软创建的一套快速开发WPF的开源MVVM框架,目前已经移植到Github全面支持Xamarin跨平台开发。包含画面跳转,对话框,依赖注入等等很多功能,大幅度简化开发。MVVM思想也是微软发布WPF时提出来的一套全新思想:通过将UI设计与UI交互分离,使得界面的自动化测试成为可能。

The MVVM classes and their interactions

 

Microsoft账号登录

Xamarin跨平台Microsoft账号认证可以使用微软开源类库Microsoft Authentication Library (MSAL)实现如下登录界面:

20161112_023646000_iOS

在使用前需要前往Microsoft个人应用中心https://apps.dev.microsoft.com)进行注册获取ApplicationID。

image

 

OutLook API

使用微软公布的 Microsoft Graph API可以访问多个 Microsoft 云服务中的数据,包括 Azure Active Directory、作为 Office 365 一部分的 Exchange Online、SharePoint、OneDrive、OneNote 和 Planner。

本次主要使用:https://graph.microsoft.com/v1.0/me/messages 列出个人邮件。

 

最终效果图

跟随本文最后将做出如下APP应用:

image

image

Hands-ON

1,下载添加Prism Template Pack模板

image

2,从Prism模板创建Xamarin.Froms项目

image

选择iOS,Android,UWP平台

image

image

 

3,为每个工程添加Microsoft.Identity.Client包

image

提醒:

【无法安装程序包“Microsoft.Identity.Client 1.0.304142221-alpha”。你正在尝试将此程序包安装到目标为“.NETPortable,Version=v4.5,Profile=Profile111”的项目中,但该程序包不包含任何与该框架兼容的程序集引用或内容文件。有关详细信息,请联系程序包作者。】

以上错误解决办法:MyOutlook.csproj文件中的Profile111改成Profile7。

image

4,添加Microsoft登录认证

Microsoft.Identity.Client默认将RefreshToken保存在本地文件中,下次认证时自动从文件读取判断。

public class AuthUtility
    {
        /// <summary>
        /// 用户认证
        /// </summary>
        /// <returns></returns>
        public static async Task<bool> AuthAsync()
        {
            try
            {
                // 已经认证的时候直接获取认证信息
                App.Authentication = await App.PCA.AcquireTokenSilentAsync(Constants.Scopes);
                return true;
            }
            catch
            {
                try
                {
                    // 没有认证的时候重新认证
                    App.Authentication = await App.PCA.AcquireTokenAsync(Constants.Scopes);
                    return true;
                }
                catch
                {
                    // 认证失败
                    return false;
                }
            }
        }
    }

调用这个方法时将自动出现如下登录界面:

image

如果输入个人邮箱地址将自动跳转到如下登录界面:

image

认证成功后将获得Token信息

image

image

5,添加退出逻辑

只需要执行如下代码即可清除认证信息

App.Authentication.User.SignOut();

image

6,添加读取邮件信息逻辑

有了Token直接调用接口就能获得我们需要的全部信息,本次只读取邮件信息(https://graph.microsoft.com/v1.0/me/messages)。

public class EmailUtility
    {
        private static JsonSerializer serializer = new JsonSerializer()
        {
            MissingMemberHandling = MissingMemberHandling.Ignore,
            NullValueHandling = NullValueHandling.Ignore,
            ReferenceLoopHandling = ReferenceLoopHandling.Serialize
        };
        /// <summary>
        /// 执行API
        /// </summary>
        /// <param name="url">API地址</param>
        /// <param name="method">请求方式</param>
        /// <returns>请求结果</returns>
        private static async Task<byte[]> ExcuteApi(string url, HttpMethod method)
        {
            var httpclient = new HttpClient();

            using (var request = new HttpRequestMessage(method, url))
            {
                request.Headers.Authorization = new AuthenticationHeaderValue(App.Authentication.TokenType, App.Authentication.Token);

                using (var response = await httpclient.SendAsync(request).ConfigureAwait(false))
                {
                    if (response.IsSuccessStatusCode)
                    {
                        return await response.Content.ReadAsByteArrayAsync().ConfigureAwait(false);
                    }
                }
            }
            return null;
        }

        /// <summary>
        /// 邮件一览取得
        /// </summary>
        /// <returns>邮件一览</returns>
        public static async Task<List<Message>> GetListAsync()
        {
            var listData = await ExcuteApi(Constants.MESSAGES_LIST, HttpMethod.Get);
            if (listData?.Length > 0)
            {
                var listObject = JObject.Parse(System.Text.Encoding.UTF8.GetString(listData, 0, listData.Length));
                var list = new List<Message>();

                foreach (var item in listObject["value"])
                {
                    list.Add(item.ToObject<Message>(serializer));
                }
                return list;
            }
            else
            {
                return null;
            }
        }
    }

Http请求取得的数据经Json转换成自己需要的形式(Message)显示如下:

一览画面

image

详细画面(邮件详细为Html文件内容,只需要用WebView显示就可以)

image

本次就简单实现邮件取得和显示,后续有时间在慢慢添加。个人电脑性能有限ios模拟器没办法跑起来,本次就先演示UWP了。

总结

Xamarin开发跨平台应用门槛越来越低,唯独UI设计比较麻烦,每个平台显示多少还是有区别。看完本文希望大家对Xamarin开发充满信心,本人在日本微软合作公司,目前日本这边推广的很火,很多开发交流会。

posted on 2016-11-13 21:00  走遍江湖  阅读(1920)  评论(8编辑  收藏