プロジェクトセクションでは、プロジェクトの作成と管理ができます。プロジェクトを作成すると、複数のアプリをこれに関連付けることができます。既存のアプリがある場合は、「インポート」機能を使ってこれをプラットフォームにインポートすることができます。

プロジェクトは、異なるプラットフォーム用のアプリとそれらが通信するクラウドアプリで構成されます。

アプリ作成に加えて、既存のアプリをプラットフォームにインポートすることもできます。アプリをインポートする際には、新規プロジェクトを作成してそこにアプリをインポートするか、既存のプロジェクトにアプリをインポートすることを選択できます。プラットフォームにインポート可能なアプリのタイプは数多くあり、Native iOS、Native Android、PhoneGap、Basic Web App、および Advanced Web App などがあります。また、アプリをプラットフォームにインポートするには、以下のような方法があります。

アプリをプラットフォームにインポートする方法については、ユーザーにステップごとの指示が示されます。この方法は、選択するインポートのメソッドによって多少異なります。例えば、「既存の Git レポジトリーをクローンする」オプションでのみ、Git レポジトリーのクローン方法に関する指示があります。

アプリ、クラウドアプリ & サービスのセクションでは、プロジェクト内のクライアントアプリとクラウドアプリの管理ができます。ここでは、新規クライアントアプリとクラウドアプリをプロジェクトに追加することができます。クラウドアプリは、クライアントアプリとクラウドバックエンドのストレージおよびサービスをつなぐゲートウェイの役割を果たします。

プロジェクトにはいくつでもアプリを追加することができ、以下の 3 つの方法があります。

接続セクションでは、選択したプロジェクトで構築されたバイナリーの概要と実行中のクラウドアプリの概要が提供されます。プロジェクトにはクライアントアプリとクラウドアプリの両方が含まれており、接続はクラウドアプリアプリがポイントするクラウドインスタンスを決定します。接続は、環境内の特定のクラウドアプリをポイントします。ダッシュボードでは、全環境内に存在する接続の概要が示されます。ユーザーはダッシュボードで、各クライアントアプリがどのようにクラウドインスタンスと接続しているかを見ることができます。クライアントアプリとクラウドアプリとの接続は、何回でも再設定したり無効にすることができます。

Git クイックスタートページでは、Git を使って自分のローカルシステム上のアプリのクライアントおよびクラウドコードにアクセスする方法を示しています。リポジトリーをクローンすると、既存リポジトリーと全く同じコピーが作成されます。'git clone' を実行すると、プロジェクト内の全ファイルの全バージョンがプルされます。ただし、リポジトリーをクローンする前に自分の SSH パブリックキーをアップロードする必要があります。パブリックキーがアップロードされたら、リポジトリーは自由にクローンすることができます。

Git リポジトリーのクローンについての詳細情報は、Git ドキュメンテーションの Getting started with Git を参照してください。

便利な Git コマンド一覧は、Git Reference を参照してください。

リソースセクションでは、全環境にまたがるプロジェクトのアプリについて、CPU やメモリー使用量 & ディスク使用率などのリソース使用率が表示されます。特定の環境にアプリがデプロイされていない場合は、この環境でのリソース使用率は表示されません。この画面では、デプロイ済みアプリのステータスを管理することもできます。例えば、特定のアプリのメモリー使用率が高い場合は、これを停止することができます。リソースのグラフはライブのデータを基にしているので、データを定期的に収集する間、傾向を表示するまでに多少時間がかかる場合もあります。

プロジェクトは通常、単一のアプリ (例: Cordova App) とクラウドアプリ (例: Node.js Application) で開始されます。プロジェクトは進捗するにつれて様々なステージを経過します。これがプロジェクトのライフサイクルになります。プロジェクトはそれぞれ異なるペースで進行し、その構成も時間の経過とともに拡大し、異なってきます。ライフサイクル管理ダッシュボードは、開発者とプロジェクト管理者の両方にとってこのプロセスを容易なものにします。

