Developer Zone

Checking for Software Updates

Trackerbird offers a service to manage updates for your software. By logging in to the customer area and accessing the Builds Management page you are able to add one or more build numbers that will be tagged as the ‘latest builds’ for your software. Then, from within your application you can call tbVersionCheck() to confirm whether end users are using the latest build/version of your your application or whether there are any newer builds available for download. Every latest build can apply to either a specific edition/versions/build or else apply to all installations. Therefore when the server matches the latest build numbers for your application it will also take into consideration the current software Edition, Version and build number that were initially submitted when creating the SDK configuration.

TBRESULT tbVersionCheck(wchar_t* internalNewVersion, wchar_t* userFriendlyNewVersion, wchar_t* downloadURL, wchar_t* changelogURL)

This function is used to implement a check for updates system for your software. It accepts 4 empty wchar_t* parameters which will be filled to give you information about the new build which you can use to inform a user a new build is available, what the version is, where they can download it from, and where to find a log which contains all of the changes for the new build.

Parameters:
  • internalNewVersion (wchar_t*) – Version number used internally (not shown to the user). Length: 45 (46 due to delimiter).
  • userFriendlyNewVersion (wchar_t*) – Friendly version number to be shown to the user. Length: 45 (46 due to delimiter).
  • downloadURL (wchar_t*) – The URL from where the new version can be downloaded. Length: 100 (101 due to delimiter).
  • changelogURL (wchar_t*) – The URL from where the user can see the change log. Length: 100 (101 due to delimiter).
Return type:

One of the return status constants below.

* TB_VERSIONCHECK_UP_TO_DATE (0)
* TB_VERSIONCHECK_NEW_VER_AVAIL (1)
* TB_FUNCTION_NOT_AVAIL (-1)
* TB_CONN_ERROR (-2)
* TB_AUTH_FAILURE (-3)
* TB_SERVER_ERROR (-4)
* TB_APP_CONFIG_NOT_LOADED (-7)