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.txtiçinde vcpkg_cmake_configureetkinleş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.jsondizini belirtir.

Varsayılan olarak en vcpkg.jsonyakı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 clonehttps://github.com/microsoft/vcpkggeç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.