Derleyici ve derleme özelliklerini ayarlama

IDE'de, özellikler proje oluşturmak için gereken bilgileri kullanıma sunar. Bu bilgiler uygulama adını, uzantısını (DLL, LIB, EXE gibi), derleyici seçeneklerini, bağlayıcı seçeneklerini, hata ayıklayıcı ayarlarını, özel derleme adımlarını ve diğer birçok şeyi içerir. Genellikle bu özellikleri görüntülemek ve değiştirmek için özellik sayfalarını kullanırsınız. Özellik sayfalarına erişmek için ana menüden Proje>proje adı Özellikleri'ni seçin veya Çözüm Gezgini proje düğümüne sağ tıklayıp Özellikler'i seçin.

Varsayılan özellikler

Bir proje oluşturduğunuzda, sistem çeşitli özellikler için değerler atar. Varsayılan değerler, proje türüne ve uygulama sihirbazında hangi seçenekleri belirlediğinize bağlı olarak değişir. Örneğin, ATL projesinin MIDL dosyalarıyla ilgili özellikleri vardır, ancak bu özellikler temel konsol uygulamasında yoktur. Varsayılan özellikler, Özellik Sayfaları'nın Genel bölmesinde gösterilir:

Derleme yapılandırmalarına ve hedef platformlara özellikler uygulama

Uygulama adı gibi bazı özellikler, hata ayıklama veya sürüm derlemesi olsun, tüm derleme varyasyonlarına ve hedef platformlara uygulanır. Ancak çoğu özellik yapılandırmaya bağımlıdır. Doğru kodu oluşturmak için derleyicinin hem programın çalıştığı belirli platformu hem de kullanılacak belirli derleyici seçeneklerini bilmesi gerekir. Bu nedenle bir özellik ayarladığınızda, yeni değerin hangi yapılandırmaya ve platforma uygulanması gerektiğine dikkat etmek önemlidir. Yalnızca Win32 derlemelerinde hata ayıklama için mi yoksa ARM64 hatalarını ayıklama ve x64 hatalarını ayıklama için de mi geçerli olmalıdır? Örneğin, Optimization özelliği varsayılan olarak Bir Yayın yapılandırmasında En Üst Düzeye Çıkarma Hızı (/O2) olarak ayarlanır, ancak Hata Ayıklama yapılandırmasında devre dışı bırakılır.

Bir özellik değerinin geçerli olması gereken yapılandırmayı ve platformu istediğiniz zaman görebilir ve değiştirebilirsiniz. Aşağıdaki çizimde, üst kısımda yapılandırma ve platform bilgileri denetimleri bulunan özellik sayfaları gösterilmektedir. İyileştirme özelliği burada ayarlandığında, kırmızı oklarda gösterildiği gibi yalnızca etkin olan Win32 derlemelerinde hata ayıklama için geçerlidir.

Aşağıdaki çizimde aynı proje özellik sayfası gösterilmektedir, ancak yapılandırma Yayın olarak değiştirilmiştir. optimization özelliği için farklı bir değere dikkat edin. Ayrıca etkin yapılandırmanın hala Hata Ayıkla olduğunu unutmayın. Burada herhangi bir yapılandırmanın özelliklerini ayarlayabilirsiniz; etkin olması gerekmez.

Hedef platformlar

Hedef platform , yürütülebilir dosyanın üzerinde çalıştırılacağı cihaz ve işletim sistemi türünü ifade eder. Birden fazla platform için proje oluşturabilirsiniz. C++ projeleri için kullanılabilir hedef platformlar, proje türüne bağlıdır. Bunlar Win32, x64, ARM, ARM64, Android ve iOS içerir ancak bunlarla sınırlı değildir. Configuration Manager'da görebileceğiniz x86 hedef platformu, yerel C++ projelerindeki Win32 ile aynıdır. Win32, 32 bit Windows, x64 ise 64 bit Windows anlamına gelir. Bu iki platform hakkında daha fazla bilgi için bkz . 32 bit uygulamaları çalıştırma.

Configuration Manager'da görebileceğiniz Herhangi bir CPU hedef platformu değerinin yerel C++ projeleri üzerinde hiçbir etkisi yoktur. Yalnızca C++/CLI ve diğer .NET proje türleri için geçerlidir. Daha fazla bilgi için bkz. /CLRIMAGETYPE (CLR Görüntüsünün Türünü Belirtme).

Hata ayıklama derlemesi için özellikleri ayarlama hakkında daha fazla bilgi için bkz:

• C++ hata ayıklama yapılandırması proje ayarları
• Hata Ayıklayıcısı Ayarları ve Hazırlığı
• Hata Ayıklama Hazırlığı: Visual C++ Proje Türleri
• Visual Studio hata ayıklayıcısında simge (.pdb) ve kaynak dosyaları belirtme

C++ derleyici ve bağlayıcı seçenekleri

