Ho una soluzione con più progetti. Sto cercando di ottimizzare i file AssemblyInfo.cs collegando un file di informazioni sull'assieme a livello di soluzione. Quali sono le migliori pratiche per farlo? Quali attributi dovrebbero essere nel file di soluzione e quali sono specifici di progetto / assembly?
Modifica: se sei interessato c'è una domanda di follow-up Quali sono le differenze tra AssemblyVersion, AssemblyFileVersion e AssemblyInformationalVersion?
Risposte:
Stiamo usando un file globale chiamato GlobalAssemblyInfo.cs e uno locale chiamato AssemblyInfo.cs. Il file globale contiene i seguenti attributi:
[assembly: AssemblyProduct("Your Product Name")]
[assembly: AssemblyCompany("Your Company")]
[assembly: AssemblyCopyright("Copyright © 2008 ...")]
[assembly: AssemblyTrademark("Your Trademark - if applicable")]
#if DEBUG
[assembly: AssemblyConfiguration("Debug")]
#else
[assembly: AssemblyConfiguration("Release")]
#endif
[assembly: AssemblyVersion("This is set by build process")]
[assembly: AssemblyFileVersion("This is set by build process")]AssemblyInfo.cs locale contiene i seguenti attributi:
[assembly: AssemblyTitle("Your assembly title")]
[assembly: AssemblyDescription("Your assembly description")]
[assembly: AssemblyCulture("The culture - if not neutral")]
[assembly: ComVisible(true/false)]
// unique id per assembly
[assembly: Guid("xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx")]È possibile aggiungere GlobalAssemblyInfo.cs utilizzando la seguente procedura:
AssemblyCultureAttributemerita una spiegazione migliore. È meglio che l'attributo sia completamente assente (a meno che non si tratti di un assembly satellite). Quando si utilizzano assiemi satellitari su larga scala, potrebbero essere necessari tre, non due livelli di file di informazioni sull'assieme (globale, assieme principale e assieme satellite che specifica solo la cultura in questo caso).
Nel mio caso, stiamo costruendo un prodotto per il quale abbiamo una soluzione Visual Studio, con vari componenti nei loro progetti. Gli attributi comuni vanno. Nella soluzione, ci sono circa 35 progetti e informazioni sull'assembly comune (CommonAssemblyInfo.cs), che ha i seguenti attributi:
[assembly: AssemblyCompany("Company")]
[assembly: AssemblyProduct("Product Name")]
[assembly: AssemblyCopyright("Copyright © 2007 Company")]
[assembly: AssemblyTrademark("Company")]
//This shows up as Product Version in Windows Explorer
//We make this the same for all files in a particular product version. And increment it globally for all projects.
//We then use this as the Product Version in installers as well (for example built using Wix).
[assembly: AssemblyInformationalVersion("0.9.2.0")]Gli altri attributi come AssemblyTitle, AssemblyVersion ecc. Vengono forniti in base al singolo assemblaggio. Quando si costruisce un assieme, sia AssemblyInfo.cs che CommonAssemblyInfo.cs sono incorporati in ciascun assieme. Questo ci dà il meglio di entrambi i mondi in cui potresti voler avere alcuni attributi comuni per tutti i progetti e valori specifici per alcuni altri.
Spero che aiuti.
<Compile Include="$(MSBuildThisFileDirectory)..\Common\CommonAssemblyInfo.cs"/>, una direttiva MSBuild che potrebbe anche essere in una condivisioneCommon.targets file . Riutilizzo del codice yay.
La soluzione presentata da @JRoppert è quasi la stessa di quello che faccio. L'unica differenza è che ho inserito le seguenti righe nel file AssemblyInfo.cs locale in quanto possono variare con ogni assembly:
#if DEBUG
[assembly: AssemblyConfiguration("Debug")]
#else
[assembly: AssemblyConfiguration("Release")]
#endif
[assembly: AssemblyVersion("This is set by build process")]
[assembly: AssemblyFileVersion("This is set by build process")]
[assembly: CLSCompliant(true)]Inoltre (generalmente) utilizzo una comune informazione di assemblaggio per soluzione, supponendo che una soluzione sia una singola linea di prodotti / prodotto rilasciabile. Il file comune di informazioni sull'assembly ha anche:
[assembly: AssemblyInformationalVersion("0.9.2.0")]Che imposterà il valore "ProductVersion" visualizzato da Esplora risorse.
MSBuild Community Tasks contiene un'attività personalizzata denominata AssemblyInfo che è possibile utilizzare per generare assemblyinfo.cs. Richiede una piccola modifica manuale dei file csproj da usare, ma vale la pena.
A mio avviso, utilizzare un GlobalAssemblyInfo.cs è più un problema di quanto non valga la pena, perché è necessario modificare ogni file di progetto e ricordare di modificare ogni nuovo progetto, mentre per impostazione predefinita si ottiene un AssemblyInfo.cs.
Per le modifiche ai valori globali (ad es. Società, prodotto, ecc.) Le modifiche sono generalmente così rare e semplici da gestire, non credo che DRY debba essere preso in considerazione. Basta eseguire il seguente script MSBuild (a seconda del pacchetto di estensione MSBuild ) quando si desidera modificare manualmente i valori in tutti i progetti come una tantum:
<?xml version="1.0" encoding="utf-8"?>
<Project ToolsVersion="4.0" DefaultTargets="UpdateAssemblyInfo" xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
<ItemGroup>
<AllAssemblyInfoFiles Include="..\**\AssemblyInfo.cs" />
</ItemGroup>
<Import Project="MSBuild.ExtensionPack.tasks" />
<Target Name="UpdateAssemblyInfo">
<Message Text="%(AllAssemblyInfoFiles.FullPath)" />
<MSBuild.ExtensionPack.Framework.AssemblyInfo
AssemblyInfoFiles="@(AllAssemblyInfoFiles)"
AssemblyCompany="Company"
AssemblyProduct="Product"
AssemblyCopyright="Copyright"
... etc ...
/>
</Target>
</Project>Per condividere un file tra più progetti è possibile aggiungere un file esistente come collegamento.
Per fare ciò, aggiungi un file esistente e fai clic su "Aggiungi come collegamento" nel selettore di file. (fonte: free.fr )
Per quanto riguarda cosa inserire nel file condiviso, suggerirei di inserire elementi da condividere tra gli assiemi. Cose come copyright, società, forse versione.
Si sconsiglia l'utilizzo di un singolo file AseemblyInfo.cs per più progetti. Il file AssemblyInfo include informazioni che potrebbero essere rilevanti solo per quel determinato assembly. Le due informazioni più ovvie sono la AssemblyTitleeAssemblyVersion .
Una soluzione migliore potrebbe essere quella di utilizzare i targetsfile, che sono gestiti da MSBuild, al fine di "iniettare" gli attributi di assembly in più di un progetto.
Una cosa che ho trovato utile è generare gli elementi AssemblyVersion (ecc.) Applicando la sostituzione token nella fase di pre-build.
Uso TortoiseSvn ed è facile da usare SubWCRev.exeper trasformare un modello AssemblyInfo.wcrevin AssemblyInfo.cs. La riga pertinente nel modello potrebbe essere simile a questa:
[assembly: AssemblyVersion("2.3.$WCREV$.$WCMODS?1:0$$WCUNVER?1:0$")]Il terzo elemento è quindi il numero di revisione. Uso il quarto elemento per verificare di non aver dimenticato di eseguire il commit di file nuovi o modificati (il quarto elemento è 00 se è tutto a posto).
A proposito, aggiungi AssemblyInfo.wcreval controllo della versione e ignora AssemblyInfo.cs se lo usi.