Even Hub CLI 0.2.0 で、G2アプリをCLIだけで自分向けベータ配信する


7月の記事「Even Hub G2で最初のアプリを作る」の最後で、「提出は Web ポータル上での手動アップロードが必要で、CLI に提出コマンドはありません」と書きました。その後、2026年10月20日に公開された Even Hub CLI(@evenrealities/evenhub-cli。CLI はターミナルから使うコマンドラインツールのことです)の 0.2.0 で、アプリの作成、新しい版のアップロード、ベータチャンネルへの配信、テスターの招待ができるコマンドが追加されました。

そこで今回は、7月に作ったアプリ「G2 Demo」(package_id は dev.y16ra.g2demo)の新しい版 1.0.1 を、CLI だけでベータチャンネルに出し、自分の Even アプリから開くところまで試しました。コマンドの仕様は、npm パッケージに含まれる README と CHANGELOG、公式ドキュメントの Beta Testing に基づいています。公式の CLI のページは、この記事を書いた時点ではまだ v0.1.14 の内容で、Beta Testing のページもポータルでの手順だけなので、CLI のコマンドについては README を参照しています。公式の資料に書かれていない、私の環境で起きたことは「私の環境では」と前置きして書きます。


1. 今回のアプリの変更

1.0.1 では、y16ra/g2-app-demo の PR #2 でタップカウンタに二つの操作を足しました。

  • 上スワイプで +1、下スワイプで −1 します。回数のカウンタなので、0 より下には減らしません。
  • カウントを保存し、アプリを開き直すと続きから表示します。保存先は Even Hub SDK(Software Development Kit。アプリから G2 やスマートフォンの機能を使うためのライブラリ)の bridge.setLocalStorage を優先し、同じ値を window.localStorage にも書いています。

自動レビュー(Cursor Bugbot)から2件の指摘があり、どちらも直しました。一つは、ブリッジからの読み込みに失敗したときに、まだ読めていない保存値を上書きしてしまう問題です。もう一つは書き込みのタイミングの問題で、書き込みは同時に1件だけにし、途中で変わった値は最後のものだけを後から送るようにしました。

ここまでの動作は、PR #2 ではシミュレーター(evenhub-simulator 0.9.5)で確かめ、その後に実機のベータ版でも確かめました(4節)。

2. 0.2.0 で増えたもの

CHANGELOG によると、0.2.0 の主な追加は次のとおりです。

  • アプリ管理のコマンドとして create、upload、update、ls、download、rm、promote、delist、testers、logout が加わりました。
  • すべてのコマンドに --json が付きました。標準出力には JSON オブジェクトが一つだけ出て、警告や進捗は標準エラー出力に回ります。
  • 失敗の種類ごとに終了コードが決まりました。たとえば 9 は「手元の処理で失敗し、サーバー側は何も変わっていない」、11 は「サーバー側の変更は終わったが、その後の手元の処理で失敗した」という意味です。
  • 名前、説明、変更履歴、メールアドレス、アイコンなどは、送信する前に手元で検証されます。
  • create や upload が途中で止まったときは、サーバー側の下書きが残っている30分以内なら、続きから再開できます。

一方で、README には「公開のための審査と公開はポータルで行う」とあります。CLI でできるのはベータ配信までです。

3. やったこと

環境は Linux、Node.js v20.19.2、npm 9.2.0 です。

npm i -g @evenrealities/evenhub-cli@0.2.0
evenhub --version    # 0.2.0
cd my-first-app && npm ci && npm run build

7月にポータルからアプリを登録済みだったので、新しいアプリを作る create は使いません。pack で .ehpk(Even Hub のアプリパッケージ)を作り、upload、promote --to beta、testers add の順に実行しました。README によると、ベータ版を入れるのに必要なのは、承認済みのテスターであることと、ベータチャンネルにビルドがあることの二つです。そのため、promote と testers add はどちらを先にしてもかまいません。

3-1. pack では —sdk-ver を指定する

最初は、7月と同じように --sdk-ver なしで pack しました。

evenhub pack --json app.json dist -o g2demo-1.0.1.ehpk
{"package_id":"dev.y16ra.g2demo","version":"1.0.1","min_app_version":"2.2.10","size":31864,"ok":true,
 "warnings":["app.json sets min_app_version 2.0.0, below SDK 0.0.16's floor 2.2.10 (SDK from npm latest, no --sdk-ver). Stamping the higher value, 2.2.10. ..."]}

