v2 Studio では、アプリはハイブリッドアプリ、Web アプリ、クラウドアプリ、および場合によってはネイティブ iOS または Android アプリすべてを表します。v3 Studio では、アプリはこれらのコンセプトの 1 つを表します。アプリはクラウドアプリまたはネイティブ iOS アプリのいずれかであり、両方ではありません。v3 Studio では、機能とプラットフォームを分けるためにさまざまなアプリの種類が提供されます (ただし、これらのアプリはプロジェクトでグループ化できます)。

v2 から v3 の Studio に移行する最大の利点は、新しい複数の機能を利用できることです。プロジェクトワークフローにより、開発ライフサイクル全体でプロジェクト内の複数のアプリを簡単に管理できるようになります。v3 の各アプリは、ホストされた git リポジトリーによって支持されます。これらのアプリは、SSH キーをアップロードするだけで使用できます。

v2 Studio は引き続きサポートされますが、v2 Studio では新しいプラットフォームの機能は使用できません。

v2 アプリを個別に v3 プロジェクトに移行するために、v2 Studio では自動移行機能が利用できます。この移行プロセスの詳細を知りたい場合、またはアプリを手動で移行する場合は、詳細なアプリ移行ガイドを参照してください。

Studio アプリ移行機能はドメイン内のすべてのアプリで利用可能です。ただし、アプリによっては移行が簡単でない場合があります。Studio は、検証チェックを実行して自動移行がアプリに適しているかどうかを判断しようとします。このチェックは非破壊的であり、アプリにはまったく変更が加えられません。この機能を実行して移行しないことを決定することができます。

アプリのサイズに応じて、検証チェックには数秒から最大 1 分かかります。検証チェック後に、移行を自動的に行えるかどうかを通知する視覚的なレポートが生成されます。このレポートには、アプリで検出されたことと移行で注意する必要がある潜在的な問題 (警告) に関する情報が示されます。作業を円滑に進めるために、移行前にすべての問題を解決する (または問題の解決を計画する) ことが重要です。

検証チェックが何らかの理由で失敗した場合は、エラーが表示されます。可能な場合は、移行のためにアプリを再び検証しようとする前にエラーを修正する必要があります。手動による移行が唯一の選択肢となることもあります。不確かな移行の問題またはサポートが必要な移行の問題は、https://access.redhat.com から報告できます。

検証チェックが成功した場合は、Migrate ボタンが表示されます。このボタンを押すと、移行が開始され、進捗のフィードバックがリアルタイムで提供されます。移行が成功すると、小さなレポートが作業途中で検出されたすべての潜在的な問題とともに表示されます。 強調表示された問題は、v3 Studio を最大に活用するのに重要である場合があるため、完全に理解することをお勧めします。

移行中に問題が発生した場合は、プラットフォームにより、すべての変更がロールバックされ、アプリが移行前の状態に復元されます。繰り返しますが、この移行ステージで発生したすべての問題は、https://access.redhat.com で報告できます。

複数のアプリを移行する場合は、移行をスクリプト化すると便利です。これは、fhc migrate コマンドを使用して行えます。以下に例を示します。

fhc migrate <appid>

migrate コマンドにより、最初に検証チェックが実行され、問題がない場合に、続行するか尋ねられます。

ドメイン内のすべてのアプリを自動的に移行する場合は、以下のスクリプトを土台として使用できます。

#!/usr/bin/env node
var fh = require('fh-fhc');
var async = require('async');

// Init fhc
fh.fhc.load(function (err) {
  if (err) return console.error(err);
  // Target my domain and login
  fh.target(['https://testing.feedhenry.me','testing@example.com','password'], function(err, ok) {
    if (err) return console.error(err);
    console.log('ok:', ok);
    // List all apps
    fh.apps([], function(err, apps) {
      if (err) return console.error(err);
      console.log('apps:', apps);
      // Iterate over apps, calling migrate for each
      async.mapSeries(apps.list, function(app, cb) {
        // Passing 'silent' here will bypass prompt after validation check if check is ok
        fh.migrate([app.id, 'silent'], function(err, data) {
          if (err) return cb(err);
          console.log('data:', data);
          return cb(null, data);
        });
      }, function(err, results) {
        if (err) return console.error(err);
        // all done
        console.log('results:', results);
      });
    });
  });
});

この例は、gist (package.json を含む) としても利用できます。

v2 アプリは v2 Studio でのみ確認できるアプリです。Web アプリとしてホストし、デバイスに対してビルドおよびデプロイして、実行されているサーバーサイドコンポーネントを Node.js (または従来の Rhino) 環境にデプロイできます。

これらすべての機能は、一意の ID である GUID (Globally Unique Identifier) を持つ単一のアプリに割り当てられます。単一のコードベースはプラットフォームに格納できます (Studio と API を介してのみアクセスできます)。また、git リポジトリー (パブリックまたはプライベート) に格納して、Studio からリンクすることもできます。上記の各機能を単一のコードベースからサポートすると、厳密なディレクトリー構造が強制されます。この構造は以下のとおりです。

すべての機能は単一のアプリ guid に割り当てられるため、このアプリにより表されるさまざまな Web アプリまたは Cordova アプリはクラウドコードに密接に結合されます。つまり、このアプリの実行中のクラウドコードとのみ対話します。

