Menyesuaikan build C++

Anda dapat menggunakan Directory.Build.props dan Directory.Build.targets untuk menyesuaikan semua proyek C++ di bawah folder induk umum. Lihat Kustomisasi menurut folder. Selain itu, proyek C++ menyediakan titik ekstensibilitas berikut. Anda dapat menggunakan properti untuk menentukan .props atau .targets file yang akan diimpor secara otomatis sebelum atau sesudah file Microsoft.Cpp.* :

• ForceImportAfterCppDefaultProps
• ForceImportBeforeCppProps
• ForceImportAfterCppProps
• ForceImportBeforeCppTargets
• ForceImportAfterCppTargets

Impor ini memberikan kontrol atas urutan definisi properti yang bergantung pada properti lain, atau target yang bergantung pada target lain. Urutan impor dalam .vcxproj tampilan seperti ini:

   vcxproj
      Microsoft.Cpp.default.props
         Microsoft.Common.props
            Directory.Build.props
      Microsoft.Cpp.props
      Microsoft.Cpp.targets
         Microsoft.Common.targets
            Directory.Build.targets

Lihat struktur file .vcxproj dan .props. Jika Anda perlu menentukan properti yang menggunakan properti lain yang ditentukan dalam Microsoft.Cpp.default.props atau Microsoft.Cpp.props, Anda dapat membuat file lain .props (misalnya, MyProps.props), dan menentukan ForceImportAfterCppProps properti dalam Directory.Build.props menunjuk ke properti tersebut:

<PropertyGroup>
  <ForceImportAfterCppProps>$(MSBuildThisFileDirectory)\MyProps.props</ForceImportAfterCppProps>
</PropertyGroup>

MyProps.props akan diimpor secara otomatis di akhir Microsoft.Cpp.props.

Menyesuaikan semua build C++

Menyesuaikan penginstalan Visual Studio tidak disarankan, karena tidak mudah untuk melacak kustomisasi tersebut, tetapi jika Anda memperluas Visual Studio untuk menyesuaikan build C++ untuk platform tertentu, Anda dapat membuat file .targets untuk setiap platform dan menempatkannya di folder impor yang sesuai untuk platform tersebut sebagai bagian dari ekstensi Visual Studio.

File .targets untuk platform Win32, Microsoft.Cpp.Win32.targets, berisi elemen Import berikut:

<Import Project="$(VCTargetsPath)\Platforms\Win32\ImportBefore\*.targets"
        Condition="Exists('$(VCTargetsPath)\Platforms\Win32\ImportBefore')"
/>

Ada elemen serupa di dekat akhir file yang sama:

<Import Project="$(VCTargetsPath)\Platforms\Win32\ImportAfter\*.targets"
        Condition="Exists('$(VCTargetsPath)\Platforms\Win32\ImportAfter')"
/>

Elemen impor serupa ada untuk platform target lain di *%ProgramFiles32%\MSBuild\Microsoft.Cpp\v{version}\Platforms*.

Setelah Anda menempatkan file .targets di folder ImportAfter yang sesuai dengan platform, MSBuild mengimpor file Anda ke setiap build C++ untuk platform tersebut. Anda dapat meletakkan beberapa file .targets di sana, jika diperlukan.

Menggunakan ekstensibilitas Visual Studio, penyesuaian lebih lanjut dimungkinkan, seperti menentukan platform baru. Untuk informasi selengkapnya, lihat ekstensibilitas proyek C++.

Menentukan impor kustom pada baris perintah

Untuk .targets kustom yang ingin Anda sertakan untuk build tertentu dari proyek C++, atur satu atau kedua properti ForceImportBeforeCppTargets dan ForceImportAfterCppTargets pada baris perintah.

msbuild /p:ForceImportBeforeCppTargets="C:\build\config\Custom.Before.Microsoft.Cpp.Targets" MyCppProject.vcxproj

Untuk pengaturan global (untuk memengaruhi, misalnya, semua build C++ untuk platform di server build), ada dua metode. Pertama, Anda dapat mengatur properti ini menggunakan variabel lingkungan sistem yang selalu diatur. Teknik ini berfungsi karena MSBuild selalu membaca lingkungan dan membuat (atau mengambil alih) properti untuk semua variabel lingkungan.

Konten terkait

• Sesuaikan build Anda.