в чем различия между assemblyversion, assemblyfileversion и assemblyinformationalversion?

<p>существует три атрибута версии сборки. какие есть отличия? это нормально, если я использую <code>assemblyversion</code> и игнорирую все остальное?</p><hr><p>msdn говорит:</p><ul> <li> <p> <a href="https://docs.microsoft.com/en-us/dotnet/api/system.reflection.assemblyversionattribute">assemblyversion</a> :</p> <blockquote> <p>определяет версию сборки приписывается.</p> </blockquote> </li> <li> <p> <a href="https://docs.microsoft.com/en-us/dotnet/api/system.reflection.assemblyfileversionattribute">assemblyfileversion</a> :</p> <blockquote> <p>указывает компилятору использовать определенный номер версии для ресурса версии файла win32. версия файла win32 не обязательно должна совпадать с номером версии сборки.</p> </blockquote> </li> <li> <p> <a href="https://docs.microsoft.com/en-us/dotnet/api/system.reflection.assemblyinformationalversionattribute">assemblyinformationalversion</a> :</p> <blockquote> <p>определяет дополнительную информацию о версии для манифеста сборки.</p> </blockquote> </li> </ul><hr><p><em> это продолжение <a href="https://stackoverflow.com/questions/62353/what-are-the-best-practices-for-using-assembly-attributes">каковы лучшие методы использования атрибутов сборки?</a> </em></p>

<p><strong> assemblyversion </strong></p><p>где будут смотреть другие сборки, которые ссылаются на вашу сборку. если это число меняется, другие сборки должны обновить свои ссылки на вашу сборку! <code>assemblyversion</code> является обязательным.</p><p>я использую формат: <em> major.minor </em>. это приведет к:</p><pre><code>[assembly: assemblyversion("1.0")] </code></pre><p><strong> assemblyfileversion </strong></p><p>используется для развертывания. вы можете увеличить это число для каждого развертывания. используется программами установки. используйте его для пометки сборок, имеющих одинаковое <code>assemblyversion</code>, но сгенерированных из разных сборок.</p><p>в windows это можно посмотреть в свойствах файла.</p><p>если возможно, пусть он генерируется msbuild. assemblyfileversion является необязательным. если не указано, используется assemblyversion.</p><p>я использую формат: <em> major.minor.revision.build </em>, где я использую ревизию для стадии разработки (alpha, beta, rc и rtm), пакеты обновления и исправления. это приведет к:</p><pre><code>[assembly: assemblyfileversion("1.0.3100.1242")] </code></pre><p><strong> assemblyinformationalversion </strong></p><p>версия продукта сборки. это версия, которую вы будете использовать при общении с клиентами или для отображения на вашем сайте. эта версия может быть строкой, например '<em> 1.0 release candidate </em>'.</p><p>анализ кода будет жаловаться на это (ca2243) - <a href="http://connect.microsoft.com/visualstudio/feedback/details/796535/the-ca2243-rule-attribute-string-literals-should-parse-correctly-should-not-be-applied-to-assemblyinformationalversionattrubute">сообщается в microsoft</a> (не исправлено в vs2013).</p><p><code>assemblyinformationalversion</code> не является обязательным. если не указан, используется assemblyfileversion.</p><p>я использую формат: <em> major.minor [ревизия как строка] </em>. это приведет к:</p><pre><code>[assembly: assemblyinformationalversion("1.0 rc1")] </code></pre>

