使用Windows Azure Mobile Service开发Windows Phone 8 App

- How to make a Windows Phone 8 app with Windows Azure Mobile Service

Windows Azure Mobile Service推出已经有一段时间了，这可能是这段时间以来Windows Azure上最受关注的一个Feature，试用了一下Mobile Service，觉得还不错，分享下试用的过程，供大家参考。

新建一个Mobile Service

1. 登陆到Windows Azure Portal，创建一个Mobile Service

2. 创建一个Mobile Service：MyTodos，并为之新建一个数据库，注意数据库服务器的区域和Mobile Service的区域最好相同，这样可以减少网络延迟和流量费用 （当然也可以使用已有的数据库实例，Mobile Service会把新建的数据表都放到MyTodos这个Schema下，所以不用担心和原有的表重名）

3. 等待几分钟后，Mobile Service创建完成后，点击MyTodos进行配置：

a) 平台这里可以看到，Mobile Service支持Windows/ WP8/Android/iOS/Html5的应用，这里我们选择Windows Phone8，注意需要安装两个SDK – Windows Phone 8 SDK和Mobile Service SDK；

b) 单击“创建TodoItem表”在刚才的数据库中创建一个TodoItem表，当然也可以自己到数据库里创建。

4. 浏览到配置这个页面，注意启用“动态架构”，这样在开发阶段，我们给Mobile Service传什么样的entity，Mobile Service会自动为我们创建相应的字段，但等到发布阶段，出于安全的考虑，最好是把“动态架构”关闭。

5. 回到MyTodos的首页，下载Azure自动生成的代码

6. 打开刚下载的代码，这时候我们已经得到了一个完整的Windows Phone 8的应用，来看看Mobile Service都生成了什么代码

a) MobileServiceClient：这就是Mobile Service SDK里面用来访问Mobile Service的客户端

b) TodoItem以及相应的Insert/Update/Refresh等方法：注意这些方法都是使用.Net 4.5的异步编程，这也是Mobile Service所推荐的编程模式。

7. 运行测试一下这个小App，添加一些TodoItem，浏览之前建的数据库，可以看到，还没有写一行代码，就已经得到了一个完整的WP8 App。

添加用户验证

接下来添加用户验证，Mobile Service支持MicrosoftAccount(也就是LiveID)/Google/Facebook/Twritter四种用户验证方式，本文只使用了MicrosoftAccount。

1. 要使用MicrosofAccount，首先要到Live Connect Developer Center（http://go.microsoft.com/fwlink/p/?linkid=262039&clcid=0x409 ）注册一下我们的App，注意“手机客户端应用”选择“是”。

2. 将注册得到的客户端ID和客户端密钥填到Mobile Service上，并保存

3. 现在设置一下数据权限，将TodoItem表设为只有验证过的用户才能读写，并保存

4. 再运行一下App，这次应该收到一个Unauthorized异常，因为当前的用户没有登录

5. 接下来为App添加登录的代码

a) 在MainPage.xaml里为MainPage添加一个Login button

b) 注释掉OnNavigatedTo里面的代码

protected override void OnNavigatedTo(NavigationEventArgs e)

{

//RefreshTodoItems();

}

c) 修改App.xaml.cs里面的ApplicationKey

public static MobileServiceClient MobileService = new MobileServiceClient(

"https://mytodos.azure-mobile.net/",

"用注册app时得到的客户端密钥"

);

d) 将下面这段代码添加到MainPage class里

private MobileServiceUser user;

private async System.Threading.Tasks.Task Authenticate()
{
    if (user == null)
    {
    string message = "You must log in. Login Required";

    try
    {
    user = await App.MobileService.LoginAsync    (MobileServiceAuthenticationProvider.MicrosoftAccount);

    message = string.Format("You are now logged in - {0}", user.UserId);
    }
    catch (InvalidOperationException ex)
    {
        message = ex.Message;
    }

    MessageBox.Show(message);
    }
}

private async void BtnLogin_Click(object sender, RoutedEventArgs e)

{

    await Authenticate();

    if (null != this.user)

    {

    RefreshTodoItems();

    }

}

运行看看效果，现在又可以刷新和添加TodoItem了

6. 如果需要得到更多的用户信息，则需要下载并安装LiveSDK（ http://msdn.microsoft.com/en-us/live/ff621310 ），并为MyTodos添加引用到Microsoft.Live

