vcpkg install
概要
- クラシック モードの
vcpkg install [options] <package>...
- マニフェスト モードの を する
vcpkg install [options]
形容
ポート パッケージをビルドしてインストールします。
クラシック モード
クラシック モード 、この動詞は、インストールされている ディレクトリ の既存のセットにポート パッケージを追加します (既定では vcpkg ルートの下に installed/ されます)。 これにより、既存のパッケージの削除と再構築が必要になり、失敗する可能性があります。
パッケージ構文
portname[feature1,feature2]:triplet
トリプレットのないパッケージ参照は、既定のターゲット トリプレット によって自動的に修飾されます。
core を明示的に一覧表示しないパッケージ参照は、すべての既定の機能を意味すると見なされます。
マニフェスト モード
マニフェスト モードのでは、このコマンドは、インストールされたディレクトリ を、vcpkg.json マニフェスト ファイルで指定された状態に設定し、必要に応じてパッケージを追加、削除、または再構築します。
オプション
すべての vcpkg コマンドは、一連の共通オプションをサポートします。
--allow-unsupported
サポートされていないポートで停止するのではなく、警告を続けます。
既定では、vcpkg は、"supports" 句外のトリプレットのポート インストールを含むインストール プランの実行を拒否します。 パッケージの "supports" 句は、パッケージがビルド可能であると予想されるプラットフォームの完全なセットを記述します。 このフラグは、ビルドが停止するのではなく失敗することが予想されることを警告するように vcpkg に指示します。
--clean-after-build
各パッケージをビルドした後、ビルドツリー、パッケージ、およびダウンロードをクリーンアップします。
このオプションは、--clean-buildtrees-after-build、--clean-downloads-after-build、および --clean-packages-after-buildを渡すのと同じ効果があります。
--clean-buildtrees-after-build
各パッケージをビルドした後、ビルドツリーの一時サブフォルダーからすべてのサブディレクトリをクリーンアップします。
buildtrees サブフォルダー内のすべての最上位ファイル (buildtrees/zlib/config-x64-windows-out.logなど) が保持されます。 すべてのサブディレクトリが削除されます。
--clean-downloads-after-build
各パッケージをビルドした後、downloads/ フォルダーからすべての未トレースアセットをクリーンアップします。
downloads/ フォルダー内のすべての最上位ファイルが削除されます。 抽出されたツールは保持されます。
--clean-packages-after-build
各パッケージをビルドした後、パッケージの一時サブフォルダーをクリーンアップします。
ビルドされたパッケージのパッケージ サブフォルダー (たとえば、packages/zlib_x64-windows) は、インストール後に削除されます。
--dry-run
インストール 計画を印刷しますが、パッケージを削除したりインストールしたりしないでください。
インストール 計画には、インストールされるすべてのパッケージと機能、および削除して再構築する必要があるその他のパッケージが一覧表示されます。
--editable
- クラシック モードのみ
コマンド ラインで、直接参照されているすべてのパッケージに対して編集可能なビルドを実行します。
vcpkg はポートをビルドするときに、毎回ソース コードを消去して再抽出し、入力が正確であることを確認します。 これは、マニフェスト モードでインストールされている内容を正確に更新し、バイナリ キャッシュでキャッシュされたコンテンツが正しいことを確認するために必要です。
--editable フラグを渡すと、この動作が無効になります。この動作では、buildtrees/ フォルダー内の抽出されたソースに対する編集が保持されます。 これにより、変更ごとにファイルを書き込む必要がないように、パッチをすばやく開発できます。
編集可能なビルド中に抽出されたソースは、ディレクトリ名に .clean/ サフィックスを持たず、以降の編集不可能なビルドではクリアされません。
--enforce-port-checks
ポートで問題が検出された場合、または非推奨の機能を使用しようとすると、インストールが失敗します。
既定では、vcpkg はビルドされたパッケージに対していくつかのチェックを実行し、問題が検出された場合は警告を出力します。 このフラグは、これらの警告をエラーにアップグレードします。
--x-feature=<feature>
手記
このセクションでは、いつでも変更または削除できる vcpkg の試験的な機能について説明します。
- マニフェスト モード のみ
依存関係をインストールする vcpkg.json から追加の 機能 を指定します。
既定では、"dependencies" と "default-features" の依存関係のみがインストールされます。
--head
- クラシック モードのみ
ビルド時に使用可能な最新のソースをフェッチするには、コマンド ラインで明示的に参照されているすべてのパッケージを要求します。
このフラグは、一時的なテストのみを目的としており、運用環境や長期的な使用を目的としたものではありません。 vcpkg ではすべての入力を正確に追跡できないため、明示的に参照されているすべてのパッケージとその依存パッケージの バイナリ キャッシュ が無効になります。
--keep-going
最初の障害が発生した後、インストール計画を続行します。
既定では、vcpkg は最初のパッケージ ビルドエラーで停止します。 このフラグは、失敗したパッケージに依存しないインストール 計画の他の部分のビルドとインストールを継続するように vcpkg に指示します。
--x-no-default-features
手記
このセクションでは、いつでも変更または削除できる vcpkg の試験的な機能について説明します。
- マニフェスト モード のみ
最上位レベルのマニフェストから既定の機能をインストールしないでください。
マニフェスト モードで install を使用する場合、既定では、"default-features" に一覧表示されている機能のすべての依存関係がインストールされます。 このフラグは、--x-feature によって明示的に有効になっている機能のみがインストールされるように、その動作を無効にします。
--no-downloads
パッケージをビルドするときに、ビルド中にポートが新しいアセットをダウンロードできないようにします。
既定では、ポートはインターネットからオンデマンドでソース コードとツールを取得します (資産キャッシュの対象となります)。 このパラメーターは、ダウンロードをブロックし、以前にダウンロードされ、コンピューターにキャッシュされた資産のみにポートを制限します。
--only-downloads
ビルドを実行せずに、インストール 計画に必要なすべての資産のダウンロードを試みます。
このオプションを渡すと、vcpkg は、最初の非ダウンロード外部プロセス呼び出しを行うまで、プラン内の各ビルドを実行します。 ほとんどのポートでは、最初の外部プロセス呼び出し (通常はビルド システム) の前にすべてのダウンロードが実行されるため、この手順では必要なすべての資産がダウンロードされます。 この手順に従わないポートでは、資産は事前にダウンロードされません。
--only-binarycaching
ビルドの実行を拒否します。 バイナリ キャッシュからのみパッケージを復元します。
このフラグは、vcpkg が必要に応じてビルドを実行するのをブロックし、バイナリ キャッシュにパッケージが見つからない場合は失敗します。
--recurse
- クラシック モードのみ
パッケージの再構築を必要とするインストール 計画を承認します。
インストールされているパッケージの機能セットを変更するには、vcpkg がそのパッケージを削除して再構築する必要があります。 これにより、ユーザーが開始したパッケージよりも少ないパッケージでインストール ツリーが失敗して残される可能性があるため、ユーザーはこのフラグを渡してパッケージを再構築するプランを承認する必要があります。
--x-write-nuget-packages-config
手記
このセクションでは、いつでも変更または削除できる vcpkg の試験的な機能について説明します。
バイナリ キャッシュ で使用する NuGet packages.config形式のファイル書き込みます。
このオプションを --dry-run と組み合わせて使用すると、パッケージをビルドまたはインストールすることなく、バイナリ キャッシュから必要な NuGet パッケージの一覧を取得できます。 これにより、代替プロトコルを使用して .nupkg ファイルを取得するなど、高度なシナリオで NuGet コマンド ラインを個別に呼び出すことができます。
--no-print-usage
インストールの終了時に印刷される使用テキストの生成を抑制します。
vcpkg