SemVersion

Internal proxy for Unity's UnityEditor.Scripting.ScriptCompilation.SemVersion. Provides semantic versioning with comparison operators, equality, string conversion, and construction from version strings.

Definition

Namespace: Paragon.Editor.ThirdPartyPackageImporter.Internals Assembly: Paragon.Editor.dll

[InternalProxy("UnityEditor.Scripting.ScriptCompilation.SemVersion", "UnityEditor.CoreModule")]
internal class SemVersion : InternalProxy<SemVersion>, IEquatable<SemVersion>, IComparable<SemVersion>

Inheritance: InternalProxy<SemVersion> → SemVersion Implements: IEquatable<SemVersion>, IComparable<SemVersion>

Remarks

SemVersion wraps Unity's internal semantic versioning type. It supports:

• Comparison operators — ==, !=, >, >=, <, <= for version ordering

• Implicit string conversion — Bidirectional conversion between string and SemVersion

• Dot-separated parsing — FromString() parses "Major.Minor.Patch.Prerelease.Build" format

Comparison and equality are delegated to the underlying Unity SemVersion.CompareTo() and Equals().

Properties

Major

public int Major { get; }

Major version number.

Minor

public int Minor { get; }

Minor version number.

Patch

public int Patch { get; }

Patch version number.

Prerelease

public string Prerelease { get; }

Prerelease identifier (e.g., "alpha", "beta"). Empty string if none.

Build

public string Build { get; }

Build metadata string. Empty string if none.

Constructors

SemVersion

public SemVersion(object semVersion) : base(semVersion)

Parameter	Type	Description
semVersion	object	The internal Unity SemVersion instance

Methods

Equals

public bool Equals(SemVersion other)
public override bool Equals(object other)

Delegates equality to the underlying Unity SemVersion.Equals().

CompareTo

public int CompareTo(SemVersion other)

Delegates comparison to the underlying Unity IComparable.CompareTo().

GetHashCode

public override int GetHashCode()

Delegates to the underlying target's hash code.

ToString

public override string ToString()

Returns: "Major.Minor.Patch" format string.

Operators

public static bool operator ==(SemVersion left, SemVersion right)
public static bool operator !=(SemVersion left, SemVersion right)
public static bool operator >(SemVersion left, SemVersion right)
public static bool operator >=(SemVersion left, SemVersion right)
public static bool operator <(SemVersion left, SemVersion right)
public static bool operator <=(SemVersion left, SemVersion right)
public static implicit operator string(SemVersion version)
public static implicit operator SemVersion(string version)

Common Pitfalls

String parsing uses dot-separated format The implicit string → SemVersion conversion parses "1.2.3" as Major=1, Minor=2, Patch=3. Extra segments are treated as Prerelease and Build strings. This differs from standard semver which uses - for prerelease and + for build.

Null target returns false for equality If either SemVersion has a null Target, equality returns false. Guard against null when comparing versions from packages that may not have imported/latest data.

Examples

Version Comparison

SemVersion installed = package.imported?.version;
SemVersion latest = package.latest?.version;

if (installed != null && latest != null && installed < latest)
{
    Debug.Log($"Update available: {installed} → {latest}");
}

String Conversion

SemVersion version = "2.1.0";  // implicit conversion
string versionStr = version;    // "2.1.0"

See Also

• PackageVersion — Contains the SemVersion via packageVersion.version

• AssetVersionList — Provides imported/latest PackageVersion with versions