Components All New MacOS Windows Linux iOS
Examples Mac & Win Server Client Guides Statistic FMM Blog Deprecated Old

Version

Useful for doing auto-updates from server and version checking.

Component Version macOS Windows Linux Server iOS SDK
Plugin 1.0 ✅ Yes ✅ Yes ✅ Yes ✅ Yes ✅ Yes
MBS( "Version" )

Parameters

none

Description

Useful for doing auto-updates from server and version checking.
e.g. 12.3.0.08

We try to have the build number on the end always use two digits, so it has the zero as prefix if needed.
Usually we have 6 big releases per year from .0 to .5. And the first number is basically the year. While development started 2006, the numbering was later adjusted to match year (from 2010) with version 4 in 2014.

For automatic checks, please use VersionAutoUpdate function as it always returns an eight digit number.

Examples

Get the Plugin Version

$r = MBS("Version")

Query Plugin version on Server from Client with two scripts:

# First a script called "Query MBS Version on Server" which you can run:

Perform Script on Server [Wait for completion; “Query MBS Version Helper”]
Set Variable [$e; Value:Get(LastError)]
Set Variable [$r; Value:Get(ScriptResult)]
If [$e ≠ 0]
    Show Custom Dialog ["MBS Version on Server"; "Failed to run script on server: " & $e]
Else
    Show Custom Dialog ["MBS Version on Server"; $r]
End If

# Second, the helper script called "Query MBS Version Helper" which will run on the server:

Set Variable [$r; Value:MBS("Version") & " " & MBS("Platform")]
Exit Script [Result: $r]

Check and ask user to install newer version than the prerelease they have:

If [ MBS("Plugin.IsPrerelease") ]
    If [ Get(CurrentDate) - MBS( "Plugin.CompileDate" ) >= 14 ]
        Show Custom Dialog [ "Update" ; "Please install newer version of MBS Plugin." & ¶ & MBS("Version") ]
    End If
End If

See also

Blog Entries

This function is free to use.

Created 18th August 2014, last changed 11st September 2023


Validate.FindReceipt - VersionAutoUpdate