Cómo conectar el Xsolla SDK nativo para Android con su proyecto

Puede utilizar el Xsolla SDK para Android nativo para implementar funciones, como el inicio de sesión mediante redes sociales y el retorno a las aplicaciones después de la compra para aplicaciones móviles.

Para conectar el SDK nativo a un proyecto de Cocos Creator, siga los siguientes pasos:

1. Genere un proyecto para Android Studio.
2. Conecte el Xsolla SDK para Android al proyecto.
3. Configure el proyecto en Android Studio.
4. Inicialice el Xsolla SDK para Android en el lado de Cocos Creator.

Generar un proyecto para Android Studio

1. En el editor Cocos Creator, vaya a Project > Build en el menú principal. Si la aplicación no se había compilado antes para plataformas, se abrirá una ventana para crear una nueva configuración para compilarla. Si el editor ya tiene configuraciones de compilación, haga clic en New Build Task para crear una nueva configuración.
2. En la ventana New Build Configuration, realice los siguientes cambios:

1. 1. En el campo Platform, seleccione Android de la lista de plataformas de compilación disponibles.
   2. En el campo APP ABI, especifique arm64-v8a (recomendado). Si prevé ejecutar una aplicación móvil en un emulador, entonces especifique x86.
   3. En el campo Target API Level, especifique android-28 o el más reciente.

3. Haga clic en Build.

Como resultado, se genera un proyecto para Android Studio en el directorio <CocosProjectPath>/build/android/proj. Los archivos que se utilizan para todas las compilaciones de Android se generan en el directorio <CocosProjectPath>/native/engine/android.

Conectar Xsolla SDK para Android al proyecto

1. Añada Actividades personalizadas desde Xsolla SDK al código fuente. Para ello:
   1. Copie y reemplace los archivos existentes de la carpeta <CocosProjectPath>/extensions/xsolla-commerce-sdk/native/android/Activities a la carpeta <CocosProjectPath>/native/engine/android/app/src/com/cocos/game.
   2. Abra el archivo <CocosProjectPath>/native/engine/android/app/AndroidManifest.xml con cualquier editor de texto y añada las siguientes líneas a la lista de actividades:

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. Añada Xsolla SDK para Android como dependencias a la configuración de compilación de su proyecto:
   1. En Android Studio, abra el archivo build.gradle de su proyecto.
   2. Añada las siguientes líneas a la sección de dependencias:

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. Para que los cambios surtan efecto, ejecute el comando Sync Now.

Android Studio descargará las biblliotecas correspondientes, y podrá usar sus métodos en el proyecto.

Configurar un proyecto en Android Studio

1. En Android Studio, abra su proyecto desde el directorio <CocosProjectPath>/build/android/proj.
2. Añada las bibliotecas nativas de AndroidX necesarias para que funcione el Xsolla SDK para Android:
   1. En el archivo gradle.properties, añada las siguientes líneas:

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

1. 2. Para que los cambios surtan efecto, ejecute el comando Sync Now.

Inicializar el Xsolla SDK para Android en el lado de Cocos Creator

Antes de usar cualquiera de las funciones del Xsolla SDK para Android, hay que inicializar el SDK. Para ello, agregue un script de inicialización al proyecto utilizando el IDE (Entorno de desarrollo integrado) o copiando el archivo en el directorio del proyecto.

En Cocos Creator, las llamadas a los métodos nativos de Java se realizan en TypeScript empleando el mecanismo de reflexión integrado.

En el proyecto de Cocos Creator, debe llamar al método xLoginInit para inicializar el Xsolla SDK.

Ejemplo de script de inicialización:

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}