Vega Studioでアプリのマニフェストを検証する方法

オープンベータ版ドキュメント：本テクニカルドキュメントは、リリース前のオープンベータ版の一部としてAmazonから提供されるものです。ここで説明されている機能は、Amazonがフィードバックを受け取り、機能の開発を繰り返す過程で変更される可能性があります。最新の機能の情報については、リリースノートを参照してください。

アプリのマニフェストを検証すると、開発プロセスの早い段階で構成エラーを検出できます。React Nativeアプリまたはネイティブアプリをデプロイする前に、必須フィールドの欠落、誤ったデータ型、無効なURL、互換性の問題を特定することができます。

Vega SDK v0.21には、Visual Studio Code（VS Code）拡張機能であるVega Studioを通じて、組み込みのマニフェスト検証が導入されています。Vega Studioを使用すれば、以下の各開発段階において、エディター内でマニフェストの検証を行うことができます。

開発 - manifest.tomlファイルの編集時に即座にフィードバックが返されます。
コードのコミット - 新しい変更内容に検証エラーが含まれるのを防ぎます。
ビルドプロセス - デプロイ前に問題を捕捉します。
アプリの申請 - プラットフォーム要件への準拠を確認します。

重要： このドキュメントでは、「Kepler Studio」（Vega Studioの旧名）を参照している場合があります。すべての機能とコマンドは同じように機能します。

前提条件

Vega SDKのインストール。
プロジェクトのルートに有効なmanifest.tomlファイルがあること。
（任意）TOML Language Supportのインストール（英語のみ）。

注： Vega Studioの組み込みの検証は、TOML言語のサポートがインストールされているかどうかにかかわらず機能します。TOML言語のサポートは、構文のハイライト、エラーの特定のしやすさ、読みやすさを提供するものです。

検証の確認

Vega Studioでは、デフォルトでマニフェストの検証が有効になります。検証が自動的に開始されます。

これが機能していることを確認するには、次の手順に従います。

VS Codeを開きます。
アクティビティバーからVega拡張機能のアイコンをクリックして、Vega Studioパネルを開きます。
プロジェクトセクションからプロジェクトを開きます。

検証が自動的に開始されない場合

検証が自動的に開始されない場合は、manifest.tomlを右クリックし、[Validate Manifest] を選択します。

VS Codeのコンテキストメニュー。manifest.tomlファイルを右クリックすると [マニフェストの検証] オプションが表示されます — マニフェストの検証

検証レポートの表示

検証結果を表示するには、[問題] パネルを確認します。

Mac： Cmd+Shift+M

Linux： Ctrl+Shift+M

VS Codeの [問題] パネル。ファイルの場所およびエラーの説明とともにマニフェスト検証エラーが表示されます — 検証結果

検証エラーの例

検証で問題が検出されると、明確で実践的なエラーメッセージが表示されます。以下に例を示します。

Error: Missing required property 'package.id'
Location: Line 3, manifest.toml
Fix: Add a unique identifier for your package, e.g., package.id = "com.example.myapp"

Last updated: 2025年9月30日