HOME.en.md
RuStore Unreal plugin for working with the cloud application configuration service
RuStore Remote Config is a cloud service that lets you change the behavior and appearance of your app without requiring users to download an app update. The SDK encapsulates fetching configuration from the server, caching, and background updates. Unreal Engine 5.3 and higher are supported.
Installing the plugin into your project
-
Go to the Releases section of the project repository on GitFlic.
-
Download the following artifacts from the selected release:
RuStoreRemoteConfig.zipRuStoreCore.zip
-
Unpack the downloaded archives into the
Pluginsfolder at the root of your Unreal project so that the following structure is obtained:
📁 your_project
└─ 📁 Plugins
├─ 📁 RuStoreRemoteConfig
│ ├─ 📁 Binaries
│ ├─ 📁 Content
│ ├─ 📁 Intermediate
│ ├─ 📁 Resources
│ ├─ 📁 Source
│ └─ RuStoreRemoteConfig.uplugin
└─ 📁 RuStoreCore
├─ 📁 Binaries
├─ 📁 Content
├─ 📁 Intermediate
├─ 📁 Resources
├─ 📁 Source
└─ RuStoreCore.uplugin
-
Restart Unreal Engine.
-
In the plugin list (Edit → Plugins → Project → Mobile), enable the RuStoreRemoteConfig and RuStoreCore plugins.
-
Add the
RuStoreCoreandRuStoreRemoteConfigmodules to thePublicDependencyModuleNameslist in theYourProject.Build.csfile. -
In the project settings (Edit → Project Settings → Android), set the Minimum SDK Version parameter to at least 24 and the Target SDK Version parameter to at least 31.
SDK initialization
Before calling library methods, you must initialize it. To do this, create a class that extends GameApplication and add RemoteConfigClient initialization to the onCreate method.
package com.example.RuStoreRemoteConfigApp;
import android.content.Context;
import com.epicgames.ue4.GameApplication;
import ru.rustore.unitysdk.remoteconfigclient.model.UnityUpdateBehaviour;
import ru.rustore.unitysdk.remoteconfigclient.RuStoreUnityRemoteConfigClient;
public class RuStoreRemoteConfigApplication extends GameApplication {
public final String APP_ID = "a83c91d3-21b4-4891-841e-0ed0fc39a562";
public final int UPDATE_TIME = 15;
public final String UPDATE_BEHAVIOUR = "Actual";
@Override
public void onCreate() {
super.onCreate();
RuStoreUnityRemoteConfigClient.INSTANCE.init(APP_ID, UPDATE_TIME, UPDATE_BEHAVIOUR, null, null, getApplicationContext());
}
}
APP_ID— unique identifier of the Remote Config tool. Available in the RuStore Console on the Remote Config parameters creation page.UPDATE_TIME— update timer interval in minutes.UPDATE_BEHAVIOUR— parameter that defines the SDK behavior.
To replace the GameApplication class with RuStoreRemoteConfigApplication in your project’s manifest file, use the Unreal Plugin Language (UPL) functionality:
<prebuildCopies>
<copyDir src="$S(PluginDir)/Java" dst="$S(BuildDir)/src/com/example/RuStoreRemoteConfigApp" />
</prebuildCopies>
<androidManifestUpdates>
<addAttribute tag="application" name="android:name" value="com.example.RuStoreRemoteConfigApp.RuStoreRemoteConfigApplication" />
</androidManifestUpdates>
For more details about initialization, see the online guide.
Working with the SDK
Start exploring the RuStore library documentation with the methods of the URuStoreRemoteConfigClient class. Alternatively, use the online guide.
Technical support
Additional help and instructions are available in the RuStore documentation and by email at support@rustore.ru.
Distribution terms
This software, including source code, binary libraries, and other files, is distributed under the MIT license. Licensing information is available in the document MIT-LICENSE.