Xamarin.Forms × IBM MobileFirst Foundation

プロジェクトの作成

Bluemix のログイン後の画面で、右上の”カタログ”を選択します.

左側にカタログ一覧が表示されるので、その中の”モバイル”を選択します.

サーバの起動には少し時間が掛かります（私の環境では3分程度掛かりました）．

サーバが起動するとこのような画面が表示されていると思います.
次にコンソールの起動を行います. 目のマークをクリックするとパスワードを表示できるのでコピーしましょう．

ユーザ名: admin, パスワード: 先程コピーしたパスワードでログインしてください.

ログイン後の画面で、アプリケーションの”新規”を選択してください.

今回は Android のアプリケーションを作成します.

パッケージ名は Android のパッケージ名と一致させる必要があります.

ここまでがプロジェクトの作成になります．

アダプターの設定

Android 用アプリケーションを作成できたら、次にセキュリティチェック用のアダプターを作成します.

アダプターは、Java または JavaScript で作成できます.

github.com

今回はサンプルに準じて、上記リポジトリの Java のアダプタをそのまま使用します.

$cd SecurityCheckAdapters
$mvn clean install

リポジトリをクローンした後、上記コマンドを実行してください.

SecurityCheckAdapters/UserLogin/target/UserLogin.adapter が生成されていると思います.

Bluemix のコンソールに戻り、アダプターの新規作成を選択します.

画面右上のアダプターのデプロイを選択します.

先程作成した、SecurityCheckAdapters/UserLogin/target/UserLogin.adapter を選択してください.

問題がなければ上記のような画面が表示されていると思います.

次に、コンソール画面左の”Android(最新)”を選択します.

タブ中央の”セキュリティ”を選択します.

スコープ・エレメントのマッピングの新規を選択してください.

ダイアログが表示されるので、スコープ・エレメントを“push.mobileclient”という名前で、カスタム・セキュリティー検査に先程登録した LoginAdapter を指定して追加します.

これでアダプターの設定は完了です．

プッシュ通知の設定

最後にプッシュ通知の設定を行います．

今回は Android にプッシュ通知を送るので、Firebase Cloud Messaging の設定を行います.

Firebase Console にて新規プロジェクトを作成してください.

作成したプロジェクトのプロジェクト ID と ウェブ API キー を MobileFirst Foundation 側にコピーします.

コンソール画面左の”プッシュ”を選択します.

タブの”プッシュ設定”を選択します．

GCM プッシュ資格情報に、先程の Firebase Cloud Messaging のIDとキーをコピーします.

以上がバックエンドの実装になります.

パッケージの導入

Prism のテンプレートを用いてソリューションを作成します．

本エントリーでは PCL を用いますので、Shared Code: Use Portable Class Library を選択してください.

今回は MobileFirstSample という名前でソリューションを作成しました．

各種 NuGet パッケージをインストールします．

• ReactiveProperty
• Json.NET
• NuGet Gallery | Xamarin Google Play Services – GCM 32.961.0

MobileFirst Foundation をインストールします．

Xamarin Studio では Components からインストールができますが、Visual Studio ではできないようなので、本エントリーでは Xamarin Studio, Visual Studio 両方で可能な方法を取ります.

IBM MobileFirst SDK / Components / Xamarin

上記ページにて、IBM MobileFirst SDK をダウンロードします（2016/12/02現在の最新版は8.0.0.4です）．

ダウンロードしたフォルダにはサンプルが同封されています.
こちらが本エントリーで用いるサンプルです．

PCL・Android それぞれのプロジェクトの References に lib 以下に含まれるライブラリを加えます.

PCLプロジェクト

• Worklight.Core.dll

Androidプロジェクト

• MobileFirst.Android.JSONStore.dll
• MobileFirst.Android.Push.dll
• MobileFirst.Xamarin.Android.dll
• Worklight.Android.dll
• Worklight.Core.dll

以上でパッケージの導入は完了です．

IPlatformInitializer の実装

プラットフォームごとの IPlatformInitializer を実装します.

public class AndroidInitializer : IPlatformInitializer
{
	public Activity Activity { get; set; }

	public void RegisterTypes(IUnityContainer container)
	{
		container.RegisterInstance(WorklightClient.CreateInstance(Activity));
		container.RegisterInstance(WorklightPush.Instance);
	}
}

Androidプロジェクトの MainActivity に AndroidInitializer を実装します．

IWorklightClient と WorklightPush のインスタンスとして WorklightClient.CreateInstance(Activity); と WorklightPush.Instance をそれぞれ登録します．

Android の場合、WorklightClient#CreateInstance の引数として Activity が必要なので、MainActivity を引数として指定しています．

以上で IPlatformInitializer の実装は完了です．

Model の実装

ここからはPCL プロジェクトの Model の実装になります．

SampleClient.cs

