XamarinはC#を使ったクロスプラットフォームなスマートフォンアプリ開発環境です。最近、コロナウイルス追跡アプリを作ったフレームワークとして注目されるようになりました。
NCMBではC#を使った開発環境としてUnityに対応していますが、あれはiOS/Android SDKをラッピングしているので、Xamarinでそのまま利用できません。C#のみで実装する必要があります。
ここでは現在開発中のXamarin用SDK(非公式)の使い方を紹介します。まずはデータストアの保存についてです。
注意点
XamarinではNuGetを使ったライブラリ管理が行えます。しかし、試してみた限りではライブラリの依存関係が解決できず、開発できませんでした。現在はiOSプロジェクトでXamarinを作っている中に組み込む形での提供になります。
ダウンロード
NCMBMania/ncmb_xamarin: Xamarin SDK for NCMBのコードをダウンロードします。Xamarinプロジェクトにて、例えばNCMBといったフォルダを作成して、その中にファイルを放り込みます。
なお、ネームスペースが ncmb_xamarin になっていますので、適宜修正してください。また、依存ライブラリとして Json.NET(Newtonsoft.Json)を追加してください。
初期化
まず最初にSDKを初期化します。
var ncmb = new NCMB("ea5...265", "fe3...615");
データストアのインスタンス作成
データストアのインスタンスはSwiftやObjective-C、Android SDKのように作成できます。
var hello = ncmb.Object("Hello");
データの追加
データの追加は set メソッドを使います。文字列、数字、真偽値、日付型はそのまま指定できます。
hello.set("message", "Hello world"); hello.set("number", 100); hello.set("bol", true); hello.set("time", DateTime.Now);
配列の場合はJArrayを使ってください。
var ary = new JArray(); ary.Add("test1"); ary.Add("test2"); hello.set("array", ary);
オブジェクトの場合はJObjectを使ってください。
var obj = new JObject(); obj["test1"] = "Hello"; obj["test2"] = 100; hello.set("obj", obj);
実際の保存処理はsaveメソッドを使います。
hello.save();
データへのアクセスについて
データへアクセスする際にはgetメソッドを使います。この時、データはすべてJToken型で返ってきます。利用するデータに合わせて型をキャストしてください。
var ary2 = (JArray)hello.get("array");
コードについて
コードはNCMBMania/ncmb_xamarin: Xamarin SDK for NCMBにアップロードしています。ライセンスはMIT Licenseになります。
まとめ
Xamarinは個人というよりも法人での利用が多いプラットフォームになるかと思います。企業内、クライアント案件などでニフクラ mobile backendを使う際にはぜひXamarin SDKをお試しください。