vcpkg yükleme
Özet
- Klasik mod
vcpkg install [options] <package>...
- Bildirim modu
vcpkg install [options]
Açıklama
Bağlantı noktası paketleri oluşturun ve yükleyin.
Klasik mod
Klasik modda, bu fiil yüklü dizindeki mevcut kümeye bağlantı noktası paketleri ekler (varsayılan olarak installed/
vcpkg kökü altındadır). Bu, mevcut paketlerin kaldırılmasını ve yeniden oluşturulmasını gerektirebilir ve bu da başarısız olabilir.
Paket Söz Dizimi
portname[feature1,feature2]:triplet
Üçlü olmayan paket başvuruları, varsayılan hedef üçlü tarafından otomatik olarak nitelenir. Açıkça listelenmeyen core
paket başvuruları, tüm varsayılan özellikleri ima eder.
Bildirim modu
Bildirim modunda, bu komut yüklü dizini bildirim dosyası tarafından vcpkg.json
belirtilen duruma ayarlar, gerektiğinde paketleri ekler, kaldırır veya yeniden oluşturur.
Seçenekler
Tüm vcpkg komutları bir dizi ortak seçeneği destekler.
--allow-unsupported
Desteklenmeyen bir bağlantı noktasında durdurmak yerine bir uyarıyla devam edin.
Varsayılan olarak vcpkg, yan tümcesi dışındaki bir üçlü için bağlantı noktası yüklemesi içeren bir yükleme planını yürütmeyi "supports"
reddeder. "supports"
Bir paketin yan tümcesi, bir paketin derlenebilir olması beklenen tüm platform kümesini açıklar. Bu bayrak, vcpkg'ye derlemenin durdurulması yerine başarısız olması beklendiği konusunda uyarır.
--clean-after-build
Her paketi derledikten sonra derleme ağaçlarını, paketleri ve indirmeleri temizleyin.
Bu seçenek, , --clean-downloads-after-build
ve --clean-packages-after-build
geçirmekle --clean-buildtrees-after-build
aynı etkiye sahiptir.
--clean-buildtrees-after-build
Her paketi derledikten sonra derleme ağaçlarının geçici alt klasöründeki tüm alt dizinleri temizleyin.
Buildtrees alt klasöründeki tüm üst düzey dosyalar (ör. buildtrees/zlib/config-x64-windows-out.log
) korunur. Tüm alt dizinler silinir.
--clean-downloads-after-build
Her paketi derledikten sonra klasörden downloads/
çıkarılmamış tüm varlıkları temizleyin.
Klasördeki downloads/
tüm üst düzey dosyalar silinir. Ayıklanan araçlar korunur.
--clean-packages-after-build
Her paketi derledikten sonra paketlerin geçici alt klasörünü temizleyin.
Yerleşik paketin paketler alt klasörü (örneğin, packages/zlib_x64-windows
) yüklemeden sonra silinir.
--dry-run
Yükleme planını yazdırın, ancak paketleri kaldırmayın veya yüklemeyin.
Yükleme planı, yüklenecek tüm paketleri ve özelliklerin yanı sıra kaldırılması ve yeniden oluşturulması gereken diğer paketleri listeler.
--editable
- Yalnızca klasik mod
Komut satırında doğrudan başvurulan tüm paketler için düzenlenebilir derlemeler gerçekleştirin.
vcpkg bağlantı noktaları oluştururken, girişlerin doğru olduğundan emin olmak için kaynak kodu her seferinde temizler ve yeniden ayıklar. Bu, Bildirim modunun yüklenenleri doğru bir şekilde güncelleştirmesi ve önbelleğe alınan içeriğin doğru olduğundan emin olmak için ikili önbelleğe alma için gereklidir.
bayrağı geçirildiğinde --editable
bu davranış devre dışı bırakılır ve klasördeki ayıklanan kaynaklarda yapılan düzenlemeler korunarak buildtrees/
devre dışı bırakılır. Bu, her değişiklikte dosya yazma gereksinimini ortadan kaldırarak düzeltme eklerinin hızla geliştirilmesine yardımcı olur.
Düzenlenebilir bir derleme sırasında ayıklanan kaynakların dizin adında bir .clean/
sonek yoktur ve sonraki düzenlenemez derlemeler tarafından temizlenmez.
--enforce-port-checks
Bir bağlantı noktası sorun algıladıysa veya kullanım dışı bırakılmış bir özelliği kullanmaya çalışırsa yükleme başarısız olur.
Varsayılan olarak, vcpkg yerleşik paketler üzerinde çeşitli denetimler çalıştırır ve herhangi bir sorun algılanırsa uyarılar gönderir. Bu bayrak, bu uyarıları bir hataya yükselter.
--x-feature=<feature>
Not
Bu bölüm, vcpkg'nin herhangi bir zamanda değişebilen veya kaldırılabilen deneysel bir özelliğini kapsar.
- Yalnızca bildirim modu
bağımlılıklarını yüklemek için öğesinden vcpkg.json
ek bir özellik belirtin.
Varsayılan olarak, yalnızca "dependencies"
ve bağımlılıkları "default-features"
yüklenir.
--head
- Yalnızca klasik mod
Derleme sırasında kullanılabilen en son kaynakları getirmek için komut satırında açıkça başvuruda bulunulan tüm paketleri isteyin.
Bu bayrak yalnızca geçici test amaçlıdır ve üretim veya uzun süreli kullanım için tasarlanmamıştır. Bu, vcpkg tüm girişleri doğru şekilde izleyemediği için açıkça başvurulan tüm paketler ve bunların bağımlıları için ikili önbelleğe almayı devre dışı bırakır.
--keep-going
İlk hatadan sonra yükleme planına devam edin.
Varsayılan olarak, vcpkg ilk paket derleme hatasında durur. Bu bayrak, vcpkg'ye yükleme planının başarısız pakete bağlı olmayan diğer bölümlerini oluşturmaya ve yüklemeye devam etmesi talimatını sağlar.
--x-no-default-features
Not
Bu bölüm, vcpkg'nin herhangi bir zamanda değişebilen veya kaldırılabilen deneysel bir özelliğini kapsar.
- Yalnızca bildirim modu
Üst düzey bildirimden varsayılan özellikleri yüklemeyin.
Bildirim modunda kullanırken install
, içinde listelenen "default-features"
özelliklerin tüm bağımlılıkları varsayılan olarak yüklenir. Bu bayrak, yalnızca açıkça --x-feature
etkinleştirilen özelliklerin yüklenmesi için bu davranışı devre dışı bırakır.
--no-downloads
Paket oluştururken, derleme sırasında bağlantı noktalarının yeni varlıkları indirmesini engelleyin.
Varsayılan olarak, bağlantı noktaları internetten isteğe bağlı olarak kaynak kodu ve araçları alır (varlık önbelleğe almaya tabidir). Bu parametre indirmeleri engeller ve bağlantı noktalarını yalnızca daha önce indirilmiş ve makinede önbelleğe alınmış varlıklarla kısıtlar.
--only-downloads
Herhangi bir derleme gerçekleştirmeden bir yükleme planı için gereken tüm varlıkları indirmeyi deneme.
Bu seçenek geçirildiğinde, vcpkg ilk indirilmeyen dış işlem çağrısını yapana kadar plandaki her derlemeyi çalıştırır. Bağlantı noktalarının çoğu ilk dış işlem çağrısından önce tüm indirmeleri gerçekleştirir (genellikle derleme sistemine), bu yordam tüm gerekli varlıkları indirir. Bu yordamı izlemeyen bağlantı noktalarının varlıkları önceden indirilmemiş olur.
--only-binarycaching
Derlemeleri gerçekleştirmeyi reddedin. Paketleri yalnızca ikili önbelleklerden geri yükleyin.
Bu bayrak vcpkg'nin isteğe bağlı derlemeler gerçekleştirmesini engeller ve herhangi bir ikili önbellekte paket bulunamazsa başarısız olur.
--recurse
- Yalnızca klasik mod
Paketlerin yeniden oluşturulmasını gerektiren bir yükleme planını onaylayın.
Yüklü bir paketin özellik kümesini değiştirmek için vcpkg'nin bu paketi kaldırması ve yeniden oluşturması gerekir. Bunun başarısız olma ve yükleme ağacını kullanıcının başlattığından daha az paketle bırakma olasılığı olduğundan, kullanıcının bu bayrağı geçirerek paketleri yeniden oluşturan planları onaylaması gerekir.
--x-use-aria2
Not
Bu bölüm, vcpkg'nin herhangi bir zamanda değişebilen veya kaldırılabilen deneysel bir özelliğini kapsar.
İndirme görevlerini gerçekleştirmek için aria2 kullanın.
--x-write-nuget-packages-config
Not
Bu bölüm, vcpkg'nin herhangi bir zamanda değişebilen veya kaldırılabilen deneysel bir özelliğini kapsar.
İkili önbelleğe alma ile kullanmak üzere NuGet packages.config
biçimli bir dosya yazar.
Bu seçenek, herhangi bir paket oluşturmadan veya yüklemeden ikili önbelleğe alma işleminden gerekli NuGet paketlerinin listesini almak için ile --dry-run
birlikte kullanılabilir. Bu, dosyaları almak için alternatif protokoller kullanma gibi gelişmiş senaryolar için NuGet komut satırının ayrı olarak çağrılmalarını .nupkg
sağlar.
--no-print-usage
Yüklemenin sonunda yazdırılan kullanım metninin oluşturulmasını engelleme.