Bagikan melalui


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.configuntuk 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.