<p>управление версиями сборок в .net может вызвать затруднения, учитывая, что в настоящее время существует как минимум три способа указать версию для вашей сборки.</p><p>вот три основных атрибута сборки, связанных с версией:</p><pre><code>// 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")] </code></pre><p>по соглашению четыре части версии называются <strong> основной версией </strong>, <strong> малой версией </strong>, <strong> build </strong> и <strong> revision </strong>.</p><h1><code>assemblyfileversion</code> предназначен для уникальной идентификации сборки <em> отдельной сборки </em></h1><p>обычно вы вручную устанавливаете major и minor assemblyfileversion для отображения версии сборки, а затем увеличиваете build и/или revision каждый раз, когда ваша система сборки компилирует сборку. assemblyfileversion должна позволять вам однозначно идентифицировать сборку сборки, чтобы вы могли использовать ее в качестве отправной точки для устранения любых проблем.</p><p>в моем текущем проекте у сервера сборки есть код списка изменений из нашего репозитория исходного кода в части build и revision assemblyfileversion. это позволяет нам напрямую сопоставлять сборку с ее исходным кодом для любой сборки, сгенерированной сервером сборки (без необходимости использовать метки или ветви в управлении исходным кодом или вручную хранить какие-либо записи выпущенных версий).</p><p>этот номер версии хранится в ресурсе версии win32, и его можно увидеть при просмотре страниц свойств проводника windows для сборки.</p><p><strong> clr не заботится и не проверяет assemblyfileversion. </strong></p><h1><code>assemblyinformationalversion</code> предназначен для представления версии всего вашего продукта</h1><p>assemblyinformationalversion предназначена для обеспечения согласованного управления версиями всего продукта, который может состоять из множества сборок, которые имеют независимое управление версиями, возможно, с разными политиками управления версиями и потенциально разработанные разнородными группами.</p><blockquote> <p>"например, версия 2.0 продукта может содержать несколько сборок; одна из этих сборок помечена как версия 1.0, поскольку это новая сборка, которая не поставлялась в версии 1.0 того же продукта. как правило, основные и второстепенные части этого номера версии задаются как открытая версия вашего продукта. затем вы увеличиваете части сборки и ревизии каждый раз, когда упаковываете полный продукт со всеми его сборками ". - джеффри рихтер, [clr через c # (второе издание)] с. 57</p> </blockquote><p><strong> clr не заботится и не изучает assemblyinformationalversion. </strong></p><h1><code>assemblyversion</code> - это единственная версия, о которой заботится clr (но она заботится обо всем <code>assemblyversion</code>)</h1><p>assemblyversion используется clr для привязки к строго именованным сборкам. он хранится в таблице метаданных манифеста assemblydef встроенной сборки и в таблице assemblyref любой сборки, которая ссылается на нее.</p><p>это очень важно, потому что это означает, что когда вы ссылаетесь на сборку со строгим именем, вы тесно связаны с конкретной версией assembly этой сборки. вся assemblyversion должна точно соответствовать для успешного связывания. например, если вы ссылаетесь на версию 1.0.0.0 сборки со строгим именем во время сборки, но во время выполнения доступна только версия 1.0.0.1 этой сборки, связывание завершится ошибкой! (затем вам придется обойти это, используя <a href="https://docs.microsoft.com/en-us/dotnet/framework/configure-apps/how-to-enable-and-disable-automatic-binding-redirection">перенаправление привязки сборки</a> .)</p><h1>путаница в том, должно ли совпадать все <code>assemblyversion</code>. (да, это так.)</h1><p>существует небольшая путаница вокруг того, должно ли все assemblyversion быть точным совпадением для загрузки сборки. некоторые люди ошибочно полагают, что только основные и второстепенные части assemblyversion должны совпадать, чтобы связывание было успешным. это разумное предположение, однако оно в конечном итоге неверно (начиная с .net 3.5), и это легко проверить для вашей версии clr. просто выполните <a href="http://webjam-upload.s3.amazonaws.com/assemblybinding\_\_\_fcbd12afca1d4bb3bf94bf88d1616d25\_\_100\_\_.rar">этот пример кода</a> .</p><p>на моей машине вторая сборка загружается неудачно, и последние две строки журнала fusion ясно дают понять, почему:</p><pre><code>.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. </code></pre><p>я думаю, что источником этой путаницы, вероятно, является то, что microsoft изначально намеревалась быть немного более снисходительной в этом строгом сопоставлении полной версии assemblyversion, сопоставляя ее только в части major и minor версии:</p><blockquote> <p>"при загрузке сборки clr автоматически найдет последнюю установленную версию обслуживания, которая соответствует основной/вспомогательной версии запрашиваемой сборки". - джеффри рихтер, [clr via c # (second edition)] p. 56</p> </blockquote><p>это было поведение в бета-версии 1 clr 1.0, однако эта функция была удалена до выпуска 1.0 и не смогла повторно появиться в .net 2.0:</p><blockquote> <p>"примечание: я только что описал, как вы должны думать о номерах версий. к сожалению, clr не обрабатывает номера версий таким образом. [в .net 2.0] clr обрабатывает номер версии как непрозрачное значение, и, если сборка зависит от версии 1.2.3.4 другой сборки, clr пытается загрузить только версию 1.2.3.4 (если не существует перенаправления привязки ). однако <strong> microsoft планирует изменить загрузчик clr в будущей версии, чтобы она загружала последнюю сборку/ревизию для данной основной/вспомогательной версии сборки </strong>. например, в будущей версии clr, если загрузчик пытается найти версию 1.2.3.4 сборки и существует версия 1.2.5.0, загрузчик автоматически выбирает последнюю версию обслуживания. это будет очень долгожданное изменение в загрузчике clr - я не могу ждать ", - джеффри рихтер, [clr via c # (second edition)] p. 164 (акцент мой)</p> </blockquote><p>поскольку это изменение до сих пор не реализовано, я думаю, что можно с уверенностью предположить, что microsoft отреагировала на это намерение, и, возможно, уже слишком поздно, чтобы изменить это сейчас. я пытался искать в интернете, чтобы выяснить, что произошло с этими планами, но я не смог найти никаких ответов. я все еще хотел докопаться до сути.</p><p>поэтому я написал джеффу рихтеру по электронной почте и прямо спросил его - я подумал, что кто-нибудь знает, что случилось, это будет он.</p><p>он ответил в течение 12 часов, не менее субботним утром, и пояснил, что в загрузчике .net 1.0 beta 1 реализован механизм "автоматического отката", позволяющий собирать последние доступные версии сборки и ревизии сборки, но такое поведение было возвращен до .net 1.0 поставляется. позже было задумано возродить это, но оно не было сделано до того, как clr 2.0 был выпущен. затем появился silverlight, который стал приоритетным для команды clr, поэтому эта функциональность была отложена еще больше. между тем, большинство людей, которые были рядом во времена clr 1.0 beta 1, уже ушли, поэтому маловероятно, что это выйдет на свет, несмотря на всю тяжелую работу, которая уже была проделана.</p><p>нынешнее поведение, похоже, здесь, чтобы остаться.</p><p>стоит также отметить, что из моего обсуждения с джеффом, assemblyfileversion был добавлен только после удаления механизма "автоматического отката" - поскольку после 1.0 beta 1 любое изменение в assemblyversion было критическим изменением для ваших клиентов, тогда негде безопасно хранить ваш номер сборки. assemblyfileversion - это безопасное убежище, поскольку оно никогда не проверяется автоматически clr. может быть, так будет понятнее, имея два отдельных номера версий с разными значениями, вместо того, чтобы пытаться разделить основные/второстепенные (ломающиеся) и части сборки/ревизии (не ломающиеся) версии assemblyversion.</p><h1>итог: тщательно продумайте, когда вы измените свое <code>assemblyversion</code></h1><p>мораль такова, что если вы отправляете сборки, на которые будут ссылаться другие разработчики, вам нужно быть предельно осторожным, когда вы изменяете (и не изменяете) assemblyversion этих сборок. любые изменения в assemblyversion будут означать, что разработчикам приложений придется либо перекомпилироваться с новой версией (чтобы обновить эти записи assemblyref), либо использовать перенаправления привязки assembly для ручного переопределения привязки.</p><ul> <li><strong> не </strong> изменяйте assemblyversion для сервисной версии, которая предназначена для обратной совместимости.</li> <li><strong> измените assemblyversion </strong> для выпуска, который, как вы знаете, содержит критические изменения.</li> </ul><p>просто взгляните на атрибуты версии в mscorlib:</p><pre><code>// 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")] </code></pre><p>обратите внимание, что это assemblyfileversion, которая содержит всю интересную информацию об обслуживании (это часть revision этой версии, которая сообщает вам, какой пакет обновления у вас установлен), в то время как assemblyversion имеет устаревшую версию 2.0.0.0. любое изменение в assemblyversion заставит каждое приложение .net, ссылающееся на mscorlib.dll, перекомпилироваться для новой версии!</p>

