mcpField
Q
quest-store

quest-store

github.com/ssheleg開発186 回インストール3 日前に更新
リポジトリ

quest-store について

quest-store は、Quest アプリ開発者向けに Meta Horizon Store での公開と配布を支援するスキルです。チャンネルの動作、リリース用パッケージ、審査要件、アップロードと昇格の手順を扱います。

主な機能

  1. 01リリースチャンネルと審査の案内
  2. 02パッケージとマニフェストの確認
  3. 03ストア申請準備チェックリスト
  4. 04ビルドのアップロードとチャンネル昇格コマンド

活用シーン

  1. 01テスター向け ALPHA ビルドの準備
  2. 02Production 審査前のアプリ確認
  3. 03ストアチャンネル間でのビルド昇格

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/ssheleg/xr-dev --skill quest-store

インストール後、Claude Code で/quest-storeを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

references/
launch-and-growth.md
production-readiness.md
store-asset-production.md
vrc-checklist.md

詳細

Meta Horizon Store へのリリース

スケジュールの大半を左右する事実は2つあります。アルファを含むすべてのアップロードは、完全なリリース用パッケージ要件を満たす必要があります。 また、レビューが実施されるのは Production チャンネルだけです。ビルドをここに置いただけでは何も起こりません。提出情報を入力し、「Submit for Review」をクリックする必要があります。

リリースの計画時や製品の準備状況の監査時には、references/production-readiness.md をお読みください。アーティファクトの識別情報、マニフェストの競合、アカウント、購入、セーブデータ、ソーシャル機能、プライバシー、レビュー用の証拠、リリース後の復旧について記載されています。

製品全体のロードマップや各段階の監査には quest-lifecycle を使用してください。単一の技術タスクはこの担当に任せます。見つからない場合は、現在の段階、その証拠、次の前提条件をその場で特定してください。

商用設定、ローンチ前の判断、収益化テスト、マーケティング、ローンチ後の運用については references/launch-and-growth.md をお読みください。撮影、ストア掲載情報の制作、または生成アセットのレビューに着手する前に、references/store-asset-production.md をお読みください。

4つのチャンネル

チャンネル対象者レビュー
ALPHA招待制、最初は空 — あなたでさえ対象外なし
BETA招待制なし
RC招待制なし
Production(Store)利用資格のある全員技術レビュー+コンテンツレビュー
  • メールアドレス、エイリアス、URLで招待するか、チャンネルを公開にしてユーザー自身が登録できるようにします。デフォルトの上限はチャンネルごとに200ユーザーで、申請すれば最大2,500人まで増やせます。
  • テスターには、Library と My Preview Apps にビルドが表示されます。
  • 承認済みのビルドを Production にコピーすると、利用資格のあるすべてのユーザーに更新が配信されます。
  • 韓国のテスターに配信する場合は、独自の GRAC レーティング要件があります。

重要な点として、最初のプレイ可能なビルドは、リリース用ビルドと同じ形式でパッケージ化されていれば、Meta のレビューをまったく受けずに実際のテスターに届けられます。

レビューの流れ

  1. 技術レビュー — Virtual Reality Checks(VRC)です。不合格の場合はレビュー指摘が返されますが、残っている不具合がすべて列挙されるとは限らないため、注意してください。
  2. コンテンツレビュー — 技術レビュー通過後に、完全性、完成度、価値が確認されます。
  3. 承認 — その後、リリース日を即時または予約で設定できます。

目標のローンチ日の少なくとも2週間前に計画してください。競争の激しいカテゴリでは、最初に見つかった違反の時点でレビューが止まる場合があります。そのため、自分で事前確認する方が、差し戻しを受けるより低コストです。プラットフォーム機能を使うアプリは、提出前にData Use Checkupを申請する必要があります。有効な DUC がなければ、プラットフォーム機能はテストユーザーに制限されます。

修正が遅れるほどコストがかかる項目別のチェック内容

グループビルドが不合格になる主な項目
パッケージングマニフェストがリリース仕様に準拠(.1)、v2署名(.2)、サポート対象外の Android 機能なし(.3)、サポート対象の SDK/エンジン(.4)、APK は 1 GB 未満、OBB は 4 GB 未満(.5)、64ビットのみ(.6)
パフォーマンス宣言したリフレッシュレートで動作(.1)、ヘッドトラッキング対応のグラフィックス、または4秒以内に表示される VR ローディングインジケーター(.3)、レンダリングスケーリングは85%以上を推奨(.4)
機能クラッシュやフリーズがない、OSからの要求に応じて一時停止する、ユーザーが先に進めなくならない、データ損失がない、ポジショナルトラッキングに対応する、利用資格のある複数のユーザーで動作する、MR Home から起動した際にパススルーのローディング画面を表示する
入力フォーカスを認識する — レンダリングを続け、手を非表示にし、入力を無視する(.4)。ハンドトラッキングアプリは、予約済みのシステムジェスチャーを尊重する必要があります
セキュリティ権限は最低限にし、サポート対象外の権限を使わない(.2)。10秒以内のエンタイトルメントチェックは推奨事項であり、必須要件ではありません(.1)
アセット背景が透明なロゴ、カバーアートの上部20%と下部20%にテキストを入れない、他プラットフォームのハードウェアが写っていない代表的なスクリーンショット、2分以内のトレーラー、24 pt 以上のテキスト

