Como conectar o SDK Xsolla para Android nativo ao seu projeto

Você pode usar o SDK Xsolla para Android nativo para implementar recursos, como o login social e o retorno a aplicativos após a compra para aplicativos móveis.

Para conectar o SDK nativo a um projeto do Cocos Creator, siga as etapas abaixo:

1. Gere um projeto para o Android Studio.
2. Conecte o SDK Xsolla para Android ao projeto.
3. Configure o projeto no Android Studio.
4. Inicialize o SDK Xsolla para Android no lado do Cocos Creator.

Gere um projeto para o Android Studio

1. No editor Cocos Creator, vá para Project > Build no menu principal. Se o aplicativo não foi criado para plataformas antes, uma janela para criar uma nova configuração para compilação será aberta. Se o editor já tiver configurações de compilação, clique em New Build Task para criar uma nova configuração.
2. Na janela New Build Configuration, faça as seguintes alterações:

1. 1. No campo Platform, selecione Android na lista de plataformas de compilação disponíveis.
   2. No campo APP ABI, especifique arm64-v8a (recomendado). Se você planeja executar um aplicativo móvel em um emulador, especifique x86.
   3. No campo Target API Level, especifique android-28 ou mais recente.

3. Clique em Build.

Como resultado, um projeto para Android Studio é gerado no diretório <CocosProjectPath>/build/android/proj. Os arquivos usados para todas as compilações do Android são gerados no diretório <CocosProjectPath>/native/engine/android.

Conecte o SDK Xsolla para Android ao projeto

1. Adicione atividades personalizadas do SDK Xsolla ao código-fonte. Para fazer isso:
   1. Copie e substitua os arquivos existentes da pasta <CocosProjectPath>/extensions/xsolla-commerce-sdk/native/android/Activities para a pasta <CocosProjectPath>/native/engine/android/app/src/com/cocos/game.
   2. Abra o arquivo <CocosProjectPath>/native/engine/android/app/AndroidManifest.xml com qualquer editor de texto e adicione as seguintes linhas à lista de atividades:

<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. Adicione as bibliotecas do SDK Xsolla para Android como dependências às configurações de compilação do seu projeto:
   1. No Android Studio, abra o arquivo build.gradle do projeto.
   2. Adicione as seguintes linhas à seção de dependências:

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. Para que as alterações entrem em vigor, execute o comando Sync Now.

O Android Studio baixará as bibliotecas correspondentes e você poderá usar seus métodos no projeto.

Configure o projeto no Android Studio

1. No Android Studio, abra seu projeto no diretório <CocosProjectPath>/build/android/proj.
2. Adicione as bibliotecas nativas do AndroidX necessárias para que o SDK Xsolla para Android funcione:
   1. No arquivo gradle.properties, Adicione as seguintes linhas:

android.useAndroidX=true
android.enableJetifier=true

1. 2. Para que as alterações entrem em vigor, execute o comando Sync Now.

Inicialize o SDK Xsolla para Android no lado do Cocos Creator

Antes de usar qualquer um dos recursos do SDK Xsolla para Android, você precisa inicializar o SDK. Para fazer isso, adicione um script de inicialização ao projeto usando o IDE ou copiando o arquivo para o diretório do projeto.

No Cocos Creator, chamadas para métodos Java nativos são feitas em TypeScript usando o mecanismo de reflexão integrado.

No projeto Cocos Creator, você deve chamar o método xLoginInit para inicializar o SDK Xsolla.

Exemplo de script de inicialização:

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

}
}