成功はしていますが、警告が出ています。pack は npm にある最新の SDK(このときは 0.0.16)を基準にして、パッケージの min_app_version(アプリを動かせる Even アプリの最低バージョン)を 2.2.10 に引き上げていました。このアプリが実際に使っている SDK は 0.0.12 です。そのままでは、必要以上に新しい Even アプリを要求するパッケージになってしまいます。

そこで、--sdk-ver で実際の SDK のバージョンを指定して作り直しました。--sdk-ver は 0.2.0 ではなく、7月の記事のあとの 0.1.14 で追加されたオプションです。

evenhub pack --json --sdk-ver 0.0.12 app.json dist -o g2demo-1.0.1.ehpk
{"package_id":"dev.y16ra.g2demo","version":"1.0.1","min_app_version":"2.2.5","size":31865,"ok":true, ...}

今度は min_app_version が 2.2.5 になりました。SDK 0.0.12 には npm 上に最低バージョンの情報がないので、CLI に同梱されている対応表の値が使われています。README によると、この引き上げはパッケージ内のマニフェストに対してだけ行われ、手元の app.json は書き換えられません。古い SDK で作ったアプリを pack するときは、--sdk-ver を付けておくのがよさそうです。

3-2. login だけは手で打つ

evenhub login --json -e <メールアドレス>

パスワードは対話式のプロンプトで入力します。フラグや環境変数でパスワードを渡す方法はありません。README にも、login は対話できる端末が必要なので一度だけ手で実行する、と書かれています。資格情報は ~/.config/evenhub/credentials.yaml に保存され、ほかのコマンドはそれを使うので、login 以外はスクリプトから実行できます。期限が切れたアクセストークンは自動で更新され、更新用のトークンも切れると終了コード 2 で止まります。

ログインできたかどうかは evenhub self-check --json で確かめられます。

3-3. 既存のアプリを確かめる

evenhub ls --json --channels
{"apps":[{"package_id":"dev.y16ra.g2demo","name":"G2 Demo","latest":"0.1.0","status":"Private","beta":null,"public":null}],"total":1,"ok":true}

7月にポータルから出した 0.1.0 が、非公開(Private)のまま残っていました。ベータにも公開にも、まだ何も出ていません。

3-4. upload

evenhub upload g2demo-1.0.1.ehpk --json -m "Swipe up/down ±1 and resume saved count"
{"package_id":"dev.y16ra.g2demo","version":"1.0.1","status":"Private","size":31865,
 "next":"evenhub promote 1.0.1 --to beta --package-id dev.y16ra.g2demo","ok":true}

-m(変更履歴)は必須で、500字までです。同じバージョンをもう一度アップロードすると終了コード 4 になるので、新しい版を出すときは app.json の version を上げてから pack し直します。

出力の next に、次に打つコマンドがそのまま入っていました。どのコマンドも --json で JSON オブジェクトを一つだけ返し、多くの場合 next に次の手順が入るので、スクリプトからも人の手でも迷わずに進められます。

3-5. promote —to beta

evenhub promote 1.0.1 --to beta --package-id dev.y16ra.g2demo --json
{"package_id":"dev.y16ra.g2demo","branch":"beta","version":"1.0.1",
 "next":"Active testers can install this beta build manually in the Even app.","ok":true}

promote で出せるのはベータチャンネルだけです。公開チャンネルを指定すると、サーバーに送る前に CLI が手元で断ります。

3-6. 自分をテスターに招待する

next にあるとおり、ベータ版を入れられるのは Active なテスターだけです。私の環境では、開発者本人でも自動ではテスターにならないので、自分のメールアドレスを招待しました。

evenhub testers add <メールアドレス> --package-id dev.y16ra.g2demo --json
{"invited":["<メールアドレス>"],"skipped":[],"reinvited":[],"case_variants":[],"ok":true}

最後に evenhub testers --json で見ると、状態は Invited(招待済み)でした。招待メールで承認すると Active になり、そこで初めてベータ版を入れられるようになります。

README によると、招待の有効期限は7日です。期限内にメールのリンクが見つからないときは、--reinvite を付けると招待を送り直せます。このとき、前のメールのリンクは使えなくなります。すでに Invited や Active の人を同じ表記でもう一度 add しても、送り直されずにスキップされるので、同じコマンドを何度実行しても大丈夫です。

