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-buildve --clean-packages-after-buildgeçirmekle --clean-buildtrees-after-buildaynı 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.configbiç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.