FHC での API キー管理に関連するコマンドは、fhc keys になります。引数なしでこのコマンドを実行すると、コマンドのヘルプが表示されます。

現行の FHC ターゲットにユーザー API キーを設定するには、以下のコマンドを入力します。

fhc keys user target eb8d9b9ea050b9b23fea59e50ba281c67f3715e5

現在 FHC に使用されている API キーを確認するには、以下のコマンドを実行します。

fhc keys user target

FHC で API キーを設定したら、他の FHC コマンドを通常通り実行できます。

例えば、FHC を使用してユーザー API キーの一覧表示、作成、更新、および取り消しができます。

FHC を使用してログインしている、またはユーザー API キーを設定している場合は、以下のコマンドを実行すると現行ユーザーに関連するすべての API キーが表示されます。

fhc keys user list

FHC config で出力形式が json に設定されていれば、各キーオブジェクトは以下のようになります。

{
  "key": "eb8d9b9ea050b9b23fea59e50ba281c67f3715e5",
  "keyReference": "1j6qcwiziRkbYy6sUUHDooAY",
  "keyType": "user",
  "label": "test 1",
  "revoked": "2012-04-20T15:18:17.258Z",
  "revokedBy": "1j6qcwiziRkbYy6sUUHDooAY",
  "revokedEmail": "dev@example.com"
}

ユーザー API キーを作成するには、以下のコマンドを実行します。

fhc keys user create test2

以下のような応答が返されます。

{
  "key": "22d0c0ac5990e8fd2c466c26db1a9eff8a171511",
  "keyReference": "1j6qcwiziRkbYy6sUUHDooAY",
  "keyType": "user",
  "label": "test2",
  "revoked": "",
  "revokedBy": "",
  "revokedEmail": ""
}

FHC を使用してユーザー API キーを更新するには、以下のコマンドを実行します。

fhc keys user update 22d0c0ac5990e8fd2c466c26db1a9eff8a171511 test3

以下のような応答が返されます。

{
  "key": "22d0c0ac5990e8fd2c466c26db1a9eff8a171511",
  "keyReference": "1j6qcwiziRkbYy6sUUHDooAY",
  "keyType": "user",
  "label": "test3",
  "revoked": "",
  "revokedBy": "",
  "revokedEmail": ""
}

FHC を使用してユーザー API キーを取り消すには、以下のコマンドを実行します。

fhc keys user revoke 22d0c0ac5990e8fd2c466c26db1a9eff8a171511

取り消しアクションの確認が求められます。確認すると、以下のような応答が返されます。

{
  "key": "22d0c0ac5990e8fd2c466c26db1a9eff8a171511",
  "keyReference": "1j6qcwiziRkbYy6sUUHDooAY",
  "keyType": "user",
  "label": "test3",
  "revoked": "2012-04-20T16:14:11.702Z",
  "revokedBy": "1j6qcwiziRkbYy6sUUHDooAY",
  "revokedEmail": "dev@example.com"
}

fhc login myUsername myPassword

プラットフォームにログインしたら、サービスを関連付けるプロジェクトを作成します。プロジェクトを作成するには、以下のコマンドを実行します。

fhc projects create serviceProject

プロジェクトが正常に作成されたことを確認するには、以下のコマンドを実行してドメイン上でプロジェクトを検索します。

fhc projects | grep 'serviceProject'

これで新規に作成されたプロジェクトが返されます。このプロジェクトには、クライアントアプリとクラウドアプリという 2 つのアプリがあることに留意してください。

サービスをプロジェクトに追加すると、この追加なしではアクセスできなかったバックエンド機能にクライアントがアクセスできるようになります。サービスを作成する前に、利用可能なテンプレートを確認してみましょう。サービステンプレートを一覧表示するには、以下のコマンドを入力します。

fhc templates services

これで利用可能なサービステンプレートすべてが一覧表示されます。ここでは PayPal サービスをプロジェクトに追加します。これを実行するには、PayPal サービス の ID をコピーします。

サービスの作成時には、名前も指定する必要があります。以下のコマンドを実行します。

fhc services create paypalService paypal

これでプロジェクトに関連付けられる新規サービスが作成されました。

fhc を使用したビルドでは、多くのパラメーターを指定する必要があります。これはビルドのタイプや使用先となるプラットフォームによって異なります。プロジェクトおよびアプリに関する作業 のチュートリアルでは、プロジェクトの一部として cordova ハイブリッドアプリを作成しました。ここでは、このアプリを使用して Android 用のビルドを実行します。

fhc build コマンドは以下のパラメーターを取ります。

すべてのビルドタイプにおいてこれらの全パラメーターが必要なわけではありません。詳細は、fhc build --help コマンドを実行してください。

アプリのビルド時には、アプリ ID に加えてアプリが格納されているプロジェクトを fhc に指定する必要があります。その後にクライアントアプリの通信先となるクラウドアプリの ID を入力します。クライアントアプリは、接続によりクラウドアプリに向けられます。クライアントは色々な接続によって異なるクラウドアプリと通信することが可能なため、ビルド実行時には使用する接続タグを指定する必要もあります。

fhc build project=XME5iUr2VoBV3DbXrVF7qApG app=XME5iNsoeRA2xvbmaDYMCdsi cloud_app=XME5iHzfwW9hcGw6_F7Eiwvf tag=0.0.3 destination=android config=debug keypass= certpass= download=true

ビルドが完了すると、以下のような確認の出力が表示されます。

Download URL: Download URL: https://ngui-demo.sandbox.feedhenry.com/digman/android-v3/dist/3e0837f2-76b6-4512-881c-bd3bf427929d/android~4.0~7~HelloWorldClient.apk?digger=diggers.digger206u

fhc artefacts XME5iUr2VoBV3DbXrVF7qApG XME5iNsoeRA2xvbmaDYMCdsi