Öğretici: Visual Studio'da MSBuild ile paketleri yükleme ve kullanma
Bu öğreticide MSBuild, vcpkg ve Visual Studio ile kitaplığını kullanan fmt
bir C++ "Merhaba Dünya" programının nasıl oluşturulacağı gösterilmektedir. Bağımlılıkları yükleyecek, basit bir uygulama yapılandıracak, derleyecek ve çalıştıracaksınız.
Ön koşullar:
- C++ geliştirme iş yükü ile Visual Studio
- Git
- Windows 7 veya üzeri
1 - vcpkg ayarlama
Depoyu kopyalama
İlk adım, vcpkg deposunu GitHub'dan kopyalamaktır. Depo, vcpkg yürütülebilir dosyasını ve vcpkg topluluğu tarafından tutulan seçilmiş açık kaynak kitaplıklarının kayıt defterini almaya yönelik betikler içerir. Bunu yapmak için şunu çalıştırın:
git clone https://github.com/microsoft/vcpkg.git
Vcpkg tarafından seçilen kayıt defteri, 2.000'den fazla açık kaynak kitaplık kümesidir. Bu kitaplıklar vcpkg'nin sürekli tümleştirme işlem hatları tarafından birlikte çalışacak şekilde doğrulanmıştır. vcpkg deposu bu kitaplıkların kaynak kodunu içermese de, bunları derlemek ve sisteminize yüklemek için tarifler ve meta veriler içerir.
Bootstrap betiğini çalıştırma
Artık vcpkg deposunu kopyaladığınıza göre dizine
vcpkg
gidin ve bootstrap betiğini yürütebilirsiniz:cd vcpkg && bootstrap-vcpkg.bat
cd vcpkg; .\bootstrap-vcpkg.bat
cd vcpkg && ./bootstrap-vcpkg.sh
Bootstrap betiği önkoşul denetimleri gerçekleştirir ve vcpkg yürütülebilir dosyasını indirir.
İşte hepsi bu! vcpkg ayarlandı ve kullanıma hazır.
- Visual Studio MSBuild ile tümleştirme
Sonraki adım, MSBuild'in bulabilmesi için vcpkg'nin kullanıcı genelindeki örneğini ayarlamaktır:
.\vcpkg.exe integrate install
Bu, şu çıkışı üretir:
All MSBuild C++ projects can now #include any installed libraries. Linking will be handled automatically. Installing new libraries will make them instantly available.
2 - Visual Studio projesini ayarlama
Visual Studio projesini oluşturma
- "Konsol Uygulaması" şablonunu kullanarak Visual Studio'da yeni proje oluşturma
Visual Studio'da yeni bir C++ Windows konsol uygulamasının nasıl oluşturulacağını gösteren Visual Studio kullanıcı arabiriminin ekran görüntüsü
- Projenize "helloworld" adını verin
- "Çözümü ve projeyi aynı dizine yerleştir" kutusunu işaretleyin.
- "Oluştur" düğmesine tıklayın
MSBuild C++ projenizi adlandırmak ve "oluştur" düğmesine tıklamak için Visual Studio kullanıcı arabiriminin ekran görüntüsü.
Ortam değişkenini
VCPKG_ROOT
yapılandırın.Visual Studio'da yerleşik Geliştirici PowerShell penceresini açın.
Yerleşik PowerShell geliştirici penceresi için Visual Studio kullanıcı arabiriminin ekran görüntüsü
Aşağıdaki komutları çalıştırın:
$env:VCPKG_ROOT = "C:\path\to\vcpkg" $env:PATH = "$env:VCPKG_ROOT;$env:PATH"
VCPKG_ROOT ayarlamayı ve PATH'e eklemeyi gösteren yerleşik PowerShell geliştirici penceresi için Visual Studio kullanıcı arabiriminin ekran görüntüsü.
Not
Ortam değişkenlerini bu şekilde ayarlamak yalnızca geçerli terminal oturumunu etkiler. Bu değişiklikleri tüm oturumlarda kalıcı hale getirmek için Bunları Windows Sistem Ortamı Değişkenleri paneli aracılığıyla ayarlayın.
Visual Studio'da Geliştirici komut istemini açın.
Geliştirici komut istemi için Visual Studio kullanıcı arabiriminin ekran görüntüsü.
Aşağıdaki komutları çalıştırın:
set VCPKG_ROOT="C:\path\to\vcpkg" set PATH=%VCPKG_ROOT%;%PATH%
VCPKG_ROOT ayarlamayı ve PATH'e eklemeyi gösteren Visual Studio geliştirici komut isteminin ekran görüntüsü.
Not
Ortam değişkenlerini bu şekilde ayarlamak yalnızca geçerli terminal oturumunu etkiler. Bu değişiklikleri tüm oturumlarda kalıcı hale getirmek için Bunları Windows Sistem Ortamı Değişkenleri paneli aracılığıyla ayarlayın.
Ayar
VCPKG_ROOT
, Visual Studio'nın vcpkg örneğinizi bulmasına yardımcı olur. Bunu eklemekPATH
, vcpkg komutlarını doğrudan kabuktan çalıştırabilmenizi sağlar.Bir bildirim dosyası oluşturun ve bağımlılıkları ekleyin.
Bir vcpkg bildirim dosyası (
vcpkg.json
) oluşturmak için aşağıdaki komutu çalıştırın:vcpkg new --application
komutu projenin
vcpkg new
dizinine birvcpkg.json
dosya ve birvcpkg-configuration.json
dosya ekler.fmt
Paketi bağımlılık olarak ekleyin:vcpkg add port fmt
Artık şu
vcpkg.json
içeriği içermelidir:{ "dependencies": [ "fmt" ] }
Bu, bildirim dosyanızdır. vcpkg, hangi bağımlılıkların yükleneceğini öğrenmek için bildirim dosyasını okur ve projenizin gerektirdiği bağımlılıkları sağlamak için MSBuild ile tümleşir.
Oluşturulan
vcpkg-configuration.json
dosya, projenin bağımlılıklarına en düşük sürüm kısıtlamaları getiren bir temel sunar. Bu dosyayı değiştirmek bu öğreticinin kapsamının dışındadır. Bu öğreticide geçerli olmasa da, farklı geliştirme ortamlarında sürüm tutarlılığı sağlamak için dosyayı kaynak denetimi altında tutmakvcpkg-configuration.json
iyi bir uygulamadır.
3 - Proje dosyalarını ayarlama
helloworld.cpp
dosyasını değiştirin.
öğesinin içeriğini helloworld.cpp
aşağıdaki kodla değiştirin:
#include <fmt/core.h>
int main()
{
fmt::print("Hello World!\n");
return 0;
}
Bu kaynak dosya kitaplığın <fmt/core.h>
parçası fmt
olan üst bilgiyi içerir. İşlev, main()
konsola "Merhaba Dünya!" iletisinin çıkışını almak için çağırırfmt::print()
.
Not
MSBuild ilk kez projenizde hata dalgalı çizgiler olacaktır. Vcpkg bağımlılıklarını kaldırmak için projeyi derleyin.
4 - Bildirim modunu etkinleştirme
Projenizin Proje Özellikleri sayfalarına gidin. Yapılandırma Özellikleri > vcpkg altında olarak Yes
ayarlayınUse vcpkg manifest
. MSBuild, vcpkg bildiriminden bağımlılıkları yüklemeden önce bu özelliğin ayarlanıp ayarlanmadığını denetler.
Visual Studio Proje Özellikleri'nde vcpkg bildirim modunu etkinleştirme işleminin ekran görüntüsü
Üçlüler gibi diğer ayarlar, vcpkg tarafından projenizden algılanan varsayılan değerlerle doldurulur ve projenizi yapılandırırken yararlı olur.
5 - Projeyi derleme ve çalıştırma
Projeyi derleyin.
Visual Studio'da projeyi derlemek ve vcpkg bağımlılıklarını almak için basın
Ctrl+Shift+B
.
MSBuild projenizde bir vcpkg.json
dosya algılarsa ve bildirimler etkinleştirilirse, MSBuild bildirimin bağımlılıklarını derleme öncesi bir adım olarak yükler. Bağımlılıklar, projenin derleme çıktı dizinindeki bir vcpkg_installed
dizine yüklenir. Kitaplık tarafından yüklenen tüm üst bilgiler doğrudan kullanılabilir ve yüklenen tüm kitaplıklar otomatik olarak bağlanır.
Not
vcpkg install
bir kitaplık için hem Hata Ayıklama hem de Yayın yapılandırmalarını oluşturur. Yalnızca sürüm kitaplıkları oluşturmak için üçlünüze ekleyin VCPKG_RELEASE_ONLY
.
Uygulamayı çalıştırın.
Son olarak yürütülebilir dosyayı çalıştırın:
Yürütülebilir dosyayı çalıştırmak için Visual Studio kullanıcı arabiriminin ekran görüntüsü.
Çıktıyı görmeniz gerekir:
Program çıkışlarının ekran görüntüsü - "Merhaba Dünya!"
Sonraki adımlar
ve vcpkg MSBuild tümleştirmesi hakkında vcpkg.json
daha fazla bilgi edinmek için başvuru belgelerimize bakın:
Geri Bildirim
https://aka.ms/ContentUserFeedback.
Çok yakında: 2024 boyunca, içerik için geri bildirim mekanizması olarak GitHub Sorunları’nı kullanımdan kaldıracak ve yeni bir geri bildirim sistemiyle değiştireceğiz. Daha fazla bilgi için bkz.Gönderin ve geri bildirimi görüntüleyin