ダッシュボードでは、その時点におけるプロジェクトのスナップショットを提供します。アプリはすべて、ダッシュボード上の行で示されます。各環境は、ダッシュボードのコラムで示されます。このグリッドにより、プロジェクトの各部分がどのステージにあるか、個別のチームメンバーに質問することなく概要がすぐに分かります。

アプリがビルドされていれば、クラウドアプリがあるターゲットとなっている環境を示すコラムに直近のビルドが表示されます。アプリのバイナリーはここからダウンロードが可能で、または異なる git ブランチやタグから再ビルドすることもできます。「プロモート」オプションは同一コードの再ビルドのショートカットになりますが、別のクラウドアプリ環境に接続します。

クラウドアプリがデプロイ済みの場合は、直近のデプロイの詳細とステータスが対応する環境コラムに表示されます。クラウドアプリのコードは、利用可能な環境であればどれでもデプロイ (または再デプロイ) することが可能です。クラウドアプリの「プロモート」オプションは、既にデプロイ済みの git ブランチまたはタグを別の環境にデプロイするためのショートカットです。

フォーム設定ページでは、ユーザーはプロジェクト内でフォームとテーマを関連付け、クライアント側のアプリフォームを設定することができます。ユーザーは、カメラ設定や提出、管理ユーザー、クライアントログイン、およびクラウドログインを管理することができます。

プロジェクトに関連付けられている提出もこのページで見ることができます。

レポートのセクションでは、特定のプロジェクト内のクライアントとクラウドアプリの両方に関するアナリティクス情報が高度なグラフで提示されます。実行されたデバイスインストール数や起動したアプリ数など、幅広い情報にユーザーはアクセスできます。これらの分野はどれでもさらに調査して、日付やプラットフォーム、場所に基づくアナリティクス情報にアクセスすることができます。

Studio では、これらの情報は多くの異なるグラフで表示されます。日付に特定したデータは折れ線グラフで示されます。これによりユーザーは、特定期間のアプリのアクティビティーの内訳を知ることができます。範囲内の特定日におけるアクティビティーの量が分かります。例えば、範囲内の特定日に実行されたクラウドリクエストの数が確認できます。

ドーナツグラフでは、プラットフォームごとのアクティビティーの内訳が表示されます。例えば、特定の期間内でプラットフォームごとに実行されたインストール数などです。場所特定のデータは、地図で示されます。これにより、ユーザーは地理的位置に基づいたアプリのアクティビティー内訳が分かります。各グラフはには対応する凡例があります。カーソルをこれらの図表上に持って行くと凡例で対応する値の詳細情報が示されます。

データ収集を行う期間は変更することができます。事前定義の期間では、「過去 7 日間」「過去 30 日間」「前月」の情報が示されますが、これらのいずれも当てはまらない場合は、範囲の開始日と終了日を手動で選択することもできます。つまりユーザーはデータのカテゴリーを選択し、日付の範囲を入力するだけでアプリのデータを入手することができます。

プロジェクト設定ページから、プロジェクトの名前を変更したり削除することができます。

Red Hat Mobile Application Platform ホスト型 (RHMAP) を使うと、hybrid、HTML5、または Native Apps など幅広いアプリをビルドできます。クライアントアプリとクラウドアプリは両方ともプロジェクトに追加できます。アプリは、位置情報やバックエンドストレージなどの機能へのアクセスを提供する数多くの JavaScript API にアクセスがあります。フォームベースのアプリは、インターフェースの簡単なドラッグアンドドロップで作成できます。

アプリ、クラウドアプリ & サービス 画面を選択すると、デフォルトで詳細ページが表示されます。ここでは、現在選択しているアプリに関する以下の情報の概要が示されます。

いずれのアプリの詳細もこのページで更新できます。Studio では、この画面にアプリのプレビューもあります。ユーザーは、アプリを電話、タブレット、またはデスクトップでプレビューすることが選択できます。アプリプレビューウィンドウでデバイスを選択したら、ドロップダウンリストから特定のデバイスを選択してアプリのプレビューを実行することができます。