C++ derleyicisi ve bağlayıcı seçenekleri, yapılandırma özellikleri'nin altındaki sol bölmedeki C/C++ ve Bağlayıcı düğümlerinin altında bulunur. Bu seçenekler doğrudan derleyiciye geçirilen komut satırı seçeneklerine çevrilir. Belirli bir seçenekle ilgili belgeleri okumak için orta bölmedeki seçeneği belirleyin ve F1 tuşuna basın. İsterseniz, MSVC derleyici seçenekleri ve MSVC bağlayıcı seçeneklerindeki tüm seçeneklerin belgelerine göz atabilirsiniz.

Özellik Sayfaları iletişim kutusu yalnızca geçerli projeyle ilgili özellik sayfalarını gösterir. Örneğin, projede dosya .idl yoksa MIDL özellik sayfası görüntülenmez. Her özellik sayfasındaki ayarlar hakkında daha fazla bilgi için bkz . Özellik Sayfaları (C++).

Dizin ve yol değerleri

MSBuild, makro olarak adlandırılan dizinleri ve yolları dahil etme gibi belirli dize değerleri için derleme zamanı sabitlerinin kullanımını destekler. Makro, Visual Studio veya MSBuild sistemi tarafından tanımlanan bir değere veya kullanıcı tanımlı bir değere başvurabilir. Makrolar veya %(item-macro-name)gibi $(macro-name) görünür. Bunlar özellik sayfalarında kullanıma sunulur ve burada Özellik Düzenleyicisi'ni kullanarak bunlara başvurabilir ve bunları değiştirebilirsiniz. Dizin yolları gibi sabit kodlanmış değerler yerine makroları kullanın. Makrolar, özellikler ayarlarını makineler arasında ve Visual Studio sürümleri arasında paylaşmayı kolaylaştırır. Ayrıca, proje ayarlarınızın özellik devralma özelliğine doğru şekilde katıldığından daha iyi emin olabilirsiniz.

Aşağıdaki çizimde Visual Studio C++ projesinin özellik sayfaları gösterilmektedir. Sol bölmede VC++ Dizinleri kuralı seçilidir ve sağ bölmede bu kuralla ilişkili özellikler listelenir. Özellik değerleri genellikle gibi $(VC_SourcePath)makrolardır:

Kullanılabilir tüm makroların değerlerini görüntülemek için Özellik Düzenleyicisi'ni kullanabilirsiniz.

Önceden tanımlanmış makrolar

• Genel makrolar:
  Genel makrolar proje yapılandırmasındaki tüm öğelere uygulanır. Genel makronun söz dizimi $(name)vardır. Genel makro örneği, Visual Studio yüklemenizin kök dizinini depolayan makrodur $(VCInstallDir). Genel makro, MSBuild içindeki öğesine PropertyGroup karşılık gelir.

• Öğe makroları
  Öğe makrolarının söz dizimi %(name)vardır. Bir dosya için, öğe makroları yalnızca bu dosyaya uygulanır; örneğin, yalnızca belirli bir dosya için geçerli olan ekleme dizinlerini belirtmek için kullanabilirsiniz %(AdditionalIncludeDirectories) . Bu tür öğe makroları MSBuild'deki bir ItemGroup meta veriye karşılık gelir. Bir proje yapılandırması bağlamında kullanıldığında, bir öğe makro belirli bir türdeki tüm dosyalara uygulanır. Örneğin, C/C++ Önişlemci Tanımları yapılandırma özelliği, projedeki tüm .cpp dosyalarına uygulanan bir %(PreprocessorDefinitions) öğe makrosunu alabilir. Bu tür öğe makroları MSBuild'deki bir ItemDefinitionGroup meta veriye karşılık gelir. Daha fazla bilgi için bkz . Öğe Tanımları.

Kullanıcı tanımlı makrolar

Proje derlemelerinde değişken olarak kullanmak için kullanıcı tanımlı makrolar oluşturabilirsiniz. Örneğin, bir özel yapı adımına veya özel yapı aracına değer sağlayan kullanıcı tanımlı bir makro oluşturabilirsiniz. Kullanıcı tanımlı makro bir ad/değer çiftidir. Proje dosyasında, değere $(name) erişmek için gösterimini kullanın.

Kullanıcı tanımlı makrolar bir özellik sayfasında depolanır. Projeniz henüz bir özellik sayfası içermiyorsa, Visual Studio proje ayarlarını paylaşma veya yeniden kullanma altındaki adımları izleyerek bir tane oluşturabilirsiniz.

Kullanıcı tanımlı makro oluşturmak için

1. Özellik Yöneticisi penceresini açın. (Menü çubuğunda Özellik Yöneticisini Görüntüle>veya Diğer Windows>Özellik Yöneticisini Görüntüle>.) Özellik sayfasının kısayol menüsünü açın (adı ile biter) ve ardından Özellikler'i .userseçin. Bu özellik sayfasının Özellik Sayfaları iletişim kutusu açılır.

