@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]セクションを参照してください。
解決済みバージョンのプロジェクトをビルド済みアプリに移行するには、次のコマンドを実行します。
-
vega project install --fixは、アプリの[os.version].targetと互換性がある各@amazon-devices/*依存関係の最新の公開バージョンを選択し、それらのバージョンをpackage.jsonに書き込みます。何もダウンロードしませんし、node_modulesフォルダを変更することもありません。 -
npm installは、vega project installが書き込んだバージョンをダウンロードして、インストールします。プロジェクトで既に使用されているパッケージマネージャーを使用してください。 -
vega project doctorは、ビルドの前にプロジェクトを検証します。検証に失敗すると0以外のコードで終了するため、そのコードをCIパイプラインでゲートとして使用できます。 -
npx react-native build-vegaはアプリをビルドし、vpkgを生成します。package.jsonでビルドスクリプトを使用することもできます。
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互換のパッケージマネージャーであれば、どれでも同じ方法でこれらのエントリをインストールします。