using System;
using System.Diagnostics;
using System.Text;
using System.Threading.Tasks;
using Newtonsoft.Json.Linq;
using Worklight;
using Worklight.Push;

namespace MobileFirstSample
{
	public class SampleClient
	{
		private string _appRealm = "UserLogin";

		public IWorklightClient Client { get; private set; }
		public IWorklightPush Push { get; private set; }
		/// 

		/// Gets a value indicating whether this instance is push supported.
		/// 
		/// true if this instance is push supported; otherwise, false.
		public bool IsPushSupported
		{
			get
			{
				try
				{
					return Push.IsPushSupported;
				}
				catch
				{
					return false;
				}
			}
		}

		public SampleClient(IWorklightPush push)
		{
			Push = push;
			Push.Initialize();
		}

		public async Task RegisterAsync()
		{
			var result = new WorklightResult();

			try
			{
				MFPPushMessageResponse response = await Push.RegisterDevice(new JObject());
				result.Success = response.Success;
				result.Message = "Registered";
				result.Response = (response.ResponseJSON != null) ? response.ResponseJSON.ToString() : "";
			}
			catch (Exception exception)
			{
				result.Success = false;
				result.Message = exception.Message;
			}

			return result;
		}

		public async Task UnregisterAsync()
		{
			var result = new WorklightResult();

			try
			{
				MFPPushMessageResponse response = await Push.UnregisterDevice();
				result.Success = response.Success;
				result.Message = "Unregistered";
				result.Response = (response.ResponseJSON != null) ? response.ResponseJSON.ToString() : "";
			}
			catch (Exception exception)
			{
				result.Success = false;
				result.Message = exception.Message;
			}

			return result;
		}

		public async Task SubscribeAsync()
		{
			var result = new WorklightResult();

			try
			{
				MFPPushMessageResponse response = await Push.Subscribe(new string[] { "Xamarin" });
				result.Success = response.Success;
				result.Message = "Subscribed";
				result.Response = (response.ResponseJSON != null) ? response.ResponseJSON.ToString() : "";
			}
			catch (Exception exception)
			{
				result.Success = false;
				result.Message = exception.Message;
			}

			return result;
		}

		public async Task UnSubscribeAsync()
		{
			var result = new WorklightResult();

			try
			{
				MFPPushMessageResponse response = await Push.Unsubscribe(new string[] { "Xamarin" });

				result.Success = response.Success;
				result.Message = "Unsubscribed";
				result.Response = (response.ResponseJSON != null) ? response.ResponseJSON.ToString() : "";
			}
			catch (Exception exception)
			{
				result.Success = false;
				result.Message = exception.Message;
			}

			return result;
		}

		public async Task GetSubscriptionsAsync()
		{
			var result = new WorklightResult();

			try
			{
				MFPPushMessageResponse response = await Push.GetSubscriptions();

				result.Success = response.Success;
				result.Message = "All Subscriptions";
				result.Response = (response.ResponseJSON != null) ? response.ResponseJSON.ToString() : "";
			}
			catch (Exception exception)
			{
				result.Success = false;
				result.Message = exception.Message;
			}

			return result;
		}

		public async Task GetTagsAsync()
		{
			var result = new WorklightResult();

			try
			{
				MFPPushMessageResponse response = await Push.GetTags();

				result.Success = response.Success;
				result.Message = "All tags";
				result.Response = (response.ResponseJSON != null) ? response.ResponseJSON.ToString() : "";
			}
			catch (Exception exception)
			{
				result.Success = false;
				result.Message = exception.Message;
			}

			return result;
		}
	}
}

バックエンドと繋がる部分である SmapleClient クラスです．

フィールドの _appRealm = “UserLogin”; の部分は、バックエンド側のアダプター名と一致させます.

また、コンストラクの IWorklightClient と IWorklightPush は先程 IPlatformInitializer で実装したインスタンスが DI されます.

async/await のメソッド群はそれぞれ以下の機能を持ちます.

• RegisterAsync: プッシュ通知の登録
• UnregisterAsync: プッシュ通知登録の解除
• SubscribeAsync: 特定のプッシュ通知グループの登録
• UnSubscribeAsync: 特定のプッシュ通知グループの登録解除
• GetSubscriptionsAsync: 登録済みプッシュ通知グループの取得
• GetTagsAsync: バックエンド上に作成済みのプッシュ通知グループの取得

以上が Model の実装になります.

View の実装

ListView と、バックエンドと通信中を表すためのインジケータを実装しています.

View の実装は以上です．

ViewModel の実装

using Prism.Commands;
using Prism.Mvvm;
using Prism.Navigation;
using System;
using System.Collections.Generic;
using System.Linq;
using Reactive.Bindings;
using System.Diagnostics;
using System.Threading.Tasks;
using Prism.Services;
using Worklight;
using Worklight.Push;
using Newtonsoft.Json.Linq;

namespace MobileFirstSample.ViewModels
{
	public class MainPageViewModel : BindableBase
	{
		public ReactiveProperty IsVisibleIndicator { get; set; }
		public ReactiveProperty SelectedItem { get; set; }
		public List CommandItemList { get; set; }

		private readonly INavigationService _navigationService;
		private readonly IPageDialogService _pageDidalogService;
		private readonly SampleClient _sampleClient;

		public MainPageViewModel(INavigationService navigationService,
								 IPageDialogService pageDailogService,
								 IWorklightClient worklightClient,
								 IWorklightPush worklightPush)
		{
			_navigationService = navigationService;
			_pageDidalogService = pageDailogService;

			_sampleClient = new SampleClient(worklightClient, worklightPush);
			_sampleClient.Push.NotificationReceived += (sender, e) =>
			{
				PushEventArgs eventArgs = (PushEventArgs) e;
				_pageDidalogService.DisplayAlertAsync("Got notification!",
				                                     eventArgs.Alert,
				                                     "OK");
			};

			IsVisibleIndicator = new ReactiveProperty { Value = false };
			SelectedItem = new ReactiveProperty();
			SelectedItem.PropertyChanged += (sender, e) =>
			{
				if (SelectedItem.Value != null)
				{
					SelectedItem.Value.Command();
				}
				SelectedItem.Value = null;
			};

			CommandItemList = new List
			{
				new CommandItem { CommandName = "Register Device", Image = "subscribe.png", Command = OnRegister },
				new CommandItem { CommandName = "Unregister Device", Image = "unsubscribe.png", Command = OnUnregister },
				new CommandItem { CommandName = "Subscribe to Push", Image = "subscribe.png", Command = OnSubscribe },
				new CommandItem { CommandName = "Unsubscribe from Push", Image = "unsubscribe.png", Command = OnUnSubscribe },
				new CommandItem { CommandName = "Get All Subscriptions", Image = "issubscribed.png", Command = OnGetSubscriptions },
				new CommandItem { CommandName = "Get All Tags", Image = "issubscribed.png", Command = OnGetTags }
			};
		}

		private async void OnRegister()
		{
			ShowWorking();
			var result = await _sampleClient.RegisterAsync();
			HandleResult(result, "Register Device Result");
		}

		private async void OnUnregister()
		{
			ShowWorking();
			var result = await _sampleClient.UnregisterAsync();
			HandleResult(result, "Unregister Device Result");
		}

		private async void OnSubscribe()
		{
			ShowWorking();
			var result = await _sampleClient.SubscribeAsync();
			HandleResult(result, "Subscribe Result");
		}

		private async void OnUnSubscribe()
		{
			ShowWorking();
			var result = await _sampleClient.UnSubscribeAsync();
			HandleResult(result, "Unsubcribe Result");
		}

		private async void OnGetSubscriptions()
		{
			ShowWorking();
			var result = await _sampleClient.GetSubscriptionsAsync();
			HandleResult(result, "Get Subscriptions Result");
		}

		private async void OnGetTags()
		{
			ShowWorking();
			var result = await _sampleClient.GetTagsAsync();
			HandleResult(result, "Get Tags Result");
		}

		private void OnIsPushEnabled()
		{
			_pageDidalogService.DisplayAlertAsync("Push Status",
												  $"Push {(_sampleClient.IsPushSupported ? "is" : "isn't")} supported",
												  "OK");
		}

		private async void ShowWorking(int timeout = 15)
		{
			IsVisibleIndicator.Value = true;

			await Task.Delay(TimeSpan.FromSeconds(timeout));

			if (IsVisibleIndicator.Value == true)
			{
				IsVisibleIndicator.Value = false;
				await _pageDidalogService.DisplayAlertAsync("Timeout", "Call timed out", "OK");
			}
		}

		private void HandleResult(WorklightResult result, string title)
		{
			IsVisibleIndicator.Value = false;

			Debug.WriteLine(title);
			Debug.WriteLine($"Success: {result.Success}");
			Debug.WriteLine($"Message: {result.Message}");
			Debug.WriteLine($"Response: {result.Response}");

			_pageDidalogService.DisplayAlertAsync(title, result.Message, "OK");
		}
	}
}

ViewModel の実装です．

ListView#SelectedItem にバインドすることで、タップされたセルのイベントを呼び出します.

それぞれのセルに指定した Command では、SampleClient の asyncメソッドを呼び出しています.

ViewModel の実装は以上です．

バックエンドのプロパティファイル

最後にバックエンド側のプロパティをクライアント側に記述します.

Androidプロジェクトの assets に “mfpclient.properties” を作成してください.

Host の部分には Bluemix のコンソール URL の上記の部分をコピーしてください.

以上でクライアントサイドの実装は完了です．