Game Info

Mobile

Understanding

What is SDK Module Version Info?

A feature that looks up the version info of the SDK modules applied to the current game app (build).
You can receive the version info of each SDK module (Base, Auth, View, Push, etc.) in JSON form.
It's mainly used in development/operations for debugging, QA, version-mismatch checks, and the like.

Returned Module-Info Example

The return form is JSON composed of each module name and version string, as shown below.

Module name	Description
Base	STOVE SDK Base module version.
Log	Log module version.
Auth	Authentication module version.
AuthUI	Authentication UI module version.
IAP	In-app purchase module version.
IAPGoogle	Google in-app purchase module version.
Push	Push module version.
View	View (pop-up) module version.
AuthFacebook	Facebook authentication module version.
AuthGoogle	Google authentication module version.
AuthTwitter	Twitter authentication module version.

Development

Getting SDK Version Info

You can look up the SDK-module version info applied to the current game app with the Log.getSDKVersions API. The return value is JSON in the form module name → version string.

When to call — after SDK initialization
Log.getSDKVersions synchronously reads and returns the module version info that the SDK cached in local storage (SharedPreferences/UserDefaults) during the initialize stage. It returns immediately with no callback or error code, and if you call it before initialization you'll get an empty object ({}), so be sure to call it after the initialize-complete callback. If the result is empty, the call happened before initialization or an SDK dependency is missing, so re-check the initialize timing and the module dependencies (build.gradle / Podfile / package settings).

public void GetVersions()
{
    Dictionary<string, object> version = Log.GetSDKVersions();
}

Module-info response example

{
    "Base": "2.4.0",
    "Log": "2.4.0",
    "Auth": "2.4.2",
    "AuthUI": "2.4.2",
    "IAP": "2.4.0",
    "IAPGoogle": "2.4.0",
    "Push": "2.4.0",
    "View": "2.4.0",
    "AuthFacebook": "2.4.0",
    "AuthGoogle": "2.4.0",
    "AuthTwitter": "2.4.0"
}

Frequently Asked Questions

Q1. When can I call SDK version info?

A. As long as the SDK is applied to the game app, you can call it at any point, with no separate initialization-complete condition.

Q2. Is the returned module list always the same?

A. It's returned based on the SDK modules actually applied to the game app.
Modules that aren't applied (e.g., when you don't use AuthFacebook) may not be included in the list.

Q3. How do I show SDK version info on the in-game settings screen?

A. From the JSON object returned by Log.getSDKVersions(), look up the version string using the desired module name as the key, then bind it directly to your in-game settings UI.
For example, looking up the Base key gives you the version string of the SDK Base module.

PC

Understanding

What is PC SDK Version Info?

A feature that looks up the version string of the PC SDK applied to the current game app (build).
It's mainly used in development/operations for debugging, QA, version-mismatch checks, and the like.

Unlike mobile, which returns per-module versions in JSON form, PC returns a single version string.

Development

Getting PC SDK Version Info

You can look up the currently integrated PC SDK version string with BaseSDK's version-lookup API (Base_GetVersion). It fills the version string into the buffer (string) passed by the caller and returns immediately, synchronously.

It's a synchronous API and returns immediately with no callback. Call it after BaseSDK initialization (Base_Initialize).

#include "BaseSDK.h"

using namespace Stove::PCSDK;
using namespace Stove::PCSDK::Base;

// Prepare a buffer to receive the version string
wchar_t buffer[1024] = { 0, };

// Call Base_GetVersion (synchronous)
auto result = Base_GetVersion(buffer, 1024);
if (result.IsSuccessful())
{
    // Success: the PC SDK version string is filled into buffer.
}
else
{
    // Implement the failure logic.
}

Frequently Asked Questions

Q1. Is the PC SDK version also returned per module like mobile?

A. No. The PC SDK returns a single version string based on BaseSDK. This differs from mobile's Log.getSDKVersions, which returns per-module JSON.

Q2. When can I call the PC SDK version lookup?

A. Call it after BaseSDK initialization (Base_Initialize) completes. As a synchronous API, it returns the result immediately with no callback.

Need to contact us directly? stove.developers@smilegate.com