How to connect native Xsolla SDK for Android to your project

You can use native Xsolla SDK for Android to implement features, such as social login and returning to applications after purchase for mobile applications.

To connect the native SDK to a Cocos Creator project, follow the steps below:

1. Generate a project for Android Studio.
2. Connect the Xsolla SDK for Android to the project.
3. Set up the project in Android Studio.
4. Initialize the Xsolla SDK for Android on the Cocos Creator side.

Generate project for Android Studio

1. In the Cocos Creator editor, go to Project > Build in the main menu. If the application wasn’t built for platforms before, a window for creating a new configuration for build will open. If the editor already has build configurations, click New Build Task to create a new configuration.
2. In the New Build Configuration window, make the following changes:

1. 1. In the Platform field, select Android from the list of available build platforms.
   2. In the APP ABI field, specify arm64-v8a (recommended). If you plan to run a mobile application on an emulator, then specify x86.
   3. In the Target API Level field, specify android-28 or newer.

3. Click Build.

As a result, a project for Android Studio is generated in the <CocosProjectPath>/build/android/proj directory. Files that are used for all Android builds are generated in the <CocosProjectPath>/native/engine/android directory.

Connect Xsolla SDK for Android to project

1. Add custom Activities from Xsolla SDK to the source code. To do that:
   1. Copy and replace the existing files from the <CocosProjectPath>/extensions/xsolla-commerce-sdk/native/android/Activities folder to the <CocosProjectPath>/native/engine/android/app/src/com/cocos/game folder.
   2. Open the <CocosProjectPath>/native/engine/android/app/AndroidManifest.xml file with any text editor and add the following lines to the list of activities:

<activity
android:name="com.cocos.game.XsollaNativeAuthActivity"
android:configChanges="orientation|screenSize"
android:theme="@android:style/Theme.NoTitleBar"/>
<activity
android:name="com.cocos.game.wxapi.WXEntryActivity"
android:exported="true"
android:theme="@android:style/Theme.NoTitleBar"/>

2. Add the Xsolla SDK libraries for Android as dependencies to your project’s build settings:
   1. In Android Studio, open your project’s build.gradle file.
   2. Add the following lines to the dependencies section:

implementation 'com.xsolla.android:login:1.2.1'
implementation 'com.xsolla.android:login-facebook:1.2.1'
implementation 'com.xsolla.android:login-google:1.2.1'
implementation 'com.xsolla.android:login-wechat:1.2.1'
implementation 'com.xsolla.android:login-qq:1.2.1'

1. 3. For the changes to take effect, run the Sync Now command.

Android Studio will download the corresponding libraries, and you can use its methods in the project.

Set up project in Android Studio

1. In Android Studio, open your project from the <CocosProjectPath>/build/android/proj directory.
2. Add the AndroidX native libraries required for the Xsolla SDK for Android to work:
   1. In the gradle.properties file, add the following lines:

android.useAndroidX=true
android.enableJetifier=true

1. 2. For the changes to take effect, run the Sync Now command.

Initialize Xsolla SDK for Android on the Cocos Creator side

Before you use any of the Xsolla SDK for Android features, you need to initialize the SDK. To do this, add an initialization script to the project using the IDE or by copying the file to the project directory.

In Cocos Creator, calls to native Java methods are made in TypeScript using the built-in reflection mechanism.

In the Cocos Creator project, you should call the xLoginInit method to initialize the Xsolla SDK.

Example of initialization script:

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

}
}