SDK pour Cocos Creator / Comment connecter le SDK Xsolla natif pour Android au projet
  Retour à la documentation

SDK pour Cocos Creator

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. 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.

  1. 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 :
Copy
Full screen
Small screen
<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"/>
  1. 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 :
Copy
Full screen
Small screen
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. 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 :
Copy
Full screen
Small screen
android.useAndroidX=true
android.enableJetifier=true
    1. 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 :

Copy
Full screen
Small screen
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);

}
}
Note
Vous devez appeler le script d’initialisation au début de l’application, par exemple dans la méthode start d’un composant attaché à la scène.
Cet article vous a été utile ?
Merci !
Que pouvons-nous améliorer ? Message
Nous sommes désolés de l'apprendre
Dites-nous pourquoi vous n'avez pas trouvé cet article utile. Message
Merci pour votre commentaire !
Nous examinerons votre message et l'utiliserons pour améliorer votre expérience.
Dernière mise à jour: 22 Janvier 2024

Faute de frappe ou autre erreur dans le texte ? Sélectionnez le texte concerné et appuyez sur Ctrl+Entée.

Signaler un problème
Nous améliorons continuellement notre contenu grâce à vos commentaires.
Indiquez votre adresse e-mail pour un suivi
Merci pour votre commentaire !