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

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