Класс Runtime.Version

Номера версий

Номер версии, $VNUM, — это непустая последовательность элементов, разделённых точками (U+002E). Элемент — это либо ноль, либо целое положительное число без ведущих нулей. Последний элемент номера версии не может быть нулём. При увеличении элемента все последующие элементы удаляются. Формат:

 [1-9][0-9]*((\.0)*\.[1-9][0-9]*)*
 

Последовательность может быть произвольной длины, но первые четыре элемента имеют определённое значение:

 $FEATURE.$INTERIM.$UPDATE.$PATCH
 

• $FEATURE — счётчик релиза функций, увеличивается при каждом релизе функций вне зависимости от содержимого релиза. В релизе функций могут быть добавлены функции; они также могут быть удалены, если об этом было сообщено как минимум за один выпуск функций. Несовместимые изменения могут быть внесены при обосновании.

• $INTERIM — счётчик промежуточного релиза, увеличивается при релизах, не содержащих новых функций, но содержащих совместимые исправления ошибок и улучшения, без удаления функций и изменений стандартных API.

• $UPDATE — счётчик релиза обновления, увеличивается при совместимых обновлениях, устраняющих проблемы безопасности, регрессии и ошибки в новых функциях.

• $PATCH — счётчик экстренного патча, увеличивается только при необходимости выпуска экстренного релиза для исправления критической проблемы.

Пятый и последующие элементы номера версии могут использоваться разработчиками платформы для идентификации патчей, специфичных для разработчиков платформы.

Номер версии никогда не имеет завершающих нулей. Если элемент и все последующие элементы логически имеют значение ноль, все они опускаются.

Последовательность цифр в номере версии сравнивается с другой такой последовательностью арифметически, поэлементно; напр., 10.0.4 меньше, чем 10.1.2. Если одна последовательность короче другой, то отсутствующие элементы короче последовательности считаются меньше соответствующих элементов более длинной последовательности; напр., 10.0.2 меньше, чем 10.0.2.1.

Строки версий

Строка версии, $VSTR, — это номер версии $VNUM, как описано выше, за которым могут следовать сведения о предварительной версии и сборке в одном из следующих форматов:

     $VNUM(-$PRE)?\+$BUILD(-$OPT)?
     $VNUM-$PRE(-$OPT)?
     $VNUM(\+-$OPT)?
 

где:

• $PRE, совпадающее с ([a-zA-Z0-9]+) — идентификатор предварительной версии. Как правило, ea, для потенциально нестабильной версии раннего доступа, находящейся в активной разработке, или internal, для внутренней сборки разработчиков.

• $BUILD, совпадающее с (0|[1-9][0-9]*) — номер сборки, увеличивается при каждой продвинутой сборке. $BUILD сбрасывается до 1 при изменении любой части $VNUM.

• $OPT, совпадающее с ([-a-zA-Z0-9.]+) — дополнительные сведения о сборке, если это необходимо. В случае сборки internal она часто содержит дату и время сборки.

Строка версии 10-ea соответствует $VNUM = "10" и $PRE = "ea". Строка версии 10+-ea соответствует $VNUM = "10" и $OPT = "ea".

При сравнении двух строк версии значение $OPT, если оно присутствует, может быть или не быть существенным в зависимости от выбранного метода сравнения. Методы сравнения compareTo() и compareToIgnoreOptional() должны использоваться согласованно с соответствующими методами equals() и equalsIgnoreOptional().

Короткий номер версии, $SVSTR, часто полезный в менее формальных контекстах, — это номер версии, за которым необязательно следует идентификатор предварительной версии:

     $VNUM(-$PRE)?
 

Это класс, основанный на значениях; программисты должны рассматривать экземпляры, которые равны, как взаимозаменяемые и не должны использовать их для синхронизации, иначе могут возникнуть непредсказуемые последствия. Например, в будущих версиях синхронизация может не сработать.