Kavram: Bağlantı noktaları
vcpkg'deki bir bağlantı noktası, bir dosya kümesi oluşturan sürüme sahip bir tariftir. Bağlantı noktasının yürütülmesi, yeni üst bilgi veya ikili dosyalar oluşturarak yükleme grafını etkiler. Bağlantı noktalarının diğer bağlantı noktalarına bağımlılıkları olabilir ve belirli özellikler etkinleştirildiğinde ek bağımlılıklar gerektirebilir. Bu bağımlılıkların bağlantı noktası meta verilerine yansıtılması gerekir. En azından bir bağlantı noktası şunları içerir:
- Paket hakkındaki meta veriler: ad, sürüm, desteklenen özellikler, bağımlılıklar vb.
- Paketi alma, gerekirse derleme ve yükleme yönergeleri.
Ayrıca bağlantı noktaları şunları içerebilir:
- Paketin kaynak koduna uygulanacak düzeltme ekleri
- Projenizin derleme sistemiyle tümleştirme yönergeleri
Bağlantı noktası dosyası (portfile.cmake
)
Tüm bağlantı noktaları bir bağlantı noktası dosyası (adlı portfile.cmake
bir dosya) içermelidir. Portfile, vcpkg ortamında paket oluşturma ve yükleme yönergelerini içeren bir betiktir. Bağlantı noktası dosyaları tarafından gerçekleştirilen bazı yaygın görevler şunlardır:
- Paketin kaynak kodunu indirin.
- Yukarı akış derleme sistemini kullanarak paketi derleyin.
- Derleme çıkışını vcpkg yükleme ağacına kopyalayın.
- Derleme sistemi tümleştirme dosyalarını yükleyin.
vcpkg.json
Dosya, vcpkg.json
vcpkg bağlantı noktasında bulunan paketle ilgili meta verileri açıklar. Bu dosya paketin adı, sürümü, açıklaması, bağımlılıkları, desteklenen özellikler ve platformlar gibi öznitelikleri tanımlar. vcpkg.json
Daha fazla bilgi edinmek için dosya başvurusuna bakın.
CONTROL dosyaları
Uyarı
CONTROL
dosyalar kullanım dışıdır ve yalnızca geriye dönük uyumluluk için korunur.
CONTROL
vcpkg'deki dosyalar, vcpkg'nin yükleyebileceği bir paket veya "bağlantı noktası" hakkındaki ayrıntıları belirten meta veri dosyaları görevi görür. Bu dosyalar kullanım dışıdır ve büyük ölçüde yeni bağlantı noktaları için bildirim dosyalarıyla vcpkg.json
değiştirilmiştir. Ancak geriye dönük uyumluluk için korunurlar. Daha fazla bilgi için bkz . denetim dosyaları .
Dosyalara düzeltme eki uygulama
Bazı senaryolarda, bağlantı noktası düzeltme eki dosyalarını içerebilir. Bu dosyalar, kitaplığın kaynak kodunda var olan sorunları düzeltmek veya diğer bileşenlerle uyumluluğu korumak için gerekli olan değişiklikleri taşır. Derleme işlemi başlamadan önce, düzeltme ekleri portfile tarafından yürütülen adımların bir parçası olarak uygulanır ve sorunsuz ve hatasız kitaplık tümleştirmesini kolaylaştırır. Daha fazla bilgi edinmek için bakımcı kılavuzuna başvurun.
Bağlantı noktası kategorileri
Bağlantı noktası kategorileri, bakımcıların farklı bağlantı noktalarının vcpkg içinde oynadığı rolleri ifade etmek için kullandığı birlikte kullanılan terimlerdir. Bu kategoriler genel işlevlerin açıklanmasında yardımcı olsa da, özelliklerine ve kullanım örneklerine bağlı olarak herhangi bir bağlantı noktasının birden çok kategoriye ait olabileceğine veya belki de hiç kategoriye ait olmadığını belirtmek gerekir.
Standart bağlantı noktası
Standart bağlantı noktası, kaynaktan kitaplık oluşturmak veya yalnızca üst bilgi kitaplıkları için üst bilgi dosyaları sağlamak için bir tarif görevi görür. Kitaplığı almak, derlemek ve yüklemek için gereken yönergeleri ve meta verileri içerir. Seçilen kayıt defterindeki kitaplıkların büyük çoğunluğu standart bağlantı noktalarıdır.
Meta bağlantı noktası
Meta bağlantı noktası, kendi derleme dosyalarına sahip olmadan yükleme grafiğine kısıtlamalar getirmeye hizmet eder. Bu bağlantı noktaları genellikle bir dizi ilgili kitaplıkları tek bir ad altında gruplandırmak veya değiştirilebilir bileşenler için bir dolaylı katman görevi görmek için kullanılır. Örneğin, boost
daha kolay bağımlılık yönetimi için çeşitli Boost kitaplıklarını tek bir ad altında gruplandıran bir meta bağlantı noktasıdır.
Betik bağlantı noktası
Betik bağlantı noktası, birincil olarak vcpkg içindeki iç görevlere veya diğer bağlantı noktaları tarafından kullanıma yönelik yardımcı program betikleri içerir. Bu bağlantı noktaları, yardımcı program betiklerinin sürümüne olanak tanıyarak uyumluluğu ve standartlaştırmayı korur. Örneğin, vcpkg-cmake
yardımcı işlevini kullanıma vcpkg_cmake_configure()
sunan bir betik bağlantı noktasıdır.
Sonraki adımlar
Bu belge, vcpkg'deki bağlantı noktalarına genel bir bakış sağlar ve temel öğelerini ve çeşitli kategorileri ayrıntılarıyla açıklar. Daha gelişmiş konular ve ayrıntılı kılavuzlar için aşağıdakilere bakın: