Android용 기본 엑솔라 SDK를 프로젝트에 연결하는 방법

Android용 기본 엑솔라 SDK를 사용하여 소셜 로그인 및 모바일 애플리케이션 구매 후 애플리케이션으로 돌아가기 등의 기능을 구현할 수 있습니다.

네이티브 SDK를 Cocos Creator 프로젝트에 연결하려면 다음 단계를 따르십시오.

1. Android Studio용 프로젝트를 생성합니다.
2. Android용 엑솔라 SDK를 프로젝트에 연결합니다.
3. Android Studio에서 프로젝트를 설정합니다.
4. Cocos Creator 측에서 Android용 엑솔라 SDK를 초기화합니다.

Android 스튜디오용 프로젝트 생성

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을(를) 클릭합니다.

그 결과 <CocosProjectPath>/build/android/proj 디렉토리에 Android Studio용 프로젝트가 생성됩니다. 모든 Android 빌드에 사용되는 파일은 <CocosProjectPath>/native/engine/android 디렉토리에 생성됩니다.

Android용 엑솔라 SDK를 프로젝트에 연결

1. 엑솔라 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 파일을 열고 활동 목록에 다음 줄을 추가합니다.

<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. Android용 엑솔라 SDK 라이브러리를 프로젝트의 빌드 설정에 종속성으로 추가합니다. 이를 위해
   1. Android Studio에서 프로젝트 build.gradle 파일을 엽니다.
   2. 다음 줄을 종속성 섹션에 추가합니다.

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. 변경 사항을 적용하려면 Sync Now 명령을 실행합니다.

Android Studio는 해당 라이브러리를 다운로드하고 프로젝트에서 해당 메서드를 사용할 수 있습니다.

Android 스튜디오에서 프로젝트 설정

1. Android Studio의 <CocosProjectPath>/build/android/proj 디렉터리에서 프로젝트를 엽니다.
2. Android용 엑솔라 SDK가 작동하는 데 필요한 AndroidX 기본 라이브러리를 추가합니다.
   1. gradle.properties 파일에서 다음 줄을 추가합니다.

android.useAndroidX=true
android.enableJetifier=true

1. 2. 변경 사항을 적용하려면 Sync Now 명령을 실행합니다.

Cocos Creator 측에서 Android용 엑솔라 SDK 초기화

Android용 엑솔라 SDK 기능을 사용하기 전에 SDK를 초기화해야 합니다. 이를 위해 IDE를 사용하거나, 파일을 프로젝트 디렉터리에 복사하여 프로젝트에 초기화 스크립트를 추가합니다.

Cocos Creator에서는 내장형 리플렉션 메커니즘을 사용하여 TypeScript에서 기본 Java 메서드에 대한 호출이 이루어집니다.

Cocos Creator 프로젝트에서 엑솔라 SDK를 초기화하는 xLoginInit 메서드를 호출해야 합니다.

초기화 스크립트 예시:

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

}
}