Ortak komut seçenekleri
Çoğu vcpkg komutu, aracın çapraz kesme yönlerini denetleen bir grup ortak seçeneği kabul eder. Tüm seçenekler her komutu etkilemez. Örneğin, herhangi bir dosya indirmeyen bir komut, indirmeler dizininin değiştirilmesinden etkilenmez.
Seçenekler
--x-asset-sources=<config>
Not
Bu bölüm, vcpkg'nin herhangi bir zamanda değişebilen veya kaldırılabilen deneysel bir özelliğini kapsar.
Varlık Önbelleğe Alma için önbellek yapılandırmasını belirtin.
--binarysource=<config>
İkili Önbelleğe Alma için bir kaynak ekleyin.
Bu seçenek birden çok kez belirtilebilir; Birden çok ikili kaynağın nasıl etkileşime geçtiğini öğrenmek için İkili Önbelleğe Alma belgelerine bakın.
--x-buildtrees-root=<path>
Not
Bu bölüm, vcpkg'nin herhangi bir zamanda değişebilen veya kaldırılabilen deneysel bir özelliğini kapsar.
Nesneler veya paketlenmemiş kaynak kodu gibi ara derleme dosyalarını depolamak için geçici yolu belirtir.
Varsayılan olarak buildtrees/
vcpkg kök klasörünün altındadır.
--x-cmake-configure-debug=<debugger-pipe>[;semicolon;port;list]
Not
Bu bölüm, vcpkg'nin herhangi bir zamanda değişebilen veya kaldırılabilen deneysel bir özelliğini kapsar.
CMake'leri --debugger
içinde olduğu gibi yukarı akış derleme sistemleri CMakeLists.txt
içinde vcpkg_cmake_configure
etkinleştirir.
<debugger-pipe>
Değer, CMake komut satırında olduğu gibi --debugger-pipe
geçirilir.
Noktalı virgülle ayrılmış bağlantı noktası listesi varsa, hata ayıklayıcı yalnızca bu listedeki bağlantı noktaları için kullanılır. Aksi takdirde, tüm bağlantı noktaları için kullanılır.
Üçlü değişken VCPKG_CMAKE_CONFIGURE_OPTIONS
, iç CMake yapılandırma çağrısına seçenekleri geçirmek için kullanılır.
Bu nedenle, üzerine yazma VCPKG_CMAKE_CONFIGURE_OPTIONS
özel üçlüleri için çalışmaz.
Hata ayıklama seçeneklerini el ile geçirin veya bunun yerine seçeneklerinizi ekleyin VCPKG_CMAKE_CONFIGURE_OPTIONS
.
Aksine --x-cmake-debug
, derlemenin bir hata ayıklayıcının bağlanmasını beklediğini belirten bir çıkış olmayacaktır. Çıktı yalnızca konumunda Configuring <triplet>
durur.
CMake araç zincirinden derleme bayrakları almak için tüm bağlantı noktalarının portfile içinde CMake çağrısı yapması gerekir. Bu komut temel olarak derleme sistemi olarak CMake kullanan bağlantı noktaları için kullanışlıdır.
--x-cmake-debug=<debugger-pipe>[;semicolon;port;list]
Not
Bu bölüm, vcpkg'nin herhangi bir zamanda değişebilen veya kaldırılabilen deneysel bir özelliğini kapsar.
Üçlü dosyalar (örneğin: x64-windows.cmake
) veya portfile.cmake
dosyalar gibi doğrudan çağrılan CMake betiklerini çalıştırırken CMake'leri --debugger
etkinleştirir.
<debugger-pipe>
Değer, CMake komut satırında olduğu gibi --debugger-pipe
geçirilir.
Noktalı virgülle ayrılmış bağlantı noktası listesi varsa, hata ayıklayıcı yalnızca bu listedeki bağlantı noktaları için kullanılır. Aksi takdirde, tüm bağlantı noktaları için kullanılır.
Not: vcpkg çıkışında gözlemlenebiliyorsa Waiting for debugger client to connect...
hata ayıklayıcısı eklenebilir ve bir hata ayıklayıcı bağlanana kadar yürütme durdurulabilir.
--downloads-root=<path>
İndirilen araçların ve kaynak kodu arşivlerinin nerede tutulacağını belirtin.
Ortam değişkeninin varsayılan değeridir VCPKG_DOWNLOADS
. Bu ayar ayarlanmamışsa, varsayılan olarak downloads/
vcpkg kök klasörünün altında olarak ayarlanır.
--feature-flags=<flag1>,...
Bu değişken, deneysel davranışı kabul etmek için özellik bayrakları listesine ayarlanabilir.
--host-triplet=<triplet>
Konak üçlüslerini belirtin.
Ortam değişkeninin varsayılan değeridir VCPKG_DEFAULT_HOST_TRIPLET
. Bu da ayarlanmamışsa, değer konak mimarisine ve işletim sistemine göre çıkarılır.
--x-install-root=<path>
Not
Bu bölüm, vcpkg'nin herhangi bir zamanda değişebilen veya kaldırılabilen deneysel bir özelliğini kapsar.
Yüklü paketlerin düzenleneceği yolu belirtir.
Klasik modda, varsayılan olarak installed/
vcpkg kök klasörünün altındadır.
Bildirim modunda, varsayılan olarak vcpkg_installed/
bildirim klasörünün altındadır.
--x-manifest-root=<path>
Not
Bu bölüm, vcpkg'nin herhangi bir zamanda değişebilen veya kaldırılabilen deneysel bir özelliğini kapsar.
öğesini içeren vcpkg.json
dizini belirtir.
Varsayılan olarak en vcpkg.json
yakın çalışma dizininden yukarı doğru arama yapılır.
--overlay-ports=<path>
Katman bağlantı noktalarını içeren bir dizin belirtir.
Bu seçenek birden çok kez belirtilebilir; bağlantı noktaları ilk eşleşmeye çözümlenir.
--overlay-triplets=<path>
Yer paylaşımlı üçlüler içeren bir dizin belirtir.
Bu seçenek birden çok dizin eklemek için birden çok kez belirtilebilir; üçlüler ada göre ilk eşleşmeye çözümlenir.
--x-packages-root=<path>
Not
Bu bölüm, vcpkg'nin herhangi bir zamanda değişebilen veya kaldırılabilen deneysel bir özelliğini kapsar.
Son yüklemeden önce ara paket dosyalarını hazırlamanın geçici yolunu belirtir.
Varsayılan olarak packages/
vcpkg kök klasörünün altındadır.
--triplet=<triplet>
Hedef mimari üçlüslerini belirtin.
Ortam değişkeninin varsayılan değeridir VCPKG_DEFAULT_TRIPLET
. Bu ayarlanmazsa, konak mimarisine ve işletim sistemine göre çıkarılır.
Windows işletim sistemlerinde mimari her zaman eski nedenlerle x86 olarak çıkarılır.
Not
Eylül 2023'te ve sonrasında yapılan tüm sürümler varsayılan olarak x86-windows yerine Windows'ta konak üçlüsünü kullanır.
--vcpkg-root=<path>
vcpkg kök klasörünü belirtir.
Varsayılan olarak vcpkg programını içeren dizini kullanır. Dizin, gibi git clone
https://github.com/microsoft/vcpkg
geçerli bir vcpkg örneği olmalıdır. Bu seçenek, aracın özel olarak oluşturulmuş bir kopyasını doğrudan derleme klasöründen çalıştırmak için kullanılabilir.
Yanıt Dosyaları (@<file>
)
vcpkg komut satırı, yeni satırla ayrılmış komut satırı parametrelerini içeren metin dosyalarını kabul eder.
Araç, dosyadaki öğelerin başvuru yerine @
komut satırına eklendiğini gösterir. Yanıt dosyaları ek yanıt dosyaları içeremez.