vcpkg yükleme

Özet

• Klasik modu

vcpkg install [options] <package>...

• bildirim modunu

vcpkg install [options]

Açıklama

Bağlantı noktası paketleri oluşturun ve yükleyin.

Klasik mod

Klasik modda bu fiil, yüklü dizin mevcut kümeye bağlantı noktası paketleri ekler (varsayılan olarak vcpkg kökü altındaki installed/ olarak ayarlanı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. core açıkça listelemeyen paket başvuruları, tüm varsayılan özellikleri ima eder.

Bildirim modu

Bildirim modunda bu komut, yüklü dizinvcpkg.json bildirim dosyası tarafından belirtilen duruma ayarlar, gerektiğinde paketleri ekler, kaldırır veya yeniden oluşturur.

Seçenekler

Tüm vcpkg komutları ortak seçenekler kümesini destekler.

--allow-unsupported

Desteklenmeyen bir bağlantı noktasında durdurmak yerine bir uyarıyla devam edin.

Varsayılan olarak vcpkg, "supports" yan tümcesi dışında bir üçlü için bağlantı noktası yüklemesi içeren bir yükleme planını yürütmeyi reddeder. Paketin "supports" 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-buildtrees-after-build, --clean-downloads-after-buildve --clean-packages-after-buildgeçirmekle 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 (örn. buildtrees/zlib/config-x64-windows-out.log) korunur. Tüm alt dizinler silinir.

--clean-downloads-after-build

Her paketi derledikten sonra downloads/ klasöründeki tüm çıkarılmamış varlıkları temizleyin.

downloads/ klasöründeki 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

• Klasik modu yalnızca

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.

--editable bayrağı geçirildiğinde bu davranış devre dışı bırakılır ve buildtrees/ klasöründe ayıklanan kaynaklarda yapılan düzenlemeler korunarak 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/ soneki 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>

• Bildirim modu yalnızca

Bağımlılıkların yükleneceği vcpkg.jsonek bir özelliği belirtin.

Varsayılan olarak, yalnızca "dependencies" ve "default-features" bağımlılıkları yüklenir.

--head

• Klasik modu yalnızca

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 alma 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

• Bildirim modu yalnızca

Üst düzey bildirimden varsayılan özellikleri yüklemeyin.

Bildirim modunda install kullanırken, varsayılan olarak "default-features" listelenen özelliklerin tüm bağımlılıkları yüklenir. Bu bayrak, yalnızca --x-feature tarafından açıkça 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 alma 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. yalnızcaikili önbelleklerinden paketleri 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

• Klasik modu yalnızca

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-write-nuget-packages-config

ikili önbelleğe almaile kullanmak üzere NuGet packages.configbiçimli bir dosya yazar.

Bu seçenek, herhangi bir paket oluşturmadan veya yüklemeden ikili önbelleğe alma işleminden gereken NuGet paketlerinin listesini almak için --dry-run ile birlikte kullanılabilir. Bu, .nupkg dosyalarını almak için alternatif protokoller kullanma gibi gelişmiş senaryolar için NuGet komut satırının ayrı olarak çağrılmalarını sağlar.

--no-print-usage

Yüklemenin sonunda yazdırılan kullanım metninin oluşturulmasını engelleme.