イマーシブアプリと2Dアプリのどちらに適用されるかを含む完全な表は、references/vrc-checklist.md にあります。提出前に最新のリストを取得してください。要件は廃止されたり追加されたりします(VRC.Quest.Performance.2 は本日時点で RETIRED です)。

リリース用マニフェストは開発用マニフェストではありません

開発要件と提出要件は別々の文書であり、レビューで適用されるのは後者だけです。アップロードする前に、次の点を確認してください。

  • android:debuggable は false または未指定にします。デバッグビルドではなく、リリースビルドにしてください。
  • installLocation="auto" を設定し、android:label は一意にします。
  • 没入型アプリの場合:android.hardware.vr.headtracking を required="true" にします。2D パネルアプリでは、この設定を省略するか、required="false" にします。
  • OpenXR アプリの場合:現在の Meta リリースページには、MAIN/LAUNCHER と並んで com.oculus.intent.category.VR が記載されています。マージ済みの APK を確認し、SDK/ランタイムが必要とする追加カテゴリは、意図をもって残してください。
  • リリース用の起動アクティビティ:android:excludeFromRecents="true" にします。
  • SDK レベル:2026 年 3 月 1 日以降に作成されたアプリは 34 をターゲットにする必要があります。ライフサイクル内のデバイスでは、min 32/target 34/compile ≥ target を推奨します。
  • APK 署名スキーム v2 で署名し、キーストアをリポジトリに含めないでください。

quest-native も、ビルド側で同じ要件を満たします。

アップロード

metavr store dist apps                       # app ids in the organization
metavr store dist channels --app-id <ID>     # channels and their latest builds
metavr store dist upload --app-id <ID> --channel ALPHA --apk build.apk \
  --notes "what changed"                     # a DRAFT upload unless --publish
metavr store dist copy-build ...             # promote between channels
metavr store test-user ...                   # FRL test accounts for the org

このフラグの LIVE はストアチャンネルです。Oculus Platform Command Line Utility(metavr tools install platform-utils)も同じ処理を行い、大きなパッケージには 差分パッチを適用します。MQDH はその GUI ラッパーです。アップロードの検証では、パッケージの問題はアップロード後に報告されるため、修正のための作業時間を見込んでください。

アップロードごとに versionCode を増やす必要があります。増やさないとアップロードは拒否されます。テスターに表示されるバージョンは versionName です。

2 つの審査段階に対応するチェックリスト

初回の ALPHA アップロード前:リリース用マニフェスト、v2 署名、64 ビット、サイズ制限、versionCode の更新、実機のヘッドセットをコールドブートした状態から起動できること。

Production 前:上記すべてに加え、VRC の自己審査を完了すること、プラットフォーム機能を使用する場合は DUC を提出すること、ストア素材を仕様に合わせること、ヘッドセット内でスクリーンショットを撮影すること、トレーラーを 2 分未満にすること、年齢評価アンケートを完了すること、プライバシーポリシーの URL を公開すること。

提出のやり直しにつながる落とし穴

  • 「アルファ版にすぎない」ことは、パッケージ要件の免除にはなりません。
  • チャンネルには開発者を含め、最初は誰も登録されていません。空のチャンネルは、アップロードに失敗したように見えます。
  • Production ビルドは提出するまで表示されません。アップロードしただけでは審査は始まりません。
  • 2D パネルアプリには別のルールセットがあります。VRC の一部の要件に加え、自動却下の対象となる権限(正確な位置情報、電話機能など)のリストがあります。
  • **ストア素材にも独自の審査があります。**現在のセーフエリアと代表的なキャプチャを確認してください。APK のアップロードに成功したからといって、受け入れられるとは限りません。

チャンネルの動作、審査段階、VRC グループ、SDK レベルのルールは、2026-09-20 に developers.meta.com の各ページ(resources/publish-release-channels、 publish-app-review、publish-quest-req、publish-mobile-manifest)を参照しました。提出前に再確認してください。これらのページには、それぞれ日付が記載されています。

トリガー

ここに振り分けるその他のフレーズ:「リリースチャンネル」/「релизный канал」、「アプリ審査」/「ревью приложения」、「Data Use Checkup」、「DUC」、「ストア素材」/「ассеты для стора」、「テストユーザー」/ 「тестовый аккаунт」、「予約注文」/「предзаказ」。

コメント