最後にもう一度 ls で確かめると、ベータチャンネルに 1.0.1 が入っていました。

{"apps":[{"package_id":"dev.y16ra.g2demo","name":"G2 Demo","latest":"1.0.1","status":"Private","beta":"1.0.1","public":null}],"ok":true}

今回は、すべてのステップが終了コード 0 で終わりました。

4. Evenアプリからベータ版を開く

スマートフォン側の手順は次のとおりです。

  1. 届いた招待メールを開いて、招待を承認します。メールの件名は「You’re invited to test G2 Demo on Even Hub」で、本文の「Accept and install」ボタンから承認とインストールを進めます。メールには、インストールするとプラグインの開発者にデータが共有されることへの同意も書かれています。共有されるのは、ユーザー情報(名前、UID(ユーザーを識別する ID)、プロフィール画像、国)、端末情報(機種、シリアル番号、状態)、端末の使い方の情報(テーマ、言語)、端末の状態(接続方法、バッテリー、装着しているか、画面のオンオフなど)、端末の操作データの5つです。

    招待メールの本文。「Accept and install」ボタンと、プラグインの開発者へのデータ共有への同意についての説明が表示されている

  2. Even アプリで「マイプラグイン」を開き、「ベータ版」に切り替えます。

  3. 一覧に出てきた「G2 Demo」の「開く」をタップします。

この手順でベータ版をインストールし、実機で動作を確認しました。スワイプでの増減も、アプリを閉じて開き直したときにカウントが続きから表示されることも、実機のベータ版で確かめています。

Evenアプリのマイプラグインで「ベータ版」を選ぶと、G2 Demo のバージョン 1.0.1 と「開く」ボタンが表示されている画面

私の環境では、Even アプリの画面は「マイプラグイン」と「ベータ版」という表示でした。公式ドキュメントの説明(Me → Beta tester)とは名前が違うので、見つからないときは両方を探してみてください。

app.json にアイコンを指定していなかったので、一覧のアイコンは「?」の仮のものになっています。既存のアプリへの upload では、アイコンの検証は行われませんでした。

公式ドキュメントによると、ベータ版のインストールは実際のユーザーがアプリを入れたときと同じ動きになります。localStorage などに保存したデータも、本番と同じように残ります。今回のようにカウントを保存するアプリでは、まっさらな状態から試したいときに、自分で保存値を消す必要があります。

5. 公開はポータルから

ベータの次の公開(審査への提出)は、これまでどおり Even Hub のポータル で行います。evenhub ls dev.y16ra.g2demo --json --verbose の出力にも、「審査と公開はポータルのアプリ画面の Builds から」という案内が入っていました。

公式ドキュメントの Beta Testing には、提出前にベータ版で確かめておく項目の一覧があります。スマートフォンをロックして5分待っても状態が残っているか、ルートページでダブルタップしたときにシステムの終了確認が出るか、などです。審査に出す前に、この一覧をベータ版で一通り試しておくつもりです。

また、公式の App Submission & QA Guidelines では、app.json の min_sdk_version は 0.0.14 以上が求められています。このアプリの app.json は 0.0.7 のままで、ベータ配信はこれで通りましたが、審査に出すときには見直す必要がありそうです。


まとめ

  1. Even Hub CLI 0.2.0 で、アプリの作成、新しい版のアップロード、ベータ配信、テスターの招待が CLI からできるようになりました。7月に書いた「CLI に提出コマンドはない」は、ベータ配信までについては当てはまらなくなりました。
  2. 登録済みのアプリなら、pack、upload、promote --to beta、testers add で進められます。promote と testers add は、どちらを先にしてもかまいません。
  3. pack は、0.1.14 で入った --sdk-ver を付けないと、npm の最新 SDK を基準に min_app_version を引き上げます。古い SDK で作ったアプリでは、実際の SDK のバージョンを指定します。
  4. login だけはパスワードを対話式で入力する必要があります。一度ログインすれば、ほかのコマンドはスクリプトから実行できます。
  5. 開発者本人も自分をテスターに招待し、招待メールで承認してから、Even アプリの「マイプラグイン」→「ベータ版」で開きます。招待は7日で切れ、--reinvite で送り直せます。
  6. 公開のための審査と公開は、引き続きポータルで行います。

参考リンク