mirai-console/net.mamoe.mirai.console.util/SemVersion

SemVersion

@Serializable(with = SemVersion.SemVersionAsStringSerializer::class)

data class SemVersion : Comparable<SemVersion>

解析示例

1.0.0-M4+c25733b8 将会解析出下面的内容, major (主本号), minor (次版本号), patch (修订号), identifier (先行版本号) 和 metadata (元数据).

SemVersion(
  major = 1,
  minor = 0,
  patch = 0,
  identifier  = "M4"
  metadata    = "c25733b8"
)

其中 identifier 和 metadata 都是可选的.

对于核心版本号, 此实现稍微比语义化版本规范宽松一些, 允许 x.y 的存在.

序列化

使用 SemVersionAsStringSerializer, SemVersion 被序列化为 toString 的字符串.

Types

Companion

object Companion

Requirement

@Serializable(with = SemVersion.Requirement.RequirementAsStringSerializer::class)

data class Requirement

一条依赖规则

SemVersionAsStringSerializer

object SemVersionAsStringSerializer : KSerializer<SemVersion>

使用 SemVersion.toString 序列化, 使用 SemVersion.invoke 反序列化.

Functions

compareTo

open operator override fun compareTo(other: SemVersion): Int

比较 this 和 other 的实际版本大小.

equals

open operator override fun equals(other: Any?): Boolean

深度比较 this 和 other, 当且仅当 major, patch, minor, identifier, metadata 完全相同时返回 true.

fun equals(other: SemVersion, deep: Boolean): Boolean

比较 this 和 other.

hashCode

open override fun hashCode(): Int

satisfies

@JvmStatic

fun SemVersion.satisfies(requirement: String): Boolean

@JvmStatic

fun SemVersion.satisfies(requirement: SemVersion.Requirement): Boolean

当满足 requirement 时返回 true, 否则返回 false

toString

open override fun toString(): String

返回类似 1.0.0-M4+c25733b8 的字符串.

toStructuredString

fun toStructuredString(): String

将 SemVersion 转为 Kotlin data class 风格的 String.

Properties

identifier

val identifier: String? = null

先行版本号识别符

major

val major: Int

主版本号

metadata

val metadata: String? = null

版本号元数据, 不参与版本号对比(compareTo), 但是参与版本号严格对比(equals)

minor

val minor: Int

次版本号

patch

val patch: Int?

修订号

SemVersion

解析示例

序列化

See also

Types

Functions

Properties