Comment connecter le SDK Xsolla natif pour Android au projet

Utiliser le SDK Xsolla natif pour Android pour implémenter les fonctionnalités telles que la connexion via les réaux sociaux et la redirection vers l’application après l’achat pour les applications mobiles.

Pour connecter le SDK natif à un projet Cocos Creator, procédez comme suit :

1. Générez un projet pour Android Studio.
2. Connectez le SDK Xsolla pour Android au projet.
3. Configurez le projet dans Android Studio.
4. Initialisez le SDK Xsolla pour Android côté Cocos Creator.

Générer un projet pour Android Studio

1. Dans l'éditeur Cocos Creator, accédez à Project > Build dans le menu principal. Si vous n'avez pas encore compilé de build de votre application pour les plateformes, une fenêtre permettant de créer une nouvelle configuration de build s'affiche. Si l'éditeur possède déjà des configurations de build, cliquez sur New Build Task pour créer une nouvelle configuration.
2. Dans la fenêtre New Build Configuration, apportez les modifications suivantes :

1. 1. Dans le champ Platform, sélectionnez Android dans la liste des plateformes de build disponibles ;
   2. Dans le champ APP ABI, spécifiez arm64-v8a (recommandé). Si vous envisagez d'exécuter l'application mobile sur un émulateur, spécifiez x86 ;
   3. Dans le champ Target API Level, spécifiez android-28 ou version ultérieure.

3. Cliquez sur Build.

Un projet pour Android Studio est généré dans le répertoire <CocosProjectPath>/build/android/proj. Les fichiers utilisés pour tous les builds Android sont générés dans le répertoire <CocosProjectPath>/native/engine/android.

Connecter le SDK Xsolla pour Android au projet

1. Ajoutez des Activities customisées du SDK Xsolla au code source. Pour ce faire :
   1. Copiez et remplacez les fichiers existants du dossier <CocosProjectPath>/extensions/xsolla-commerce-sdk/native/android/Activities au dossier <CocosProjectPath>/native/engine/android/app/src/com/cocos/game ;
   2. Ouvrez le fichier <CocosProjectPath>/native/engine/android/app/AndroidManifest.xml dans n'importe quel éditeur de texte et ajoutez les lignes suivantes à la liste des 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. Ajoutez les bibliothèques du SDK Xsolla pour Android en tant que dépendances aux paramètres de génération de votre projet :
   1. Dans Android Studio, ouvrez le fichier build.gradle de votre projet ;
   2. Ajoutez les lignes ci-dessous à la section des dépendances :

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. Pour que les modifications prennent effet, exécutez la commande Sync Now.

Android Studio téléchargera les bibliothèques correspondantes et vous pourrez utiliser ses méthodes dans le projet.

Configurer un projet dans Android Studio

1. Dans Android Studio, ouvrez votre projet depuis le répertoire <CocosProjectPath>/build/android/proj.
2. Ajoutez les bibliothèques natives AndroidX requises pour le bon fonctionnement du SDK Xsolla pour Android :
   1. Dans le fichier gradle.properties, ajoutez les lignes suivantes :

android.useAndroidX=true
android.enableJetifier=true

1. 2. Pour que les modifications prennent effet, exécutez la commande Sync Now.

Initialiser le SDK Xsolla pour Android côté Cocos Creator

Avant d’utiliser toute fonctionnalité du SDK Xsolla pour Android, vous devez initialiser le SDK. Pour ce faire, ajoutez un script d’initialisation au projet à l’aide de l’IDE ou en copiant le fichier dans le répertoire du projet.

Dans Cocos Creator, l’appel à une méthode Java native dans TypeScript s’effectue à l’aide du mécanisme de réflexion intégré.

Dans le projet Cocos Creator, appelez la méthode xLoginInit pour initialiser le SDK Xsolla.

Exemple de script d’initialisation :

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

}
}