Quelles sont les différences entre AssemblyVersion, AssemblyFileVersion et AssemblyInformationalVersion?

Il y a trois version de l'assembly attributs. Quelles sont les différences? Est-ce ok si j'utilise AssemblyVersion et ignorer le reste?

MSDN dit:

  • AssemblyVersion:

    Spécifie la version de l'assemblée étant attribué.

  • AssemblyFileVersion:

    Indique un compilateur d'utiliser un numéro de version Win32 de version de fichier de ressources. Le fichier Win32 version n'est pas nécessaire d'être le même que l'assemblée du numéro de version.

  • AssemblyInformationalVersion:

    Définit d'autres informations de version pour un manifeste d'assembly.

C'est un suivi à Quelles sont les meilleures pratiques pour l'utilisation de l'Assemblage des Attributs?

InformationsquelleAutor Jakub Šturc | 2008-09-15
  1. 893

    AssemblyVersion

    Où d'autres assemblys de référence de votre assemblée sera look. Si ce nombre de changements, d'autres assemblées doivent mettre à jour leurs références à votre assemblée! Le AssemblyVersion est nécessaire.

    - Je utiliser le format: majeur.mineur. Cela aurait pour conséquence:

    [assembly: AssemblyVersion("1.0")]

    AssemblyFileVersion

    Utilisé pour le déploiement. Vous pouvez augmenter ce nombre pour chaque déploiement. Il est utilisé par les programmes d'installation. Utilisez-le pour marquer les assemblées qui ont le même AssemblyVersion, mais sont générés à partir de différentes versions.

    Dans Windows, il peut être affiché dans les propriétés du fichier.

    Si possible, qu'il soit généré par MSBuild. Le AssemblyFileVersion est facultatif. Si ce n'est pas donné, le AssemblyVersion est utilisé.

    - Je utiliser le format: majeur.mineure.la révision.construire, où j'utilise révision pour la phase de développement (Alpha, Beta, RC et RTM), les service packs et les correctifs à chaud. Cela aurait pour conséquence:

    [assembly: AssemblyFileVersion("1.0.3100.1242")]

    AssemblyInformationalVersion

    La version du Produit de l'assemblée. C'est la version que vous utilisez lorsque vous parlez à des clients ou pour les afficher sur votre site web. Cette version peut être une chaîne de caractères, comme " 1.0 Release Candidate'.

    L'Analyse de Code va s'en plaindre (CA2243) -- signalé à Microsoft (pas fixe dans VS2013).

    La AssemblyInformationalVersion est facultatif. Si ce n'est pas donné, le AssemblyFileVersion est utilisé.

    - Je utiliser le format: majeur.mineur [révision à la chaîne]. Cela aurait pour conséquence:

    [assembly: AssemblyInformationalVersion("1.0 RC1")]
    • Situation: ASM - une assemblée de projet (.DLL/.EXE). Le programme d'INSTALLATION - un projet d'installation. Notez que si [SETUP cibles ASM] ET [ASM est AssemblyFileVersion PAS mis à jour] ET [ASM binaires de ne pas changer (par exemple uniquement les fichiers de contenu mis à jour)]; j'ai eu des problèmes avec le programme d'INSTALLATION de ne pas prendre la dernière binaires (avec les dernières versions spécifiée). Cela a causé des problèmes avec Application.ProductVersion et lors de l'accès AssemblyInformationalVersion par la réflexion.
    • Pour AssemblyFileVersion, "Si possible, qu'il soit généré par MSBuild" - Pourquoi? Vous avez juste allé à expliquer une bonne raison de le contrôler manuellement ça 🙂
    • L'avertissement sur la AssemblyInformationalVersion format existe encore dans VS2010 aujourd'hui (21 Mai 2013) et votre lien est mort.
    • Malheureusement, le Version de la Classe définit major.minor[.build[.revision]] et pas major.minor.revision.build donc dans la réponse de la construction et des numéros de révision serait échangé si vous avez été en utilisant les propriétés de la classe ou System.Reflection.Assembly.GetExecutingAssembly().GetName().Version pour détecter les construire et les numéros de révision.
    • Votre droit à propos de la Version de Classe, mais c'est Microsoft façon de versioning. Personnellement, je pense qu'il est étrange de ne pas avoir le buildnumber à la fin et c'est pourquoi je ne mets mon format comme un exemple, basé sur Sémantique Versioning. Gratuitement votre utilisation de Microsoft manière ou votre propre bien sûr.
    • La remarque "Si possible, qu'il soit généré par MSBuild" signifiait surtout pour la construction de la partie (et en option, la révision d'une partie) de la version. Désolé de ne pas être clair.
    • Je suis d'accord, j'aime utiliser sémantique versioning ainsi, mais c'est difficile à mélanger avec de l'défini Version classe, sauf si vous n'utilisez pas Microsoft les définitions, les autres utilisateurs de votre assemblée pourrait s'attendre. Le propos sate "Une différence dans le numéro de build représente une recompilation de la même source."
    • Visual Studio affiche deux versions dans ses propriétés de référence: Version et RuntimeVersion:. Quel est le rapport à la version listé ici? Est le RuntimeVersion: inséré automatiquement?
    • Convient de noter que pour AssemblyInformationalVersion, si omis, AssemblyFileVersion est utilisé. Puis AssemblyVersion si les deux sont omis.
    • AssemblyInformationalVersion==ProductVersion est une chaîne, c'est donc le lieu où l'on peut mettre toutes sortes ofthings, comme la date ou le numéro de build. Je cherchais pour cette info pour un certain temps, donc je l'ajoute ici.

    InformationsquelleAutor Rémy van Duijkeren
  2. 583

    La gestion des versions des assemblées .NET peut être une source de confusion perspective étant donné qu'il existe actuellement au moins trois façons de spécifier une version de votre assemblée.

    Ici sont les trois principaux liés à la version de l'assemblée attributs:

    //Assembly mscorlib, Version 2.0.0.0
[assembly: AssemblyFileVersion("2.0.50727.3521")]
[assembly: AssemblyInformationalVersion("2.0.50727.3521")]
[assembly: AssemblyVersion("2.0.0.0")]

    Par convention, les quatre parties de la version sont appelés les Version Majeure, Version Mineure, Construire, et Révision.

    La AssemblyFileVersion est destiné à identifier de manière unique une version de la assemblée individuelle

    Typiquement, vous allez définir manuellement la Majeure et la Mineure AssemblyFileVersion pour refléter la version de l'assemblée, puis incrémenter la construction et/ou la Révision à chaque fois que votre système de construction compile l'assemblée. Le AssemblyFileVersion devrait vous permettre d'identifier de manière unique une accumulation de l'assemblée, de sorte que vous pouvez l'utiliser comme un point de départ pour le débogage des problèmes.

    Sur mon projet actuel, nous avons le serveur de build encoder la liste nombre de sources de notre référentiel de contrôle dans la construction et la Révision des pièces de la AssemblyFileVersion. Cela nous permet de mapper directement à partir d'un assembly à son code source, pour toute assemblée généré par le serveur de build (sans avoir à utiliser des étiquettes ou des branches dans le contrôle de code source, ou manuellement en gardant tous les enregistrements de versions).

    Ce numéro de version est stockée dans la version Win32 de ressources et peut être vu lors de l'affichage de l'Explorateur Windows les pages de propriétés de l'assemblée.

    Le CLR ne pas s'en soucier, ni examiner les AssemblyFileVersion.

    La AssemblyInformationalVersion est destiné à représenter la version de votre produit

    La AssemblyInformationalVersion est destiné à permettre cohérente de gestion des versions de la totalité du produit, qui peut consister en de nombreuses assemblées qui sont leur propre version, peut-être avec les différentes politiques de gestion des versions, et potentiellement développés par des équipes hétérogènes.

    “Par exemple, la version 2.0 d'un produit
    peut contenir plusieurs assemblées; un
    de ces assemblées est marqué comme
    version 1.0 puisque c'est une nouvelle assemblée
    qui n'a pas été livré dans la version 1.0 de l'
    même produit. En règle générale, vous définissez la
    majeure et mineure de cette version
    nombre de représenter la version publique
    de votre produit. Ensuite, vous incrémentez
    la construction et la révision des pièces à chaque fois
    vous créez un package d'un produit complet, avec
    toutes ses assemblées.”
    — Jeffrey Richter, [CLR via C# (Second Edition)] p. 57

    Le CLR ne pas s'en soucier, ni examiner les AssemblyInformationalVersion.

    La AssemblyVersion est la seule version du CLR se soucie (mais il se soucie de l'ensemble de la AssemblyVersion)

    La AssemblyVersion est utilisé par le CLR pour lier fortement nommé assemblées. Il est stocké dans le AssemblyDef manifeste des métadonnées de la table du construit de l'assemblée, et dans le AssemblyRef tableau de toute l'assemblée qui y fait référence.

    C'est très important, car cela signifie que lorsque vous faites référence à un nommé fortement de l'assemblée, vous êtes étroitement lié à un AssemblyVersion de l'assemblée. L'ensemble de la AssemblyVersion doit être une correspondance exacte pour la liaison à réussir. Par exemple, si vous faites référence à la version 1.0.0.0 d'un nommé fortement de l'assemblée au moment de la construction, mais seulement la version 1.0.0.1 de cette assemblée est disponible au moment de l'exécution, la liaison échoue! (Vous serez alors obligé de contourner cela en utilisant De Liaison D'Assembly De Redirection.)

    Confusion quant à savoir si l'ensemble de la AssemblyVersion doit correspondre. (Oui, c'est fait.)

    Il y a un peu de confusion autour de l'ensemble de la AssemblyVersion doit être une correspondance exacte pour un assemblage à être chargé. Certains gens sont sous la fausse conviction que seule la Majeure et la Mineure de la AssemblyVersion doivent correspondre pour que la liaison à réussir. C'est une hypothèse raisonnable, mais il est en fin de compte incorrect (comme de .NET 3.5), et il est trivial de vérifier votre version du CLR. Juste exécuter cet exemple de code.

    Sur ma machine de la deuxième assemblée chargement échoue, et les deux dernières lignes de la fusion du journal qu'il soit parfaitement clair pourquoi:

    .NET Framework Version: 2.0.50727.3521
---
Attempting to load assembly: Rhino.Mocks, Version=3.5.0.1337, Culture=neutral, PublicKeyToken=0b3305902db7183f
Successfully loaded assembly: Rhino.Mocks, Version=3.5.0.1337, Culture=neutral, PublicKeyToken=0b3305902db7183f
---
Attempting to load assembly: Rhino.Mocks, Version=3.5.0.1336, Culture=neutral, PublicKeyToken=0b3305902db7183f
Assembly binding for  failed:
System.IO.FileLoadException: Could not load file or assembly 'Rhino.Mocks, Version=3.5.0.1336, Culture=neutral, 
PublicKeyToken=0b3305902db7183f' or one of its dependencies. The located assembly's manifest definition 
does not match the assembly reference. (Exception from HRESULT: 0x80131040)
File name: 'Rhino.Mocks, Version=3.5.0.1336, Culture=neutral, PublicKeyToken=0b3305902db7183f'

=== Pre-bind state information ===
LOG: User = Phoenix\Dani
LOG: DisplayName = Rhino.Mocks, Version=3.5.0.1336, Culture=neutral, PublicKeyToken=0b3305902db7183f
 (Fully-specified)
LOG: Appbase = [...]
LOG: Initial PrivatePath = NULL
Calling assembly : AssemblyBinding, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null.
===
LOG: This bind starts in default load context.
LOG: No application configuration file found.
LOG: Using machine configuration file from C:\Windows\Microsoft.NET\Framework64\v2.0.50727\config\machine.config.
LOG: Post-policy reference: Rhino.Mocks, Version=3.5.0.1336, Culture=neutral, PublicKeyToken=0b3305902db7183f
LOG: Attempting download of new URL [...].
WRN: Comparing the assembly name resulted in the mismatch: Revision Number
ERR: Failed to complete setup of assembly (hr = 0x80131040). Probing terminated.

    Je pense que la source de cette confusion est probablement parce que Microsoft à l'origine prévu pour être un peu plus indulgent sur cette stricte correspondance de la pleine AssemblyVersion, par correspondance uniquement sur la Majeure et la Mineure de la version de pièces:

    “Lors du chargement d'une assemblée, le CLR de trouver automatiquement la dernière
    installé entretien de version
    correspond à la majeure/mineure de la version de la
    l'assemblée de la demande.”
    — Jeffrey Richter, [CLR via C# (Second Edition)] p. 56

    C'était le comportement de la Bêta 1 de l'1.0 CLR, cependant cette fonctionnalité a été supprimée avant la version 1.0, et n'a pas réussi à refaire surface dans .NET 2.0:

    “Note: je viens de décrire comment vous
    devrait penser à des numéros de version.
    Malheureusement, le CLR ne permet pas de traiter
    les numéros de version de cette façon. [Dans .NET
    2.0], le CLR traite un numéro de version opaque de la valeur, et si une assemblée
    dépend de la version 1.2.3.4 de l'autre
    de l'assemblée, le CLR essaie de charger
    version 1.2.3.4 seulement (à moins d'une liaison
    la redirection est en place). Cependant,
    Microsoft a prévu de modifier la
    CLR du chargeur dans une future version
    qu'il se charge de la dernière
    version/révision pour un majeur/mineur
    la version de l'assemblée    . Par exemple,
    sur une future version du CLR, si l'
    chargeur essaie de trouver la version
    1.2.3.4 d'une assemblée et la version 1.2.5.0 existe, le chargeur avec automatiquement ramasser la dernière
    l'entretien de la version. Ce sera un très
    changement bienvenu de la CLR chargeur — je
    pour l'un ne peut pas attendre.”
    — Jeffrey Richter, [CLR via C# (Second Edition)] p. 164 (Accent
    le mien)

    Que ce changement n'a pas encore été mis en œuvre, je pense qu'il est sûr de supposer que Microsoft est revenue sur cette intention, et c'est peut-être trop tard pour changer maintenant. J'ai essayé de chercher sur le web pour savoir ce qui s'est passé avec ces plans, mais je ne pouvais pas trouver toutes les réponses. J'ai toujours voulu aller au fond de lui.

    Donc j'ai envoyé Jeff Richter et lui a demandé directement — j'ai pensé que si quelqu'un savait ce qui s'est passé, ce serait lui.

    Il a répondu dans un délai de 12 heures, un samedi matin, pas moins, et a précisé que l' .NET 1.0 Beta 1 chargeur de ne mettre en œuvre cette "automatique roll-forward" mécanisme de la cueillette jusqu'à la dernière Construire et la Révision d'un assemblage, mais ce comportement a été repris avant .NET 1.0 fourni. Plus tard, il fut destiné à relancer ce, mais il ne l'a pas fait en avant de la CLR 2.0 livré. Puis vint Silverlight, qui a la priorité pour l'équipe CLR, afin que cette fonctionnalité a été retardé de plus. Dans l'intervalle, la plupart des gens qui étaient autour de dans le jours de CLR 1.0 Beta 1 ont depuis évolué, de sorte qu'il est peu probable que cela permettra de voir la lumière du jour, en dépit de tout le travail qui avait déjà été mis en elle.

    Le comportement actuel, il semble, est là pour rester.

    Il est également intéressant de noter à partir de ma discussion avec Jeff qui AssemblyFileVersion n'a été ajouté après la suppression de la ‘automatique roll-forward " mécanisme — parce que, après 1.0 Beta 1, toute modification de la AssemblyVersion est une modification importante pour vos clients, puis il y a eu nulle part pour stocker en toute sécurité votre numéro de build. AssemblyFileVersion est qu'un refuge sûr, comme il n'est jamais automatiquement examiné par le CLR. Peut-être que c'est plus clair de cette façon, avoir deux numéros de version, avec des significations, plutôt que d'essayer de faire que la séparation entre le Majeur/Mineur (la rupture) et de la création/Révision (sans rupture) des parties de la AssemblyVersion.

    La ligne du bas: Réfléchir soigneusement lorsque vous modifiez votre AssemblyVersion

    La morale est que si vous expédiez des assemblées que les autres développeurs vont être de référencement, vous devez être extrêmement prudent quand vous faites (et ne le font pas) changer le AssemblyVersion de ces assemblées. Toute modification de la AssemblyVersion signifie que les développeurs d'applications doivent re-compiler à l'encontre de la nouvelle version (mise à jour de ces AssemblyRef entrées) ou utiliser de l'assemblée de liaison des redirections pour remplacer manuellement la liaison.

    • Ne pas changer le AssemblyVersion pour une version de maintenance qui est conçu pour être compatible en arrière.
    • Ne changer le AssemblyVersion pour une version que vous connaissez a des changements considérables.

    Il suffit de prendre un autre regard sur la version attributs sur mscorlib:

    //Assembly mscorlib, Version 2.0.0.0
[assembly: AssemblyFileVersion("2.0.50727.3521")]
[assembly: AssemblyInformationalVersion("2.0.50727.3521")]
[assembly: AssemblyVersion("2.0.0.0")]

    Noter que c'est la AssemblyFileVersion qui contient toutes les intéressantes informations de service (c'est la partie Révision de cette version qui vous indique ce Service Pack, vous êtes sur la), pendant ce temps la AssemblyVersion est fixé à un ennuyeux 2.0.0.0. Toute modification de la AssemblyVersion serait forcer .NET application référencement mscorlib.dll de re-compiler avec la nouvelle version!

    • Grande réponse. Je pense que le point le plus important que vous faites, et ce MS doit être explicitement recommander--est de faire des changements à la AssemblyVersion si et seulement si la nouvelle version des sauts de compatibilité descendante.
    • L'une des questions que j'ai à plusieurs reprises de me poser, c'est quand dois-je modifier chacun de ces numéros de version, vos points de balle sur AssemblyVersion ajouté une bonne clarté du présent et de l'ensemble de la réponse a été une lecture intéressante.
    • Je vois beaucoup de réponses qui expliquent les concepts de base de ces trois choses. Mais comment ils se rapportent à la version modifiable des numéros dans les propriétés du projet? Lorsque vous cliquez sur l'Assemblée de l'Information... vous avez la possibilité de changer les deux versions. Et il y a changement de l'Assemblée des changements de Version le dossier dans lequel l'utilisateur.la config est trouvé, et de changer de Version de Fichier change le numéro de version affiché lorsque vous cliquez-droit sur le fichier exe et accédez à ses propriétés. Alors, comment ces deux numéros de version correspond à AssemblyVersion, AssemblyFileVersion et AssemblyInformationalVersion?
    • Le lien vers le blog qui vous a écrit à l'origine donne une erreur 404. Est-il un nouvel emplacement pour qui?
    • Ah, toutes mes excuses. Que site est en panne, mais l'ensemble du contenu du blog est reproduit dans la réponse que vous êtes de ne pas manquer quoi que ce soit. Je vais supprimer le lien brisé maintenant.
    InformationsquelleAutor Daniel Fortunov
  3. 44

    AssemblyVersion assez bien séjours à l'interne .NET, tandis que AssemblyFileVersion est ce que Windows voit. Si vous accédez aux propriétés d'une séance de l'assemblée dans un répertoire et de passer à l'onglet version, la AssemblyFileVersion est ce que vous verrez en haut. Si vous trier les fichiers selon la version, c'est ce qui est utilisé par l'Explorateur.

    La AssemblyInformationalVersion cartes à la "Version du Produit" et est destiné à être purement "humain-utilisé".

    AssemblyVersion est certainement le plus important, mais je ne voudrais pas sauter AssemblyFileVersion, soit. Si vous ne fournissez pas AssemblyInformationalVersion, le compilateur ajoute pour vous en dépouiller de la "révision" pièce de votre numéro de version et quitter la major.mineure.construire.

    InformationsquelleAutor Bob King
  4. 23

    AssemblyInformationalVersion et AssemblyFileVersion sont affichés lorsque vous affichez la "Version" de l'information sur un fichier via l'Explorateur Windows en affichant les propriétés du fichier. Ces attributs réellement obtenir compilées dans un VERSION_INFO ressource qui est créé par le compilateur.

    AssemblyInformationalVersion est le "Produit" version de valeur. AssemblyFileVersion est la version du Fichier de la valeur.

    La AssemblyVersion est spécifique .NET assemblées et est utilisé par la .NET de l'assemblée chargeur pour connaître la version d'un assemblage de charge/bind au moment de l'exécution.

    De ces, la seule qui soit absolument nécessaire par .NET est le AssemblyVersion attribut. Malheureusement, il peut aussi causer le plus de problèmes en cas de changement tort et à travers, surtout si vous êtes forts de nommage de vos assemblées.

    InformationsquelleAutor Scott Dorman
  5. 8

    De garder cette question actuelle, il est important de souligner que AssemblyInformationalVersion est utilisé par NuGet et reflète la version de package y compris toute version pré-suffixe.

    Par exemple un AssemblyVersion de 1.0.3.* emballé avec la asp.net core dotnet-cli

    dotnet pack --version-suffix ci-7 src/MyProject

    Produit un paquet de la version 1.0.3-ic-7 que vous pouvez inspecter la réflexion à l'aide de:

    CustomAttributeExtensions.GetCustomAttribute<AssemblyInformationalVersionAttribute>(asm);
    InformationsquelleAutor KCD
  6. 7

    Il est intéressant de noter quelques autres choses:

    1) Comme indiqué dans l'Explorateur Windows boîte de dialogue Propriétés de l'assembly généré un fichier, il existe deux endroits appelés "version du Fichier". Celle que l'on voit dans l'en-tête de la boîte de dialogue affiche le AssemblyVersion, pas la AssemblyFileVersion.

    Dans les Autres informations de version de l'article, il y a un autre élément appelé "Fichier" Version. C'est là que vous pouvez voir ce qui a été conclu que la AssemblyFileVersion.

    2) AssemblyFileVersion est juste du texte brut. Il n'a pas à se conformer au schéma de numérotation des restrictions qui AssemblyVersion t (<build> < 65K, par exemple). Il peut être 3.2.<balise de version texte>.<datetime>, si vous le souhaitez. Votre système de construction devra remplir les jetons.

    En outre, il n'est pas soumis au générique de remplacement qui AssemblyVersion est. Si vous venez d'avoir une valeur de "3.0.1.*" dans le AssemblyInfo.cs, c'est exactement ce qui s'affichera dans l'Autre version de l'information->Version de Fichier de l'élément.

    3) je ne sais pas l'impact sur un programme d'installation de l'aide de quelque chose d'autre que numérique numéros de version de fichier, si.

    InformationsquelleAutor DavidM
  7. 2

    Lors d'une assemblée s' AssemblyVersion est changé,
    Si elle a de fortes nom, le référencement assemblées besoin d'être recompilées, sinon l'assemblée ne se charge pas!
    Si elle n'a pas de nom, si ce n'est explicitement ajouté au fichier de projet, il ne sera pas copié dans le répertoire de sortie lors de la construction afin que vous pouvez manquer selon des assemblées, notamment après le nettoyage, le répertoire de sortie.

    • C'est très intéressant! Pourriez-vous élaborer peu sur le "ne seront pas copiés vers le répertoire de sortie" de la partie? Peut-être un lien à l'endroit où ce comportement est défini. Je n'ai jamais compris pourquoi certaines dépendances indirectes ont été copiés parfois, mais pas toujours. Ce doit être de 100% liée à elle.
    InformationsquelleAutor linquize