2. İletişim kutusunun sol bölmesinde Kullanıcı Makroları'nı seçin. Sağ bölmede Makro Ekle düğmesini seçerek Kullanıcı Makrou Ekle iletişim kutusunu açın.

3. İletişim kutusunda, makro için bir ad ve değer belirtin. İsteğe bağlı olarak, Derleme ortamında bu makroyu ortam değişkeni olarak ayarla onay kutusunu seçin.

Özellik Düzenleyicisi

Belirli dize özelliklerini değiştirmek ve makroları değer olarak seçmek için Özellik Düzenleyicisi'ni kullanabilirsiniz. Özellik Düzenleyicisi'ne erişmek için, özellik sayfasında bir özellik seçin ve sonra sağdaki aşağı ok düğmesini seçin. Açılan listede Düzenle> varsa<, bu özelliğin Özellik Düzenleyicisi'ni görüntülemek için listeyi seçebilirsiniz.

Özellik Düzenleyicisi'nde, kullanılabilir makroları ve bunların geçerli değerlerini görüntülemek için Makrolar düğmesini seçebilirsiniz. Aşağıdaki çizimde, Makrolar düğmesi seçildikten sonra Ek Ekleme Dizinleri özelliğinin Özellik Düzenleyicisi gösterilmektedir. Üst öğeden veya proje varsayılanlarından devral onay kutusu seçiliyse ve yeni bir değer eklediğinizde, devralınan tüm değerlere eklenir. Onay kutusunun işaretini kaldırırsanız, yeni değeriniz devralınan değerlerin yerini alır. Çoğu durumda, onay kutusunu seçili bırakın.

Varsayılan dizin kümesine ekleme dizini ekleme

Projeye ekleme dizini eklediğinizde, tüm varsayılan dizinleri geçersiz kılmamak önemlidir. Dizin eklemenin doğru yolu, "" gibiC:\MyNewIncludeDir\ yeni yolu eklemek ve ardından makroyu $(IncludePath) özellik değerine eklemektir.

Tüm özelliklere hızla göz atma ve arama

Tüm Seçenekler özellik sayfası (Özellik Sayfaları iletişim kutusundaki Yapılandırma Özellikleri>C/C++ düğümü altında), geçerli bağlamda kullanılabilen özelliklere göz atmak ve bunları aramak için hızlı bir yol sağlar. Özel bir arama kutusu ve sonuçlara filtre uygulamanıza yardımcı olacak basit bir sözdizimi vardır:

Önek yok:
Yalnızca özellik adlarında arayın (büyük/küçük harf duyarsız alt dize).

'/' veya '-':
Yalnızca derleyici anahtarlarında arayın (büyük/küçük harf duyarsız önek)

v:
Yalnızca değerlerde arayın (büyük/küçük harf duyarsız alt dize).

Derleme için ortam değişkenlerini ayarlama

MSVC derleyicisi (cl.exe), özellikle LIB, LIBPATH, PATHve INCLUDEgibi belirli ortam değişkenlerini tanır. IDE ile derleme yaptığınızda, bu ortam değişkenlerini ayarlamak için VC++ Dizinleri Özellik Sayfasında ayarlanan özellikler kullanılır. , LIBPATHve INCLUDE değerleri, örneğin Geliştirici Komut İstemi tarafından zaten ayarlanmışsaLIB, bunlar ilgili MSBuild özelliklerinin değerleriyle değiştirilir. Derleme daha sonra VC++ Dizinleri yürütülebilir dizinleri özelliğinin değerini öğesine ekler PATH. Kullanıcı tanımlı bir makro oluşturup bu makroyu derleme ortamında ortam değişkeni olarak ayarla yazan kutuyu işaretleyerek kullanıcı tanımlı bir ortam değişkeni ayarlayabilirsiniz.

Hata ayıklama oturumu için ortam değişkenlerini ayarlama

Projenin Özellik Sayfaları iletişim kutusunun sol bölmesinde Yapılandırma Özellikleri'ni genişletin ve hata ayıklama'yı seçin.

Sağ bölmede Ortam veya Birleştirme Ortamı proje ayarlarını değiştirin ve ardından Tamam düğmesini seçin.

Bu bölümde

Visual Studio projelerinin ayarlarını paylaşma veya yeniden kullanma
Paylaşılabilen veya yeniden kullanılabilen özel derleme ayarlarına sahip bir .props dosya oluşturma.

Proje özelliği devralma
Derleme işlemindeki .props, , .targets.vcxproj dosyaları ve ortam değişkenleri için değerlendirme sırasını açıklar.

Proje dosyasını değiştirmeden özellikleri ve hedefleri değiştirme
Proje dosyasını değiştirmek zorunda kalmadan geçici derleme ayarları oluşturma.

Ayrıca bkz.

Visual Studio Projeleri - C++
.vcxproj ve .props dosya yapısı
Özellik sayfası XML dosyaları