Класс 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)?
 

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