Amazon Developer

as

Settings
Sign out
Notifications
Alexa
Amazonアプリストア
Ring
AWS
ドキュメント
Support
Contact Us
My Cases
開発
設計と開発
公開
リファレンス
サポート
ネイティブ
Skip to main content
アプリの依存関係には2つのグループがあり、Vegaはそれらを異なる方法で管理します。このガイドでは、これら2種類の依存関係を解決してインストールするツールと、OSバージョンターゲットがパッケージバージョンを選択する仕組みについて説明します。 OS提供のVegaパッケージには、@amazon-devices/プレフィックスが付いています(例:@amazon-devices/kepler-camera)。[os.version]ターゲットは、アプリが使用できるVegaパッケージのバージョンを制限し、vega project installがそれらを解決します。reactやlodashなどの通常のnpmパッケージは、パッケージマネージャーを使用していつもの方法で解決します。 どちらの種類もパッケージマネージャーがインストールします。vega projectによってインストールされることはありません。代わりに、vega projectは、OSバージョンターゲットに合わせてOS提供パッケージの正しいバージョンを解決し、package.jsonに書き込みます。その後、開発者のパッケージマネージャー(npm、yarn、pnpmなど)を実行して、それらのダウンロードとインストールを行います。

解決、インストール、ビルドのチェーン

始める前に、manifest.tomlに[os.version]セクションがあることを確認してください。vega project install --fixは、このセクションに基づいてアプリのOSターゲットを解決します。そのため、このセクションがないとMissing OS Versionエラーが発生し、何も書き込まれません。セクションの作成と再調整を1つのコマンドで行うには、vega project install --fix --os-min 1.2 --os-version 2.0のように両方のフラグを追加します。セクションを追加するその他の方法については、マニフェストの[os.version]セクションを参照してください。 解決済みバージョンのプロジェクトをビルド済みアプリに移行するには、次のコマンドを実行します。
  1. vega project install --fixは、アプリの[os.version].targetと互換性がある各@amazon-devices/*依存関係の最新の公開バージョンを選択し、それらのバージョンをpackage.jsonに書き込みます。何もダウンロードしませんし、node_modulesフォルダを変更することもありません。
  2. npm installは、vega project installが書き込んだバージョンをダウンロードして、インストールします。プロジェクトで既に使用されているパッケージマネージャーを使用してください。
  3. vega project doctorは、ビルドの前にプロジェクトを検証します。検証に失敗すると0以外のコードで終了するため、そのコードをCIパイプラインでゲートとして使用できます。
  4. npx react-native build-vegaはアプリをビルドし、vpkgを生成します。package.jsonでビルドスクリプトを使用することもできます。
すべてのコマンドとオプションの詳細については、Vega SDK CLIリファレンスを参照してください。

OSバージョンターゲットがパッケージバージョンを選択する仕組み

manifest.tomlの[os.version]セレクションは、vega project installで解決するバージョンを指定します。
  • target - vega project installにより、各@amazon-devices/*パッケージは、このOSバージョンで利用可能な最新バージョンに解決されます。
  • min - アプリがサポートする最も古いOSバージョン。コードでは、min以降に追加されたAPIを保護し、minのデバイスでもアプリが実行されるようにする必要があります。
ソースmanifest.tomlにOSバージョンのモジュールエントリを追加する必要はありません。ビルド時、ツールが[os.version]からそれらのエントリを生成し、検証、段階的、パッケージのマニフェストに書き込みます。そのように生成されたマニフェストでは、minのOSバージョンが必須の[[needs.module]]エントリであり、min以降で、targetまでの各OSバージョンが任意の[[wants.module]]エントリです。 minとtargetはいずれも、"M.n"形式の文字列で正式なOSバージョンを指定する必要があります。Vegaは、たとえその値が数値的に正しい形式であっても、正式に定義されていない値は受け付けません。OS 2.0をターゲットにして、OS 1.2で引き続きデバイスのサポートを受けるには、targetを2.0に、minを1.2に設定します。アプリがOS 2.0のみサポートしている場合は、両方の値を2.0に設定します。 詳細なフィールド定義、検証ルール、モジュールIDの形式については、マニフェストの[os.version]セクションを参照してください。

パッケージの追加、更新、再調整

次の表では、各アクションを実行するコマンドについて説明します。 package.jsonを書き換えるコマンド(installやupdateなど)が終了したら、パッケージマネージャーを実行して変更のインストールと再ビルドを行います。 update-manifestは異なる方法で機能します。package.jsonではなくmanifest.tomlを書き込みます。[os.version]でmin値とtargetを設定し、ソースマニフェストからツール所有のOSバージョンのモジュールエントリを削除します。targetを変更した場合、新しいターゲットに合わせてパッケージバージョンを再調整するためにvega project install --fixを実行し、パッケージマネージャーを実行してから再ビルドします。

パッケージマネージャーの選択

vega projectコマンドで書き込むのはpackage.jsonのみです。npm、yarn、pnpmを呼び出すことはありません。プロジェクトで既に使用されているパッケージマネージャーを使用してください。解決された@amazon-devices/*バージョンはプレーンなpackage.jsonエントリです。npm互換のパッケージマネージャーであれば、どれでも同じ方法でこれらのエントリをインストールします。

関連トピック

最終更新日 2026年10月13日