Домашняя страница


RU EN
🏠 Домой ❮ Назад

Unreal-плагин RuStore для работы с облачным сервисом конфигурации приложения

RuStore Remote Config — это облачный сервис, который позволяет изменять поведение и внешний вид вашего приложения, не требуя от пользователей загрузки обновления приложения. SDK инкапсулирует в себе запрос конфигурации с сервера, кэширование, фоновое обновление. Поддерживаются версии Unreal Engine 5.3 и выше.

Установка плагина в свой проект

  1. Перейдите в раздел Релизы репозитория проекта на GitFlic.

  2. Скачайте из выбранного релиза артефакты:

    • RuStoreRemoteConfig.zip
    • RuStoreCore.zip
  3. Распакуйте скачанные архивы в папку Plugins в корне вашего Unreal-проекта, чтобы получилась следующая структура:

📁 your_project
└─ 📁 Plugins
   ├─ 📁 RuStoreRemoteConfig
   │  ├─ 📁 Binaries
   │  ├─ 📁 Content
   │  ├─ 📁 Intermediate
   │  ├─ 📁 Resources
   │  ├─ 📁 Source
   │  └─ RuStoreRemoteConfig.uplugin
   └─ 📁 RuStoreCore
      ├─ 📁 Binaries
      ├─ 📁 Content
      ├─ 📁 Intermediate
      ├─ 📁 Resources
      ├─ 📁 Source
      └─ RuStoreCore.uplugin
  1. Перезапустите Unreal Engine.

  2. В списке плагинов (Edit → Plugins → Project → Mobile) отметьте плагины RuStoreRemoteConfig и RuStoreCore.

  3. Подключите модули RuStoreCore и RuStoreRemoteConfig в файле YourProject.Build.cs в списке PublicDependencyModuleNames.

  4. В настройках проекта (Edit → Project Settings → Android) установите параметр Minimum SDK Version на уровень не ниже 24 и параметр Target SDK Version не ниже 31.

Инициализация SDK

Перед вызовом методов библиотеки необходимо выполнить её инициализацию. Для этого создайте класс, расширяющий GameApplication, и добавьте инициализацию RemoteConfigClient в метод onCreate.

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 — уникальный идентификатор инструмента Remote Config. Доступен в RuStore Консоли на странице создания параметров Remote Config.
  • UPDATE_TIME — интервал таймера обновления в минутах.
  • UPDATE_BEHAVIOUR — параметр, определяющий поведение SDK.

Для замены класса GameApplication на RuStoreRemoteConfigApplication в файле манифеста вашего проекта воспользуйтесь функционалом Unreal Plugin Language (UPL):

<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>

Подробнее об инициализации см. в руководстве онлайн.

Работа с SDK

Начните изучение документации библиотеки RuStore с методов класса URuStoreRemoteConfigClient. Или воспользуйтесь руководством онлайн.

Техническая поддержка

Дополнительная помощь и инструкции доступны в документации RuStore и по электронной почте support@rustore.ru.

Условия распространения

Данное программное обеспечение, включая исходные коды, бинарные библиотеки и другие файлы, распространяется под лицензией MIT. Информация о лицензировании доступна в документе MIT-LICENSE.