<p><code>assemblyversion</code> в значительной степени остается внутренним для .net, в то время как <code>assemblyfileversion</code> - это то, что видит windows. если вы перейдете к свойствам сборки, расположенной в каталоге, и перейдете на вкладку версии, то <code>assemblyfileversion</code> - это то, что вы увидите вверху. если вы сортируете файлы по версии, это то, что используется explorer.</p><p><code>assemblyinformationalversion</code> соответствует "версии продукта" и предназначен исключительно для использования человеком.</p><p><code>assemblyversion</code>, безусловно, является наиболее важным, но я бы не стал пропускать и <code>assemblyfileversion</code>. если вы не предоставите <code>assemblyinformationalversion</code>, компилятор добавит его для вас, убрав часть "revision" номера вашей версии и оставив major.minor.build.</p>

<p><code>assemblyinformationalversion</code> и <code>assemblyfileversion</code> отображаются, когда вы просматриваете информацию "версия" в файле через проводник windows, просматривая свойства файла. эти атрибуты фактически компилируются в ресурс <code>version\_info</code>, который создается компилятором.</p><p><code>assemblyinformationalversion</code> - это значение "версия продукта". <code>assemblyfileversion</code> - это значение "версия файла".</p><p><code>assemblyversion</code> характерно для сборок .net и используется загрузчиком сборок .net, чтобы узнать, какую версию сборки загружать/связывать во время выполнения.</p><p>из них единственным, который абсолютно необходим для .net, является атрибут <code>assemblyversion</code>. к сожалению, это может также вызвать большинство проблем, когда оно меняется без разбора, особенно если вы хорошо называете свои сборки.</p>

