Android アプリの作成

まずは、アプリを新規作成し、Kii Cloud SDK を組み込んで簡単なテストを行います。

アプリの新規作成

Android Studio から Android のモバイルアプリを新規に作成します。

ここでは、プロジェクトを以下の条件で作成すると仮定して説明します。

Application Name としてデフォルトの My Application を指定
com.example.pushtest パッケージにプロジェクトを作成、パッケージ以外はデフォルトの状態
Phone & Tablet を選択
Empty Activity を選択
その他の条件はデフォルトの状態

アプリの作成が完了したら、一旦ビルドしてアプリを実行してみます。もし、正しく実行できない場合は開発環境に問題があります。Web 等で類似の問題を検索してデバッグできる環境を用意してください。

Kii Cloud SDK の組み込み

リファレンスガイドの「Android アプリ開発の準備」に従って、Kii Cloud SDK を利用する準備を行います。

それぞれの手順は操作が複雑なため、Android の導入手順へのリンクによって詳細な操作方法を示しています。各ページの手順を実行した後は、このページに戻ってください。

ここで必要な設定は以下の 2 つです。

Kii Cloud でのアプリケーションの作成

Kii Cloud の開発者ポータルにログインして、アプリケーションを作成します。プッシュ通知はこのアプリケーション配下で実行させます。

アプリケーションは以下の条件で作成します。
- アプリケーション名：「Push Notification」など、わかりやすい名前を付けてください。
- サーバー設置場所：アプリ配布先の地域に近い場所を選択してください。
最終的に、Kii Cloud 上にアプリケーションを作成し、それを識別するための AppID を入手できます。

アプリケーションの作成を開いて、「コラボレーターの追加」の 直前まで の手順を実行し、このページに戻ってきてください。
Kii Cloud SDK の導入

先ほど作成した Android アプリに、Kii Cloud SDK を組み込みます。

Maven リポジトリからのダウンロードと、Kii ライブラリーのダウンロードのどちらを選択しても構いません。

プッシュ通知の導入手順を開いて、手順をすべて実行し、このページに戻ってきてください。

導入手順にあるプッシュ通知の導入手順は実施不要です。この後で詳細な手順を示します。

Kii Cloud の機能をテスト

ここまでの設定で、アプリから Kii Cloud の API を呼び出せる状態になっています。正しく組み込めたかどうか、テストのためユーザーを作成してみます。

作成したユーザーは、後の工程で使用します。Kii Cloud のプッシュ通知は、通知対象がユーザーであるため、そのユーザーを事前に作成しておきます。ここでは、簡易的に固定のユーザー名とパスワードで作成しますが、実際のアプリではこのチュートリアルの最後に示すヒントによって代わりの方法を使用できます。

作成するユーザーは以下のとおりです。

ユーザー名：user1
パスワード：123ABC

次のコードを MainActivity クラスの onCreate などの容易に実行できる場所に追加します。

String username = "user1";
String password = "123ABC";
KiiUser.Builder builder = KiiUser.builderWithName(username);
KiiUser user = builder.build();
user.register(new KiiUserCallBack() {
  @Override
  public void onRegisterCompleted(int token, KiiUser user, Exception exception) {
    if (exception != null) {
      // Handle the error.
      Toast.makeText(MainActivity.this, "Error register user:" + exception.getMessage(), Toast.LENGTH_LONG).show();
      return;
    }
    Toast.makeText(MainActivity.this, "Succeeded", Toast.LENGTH_LONG).show();
  }
}, password);

ここでは、以下の処理を行っています。

register メソッドの実行により、固定のユーザー名とパスワードで Kii Cloud 上にユーザーを作成します。
作成結果はコールバックメソッド onRegisterCompleted によって通知されます。結果を受けて Toast でメッセージ表示を行います。

アプリ起動後に「Succeeded」と表示されれば成功です。2 回以上実行すると、ユーザーの重複により「USER_ALREADY_EXISTS」エラーとなるはずですが、ユーザーは作成できているため問題ありません。

これ以外のエラーが発生する場合、ここまでの設定手順をもう一度確認してください。特に、Kii Cloud SDK の組み込みで実装した Kii.initialize が実行されているか、AppID とサーバー設置場所が作成したアプリケーションと一致しているかを確認してください。

一旦ユーザーを作成すると、処理は不要になるため、削除、または、コメントアウトしておきます。次のステップ JPush プロジェクトの作成に進みましょう。

<< Android (JPush) プッシュ通知設定チュートリアル

JPush プロジェクトの作成 >>