v3 アプリは v3 Studio でのみ確認できるアプリです。すべての v3 アプリはプロジェクトの一部です。v3 アプリの機能はアプリの種類 (Cordova アプリ、クラウドアプリ、ネイティブ iOS など) によって異なります。一般的に v2 アプリの個別機能は v3 アプリタイプにマップされます。たとえば、v3 アプリタイプがクラウドアプリの場合は、Node.js コードをクラウド環境にデプロイできます。タイプが Cordova Light の場合は、Web コンテンツ (html、css、js) を使用してさまざまなプラットフォーム用のネイティブアプリバイナリーをビルドできます。各アプリタイプは特定の機能を考慮して設計されているため、特にチームで開発を容易に管理できます (懸念事項の切り分けが可能)。

v3 Studio では、確認するアプリタイプで利用できる機能のみが表示されます。たとえば、確認するアプリが Cordova Light アプリタイプである場合は、Build オプションが表示されますが、Deploy オプションは表示されません。(新しい) ネイティブ iOS アプリを確認する場合は、Build オプションが表示されますが、Config オプションと Push オプションは表示されません (これらは Cordova と類似したアプリであるため)。

各 v3 アプリには、独自の git リポジトリー (プラットフォームでホストされる) により支持された独自のコードベースがあります。つまり、厳密なディレクトリー構造はありません。たとえば、クラウドアプリの場合は、git リポジトリーのルートにファイル package.json と application.js があります。一般的に、ルートにコードを配置することが適切な場合、プラットフォームはビルド時またはデプロイ時にその場所でコードを探します。この唯一の例外は Cordova Light アプリです。このアプリでは、すべての Web コンテンツ (HTML、CSS、JS) を /www フォルダーに保持する Cordova の規則に従います。これにより、ビルドスクリプトと他の非本番稼働コンテンツをビルドされるアプリに含めずに保守することが簡単になります。

v3 Studio では、プロジェクトはアプリの論理的なグループです。プロジェクトのクライアントアプリが (接続を介して) 同じプロジェクトのクラウドアプリまたはデプロイ済みアプリに API 呼び出しを行うよう設定できます。プラットフォームの一部の機能 (フォーム、接続、レポートなど) はプロジェクトに関連付けられます。また、プロジェクトにはサービスも関連付けられます。サービスは、サードパーティー製システムとの事前定義された統合です。プロジェクトにはコードベースと独自の特別な機能がないため、プロジェクトをビルドまたはデプロイすることはできません。

v3 Studio では、アプリは独自に存在することはできません。アプリはプロジェクトに属する必要があります。v2 アプリを v3 Studio に移行する場合は、ベアプロジェクトを選択することをお勧めします。これにより、アプリがない状態で新しいプロジェクトが作成されます。

package.json を更新するには、以下の手順に従ってください。

グローバルの $fh は使用されなくなりました。必要な場合は作成できますが、代わりに fh に置き換えることが推奨されます。

fh-mbaas-api/fh-mbaas-express の場合、application.js ファイルは大幅に異なります。既存の application.js を Hello World テンプレートアプリの最新の application.js ファイルに置き換えることが推奨されます。

これはオプションですが、使用することを強く推奨します。新しい FeedHenry テンプレートは、ローカル開発とテスト向けのベストプラクティスの支援のために Grunt を頻繁に使用します。

アプリで Grunt を使用するには、Hello World Cloud テンプレートの該当する Grunt 部分をコピーすることをお勧めします。

FeedHenry v2 では、Embed 宛先を使用して、プラットフォームでクライアントコードを Web アプリとしてホストできました。これは既存のクライアントアプリの単純な HTML ベース Web ポータルを作成する場合に便利でした。

RHMAP Studio では、組み込みアプリが非推奨になり、基本的な Web アプリに置き換えられました。基本的な Web アプリは、アプリを組み込む以前の FeedHenry v2 オプションと同じ機能を提供します。また、ライフサイクル管理のために index.html 、アプリの実行方法と実行場所、および個別の Git リポジトリーを完全に制御することもできます。

アプリを RHMAP プロジェクトに移行した後で、組み込みアプリは引き続き実行されますが、既存の組み込みアプリを再デプロイすることはできなくなります。本書では、RHMAP プロジェクトで既存の組み込みアプリを新しい基本的な Web アプリに移行する手順について説明します。

移行を開始するために、既存の FeedHenry v2 アプリを RHMAP プロジェクトにすでに移行したことを前提とします。まだ移行していない場合は、ここにあるガイドを参照してください。

ロールベースのパーミッションシステムでは、ロールは以下の 3 つのレベルのユーザーに割り当てられます。

チームに割り当てられる以下のパーミッションにより、アナリィティクスへの同等のアクセスが許可されます。

チームに割り当てられる以下のパーミッションにより、フォームへの同等のアクセスが許可されます。

チームに割り当てられる以下のパーミッションにより、フォームへの同等のアクセスが許可されます。

チームに割り当てられる以下のパーミッションにより、フォームへの同等のアクセスが許可されます。

チームに割り当てられる以下のパーミッションにより、フォームへの同等のアクセスが許可されます。

チームに割り当てられる以下のパーミッションにより、同等のアクセスが許可されます。

チームに割り当てられる以下のパーミッションにより、同等のアクセスが許可されます。

チームに割り当てられる以下のパーミッションにより、同等のアクセスが許可されます。

チームに割り当てられる以下のパーミッションにより、同等のアクセスが許可されます。

チームに割り当てられる以下のパーミッションにより、同等のアクセスが許可されます。

チームに割り当てられる以下のパーミッションにより、同等のアクセスが許可されます。