Android向けのXsolla SDKのネイティブアプリをプロジェクトに接続する方法

ネイティブのAndroid向けのXolla SDKを利用して、ソーシャルログインや購入後のアプリケーションへの復帰などの機能をモバイルアプリケーションに実装することが可能です。

ネイティブSDKをCocos Creatorのプロジェクトに接続するには、以下の手順で行います：

1. Android Studio用のプロジェクトを生成します。
2. Android向けのXsolla SDKをプロジェクトに接続します。
3. Android Studioでプロジェクトをセットアップします。
4. Cocos Creator側でAndroid向けのXsolla SDKを初期化します。

Android Studio用のプロジェクトを生成する

1. Cocos Creatorのエディターで、メインメニューからProject > Buildに移動します。アプリケーションが以前にプラットフォーム用にビルドされていない場合、ビルド用の新しい設定を作成するためのウィンドウが開きます。エディタにすでにビルド構成がある場合は、New Build Taskをクリックして、新しい構成を作成します。
2. New Build Configurationウィンドウで、以下の変更を行います：

1. 1. Platformフィルド、利用可能なビルドプラットフォームのリストからAndroidを選択します。
   2. APP ABIフィルドで、arm64-v8aを指定します（推薦）。エミュレーター上でモバイルアプリケーションを実行する予定がある場合は、x86を指定します。
   3. Target API Levelフィルドで、android-28またはそれ以降を指定します。

3. Buildをクリックします。

その結果、Android Studio用のプロジェクトが<CocosProjectPath>/build/android/projディレクトリに生成されます。すべてのAndroidビルドに使われるファイルは<CocosProjectPath>/native/engine/androidディレクトリに生成されます。

Android向けのXsolla SDKをプロジェクトに接続する

1. Xsolla SDKのカスタムアクティビティをソースコードに追加します。そのためには：
   1. 既存のファイルを<CocosProjectPath>/extensions/xsolla-commerce-sdk/native/android/Activitiesフォルダーから<CocosProjectPath>/native/engine/android/app/src/com/cocos/gameフォルダーにコピーして置き換えます。
   2. <CocosProjectPath>/native/engine/android/app/AndroidManifest.xmlファイルを任意のテキストエディタで開き、アクティビティーのリストに以下の行を追加します：

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. プロジェクトのビルド設定にAndroid向けのXsolla SDKライブラリを依存関係として追加します：
   1. Android Studioで、プロジェクトのbuild.gradleファイルを開きます。
   2. 依存関係セクションに以下の行を追加します：

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. 変更を有効にするには、Sync Nowコマンドを実行します。

Android Studioが対応するライブラリをダウンロードし、プロジェクト内でそのメソッドを使用することができます。

Android Studioでプロジェクトをセットアップする

1. Android Studioで、<CocosProjectPath>/build/android/projディレクトリからプロジェクトを開きます。
2. Android向けのXolla SDKの動作に必要なAndroidXネイティブライブラリを追加します：
   1. gradle.propertiesファイルで、次の行を追加します：

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

1. 2. 変更を有効にするには、Sync Nowコマンドを実行します。

Cocos Creator側でAndroid向けのXsolla SDKを初期化する。

Android向けのXsolla SDKの機能を使用する前に、SDKを初期化する必要があります。これを行うには、IDEを使用してプロジェクトに初期化スクリプトを追加するか、プロジェクトディレクトリにファイルをコピーしてください。

Cocos Creatorで、ネイティブJavaメソッドの呼び出しは、ビルトインのリフレクションメカニズムを利用してTypeScriptで行われます。

Cocos Creatorプロジェクトでは、xLoginInitメソッドを呼び出してXsolla SDKを初期化する必要があります。

初期化スクリプトの例：

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}