penginstalan vcpkg
Sinopsis
- mode Klasik
vcpkg install [options] <package>...
- mode Manifes
vcpkg install [options]
Deskripsi
Membangun dan menginstal paket port.
Mode klasik
Dalam mode Klasik, kata kerja ini menambahkan paket port ke set yang ada di direktori yang diinstal (default ke installed/
di bawah akar vcpkg). Ini dapat memerlukan penghapusan dan pembangunan kembali paket yang ada, yang dapat gagal.
Sintaks Paket
portname[feature1,feature2]:triplet
Referensi paket tanpa triplet secara otomatis memenuhi syarat oleh target default triplet. Referensi paket yang tidak secara eksplisit mencantumkan core
dianggap menyiratkan semua fitur default.
Mode manifes
Dalam mode manifes , perintah ini mengatur direktori yang diinstal ke status yang ditentukan oleh file manifes vcpkg.json
, menambahkan, menghapus, atau membangun kembali paket sesuai kebutuhan.
Pilihan
Semua perintah vcpkg mendukung serangkaian opsi umum .
--allow-unsupported
Alih-alih berhenti pada port yang tidak didukung, lanjutkan dengan peringatan.
Secara default, vcpkg menolak untuk menjalankan rencana penginstalan yang berisi penginstalan port untuk triplet di luar klausa "supports"
. Klausul "supports"
paket menjelaskan set lengkap platform yang diharapkan dapat dibangun. Bendera ini menginstruksikan vcpkg untuk memperingatkan bahwa build diharapkan gagal alih-alih berhenti.
--clean-after-build
Bersihkan buildtree, paket, dan unduhan setelah membuat setiap paket.
Opsi ini memiliki efek yang sama dengan meneruskan --clean-buildtrees-after-build
, --clean-downloads-after-build
, dan --clean-packages-after-build
.
--clean-buildtrees-after-build
Bersihkan semua subdirektori dari subfolder sementara buildtrees setelah membangun setiap paket.
Semua file tingkat atas di subfolder buildtrees (misalnya buildtrees/zlib/config-x64-windows-out.log
) akan disimpan. Semua subdirektori akan dihapus.
--clean-downloads-after-build
Bersihkan semua aset yang tidak dilepas dari folder downloads/
setelah membangun setiap paket.
Semua file tingkat atas dalam folder downloads/
akan dihapus. Alat yang diekstrak akan disimpan.
--clean-packages-after-build
Bersihkan paket subfolder sementara setelah membangun setiap paket.
Subfolder paket untuk paket bawaan (misalnya, packages/zlib_x64-windows
) akan dihapus setelah penginstalan.
--dry-run
Cetak paket penginstalan, tetapi jangan hapus atau instal paket apa pun.
Paket penginstalan mencantumkan semua paket dan fitur yang akan diinstal, serta paket lain yang perlu dihapus dan dibangun kembali.
--editable
- mode Klasik hanya
Lakukan build yang dapat diedit untuk semua paket yang dirujuk langsung pada baris perintah.
Ketika vcpkg membangun port, vcpkg membersihkan dan mengekstrak ulang kode sumber setiap kali untuk memastikan input secara akurat. Ini diperlukan agar mode Manifes memperbarui secara akurat apa yang diinstal dan untuk penembolokan biner untuk memastikan konten yang di-cache sudah benar.
Meneruskan bendera --editable
menonaktifkan perilaku ini, mempertahankan pengeditan ke sumber yang diekstrak di folder buildtrees/
. Ini membantu mengembangkan patch dengan cepat dengan menghindari kebutuhan untuk menulis file pada setiap perubahan.
Sumber yang diekstrak selama build yang dapat diedit tidak memiliki akhiran .clean/
pada nama direktori dan tidak akan dihapus oleh build berikutnya yang tidak dapat diedit.
--enforce-port-checks
Gagal menginstal jika port telah mendeteksi masalah atau mencoba menggunakan fitur yang tidak digunakan lagi.
Secara default, vcpkg akan menjalankan beberapa pemeriksaan pada paket bawaan dan mengeluarkan peringatan jika ada masalah yang terdeteksi. Bendera ini meningkatkan peringatan tersebut ke kesalahan.
--x-feature=<feature>
Nota
Bagian ini mencakup fitur eksperimental vcpkg yang dapat berubah atau dihapus kapan saja.
- mode manifes hanya
Tentukan fitur tambahan dari vcpkg.json
untuk menginstal dependensi.
Secara default, hanya "dependencies"
dan dependensi "default-features"
yang akan diinstal.
--head
- mode Klasik hanya
Minta semua paket yang dirujuk secara eksplisit pada baris perintah untuk mengambil sumber terbaru yang tersedia saat membangun.
Bendera ini hanya ditujukan untuk pengujian sementara dan tidak ditujukan untuk produksi atau penggunaan jangka panjang. Ini menonaktifkan penembolokan biner untuk semua paket yang direferensikan secara eksplisit dan dependennya karena vcpkg tidak dapat melacak semua input secara akurat.
--keep-going
Lanjutkan rencana penginstalan setelah kegagalan pertama.
Secara default, vcpkg akan berhenti pada kegagalan build paket pertama. Bendera ini menginstruksikan vcpkg untuk terus membangun dan menginstal bagian lain dari rencana penginstalan yang tidak bergantung pada paket yang gagal.
--x-no-default-features
Nota
Bagian ini mencakup fitur eksperimental vcpkg yang dapat berubah atau dihapus kapan saja.
- mode manifes hanya
Jangan instal fitur default dari manifes tingkat atas.
Saat menggunakan install
dalam mode Manifes, secara default semua dependensi fitur yang tercantum dalam "default-features"
akan diinstal. Bendera ini menonaktifkan perilaku tersebut sehingga hanya fitur yang diaktifkan secara eksplisit oleh --x-feature
yang akan diinstal.
--no-downloads
Saat membuat paket, cegah port mengunduh aset baru selama build.
Secara default, port akan memperoleh kode sumber dan alat sesuai permintaan dari internet (tunduk pada penembolokan aset). Parameter ini memblokir unduhan dan membatasi port hanya untuk aset yang sebelumnya diunduh dan di-cache pada komputer.
--only-downloads
Coba unduh semua aset yang diperlukan untuk rencana penginstalan tanpa melakukan build apa pun.
Ketika diteruskan opsi ini, vcpkg akan menjalankan setiap build dalam paket hingga melakukan panggilan proses eksternal non-unduhan pertamanya. Sebagian besar port melakukan semua unduhan sebelum panggilan proses eksternal pertama (biasanya ke sistem build mereka), sehingga prosedur ini akan mengunduh semua aset yang diperlukan. Port yang tidak mengikuti prosedur ini tidak akan memiliki aset yang telah diunduh sebelumnya.
--only-binarycaching
Menolak untuk melakukan build apa pun. Hanya pulihkan paket dari cache biner.
Bendera ini memblokir vcpkg agar tidak melakukan build sesuai permintaan dan akan gagal jika paket tidak dapat ditemukan di cache biner apa pun.
--recurse
- mode Klasik hanya
Setujui paket penginstalan yang memerlukan pembuatan ulang paket.
Untuk mengubah serangkaian fitur paket yang diinstal, vcpkg harus menghapus dan membangun kembali paket tersebut. Karena ini memiliki potensi gagal dan meninggalkan pohon instal dengan lebih sedikit paket daripada yang dimulai pengguna, pengguna harus menyetujui paket yang membangun kembali paket dengan meneruskan bendera ini.
--x-write-nuget-packages-config
Nota
Bagian ini mencakup fitur eksperimental vcpkg yang dapat berubah atau dihapus kapan saja.
Menulis file berformat NuGet packages.config
untuk digunakan dengan penembolokan biner.
Opsi ini dapat digunakan bersama dengan --dry-run
untuk mendapatkan daftar paket NuGet yang diperlukan dari penembolokan biner tanpa membangun atau menginstal paket apa pun. Ini memungkinkan baris perintah NuGet dipanggil secara terpisah untuk skenario tingkat lanjut, seperti menggunakan protokol alternatif untuk memperoleh file .nupkg
.
--no-print-usage
Tekan pembuatan teks penggunaan yang dicetak di akhir penginstalan.