第4章 プロジェクトおよびアプリに関する作業

概要

プラットフォームでは、プロジェクトは関連アプリをまとめるコンテナーとして使用されており、アプリはすべてプロジェクト内で作成する必要があります。以下では、fhc を使用してプロジェクトを作成、追加する方法について説明します。

要件

以下のチュートリアルを終了していることを前提としています。

4.1. プラットフォームへのログイン

端末に fhc targets を入力して利用可能なターゲットドメインを一覧表示します。

fhc targets list

fhc target コマンドを使用してターゲットドメインを選択します。

fhc target exampleDomain.redhatmobile.com
注記

上記のコードでは、'exampleDomain.redhatmobile.com' がターゲットドメインとして選択されます。

これでターゲットドメインが選択されました。ログインするには、fhc login の後にユーザー名とパスワードを続けます。

fhc login username@example.com password
注記

ログインが完了したら、アクセス制限が適用されます。チームパーミッションでプラットフォーム内のユーザーのアクセスレベルが決定されます。詳細は、チームおよびコラボレーション を参照してください。

4.2. 既存プロジェクトの一覧表示

既存のプロジェクトを一覧表示します。

fhc projects list
注記

プロジェクト一覧を raw JSON 形式としたい場合は、fhc projects list --json のようにコマンドの最後に --json を追記します。

既存プロジェクトが最新更新日の順番で表示されます。例を示します。

--------------------------------------------------------------------------
| Id                       | Title            | No. Apps | Last Modified |
--------------------------------------------------------------------------
| 1234567890abcdefghijklmn | Hello World      | 3        | 3 hours ago   |
--------------------------------------------------------------------------
| 9876543210zyxwvutsrqpomn | Welcome to RHMAP | 2        | 3 hours ago   |
--------------------------------------------------------------------------

4.3. プロジェクトの作成

クライアントアプリやクラウドアプリを含まない新規プロジェクトを作成することは可能ですが、プロジェクトには名前を付けることが必要ですfhc projects create を使用してプロジェクトを作成します。

通常、新規プロジェクトは事前定義のテンプレートを使用して作成します。プロジェクトテンプレートを使用すると、普通は 1 つのクライアントアプリと 1 つのクラウドアプリを提供するプロジェクトテンプレートをクローンすることで開発をブーストラップすることができるようになります。

プロジェクトについての詳細は、プロジェクト を参照してください。

このチュートリアルでは、hello_world_project テンプレートを使用します。これは 1 つのクライアントアプリと 1 つのクラウドアプリを提供する基本的なプロジェクトで、標準の Hello World パラダイムを使用して基本的な機能が説明されます。

全プロジェクトテンプレートを一覧表示するには、以下を実行します。

fhc templates projects

hello_world_project テンプレートをベースにした新規プロジェクトを作成するには、以下を実行します。

fhc projects create helloWorld hello_world_project

以下を実行してプロジェクトが正常に作成されたことを確認します。

fhc projects list

別の方法では、以下のように fhc projects コマンドの出力を grep コマンドでパイプすることで、特定のプロジェクトを検索することもできます。

fhc projects list | grep 'helloWorld'

# Example:

XME5iUr2VoBV3DbXrVF7qApG ┃ helloWorld  ┃ 2  ┃ 3 minutes ago
# ProjectId | Title | Number of apps | Minutes since last update

コンソールの出力にクライアントアプリとクラウドアプリが含まれる、最近作成されたプロジェクトが表示されます。

プロジェクト内の全アプリを一覧表示するには、projectId ('guid' (Global Unique IDentifier) とも呼ぶ) を選択し、fhc apps と使用します。

fhc projects # lists all projects. Next, select a projectId

fhc apps <the_selected_project_guid>

これで指定された projectId のアプリすべてが表示されます。

  • Id - アプリの guid。
  • Title - アプリのタイトル。これはモバイルデバイス上でクライアントアプリのアプリ名として使用されます。
  • Description - アプリの説明。デフォルトでは空白になります。
  • Type - アプリのタイプ。プラットフォームが異なるアプリタイプを区別するために使用します。
  • Git - アプリの Git URL。これはローカル開発用にアプリをクローンする際に使用できます。
  • Branch - プラットフォームでアプリコードを編集するために現在選択されているブランチ。

4.4. プロジェクトにアプリを追加する

プロジェクトには複数のアプリを含めることが可能ですが、相互に関係の内アプリは別個のプロジェクトに格納するようにします。アプリは通常、既存のアプリテンプレートを使ってプロジェクトに追加されます。クライアントおよびクラウドアプリの両方に多くのテンプレートが用意されています。

以下を実行して利用可能なアプリテンプレートを一覧表示します。

fhc templates apps

クライアントアプリをプロジェクトに追加するには、以下のコマンドを使用して、<projectId><appTitle> の名前、および <appTemplate> を指定します。

fhc app create --project=<projectId> --title=<appTitle> --type=<type> --template=<appTemplate>

 #The following example illustrates the creation of a new project

fhc app create --project=xe2cbz3cky6zfxq2ca66t55u --title='My Native iOS App' --type=client_native_ios --template=native_ios_swift_blank_app
注記

テンプレートが指定されない場合は、空のクライアントアプリが作成されます。

プロジェクト内の全アプリを一覧表示して、アプリが正常に作成されたことを確認します。

4.5. 次のステップ