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

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