Cómo conectar el SDK de Xsolla nativo para Android con su proyecto
Puede utilizar el SDK de Xsolla para iOS 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:
- Genere un proyecto para Android Studio.
- Conecte el SDK de Xsolla para Android al proyecto.
- Configure el proyecto en Android Studio.
- Inicialice el SDK de Xsolla para Android en el lado de Cocos Creator.
Generar un proyecto para Android Studio
- 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 enNew Build Task para crear una nueva configuración. - En la ventana
New Build Configuration , realice los siguientes cambios:
- En el campo
Platform , seleccioneAndroid de la lista de plataformas de compilación disponibles. - En el campo
APP ABI , especifiquearm64-v8a (recomendado). Si prevé ejecutar una aplicación móvil en un emulador, entonces especifiquex86 . - En el campo
Target API Level , especifiqueandroid-28 o el más reciente.
- En el campo
- 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 el SDK de Xsolla para Android al proyecto
- Añada Actividades personalizadas desde el SDK de Xsolla al código fuente. Para ello:
- 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
. - 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:
- Copie y reemplace los archivos existentes de la carpeta
- kotlin
<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"/>
- Añada las bibliotecas de Xsolla SDK para Android como dependencias a la configuración de compilación de su proyecto:
- En Android Studio, abra el archivo
build.gradle
de su proyecto. - Añada las siguientes líneas a la sección de dependencias:
- En Android Studio, abra el archivo
- kotlin
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'
- Para que los cambios surtan efecto, ejecute el comando
Sync Now
.
- Para que los cambios surtan efecto, ejecute el comando
Android Studio descargará las biblliotecas correspondientes, y podrá usar sus métodos en el proyecto.
Configurar un proyecto en Android Studio
- En Android Studio, abra su proyecto desde el directorio
<CocosProjectPath>/build/android/proj
. - Añada las bibliotecas nativas de AndroidX necesarias para que funcione el SDK de Xsolla para Android:
- En el archivo
gradle.properties
, añada las siguientes líneas:
- En el archivo
- kotlin
android.useAndroidX=true
android.enableJetifier=true
- Para que los cambios surtan efecto, ejecute el comando
Sync Now
.
- Para que los cambios surtan efecto, ejecute el comando
Inicializar el SDK de Xsolla para Android en el lado de Cocos Creator
Antes de usar cualquiera de las funciones del SDK de Xsolla 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 SDK de Xsolla.
Ejemplo de script de inicialización:
- typescript
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);
}
}
start
de un componente asociado a la escena.¿Has encontrado una errata u otro error de texto? Selecciona el texto y pulsa Ctrl+Intro.