バックエンドの実行、テスト、デプロイ

Android Studio を使用して、バックエンドをローカルで実行し、テストして、デプロイできます。

ローカルでのバックエンドの実行とテスト

エンドポイント バックエンド テンプレートを追加したら、ローカルでテストして、環境が正しく動作することを確認する必要があります。バックエンド テンプレートをローカルで実行するには、次のようにします。

  1. [Run] > [Edit Configurations] をクリックして [Run/Debug Configurations] フォームを開きます。

    バックエンド構成を実行

    バックエンド モジュール テンプレートをプロジェクトに追加すると、バックエンド用の新しい実行構成が作成され、この構成の名前がバックエンドの作成時に割り当てたモジュールの名前となることに注意してください。

  2. 左側のペインの [App Engine DevAppServer] で、追加したバックエンド モジュールを選択し、[OK] をクリックします。

  3. [Build] > [Rebuild Project] をクリックしてプロジェクトの作成が完了するまで待機します。

  4. [Run]、[Run] <your-backend-module-name> の順に選択して、Android Studio のローカル App Engine 開発用サーバーでバックエンドを起動します。

    バックエンド構成を実行

  5. バックエンドが開発用サーバーで起動するまで待機します。バックエンドのロードが完了すると、以下のようなメッセージがコンソールに表示されます。

        Jun 18, 2014 4:07:30 PM com.google.appengine.tools.development.AbstractModule startup
    INFO: The admin console is running at http://localhost:8080/_ah/admin
    Jun 18, 2014 4:07:30 PM com.google.appengine.tools.development.DevAppServerImpl doStart
    INFO: Dev App Server is now running

  6. Android Studio プロジェクトを実行しているパソコンで、http://localhost:8080 に移動します。問題がなければ次のページが表示されます。

    ローカルでの「HelloWorld」バックエンドの実行

    （表示されるページはエンドポイント バックエンド用です。他のバックエンド タイプのページはこれと若干異なります。）

    このページの上部にあるリンク、特に Google Cloud コンソールに移動するリンクで、プロジェクトの作成または構成ができます。開発とテスト作業が完了したら、バックエンドをデプロイするためのプロジェクトが必要になります。

ここでは、テンプレートからのデフォルトのバックエンドが正常に稼働しています。 ただし、Android アプリはまだバックエンドに接続していません。 バックエンドにアクセスする場合、以下の README ファイルの中で該当するものに記載されているように、Android アプリにコードを追加する必要があります。

バックエンドに設定したいユーザー定義の動作も追加する必要があります。

API エクスプローラを使用したエンドポイント バックエンドのテスト

エンドポイントを持つバックエンドは、内蔵された Google API エクスプローラを使って API の機能を直接テストできます。

  1. 前述のとおり、バックエンドをローカルで起動し、実行します。

  2. Android Studio プロジェクトを実行しているパソコンで http://localhost:8080/_ah/api/explorer に移動します。問題がなければ、次のようなページが表示されます。

    Cloud Endpoints API エクスプローラ

  3. API 名（myApi API）をクリックすると、この API で利用できるメソッドが表示されます。

  4. メソッド（myApi.sayHi）をクリックすると、このメソッドのエクスプローラ フォームが表示されます。

    SayHi フォーム

  5. 入力フィールド値を指定します（値がある場合）。たとえば、デフォルトのバックエンドを使用して、自分の名前を [name] フィールドに指定します。[Execute] をクリックし、予想どおりのレスポンスがあることを確認します。

バックエンドのデプロイ

ローカルで動作しているバックエンドを Google App Engine にデプロイできます。

バックエンドをデプロイする前に、バックエンド用の Cloud プロジェクトを作成してそのプロジェクト ID をバックエンドに追加する必要があります。この手順は、バックエンド テンプレートの README（Servlet Module/Endpoints Module/Backend with Google Cloud Messaging）に記載されています。バックエンドを Android Studio から App Engine にデプロイする手順は次のとおりです。

  1. バックエンドがローカルで実行されている場合は、[Run] > [Stop] を選択して停止します。

  2. [Build] > [Deploy Module to App Engine] を実行します。

    • このタスクを初めて実行する場合、Google アカウントでのログインを求めるメッセージが表示されます。アカウントを選択してログインします。

  3. [Deploy to App Engine] ダイアログで、モジュールを選択します。[Deploy To] プルダウン リストで、Google Cloud コンソール プロジェクト（ここでは backend-example-352）を選択します。

    App Engine をデプロイ

    プロジェクトを新たに作成する必要がある場合、または別のアカウントでログインする必要がある場合は、プルダウン リストの最後までスクロールします。

    • プロジェクトを新たに作成する場合、プルダウンの最後までスクロールし、[Click Here] をクリックします。Google Cloud コンソールが表示され、プロジェクトを作成できます。Android Studio のダイアログに戻り、更新ボタンをクリックすると、プルダウンに新しいプロジェクトが組み込まれます。この新しいプロジェクトを選択します。
    • 新しいアカウントを作成する場合、または別の既存のアカウントを指定する場合は、プルダウンの最後までスクロールして、[Add Account] をクリックします。

    アカウントを追加

  4. [Deploy to App Engine] ダイアログで [Deploy] をクリックします。デプロイ状況は Android Studio コンソールから確認できます。