ekspor vcpkg

Sinopsis

vcpkg export [options] {<package>... | --x-all-installed}

Description

Mengekspor paket bawaan dari direktori yang diinstal ke SDK pengembang mandiri.

export menghasilkan SDK mandiri dan dapat didistribusikan (Software Development Kit) yang dapat digunakan pada komputer lain tanpa memperoleh vcpkg secara terpisah. Berisi:

1. Biner bawaan untuk paket yang dipilih
2. Dependensi transitif mereka
3. File integrasi, seperti toolchain CMake atau MSBuild props/targets

Perintah export tidak menginstal paket atau dependensi transitif apa pun. Ini hanya mengekspor paket yang sudah diinstal.

Lihat Mode Manifes atau Mode Klasik untuk detail selengkapnya.

Mode Klasik

Dalam mode klasik, vcpkg export menerima argumen spesifikasi paket yang memenuhi syarat triplet (misalnya: zlib:x64-windows)

Anda menentukan paket yang akan diekspor dengan menambahkan <port name>:<triplet> argumen ke baris perintah.

Misalnya, untuk mengekspor sqlite paket untuk x64-windows dan x64-linux, gunakan:

vcpkg export sqlite:x64-windows sqlite:x64-linux --zip

Perintah ini mengekspor paket yang ditentukan dalam format zip. Baik sqlite:x64-windows dan sqlite:x64-linux harus diinstal sebelum menjalankan vcpkg export.

Mode Manifes

Dalam mode manifes, perintah mengekspor semua paket yang saat ini diinstal. Direktori penginstalan mencakup semua paket yang dideklarasikan dalam manifes (vcpkg.json) serta dependensi transitifnya. Jalankan vcpkg install sebelum menggunakan perintah ini untuk memastikan bahwa semua paket yang diperlukan diinstal.

Dalam mode ini Anda tidak dapat menentukan paket individual untuk diekspor. Perintah beroperasi pada seluruh status yang diinstal sebagai entitas tunggal, menghormati dependensi dan versi yang ditentukan dalam file manifes.

Perbedaan lain adalah persyaratan --output-dir opsi. Opsi ini menentukan direktori tempat paket yang diekspor akan disimpan.

Misalnya, dari direktori manifes

vcpkg export --zip --output-dir=.\exports

Mengekspor semua paket yang saat ini diinstal ke .\exports direktori dalam file zip. Opsi --zip menentukan bahwa paket yang diekspor harus dikompresi ke dalam file zip.

Integrasi Standar

Sebagian besar format ekspor berisi sekumpulan file integrasi standar:

• Toolchain CMake di/scripts/buildsystems/vcpkg.cmake
• Alat peraga/target MSBuild di /scripts/buildsystems/msbuild/vcpkg.props dan /scripts/buildsystems/msbuild/vcpkg.targets
• Pohon penginstalan di/

Beberapa format ekspor berbeda dari set standar ini; lihat bantuan format individual di bawah ini untuk detail selengkapnya.

Format

Format SDK yang didukung secara resmi:

• Direktori Mentah
• Zip
• 7zip
• NuGet

Direktori Mentah

vcpkg export --raw [options] <package>...

Buat tata letak direktori yang tidak dikompresi di <output-dir>/<output>/.

Berisi File Integrasi Standar.

Zip

vcpkg export --zip [options] <package>...

Buat tata letak direktori terkompresi zip di <output-dir>/<output>.zip.

Berisi File Integrasi Standar.

7Zip

vcpkg export --7zip [options] <package>...

Buat tata letak direktori 7zip di <output-dir>/<output>.7z.

Berisi File Integrasi Standar.

NuGet

vcpkg export --nuget [options] <package>...

Buat paket NuGet di <output-dir>/<nuget-id>.<nuget-version>.nupkg.

Berisi File Integrasi Standar serta integrasi MSBuild tambahan untuk mendukung penyertaan dalam proyek MSBuild C++ (.vcxproj) melalui Manajer Paket NuGet. Perhatikan bahwa Anda tidak dapat mencampur beberapa paket NuGet yang diproduksi bersama export -- hanya salah satu paket yang akan digunakan. Untuk menambahkan pustaka tambahan, Anda harus membuat ekspor baru dengan serangkaian dependensi lengkap.

Format opsi tertentu:

• --nuget-id
• --nuget-version
• --nuget-description

IFW

Ekspor IFW telah dihapus.

Chocolatey

Ekspor cokelat telah dihapus.

Cetakan

Ekspor prefab telah dihapus.

Opsi

Semua perintah vcpkg mendukung serangkaian opsi umum.

<package>

Ini adalah daftar paket bawaan tingkat atas yang akan disertakan dalam SDK. Setiap dependensi dari paket ini juga akan disertakan untuk memastikan SDK yang dihasilkan mandiri.

Sintaks Paket

<port name>:<triplet>

Referensi paket tanpa triplet secara otomatis memenuhi syarat oleh triplet target default. Catatan: <port name>:<triplet> argumen tidak diperbolehkan saat menggunakan vcpkg export dalam mode manifes.

--x-all-installed

Ekspor semua paket yang terinstal. Opsi ini tersirat saat menggunakan vcpkg export dalam mode manifes.

--dereference-symlinks

Menyalin symlink sebagai file dan direktori reguler dalam hasil yang diekspor.

--dry-run

Jangan melakukan ekspor, hanya cetak paket ekspor.

--nuget-description=

Menentukan deskripsi output untuk file NuGet .nupkg.

Default ke "ekspor Vcpkg NuGet".

--nuget-id=

Menentukan id output untuk file NuGet .nupkg.

Opsi ini mengambil alih --output opsi khusus untuk pengekspor NuGet. Lihat --output untuk nilai default.

--nuget-version=

Menentukan versi output untuk file NuGet .nupkg.

Secara default menjadi 1.0.0.

--output=

Menentukan nama dasar output.

Setiap jenis SDK menggunakan nama dasar ini untuk menentukan file output spesifiknya. Lihat dokumentasi khusus SDK di atas untuk detailnya.

Secara default menjadi vcpkg-export-<date>-<time>. Penggunaan export skrip harus selalu meneruskan bendera ini untuk memastikan output deterministik.

--output-dir=

Menentukan direktori output.

Semua file SDK tingkat atas akan diproduksi ke direktori ini. Opsi ini diperlukan dalam mode manifes. Dalam mode klasik, ini bersifat opsional dan default ke direktori akar vcpkg.