アプリは、アプリ、クラウドアプリ & サービス ページから削除することもできます。

ビルトインのエディターを使うことで、アプリ内のコードが編集できます。構文ハイライト表示の機能が組み込まれているため、構文要素を区別しやすくなっています。ユーザーはファイルやフォルダーを新規作成し、保存された変更は自動的に対応する Git リポジトリーにプッシュバックされます。

変更がなされたらプレビューが自動的にリフレッシュされるため、変更の反映がすぐに確認できます。'git pull' を実行すると、Git リポジトリーから変更がプルされます。以下の Git 機能は、Studio のエディターセクションで利用できます。

エディターのアプリプレビューでは、多くの選択可能なデバイスで現行アプリがどのように表示されるかを確認できます。

アプリに README.md のマークダウンファイルが含まれる場合は、変換されてここに表示されます。

アナリィティクスセクションでは、アプリ使用量統計値のグラフィック表示にアクセスできます。データは、インストールやクラウドリクエスト、起動、アクティブなデバイスなど多くのカテゴリーで調べることができます。また、日付やプラットフォーム、場所でカテゴリー分けすることもできます。グラフのコンテンツは、「場所ごとのインストール」を除いてプラットフォーム別に表示されます。各プラットフォームは、凡例でそれぞれ別のキーで示されます。グラフ内のコンテンツは、凡例で各プラットフォームをクリックするとオンとオフが切り替えられます。

日付の範囲もカスタマイズが可能です。事前定義の期間は、「過去 7 日間」「過去 30 日間」「前月」ですが、独自の開始日と終了日を適用することもできます。

アプリの初回起動時にクラウドにコールバックが行われ、この時点でデバイスインストールが記録されます。デバイスインストールはユーザーインストールとは異なります。ユーザーインストールは、以下の方法で App Stores が追跡するものです。

プッシュセクションでは、アプリのプッシュ通知の設定ができます。プッシュ通知についての詳細は、プッシュ通知 の章を参照してください。

ビルド機能を使うと、選択したプラットフォーム向けにバイナリーのセットを構築できます。ビルド操作を実行する際には、バイナリーの接続先となるクラウドアプリを選択する必要があります。これは、プロジェクトと関連付けられているクラウドアプリであれば、どれでも構いません。ビルドは以下のプラットフォーム向けに実行できます。

また、以下のいずれかのビルドタイプを選択する必要があります。

選択したプラットフォームとビルドタイプによっては、バイナリーの署名に認証情報バンドルが必要になる場合があります。認証情報については、下記の証明書セクションを参照してください。

ビルドが成功したら、そのアーティファクトがアーティファクト履歴に追加されます。アーティファクト履歴では、バイナリーが構築されたプラットフォームやビルドタイプ、ビルドに使用された認証情報バンドルなどを含むビルドの概要情報が提供されます。アーティファクト履歴からアーティファクトを選択すると、そのバイナリーを再度ダウンロードすることができます。

エクスポートセクションでは、アプリをいくつもの選択したプラットフォームでエクスポートできます。アプリをエクスポートする際には、バイナリーの接続先となるクラウドアプリ、プラットフォーム、およびプラットフォームのバージョンを指定する必要があります。アプリは zip ファイルとしてエクスポートされます。エクスポートが完了すると、エクスポートはアーティファクト履歴に追加され、ここからいつでも再ダウンロードできるようになります。

認証情報セクションでは、認証情報バンドルが管理できます。新規の認証情報バンドルは追加またはインポートが可能です。また、既存の認証情報バンドルを一覧表示することもできます。

統合セクションでは、既存のクライアントアプリを RHMAP プロジェクトにインポートすることができます。アプリをインポートするには、レポジトリーをクローンして、アプリを RHMAP SDK と統合する必要があります。

