サーバー構築不要！スマートフォンアプリ向けの新クラウド

トップ >ドキュメント >イントロダクション（Android）:クイックスタート

イントロダクション（Android）

クイックスタート

クイックスタートについて

このページでは、mobile backendをAndroidアプリを連携させる手順を紹介します

アプリの新規作成

管理画面

  • ニフクラ mobile backendにログインします
  • 管理画面が表示されたら、「アプリの新規作成」を行います
    • すでに別のアプリを作成済みの場合は、ヘッダーの「＋新しいアプリ」をクリックします

新規アプリケーション作成

  • 「アプリ名」を入力し「新規作成」をクリックすると、APIキー（アプリケーションキーとクライアントキー）が発行されます

APIキー発行

  • APIキーは後ほどAndroidアプリで使います

AndroidStudio

  • AndroidStudioでプロジェクトを作成します
    • 既存のプロジェクトを利用する場合はこの作業は不要です

Androidプロジェクト

Androidプロジェクト

Androidプロジェクト

SDKのダウンロード

  • Githubリリースページの NCMB.x.x.x.zip ボタンからダウンロードしてください
    • 最新版をダウンロードしてください。
    • zipファイルの中身に、NCMB.jarがあります。

SDKのインストール

  • このSDKでは、以下のライブラリを使用しています。
    • Gson

AndroidStudio

  • Android Studioでプロジェクトを開き、以下の手順でSDKをインストールしてください
    • Project Viewに切り替えてから、app/libsフォルダにNCMB.jarをコピーします

jarファイルをコピー

  • app/build.gradleファイルに以下を追加します
dependencies {
    implementation 'com.google.code.gson:gson:2.3.1'
    api files('libs/NCMB.jar')
}

jarファイルをコピー

AndroidManifest.xmlの編集

AndroidStudio

  • <application>タグの直前に以下のpermissionを追加します
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />

jarファイルをコピー

  • 【任意設定】アプリのプロセスが存在しない状態から、サービスなどでアプリを起動し、初期化メソッドを実行せずにAPIリクエストを行う必要がある場合、以下の設定をAndroidManifestのapplicationタグに追記します。
android:name="com.nifcloud.mbaas.core.NCMBApplicationController"

SDKの読み込み

AndroidStudio

  • MainActivity.javaの冒頭に次のコードを追記して、インストールしたSDKを読み込みます
import com.nifcloud.mbaas.core.NCMB;

APIキーの設定とSDKの初期化

AndroidStudio

  • ニフクラ mobile backendのアプリケーションキーとクライアントキーを利用して、 NCMBクラスのinitializeメソッドでAndroid SDKの初期化を行います
  • アプリ起動時に表示するアクティビティのonCreateメソッドに下記の内容を追記します
NCMB.initialize(this.getApplicationContext(),"APP_KEY","CLIENT_KEY");

管理画面

  • 上の「APP_KEY」と「CLIENT_KEY」は、mBaaSの管理画面で「アプリの新規作成」を行ったときに発行されたAPIキーに置き換えます
    • アプリ作成時のAPIキー発行画面を閉じてしまった場合は、「アプリ設定」＞「基本」で確認できます。
    • 「コピー」ボタンを使用してコピーしてください。

APIキー確認

  • これで連携作業は完了です！
  • サンプルコードを書いて実際にmBaaSを使ってみましょう

サンプルコードの実装

AndroidStudio

  • 最初に、ファイルの先頭に利用するライブラリを追記します
import com.nifcloud.mbaas.core.NCMB;
import com.nifcloud.mbaas.core.NCMBException;
import com.nifcloud.mbaas.core.NCMBObject;
import com.nifcloud.mbaas.core.DoneCallback;
  • MainActivity.javaのonCreateメソッド内に書いた処理は、アプリの起動時に実行されます
  • APIキーの設定とSDK初期化コードの下にサンプルコードを書くと、すぐに動作確認が可能です
@Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    // APIキーの設定とSDK初期化
    NCMB.initialize(this.getApplicationContext(), "APP_KEY", "CLIENT_KEY");
    // ↓　ここにサンプルコードを実装　↓


    setContentView(R.layout.activity_main);
}
サンプルコード（データストア）
  • 次のコードはmBaaSのデータストアに保存先の「TestClass」というクラスを作成し、「message」というフィールドへ「Hello, NCMB!」というメッセージ（文字列）を保存するものです。
// クラスのNCMBObjectを作成
NCMBObject obj = new NCMBObject("TestClass");

// オブジェクトの値を設定
try {
    obj.put("message", "Hello, NCMB!");
} catch (NCMBException e) {
    e.printStackTrace();
}

// データストアへの登録
obj.saveInBackground(new DoneCallback() {
    @Override
    public void done(NCMBException e) {
        if(e != null){
            //保存に失敗した場合の処理

        }else {
            //保存に成功した場合の処理

        }
    }
});
アプリを実行してmBaaSの管理画面を確認する
  • アプリを実機またはシミュレーターで実行します

管理画面

  • アプリが起動されたら、mBaaSの管理画面で「データストア」から、データが保存されていることを確認できます

DBサンプル結果

Androidアプリのチュートリアルについて

ぜひご活用ください！

お探しの内容が見つからなかった場合はユーザーコミュニティ もご活用ください。（回答保証はいたしかねます）
なお、 Expertプラン以上のお客様はテクニカルサポートにてご質問を承らせて頂きます。

推奨画面サイズ1024×768px以上

ページの先頭へ