Condividi tramite


Personalizzare le compilazioni C++

È possibile usare Directory.Build.props e Directory.Build.targets per personalizzare tutti i progetti C++ in una cartella padre comune. Vedere Personalizzare per cartella. Inoltre, i progetti C++ forniscono i punti di estendibilità seguenti. È possibile usare le proprietà per specificare o importare .props automaticamente i file prima o dopo i file Microsoft.Cpp.* :.targets

  • ForceImportAfterCppDefaultProps
  • ForceImportBeforeCppProps
  • ForceImportAfterCppProps
  • ForceImportBeforeCppTargets
  • ForceImportAfterCppTargets

Queste importazioni forniscono il controllo sulla sequenza delle definizioni delle proprietà che dipendono da altre proprietà o destinazioni che dipendono da altre destinazioni. La sequenza di importazioni in un .vcxproj oggetto è simile alla seguente:

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

Vedere .vcxproj e la struttura del file props. Se è necessario definire proprietà che usano altre proprietà definite in Microsoft.Cpp.default.props o Microsoft.Cpp.props, è possibile creare un altro .props file (ad esempio, MyProps.props) e definire la ForceImportAfterCppProps proprietà in Directory.Build.props modo che punti al file:

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

MyProps.props verrà importato automaticamente alla fine di Microsoft.Cpp.props.

Personalizzare tutte le compilazioni C++

La personalizzazione dell'installazione di Visual Studio non è consigliata, poiché non è facile tenere traccia di tali personalizzazioni, ma se si estende Visual Studio per personalizzare le compilazioni C++ per una determinata piattaforma, è possibile creare .targets file per ogni piattaforma e inserirli nelle cartelle di importazione appropriate per tali piattaforme come parte di un'estensione di Visual Studio.

Il .targets file per la piattaforma Win32, Microsoft.Cpp.Win32.targets, contiene l'elemento seguente Import :

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

C'è un elemento simile alla fine dello stesso file:

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

Esistono elementi di importazione simili per altre piattaforme di destinazione in *%ProgramFiles32%\MSBuild\Microsoft.Cpp\v{version}\Platforms*.

Dopo aver inserito il .targets file nella cartella appropriata ImportAfter in base alla piattaforma, MSBuild importa il file in ogni compilazione C++ per tale piattaforma. Se necessario, è possibile inserire più .targets file.

Usando l'estendibilità di Visual Studio, sono possibili ulteriori personalizzazioni, ad esempio la definizione di una nuova piattaforma. Per altre informazioni, vedere Estendibilità del progetto C++.

Specificare un'importazione personalizzata nella riga di comando

Per la personalizzazione .targets da includere per una compilazione specifica di un progetto C++, impostare una o entrambe le proprietà ForceImportBeforeCppTargets e ForceImportAfterCppTargets nella riga di comando.

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

Per un'impostazione globale ,ad esempio tutte le build C++ per una piattaforma in un server di compilazione, sono disponibili due metodi. Prima di tutto, è possibile impostare queste proprietà usando una variabile di ambiente di sistema sempre impostata. Questa tecnica funziona perché MSBuild legge sempre l'ambiente e crea (o esegue l'override) delle proprietà per tutte le variabili di ambiente.