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

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