a) 按下面的代码修改MainPage.Authenticate

private async System.Threading.Tasks.Task Authenticate()

{

if (user == null)

{

string message = "You must log in. Login Required";

try

{

string clientId = "用注册app时得到的客户端ID";

LiveAuthClient liveIdClient = new LiveAuthClient(clientId);

LiveLoginResult result = await liveIdClient.LoginAsync(new[] { "wl.basic", "wl.photos" });

if (result.Status == LiveConnectSessionStatus.Connected)

{

LiveConnectClient client = new LiveConnectClient(result.Session);

var me = await client.GetAsync("me");

user = await App.MobileService.LoginAsync(result.Session.AuthenticationToken); //(MobileServiceAuthenticationProvider.MicrosoftAccount);

this.TitleTextBlock.Text = this.TitleTextBlock.Text +

" - welcome, "

+ me.Result["first_name"].ToString() + "." + me.Result["last_name"].ToString();

message = string.Format("You are now logged in - {0}", user.UserId);

}

else

{

message = string.Format("Connect to microsoft account failed. Status: {0}", result.Status);

}

}

catch (LiveAuthException authEx)

{

message = string.Format("{0}:{1}", authEx.GetType().Name, HttpUtility.UrlDecode(authEx.Message));

}

catch (LiveConnectException connEx)

{

message = string.Format("{0}:{1}", connEx.GetType().Name, HttpUtility.UrlDecode(connEx.Message));

}

catch (InvalidOperationException ex)

{

message = ex.Message;

}

MessageBox.Show(message);

}

}

运行效果如下,可以看到登录的页面与之前稍有差别,但这次能得到更多的用户信息

添加推送通知

1. 添加代码如下

a) 在App.xaml.cs中添加如下代码

public static HttpNotificationChannel CurrentChannel { get; private set; }

private static readonly string ChannelName = "MyTodosPushChannel";

private void AcquirePushChannel()

{

CurrentChannel = HttpNotificationChannel.Find(ChannelName);

if (CurrentChannel == null)

{

CurrentChannel = new HttpNotificationChannel(ChannelName);

CurrentChannel.Open();

CurrentChannel.BindToShellTile();

CurrentChannel.BindToShellToast();

}

CurrentChannel.ShellToastNotificationReceived += CurrentChannel_ShellToastNotificationReceived;

}

void CurrentChannel_ShellToastNotificationReceived(object sender, NotificationEventArgs e)

{

string msg = "";

foreach (var kv in e.Collection)

{

msg = msg + "\r\n" + kv.Key.ToString() + ": " + kv.Value;

}

Deployment.Current.Dispatcher.BeginInvoke(() => { MessageBox.Show(msg); });

}

b) 在Application_Launching中调用AcquirePushChannel

private void Application_Launching(object sender, LaunchingEventArgs e)

{

AcquirePushChannel();

}

c) 给TodoItem class添加一个property

[DataMember(Name = "channel")]

public string Channel { get; set; }

d) 修改MainPage.xaml.cs的ButtonSave_Click，代码如下。由于我们启用的动态架构，所以Save的时候Mobile Service会为新添加的Channel属性创建一个对应的数据库字段。

private void ButtonSave_Click(object sender, RoutedEventArgs e)

{

var todoItem = new TodoItem

{

Text = TodoInput.Text,

Channel = App.CurrentChannel.ChannelUri.ToString()

};

InsertTodoItem(todoItem);

}

2. 给App开启推送

3. 回到Azure的Portal，修改Mobile Service服务端script并保存，详细参数可以参考这里：

http://msdn.microsoft.com/en-us/library/windowsazure/jj871025.aspx

代码如下：

function insert(item, user, request) {

request.execute({

success: function () {

request.respond();

// send flip tile

push.mpns.sendFlipTile(item.channel, {

title: item.text

}, {

success: function (pushResponse) {

console.log("Sent flip tile push:", pushResponse);

}

});

// send toast

push.mpns.sendToast(item.channel, {

text1: 'MyTodos',

text2: item.text

}, {

success: function(pushResponse){

console.log("Sent toast push:", pushResponse);

}

});

}

});

}

4. 把MyTodos pin到主界面上，运行app，观察效果

总结

Azure Mobile Service极大地简化了server端的代码开发，尤其是对于比较小的应用来说，更是非常方便，使App开发者可以专注于前端代码。

附：

客户端源代码在这里