クラウドアプリ はサーバー側のアプリケーションで、クラウドの実行環境である MBaaS で稼働します。クライアントアプリはクラウドアプリと通信し、データストレージや認証、キャッシングなどのバックエンド機能にアクセスします。

詳細のセクションでは、クラウドアプリの概要情報にアクセスできます。このセクションでは、このデータを編集、管理することができます。

アプリは、Running または Stopped のいずれかのステータスになり、ステータスは Start App、Stop App、および Restart App ボタンで制御されます。アプリが Running 状態の場合は、そのアプリのデバイス上のビルドは予想どおりに機能します。ただし、Stopped ステータスの場合は、アプリがクラウドの機能に依存していれば、デバイス上のユーザーはそのアプリを使用することができません。

また、アプリ ID、アプリ API キー、名前などの一般的な情報も記載されています。これらの情報は、このセクションで編集および更新ができます。

ビルトインのエディターを使うことで、クラウドアプリ内のコードが編集できます。構文ハイライト表示の機能が組み込まれているため、構文要素を区別しやすくなっています。ユーザーはファイルやフォルダーを新規作成し、保存された変更は自動的に対応する Git リポジトリーにプッシュバックされます。

変更がなされたらプレビューが自動的にリフレッシュされるため、変更の反映がすぐに確認できます。git pull を実行すると、Git リポジトリーから変更がプルされます。

エディターのアプリプレビューでは、多くの選択可能なデバイスで現行アプリがどのように表示されるかを確認できます。

Studio を使用する環境変数は定義が可能で、これらの変数はクラウドコードでアクセスできます。Studio では、各クラウド環境における現在定義済みの環境変数とデプロイ済みの環境変数の一覧を表示します。また、システムが定義する環境変数一覧も見ることができます。

// PIN_ENABLED is the environmental variable created in the Studio.
var pin_enabled = process.env.PIN_ENABLED  || true  // defaults to true if no value defined

// On the cloud side using node.js
exports.getEnvVariable = function(params, cb){
  var pin_enabled = process.env.PIN_ENABLED  || true

  return cb(null, {
    enabled : pin_enabled
  });
};

// On the client side
$fh.act({
  act : 'getEnvVariable',
  req : {}
  }, function(res){
   // run this in the event of success.
}, function(err){
   // run this in the event of failure.
});

App Studio データブラウザーセクションでは、開発者は以下のことができます。

詳細情報は データブラウザーガイド を参照してください。

デプロイセクションでは、開発者は以下のことができます。

Node.js アプリケーションのデプロイプロセスは通常、以下のようになります。

上記のステップは、選択したオプションやアプリのタイプ、特定ファイルの有無およびそのコンテンツによって異なります。

さらに開発者は、クラウドコードを OpenShift Online にデプロイするようプラットフォームを設定することができます。詳細は、Staging Cloud Apps to RedHat OpenShift Online PaaS guide を参照してください。

Studio では、アプリのエンドポイント統計値とカスタム統計値という 2 種類の統計があります。これらは、クラウドアプリの統計セクションにあります。

これらの統計数値を表すグラフには共通の UI 機能があります。データは異なる形式で (例: csv) ダウンロードできます。データの範囲は、各グラフの下にあるスクロールバーとスライダーで変更可能です。グラフ内の各行は、凡例のアイテムをクリックすることでオンとオフが切り替えられます。

アプリでは、アプリに対して特定のアクションが発生すると、イベントが生成されます。これらのイベントはプラットフォームが記録し、App Studio と FHC が開発者に提示します。例えば、開発者がアプリをデプロイすると、プラットフォームはデプロイの発生時間とデプロイ実行者、およびその結果を記録します。

イベントにはカテゴリー、重大度、および名前があります。現在プラットフォームが生成するイベントは以下の通りです。

ユーザーは、各アプリ環境で作成された現行およびアーカイブ済みのアプリログにアクセスできます。

エンドポイントセキュリティーの機能を使用すると、アプリのエンドポイントに適用するセキュリティーレベルを決定できます。

