【Android】ニフクラ mobile backend を体験しよう！

概要

AndroidStudioで作成したAndroidアプリから、ニフクラ mobile backendへデータ登録を行うサンプアプリです
アプリを起動して「START DEMO」ボタンをタップするとクラウドにデータを保存できます
簡単な操作ですぐにニフクラ mobile backend の機能を体験いただけます

ニフクラ mobile backend って何？？

スマートフォンアプリのバックエンド機能（プッシュ通知・データストア・会員管理・ファイルストア・SNS連携・位置情報検索・スクリプト）が開発不要、しかも基本無料(注1)で使えるクラウドサービス！

注1：詳しくはこちらをご覧ください

動作環境

Macos Mojave version: 10.14.6 (18G103)
Android studio: 3.4.1
Simulator: Pixel 2 Version: 10

※上記内容で動作確認をしています。

手順

1. ニフクラ mobile backend の会員登録・ログインとアプリの新規作成

下記リンクから会員登録（無料）をします
- https://console.mbaas.nifcloud.com/signup
登録ができたら下記リンクからログインします
- https://console.mbaas.nifcloud.com/
下図のように「アプリの新規作成」画面が出るのでアプリを作成します
- 既に mobile backend を利用したことがある方は左上の「＋新しいアプリ」をクリックすると同じ画面が表示されます

アプリ作成されるとAPIキー（アプリケーションキーとクライアントキー）が発行されます
この２種類のAPIキーはこの後ダウンロードするサンプルアプリとニフクラ mobile backend を紐付けるため、あとで使います。

ついでに、この後動作確認でデータが保存される場所も確認しておきましょう

2. サンプルプロジェクトのダウンロード

下記リンクをクリックしてプロジェクトをダウンロードします
https://github.com/NIFCLOUD-mbaas/android_data_demo/archive/master.zip
ダウンロードしたプロジェクトを解凍します
AndroidStudio を開きます、「Open an existing Android Studio project」をクリックして解凍したプロジェクトを選択します

プロジェクトが開かれます

3. SDKの導入（実装済み）

※このサンプルアプリには既にSDKが実装済み（下記手順）となっています。（ver.3.0.2)
最新版をご利用の場合は入れ替えてご利用ください。

SDKダウンロード SDKはここ（SDK リリースページ）から取得してください.
- NCMB.jarファイルがダウンロードします。
SDKをインポート
- app/libsフォルダにNCMB.jarをコピーします
設定追加
- app/build.gradleファイルに以下を追加します

dependencies {
    implementation 'com.google.code.gson:gson:2.3.1'
    implementation files('libs/NCMB.jar')
}

androidManifestの設定
- タグの直前に以下のpermissionを追加します

<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />

4. APIキーの設定

AndroidStudio で MainActivity.java を開きます
- ディレクトリはデフォルトで「Android」が選択されていますので、「Project」に切り替えてから探してください
APIキー（アプリケーションキーとクライアントキー）の設定をします

それぞれ YOUR_APPLICATION_KEY と YOUR_CLIENT_KEY の部分を書き換えます
このとき、ダブルクォーテーション（"）を消さないように注意してください

5. 動作確認

エミュレーターでアプリをビルドします
- 失敗する場合は一度「Clean Project」を実行してから再度ビルドしてください
エミュレーターが起動したら「START DEMO」ボタンをタップタブし、保存成功！とメッセージが表示しました。

mBaaS側もデータが保存されたことを確認しています！

コード説明

SDKおよび必要なライブラリーのインポート

import com.nifcloud.mbaas.core.DoneCallback;
import com.nifcloud.mbaas.core.NCMB;
import com.nifcloud.mbaas.core.NCMBException;
import com.nifcloud.mbaas.core.NCMBObject;

SDKを初期化

MainActivity の OnCreate メソッド内

 @Override
    protected void onCreate(Bundle savedInstanceState) {
       <省略>
        //**************** APIキーの設定とSDKの初期化 **********************
        NCMB.initialize(this.getApplicationContext(), "YOUR_APPLICATION_KEY", "YOUR_CLIENT_KEY");
    }

データの保存

Android SDK が提供する NCMBObject クラスは、データストアを操作するためのクラスです
データを保存するには、このクラスが提供する saveInBackground メソッドを利用します
NCMBObject のインスタンス obj を作成し、クラス名「"TestClass"」を設定することで、データストアにデータの保存先クラスである「TestClass」クラスを作成・操作することができます
obj.put(Key, Value) で、フィールド「Key」に値「Value」を設定します
saveInBackground() : 保存の実行を行います（非同期処理）

final NCMBObject obj = new NCMBObject("TestClass");
    try {
        obj.put("message", "Hello, NCMB!");
        obj.saveInBackground(new DoneCallback() {
            @Override
            public void done(NCMBException e) {
                if (e != null) {
                    //保存失敗

                } else {
                    //保存成功

                }
            }
        });
    } catch (NCMBException e) {
        e.printStackTrace();
    }

参考

データ保存・データ検索・会員管理・プッシュ通知などの機能を実装したい場合は、以下のドキュメント（Android for Java）もご参照ください。

ドキュメント

Contributing

Fork it!
Create your feature branch: git checkout -b my-new-feature
Commit your changes: git commit -am 'Add some feature'
Push to the branch: git push origin my-new-feature
Submit a pull request :D

License

MITライセンス
NIFCLOUD mobile backendのAndroid SDKのライセンス

ncmbadmin/android_data_demo