Как подключить к проекту нативный Xsolla SDK для Android

Для реализации некоторых возможностей в мобильных приложениях (например, для авторизации через социальные сети, возврата в приложение после оплаты покупки) используйте нативный Xsolla SDK для Android.

Чтобы подключить нативный SDK к проекту для Cocos Creator:

1. Сгенерируйте проект для Android Studio.
2. Подключите к проекту Xsolla SDK для Android.
3. Настройте проект в Android Studio.
4. Инициализируйте Xsolla SDK для Android на стороне Cocos Creator.

Генерация проекта для Android Studio

1. В редакторе Cocos Creator в главном меню выберите пункт Project > Build. Если ранее сборка приложения под платформы не выполнялась, откроется окно создания новой конфигурации для сборки. Если в редакторе уже есть конфигурации для сборки, нажмите New Build Task для создания новой конфигурации.
2. В окне New Build Configuration выполните следующие изменения:

1. 1. В поле Platform из списка доступных платформ для сборки выберите Android.
   2. В поле APP ABI выберите arm64-v8a (рекомендуется). Если планируется запускать мобильное приложение на эмуляторе, выберите x86.
   3. В поле Target API Level укажите android-28 или более новый.

3. Нажмите Build.

В результате в директории <CocosProjectPath>/build/android/proj будет сгенерирован проект для Android Studio. В папке <CocosProjectPath>/native/engine/android будут сгенерированы файлы, которые будут использоваться для всех сборок под Android.

Подключение Xsolla SDK для Android к проекту

1. Добавьте в исходный код приложения кастомные Activity из Xsolla SDK. Для этого:
   1. Скопируйте с заменой существующих файлов содержимое папки <CocosProjectPath>/extensions/xsolla-commerce-sdk/native/android/Activities в папку <CocosProjectPath>/native/engine/android/app/src/com/cocos/game.
   2. Откройте файл <CocosProjectPath>/native/engine/android/app/AndroidManifest.xml в любом текстовом редакторе и добавьте в список Activity следующие строки:

1<activity
2android:name="com.cocos.game.XsollaNativeAuthActivity"
3android:configChanges="orientation|screenSize"
4android:theme="@android:style/Theme.NoTitleBar"/>
5<activity
6android:name="com.cocos.game.wxapi.WXEntryActivity"
7android:exported="true"
8android:theme="@android:style/Theme.NoTitleBar"/>

2. Добавьте библиотеки Xsolla SDK для Android в качестве зависимостей в настройки сборки проекта. Для этого:
   1. В Android Studio откройте файл build.gradle проекта.
   2. В раздел dependencies добавьте следующие строки:

1implementation 'com.xsolla.android:login:1.2.1'
2implementation 'com.xsolla.android:login-facebook:1.2.1'
3implementation 'com.xsolla.android:login-google:1.2.1'
4implementation 'com.xsolla.android:login-wechat:1.2.1'
5implementation 'com.xsolla.android:login-qq:1.2.1'

1. 3. Чтобы изменения вступили в силу, выполните команду Sync Now.

В результате Android Studio скачает соответствующие библиотеки, и их методы можно будет использовать в проекте.

Настройка проекта в Android Studio

1. В Android Studio откройте проект из директории <CocosProjectPath>/build/android/proj.
2. Добавьте в проект нативные библиотеки AndroidX, необходимые для работы Xsolla SDK для Android:
   1. В файле gradle.properties добавьте следующие строки:

1android.useAndroidX=true
2android.enableJetifier=true

1. 2. Чтобы изменения вступили в силу, выполните команду Sync Now.

Инициализация Xsolla SDK для Android на стороне Cocos Creator

Перед тем как использовать какую-либо функциональность Xsolla SDK для Android необходимо инициализировать SDK. Для этого добавьте в проект скрипт инициализации через IDE или скопировав файл в директорию проекта.

Вызов нативных Java-методов из TypeScript в Cocos Creator осуществляется при помощи встроенного механизма рефлексии.

В проекте Cocos Creator необходимо вызвать метод xLoginInit для инициализации Xsolla SDK.

Пример скрипта инициализации:

1if(sys.platform.toLowerCase() == 'android') {
2    jsb.reflection.callStaticMethod("com/cocos/game/XsollaNativeAuth", "xLoginInit",
3        "(Ljava/lang/String;Ljava/lang/String;Ljava/lang/String;Ljava/lang/String;Ljava/lang/String;Ljava/lang/String;Ljava/lang/String;)V",
4        Xsolla.settings.loginId, Xsolla.settings.clientId.toString(), "https://login.xsolla.com/api/blank",
5        this.facebookAppId, this.googleAppId, this.wechatAppId, this.qqAppId);
6
7}
8}