Procedura: specificare eventi di compilazione (C#)

Articolo
09/12/2008

Aggiornamento: novembre 2007

È possibile utilizzare gli eventi di compilazione per specificare i comandi da eseguire prima dell'inizio o al termine della compilazione. Gli eventi di compilazione vengono eseguiti solo se la generazione raggiunge correttamente quei punti nel processo di compilazione.

Quando un progetto viene compilato, gli eventi di pre-compilazione vengono aggiunti a un file denominato PreBuildEvent.bat mentre gli eventi di post-compilazione vengono aggiunti a un file denominato PostBuildEvent.bat. Per garantire il controllo degli errori, aggiungere i comandi di controllo degli errori alle istruzioni di compilazione.

Nota:
Nel computer in uso è possibile che vengano visualizzati nomi o percorsi diversi per alcuni elementi dell'interfaccia utente di Visual Studio nelle istruzioni seguenti. La versione di Visual Studio in uso e le impostazioni configurate determinano questi elementi. Per ulteriori informazioni vedere Impostazioni di Visual Studio.

Come specificare gli eventi di pre-compilazione e post-compilazione

Per specificare un evento di compilazione

In Esplora soluzioni selezionare il progetto per il quale si desidera specificare l'evento di compilazione.
Scegliere Proprietà dal menu Progetto.
Fare clic sulla scheda Eventi di compilazione.
Nella casella Riga di comando eventi pre-compilazione specificare la sintassi per l'evento di compilazione.

Nota:

Gli eventi pre-compilazione non vengono eseguiti se il progetto è aggiornato e non viene attivata la compilazione.
Nella casella Riga di comando eventi post-compilazione specificare la sintassi per l'evento di compilazione.

Nota:

Aggiungere un'istruzione call prima di tutti i comandi di post-compilazione che eseguono file BAT. Ad esempio, call C:\MyFile.bat o call C:\MyFile.bat call C:\MyFile2.bat.

Nota:
Gli eventi pre-compilazione non vengono eseguiti se il progetto è aggiornato e non viene attivata la compilazione.

Nota:
Aggiungere un'istruzione call prima di tutti i comandi di post-compilazione che eseguono file BAT. Ad esempio, call C:\MyFile.bat o call C:\MyFile.bat call C:\MyFile2.bat.

Nella casella Esegui evento post-compilazione specificare in quali condizioni eseguire l'evento di post-compilazione.

Nota:
Per aggiungere una sintassi più lunga o per selezionare macro di compilazione dalla Finestra di dialogo Riga di comando eventi pre-generazione/post-generazione, fare clic sul pulsante con i puntini di sospensione (…) per visualizzare una casella di testo.

La sintassi dell'evento di compilazione può includere qualsiasi comando valido a un prompt dei comandi oin un file bat. Il nome di un file batch deve essere preceduto da call per essere certi che verranno eseguiti tutti i comandi successivi.

Nota Se l'evento di pre-compilazione o post-compilazione non viene completato correttamente, è possibile terminare la compilazione impostando l'azione evento in modo che si chiuda con un codice diverso da zero (0), che indica un'azione riuscita.

Esempio: come modificare le informazioni del manifesto utilizzando un evento di post-compilazione

La procedura descritta di seguito illustra come impostare la versione minima del sistema operativo nel manifesto dell'applicazione utilizzando un comando exe chiamato da un evento di post-compilazione (il file exe.manifest nella directory del progetto). La versione minima del sistema operativo è un numero costituito da quattro parti, ad esempio 4.10.0.0. Per eseguire questa operazione, il comando modificherà la sezione <dependentOS> del manifesto:

<dependentOS>
   <osVersionInfo>
      <os majorVersion="4" minorVersion="10" buildNumber="0" servicePackMajor="0" />
   </osVersionInfo>
</dependentOS>

Per creare un comando exe per la modifica del manifesto dell'applicazione

Creare un'applicazione console per il comando. Scegliere Nuovo dal menu File, quindi selezionare Progetto.
Nella finestra di dialogo Nuovo progetto espandere il nodo Visual C#, selezionare Windows e fare clic sul modello Applicazione console. Assegnare il nome ChangeOSVersionCS al progetto.
In Program.cs, aggiungere la riga seguente all'altra istruzione using nella parte superiore del file:
```
using System.Xml;
```

Nello spazio dei nomi ChangeOSVersionCS sostituire l'implementazione della classe Program con il seguente codice:

class Program
{
   /// <summary>
   /// This function will set the minimum operating system version for a ClickOnce application.
   /// </summary>
   /// <param name="args">
   /// Command Line Arguments:
   /// 0 - Path to application manifest (.exe.manifest).
   /// 1 - Version of OS
   ///</param>
   static void Main(string[] args)
   {
      string applicationManifestPath = args[0];
      Console.WriteLine("Application Manifest Path: " + applicationManifestPath);

      // Get version name.
      Version osVersion = null;
      if (args.Length >=2 ){
         osVersion = new Version(args[1]);
      }else{
         throw new ArgumentException("OS Version not specified.");
      }
      Console.WriteLine("Desired OS Version: " + osVersion.ToString());

      XmlDocument document;
      XmlNamespaceManager namespaceManager;
      namespaceManager = new XmlNamespaceManager(new NameTable());
      namespaceManager.AddNamespace("asmv1", "urn:schemas-microsoft-com:asm.v1");
      namespaceManager.AddNamespace("asmv2", "urn:schemas-microsoft-com:asm.v2");

      document = new XmlDocument();
      document.Load(applicationManifestPath);

      string baseXPath;
      baseXPath = "/asmv1:assembly/asmv2:dependency/asmv2:dependentOS/asmv2:osVersionInfo/asmv2:os";

      // Change minimum required operating system version.
      XmlNode node;
      node = document.SelectSingleNode(baseXPath, namespaceManager);
      node.Attributes["majorVersion"].Value = osVersion.Major.ToString();
      node.Attributes["minorVersion"].Value = osVersion.Minor.ToString();
      node.Attributes["buildNumber"].Value = osVersion.Build.ToString();
      node.Attributes["servicePackMajor"].Value = osVersion.Revision.ToString();

      document.Save(applicationManifestPath);
   }
}

Il comando accetta due argomenti: il percorso del manifesto dell'applicazione, la cartella in cui viene creato il manifesto durante il processo di compilazione, che in genere corrisponde a Projectname.publish, e la nuova versione del sistema operativo.

Compilare il progetto. Scegliere Compila soluzione dal menu Compila.
Copiare il file exe in una directory, ad esempio C:\TEMP\ChangeOSVersionVB.exe.

Quindi, richiamare questo comando in un evento di post-compilazione per modificare il manifesto dell'applicazione.

Per richiamare un evento di post-compilazione e modificare il manifesto dell'applicazione

Creare un'applicazione Windows per il progetto da pubblicare. Scegliere Nuovo dal menu File, quindi selezionare Progetto.
Nella finestra di dialogo Nuovo progetto espandere il nodo Visual C#, selezionare Windows e fare clic sul modello Applicazione Windows Form. Assegnare il nome CSWinApp al progetto.
Con il progetto selezionato in Esplora soluzioni, scegliere Proprietà dal menu Progetto.
In Progettazione progetti passare alla pagina Pubblica e impostare Posizione pubblicazione su C:\TEMP\.
Pubblicare il progetto facendo clic su Pubblica.

Il file manifesto verrà compilato e collocato in C:\TEMP\CSWinApp_1_0_0_0\CSWinApp.exe.manifest. Per visualizzare il manifesto, fare clic con il pulsante destro del mouse sul file e scegliere Apri con, quindi fare clic su Seleziona il programma in un elenco e selezionare Blocco note.

Cercare l'elemento <osVersionInfo> nel file. Ad esempio, la versione potrebbe essere la seguente:
```
<os majorVersion="4" minorVersion="10" buildNumber="0" servicePackMajor="0" />
```
In Progettazione progetti fare clic sulla scheda Eventi di compilazione e quindi sul pulsante Modifica post-compilazione.
Nella casella Riga di comando eventi post-compilazione immettere il seguente comando:

C:\TEMP\ChangeOSVersionCS.exe "$(TargetPath).manifest" 5.1.2600.0

Al momento della compilazione del progetto, questo comando imposterà la versione minima del sistema operativo nel manifesto dell'applicazione su 5.1.2600.0.

La macro $(TargetPath) indica il percorso completo dell'eseguibile in fase di creazione, pertanto $(TargetPath).manifest specificherà il manifesto dell'applicazione creato nella directory bin. Con la pubblicazione, questo manifesto verrà copiato nel percorso di pubblicazione impostato in precedenza.
Pubblicare nuovamente il progetto. Accedere alla pagina Pubblica e fare clic su Pubblica.

Visualizzare nuovamente il manifesto. Per visualizzare il manifesto, passare alla directory di pubblicazione, fare clic con il pulsante destro del mouse sul file e scegliere Apri con, quindi fare clic su Selezionare il programma in un elenco e selezionare Blocco note.

La versione dovrebbe risultare come segue:
```
<os majorVersion="5" minorVersion="1" buildNumber="2600" servicePackMajor="0" />
```

Vedere anche

Condividi tramite

Procedura: specificare eventi di compilazione (C#)

Come specificare gli eventi di pre-compilazione e post-compilazione

Per specificare un evento di compilazione

Esempio: come modificare le informazioni del manifesto utilizzando un evento di post-compilazione

Per creare un comando exe per la modifica del manifesto dell'applicazione

Per richiamare un evento di post-compilazione e modificare il manifesto dell'applicazione

Vedere anche

Attività

Riferimenti

Altre risorse

Risorse aggiuntive