<p>чтобы сохранить актуальность этого вопроса, стоит подчеркнуть, что <code>assemblyinformationalversion</code> используется nuget и отражает <strong>версия пакета</strong>, включая любой суффикс перед выпуском.</p><p>например, assemblyversion версии 1.0.3. *, упакованный с ядром asp.net dotnet-cli</p><pre><code>dotnet pack --version-suffix ci-7 src/myproject </code></pre><p>создает пакет с версией 1.0.3-ci-7, который вы можете проверить с помощью отражения:</p><pre><code>customattributeextensions.getcustomattribute<assemblyinformationalversionattribute>(asm); </code></pre>

<p>стоит отметить некоторые другие вещи:</p><p>1) как показано в диалоговом окне "свойства проводника windows" для сгенерированного файла сборки, существует два места, называемых "версия файла". в заголовке диалогового окна отображается assemblyversion, а не assemblyfileversion.</p><p>в разделе информация о другой версии есть еще один элемент, который называется "версия файла". здесь вы можете увидеть, что было введено как assemblyfileversion.</p><p>2) assemblyfileversion - это просто текст. он не должен соответствовать ограничениям схемы нумерации, которые делает assemblyversion (<build> <65k, например). это может быть 3.2. <release tag text>. <datetime>, если хотите. ваша система сборки должна будет заполнить токены.</p><p>более того, он не подлежит замене подстановочным знаком, которым является assemblyversion. если у вас просто есть значение "3.0.1. *" в assemblyinfo.cs, это именно то, что будет отображаться в элементе "другая информация о версии" -> "версия файла".</p><p>3) я не знаю, как влияет на установщик использование чего-либо, кроме числовых номеров версий файлов.</p>

<p>при изменении assemblyversion в сборке, если она имеет строгое имя, ссылочные сборки необходимо перекомпилировать, иначе сборка не загружается! если у него нет строгого имени, если оно явно не добавлено в файл проекта, оно не будет скопировано в выходной каталог при сборке, поэтому вы можете пропустить определенные сборки, особенно после очистки выходного каталога.</p>