Struct Version 

pub struct Version {
    pub major: u32,
    pub minor: u32,
    pub patch: u32,
    pub build: u32,
}

版本号结构体，支持四段式版本号 (major.minor.patch.build)

示例

• 0.0.13.0 - 基础版本 0.0.13，build level 0
• 0.0.13.5 - 基础版本 0.0.13，build level 5 (应用了5个补丁)

Fields

major: u32

主版本号

minor: u32

次版本号

patch: u32

修订版本号

build: u32

构建号/补丁级别

Implementations

impl Version

pub fn new(major: u32, minor: u32, patch: u32, build: Option<u32>) -> Self

创建新的版本号

pub fn new_without_build(major: u32, minor: u32, patch: u32) -> Self

pub fn base_version(&self) -> Version

获取基础版本（不包含build级别）

示例

use client_core::version::Version;

let v = Version::from_str("0.0.13.5").unwrap();
let base = v.base_version();
assert_eq!(base.to_string(), "0.0.13.0");

pub fn can_apply_patch(&self, patch_base_version: &Version) -> bool

检查是否可以在当前版本上应用指定的补丁

补丁只能应用在相同的基础版本上

示例

use client_core::version::Version;

let current = Version::from_str("0.0.13.2").unwrap();
let patch_target = Version::from_str("0.0.13.0").unwrap();
assert!(current.can_apply_patch(&patch_target));

let different_base = Version::from_str("0.0.14.0").unwrap();
assert!(!current.can_apply_patch(&different_base));

pub fn is_compatible_with_patch(&self, patch_version: &Version) -> bool

检查当前版本是否兼容指定的补丁版本

当前版本的基础版本必须与补丁版本的基础版本相同， 且当前的build级别不能超过补丁版本

pub fn to_short_string(&self) -> String

获取版本字符串的简短表示（不包含build为0的情况）

示例

• Version(0, 0, 13, 0) -> “0.0.13”
• Version(0, 0, 13, 5) -> “0.0.13.5”

pub fn base_version_string(&self) -> String

获取基础版本字符串

pub fn validate(&self) -> Result<()>

验证版本号格式的有效性

impl Version

pub fn compare_detailed(&self, server_version: &Version) -> VersionComparison

与另一个版本进行详细比较

示例

use client_core::version::{Version, VersionComparison};

let current = Version::from_str("0.0.13.2").unwrap();
let target = Version::from_str("0.0.13.5").unwrap();

match current.compare_detailed(&target) {
    VersionComparison::PatchUpgradeable => println!("可以通过补丁升级"),
    VersionComparison::FullUpgradeRequired => println!("需要全量升级"),
    _ => {}
}

Trait Implementations

impl Clone for Version

fn clone(&self) -> Version

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Version

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for Version

fn default() -> Version

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for Version

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for Version

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl FromStr for Version

从字符串解析版本号

支持的格式：

• “1.2.3” -> Version { major: 1, minor: 2, patch: 3, build: 0 }
• “1.2.3.4” -> Version { major: 1, minor: 2, patch: 3, build: 4 }

示例

use client_core::version::Version;

let v1 = Version::from_str("0.0.13.5").unwrap();
assert_eq!(v1.major, 0);
assert_eq!(v1.minor, 0);
assert_eq!(v1.patch, 13);
assert_eq!(v1.build, 5);

type Err = Error

The associated error which can be returned from parsing.

fn from_str(s: &str) -> Result<Self>

Parses a string s to return a value of this type.

impl Ord for Version

fn cmp(&self, other: &Version) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

impl PartialEq for Version

fn eq(&self, other: &Version) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl PartialOrd for Version

fn partial_cmp(&self, other: &Version) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

fn lt(&self, other: &Rhs) -> bool

Tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Rhs) -> bool

Tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &Rhs) -> bool

Tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Rhs) -> bool

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl Serialize for Version

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for Version

impl StructuralPartialEq for Version