サービスとは、Oracle 統合サービスのようなバックエンドシステムと統合するためにプロジェクトが使用する稼働中のクラウドアプリです。サービスは 1 つ以上のプロジェクトに追加して、そのプロジェクトのアプリで利用可能とします。

クラウドサービスのインスタンス作成を可能とするには、ユーザーのアカウントに 開発者管理 ロールか 開発者 が割り当てられ、プロジェクトの作成および管理が可能となっている必要があります。プロジェクトにアプリやクラウドインスタンスを追加した方法でサービスを追加することができます。

サービス管理者は、開発者による様々なバックエンドシステムへのアクセスを可能とする新規 MBaaS マイクロサービスのプロビジョニングを実行できます。サービスがプロビジョニングされたら、プラットフォーム上のプロジェクト内で使用可能になります。デフォルトでは、サービスが作成されるとプライベートとマークされます。ドメイン上の全プロジェクトでサービスを利用可能とするには、「グローバルサービス」オプションを有効にする必要があります。これでこのサービスが公開で利用可能であることが宣言されます。

以下は特定のサービスに関連する概要情報になります。

Docs セクションには API ドキュメンテーションビューワが含まれており、以下のような各エンドポイント向けのサービス API の重要な要素が明確に表示されます。

API Blueprint 仕様に準ずる README.md ファイルがサービスの root ディレクトリーに含まれている場合、これらはすべて自動的に生成されます。仕様に関する詳細情報は API Blueprint Tutorial または Language Specification を参照してください。

ビルトインのエディターを使うことで、サービスインスタンスに関連したクラウドコードが編集できます。構文ハイライト表示の機能が組み込まれているため、構文要素を区別しやすくなっています。ユーザーはファイルやフォルダーを新規作成し、保存された変更は自動的に対応する Git リポジトリーにプッシュバックされます。

変更がなされたらプレビューが自動的にリフレッシュされるため、変更の反映がすぐに確認できます。'git pull' を実行すると、Git リポジトリーから変更がプルされます。

エディターのアプリプレビューでは、多くの選択可能なデバイスで現行アプリがどのように表示されるかを確認できます。

Studio を使用する環境変数は定義が可能で、これらの変数はクラウドコードでアクセスできます。Studio では、各クラウド環境における現在定義済みの環境変数とデプロイ済みの環境変数の一覧を表示します。また、システムが定義する環境変数一覧も見ることができます。

App Studio データブラウザーセクションでは、開発者は以下のことができます。

詳細情報は データブラウザーガイド を参照してください。

デプロイセクションでは、ユーザーは現行 mBaaS コードのデプロイメントを管理できます。デプロイメントターゲットを作成または選択し、デプロイをライブまたは開発環境にステージすることが可能です。クラウドインスタンスのデプロイの際には、デプロイメントログが表示され、ユーザーはデプロイの詳細を細かく調査することができます。

Studio では、アプリのエンドポイント統計値とカスタム統計値という 2 種類の統計があります。これらは、クラウドインスタンスの統計セクションにあります。

これらの統計数値を表すグラフには共通の UI 機能があります。データは異なる形式で (例: csv) ダウンロードできます。データの範囲は、各グラフの下にあるスクロールバーとスライダーで変更可能です。グラフ内の各行は、凡例のアイテムをクリックすることでオンとオフが切り替えられます。

アプリでは、アプリに対して特定のアクションが発生すると、イベントが生成されます。これらのイベントはプラットフォームが記録し、App Studio と FHC が開発者に提示します。例えば、開発者がアプリをデプロイすると、プラットフォームはデプロイの発生時間とデプロイ実行者、およびその結果を記録します。

イベントにはカテゴリー、重大度、および名前があります。現在プラットフォームが生成するイベントは以下の通りです。

ユーザーは、各アプリ環境で作成された現行およびアーカイブ済みのサービスログにアクセスできます。

エンドポイントセキュリティーの機能を使用すると、アプリのエンドポイントに適用するセキュリティーレベルを決定できます。