결제 >

멀티 스토어 결제 설정

now.gg 결제 모듈은 nowStudio를 사용하여 멀티 스토어 퍼블리싱 기능을 활용할 때 멀티 스토어 결제를 지원할 수 있습니다.

이 문서는 멀티 스토어 결제를 활성화하는 데 필요한 단계를 설명합니다.

사전 조건

멀티 스토어 결제를 활성화하려면 다음 요구 사항을 충족해야 합니다:

1. 지원 스토어

현재 지원되는 스토어는 다음과 같습니다:

  • now.gg 기반
    • BlueStacks 스토어
    • Cloud 스토어
  • 대체 스토어
    • Amazon Appstore
    • OnePlus OneStore
    • Xiaomi GetApps
    • Huawei AppGallery (출시 예정)
    • Samsung Galaxy Store

2. 스토어별 설정

결제 모듈을 통합한 후, 최종 APK를 제공하기 전에 다음 스토어별 변경 사항을 최종 빌드에 포함했는지 확인하세요.

스토어 선택에 따라 다음 단계를 참조하세요:

2.1 아마존 앱스토어

아마존 앱스토어용 앱 빌드를 생성하려면 다음 단계를 수행해야 합니다.

2.1.1 PEM 파일

아마존은 PEM 파일을 요구하며, 이는 아마존 앱스토어와 앱 간의 안전한 통신 채널을 설정하는 고유한 앱 전용 공개 키를 포함합니다.

  • PEM 파일을 받으려면 dev-support@now.gg로 문의하세요.
  • 다음 지침에 따라 PEM 파일을 포함하세요:
  • 네이티브 안드로이드:
    • PEM 파일을 Android Studio 프로젝트의 app/src/main/assets 디렉토리에 붙여넣으세요.
      참고: 앱에 assets 디렉토리가 없으면 새로 생성한 후 PEM 파일을 해당 디렉토리에 넣어야 합니다.
  • Unity:
    • 프로젝트의 Assets 폴더에서 StreamingAssets라는 새 폴더를 만드세요.
      • PEM 파일을 Assets/StreamingAssets에 붙여넣으세요.

2.1.2 AndroidManifest.xml 업데이트

앱의 AndroidManifest.xml 내에 다음 항목을 추가하세요:

<queries>
     <package android:name="com.amazon.sdktestclient" />
     <package android:name="com.amazon.venezia" />
 </queries>

2.2 원플러스 원스토어

원플러스 원스토어용 앱 빌드를 생성하려면 다음 단계를 수행해야 합니다.

2.2.1 종속 항목 추가

다음 종속 항목을 모듈/앱 수준의 build.gradle에 추가하세요:

implementation "com.onestorecorp.sdk:sdk-iap:21.01.00"

2.2.2 루트 build.gradle / settings.gradle 업데이트

다음 지침을 기반으로 루트 build.gradle 또는 settings.gradle을 업데이트하세요:

pluginManagement {
    repositories {
        google {
            content {
                includeGroupByRegex("com\\.android.*")
                includeGroupByRegex("com\\.google.*")
                includeGroupByRegex("androidx.*")
            }
        }
	  maven { url "https://jitpack.io" }
	 maven { url = uri("https://repo.onestore.net/repository/onestore-sdk-public") }
        mavenCentral()
        gradlePluginPortal()
    }
 }
 dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        google()
        mavenCentral()
	  maven { url "https://jitpack.io" }
	  maven { url = uri("https://repo.onestore.net/repository/onestore-sdk-public") }
    }
 }

2.2.3 AndroidManifest.xml 업데이트

앱의 AndroidManifest.xml 내에 다음 항목을 추가하세요:

<queries>
    <intent>
        <action android:name="com.onestore.ipc.iap.IapService.ACTION" />
    </intent>
    <intent>
        <action android:name="android.intent.action.VIEW" />
	<data android:scheme="onestore" />
    </intent>
 </queries>

2.2.4 ProGuard 규칙 추가

ProGuard/R8가 활성화된 경우에만 다음 규칙을 ProGuard 구성에 추가하세요:

# Core ProGuard 규칙
 -keep class com.gaa.sdk.base.** { *; }
 -keep class com.gaa.sdk.auth.** { *; }

 # 구매 관련 ProGuard 규칙
 -keep class com.gaa.sdk.iap.** { *; }
 -keep class com.onestore.extern.licensing.** { *; }

중요

  • 이 규칙은 ProGuard/R8가 활성화된 경우에만 추가해야 합니다.

2.3 샤오미 GetApps

샤오미 GetApps용 앱 빌드를 생성하려면 다음 단계를 수행해야 합니다.

2.3.1 종속 항목 추가

다음 종속 항목을 모듈/앱 수준의 build.gradle에 추가하세요:

implementation 'com.xiaomi.billingclient:billing:1.1.3'

2.3.2 서명된 빈 APK

샤오미는 검증을 위해 서명된 빈 APK를 요구합니다.

1. now.gg 관리 앱 서명

now.gg 관리 앱 서명을 선택하면 이 단계를 건너뛸 수 있습니다. now.gg가 자동으로 APK에 서명합니다.

2. 자체 인증서로 서명

APK를 자체 인증서로 서명하려면 다음 단계를 따르세요:

중요 정보

  • 서명된 빈 APK는 초기 제출 시에만 필요합니다.

2.4 화웨이 AppGallery (출시 예정)

화웨이 AppGallery용 앱 빌드를 생성하려면 다음 단계를 수행해야 합니다.

2.4.1 네이티브 안드로이드

1. 종속 항목 추가

다음 종속 항목을 모듈/앱 수준의 build.gradle에 추가하세요:

implementation 'com.huawei.agconnect:agconnect-core:1.5.2.300'
 implementation 'com.huawei.agconnect:agcp:1.9.1.303'
 implementation 'com.huawei.hms:iap:6.13.0.300'
2. 루트 build.gradle / settings.gradle 업데이트

다음 지침을 기반으로 루트 build.gradle 또는 settings.gradle을 업데이트하세요:

pluginManagement {
    repositories {
        google {
            content {
                includeGroupByRegex("com\\.android.*")
                includeGroupByRegex("com\\.google.*")
                includeGroupByRegex("androidx.*")
            }
        }
        maven {url 'https://developer.huawei.com/repo/'}
        mavenCentral()
        gradlePluginPortal()
    }
 }
 dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        google()
        mavenCentral()
        maven {url 'https://developer.huawei.com/repo/'}
    }
 }
3. AndroidManifest.xml 업데이트

앱의 AndroidManifest.xml 내에 다음 항목을 추가하세요:

<Application>
 <meta-data
     android:name="com.huawei.hms.client.appid"
     android:value="<HUAWEI_APP_ID>">
 </meta-data
 </Application>

참고: HUAWEI_APP_ID는 dev-support@now.gg로 문의하면 받을 수 있습니다.

4. ProGuard 규칙 추가

ProGuard/R8가 활성화된 경우에만 다음 규칙을 ProGuard 구성에 추가하세요:

-ignorewarnings
 -keepattributes *Annotation*
 -keepattributes Exceptions
 -keepattributes InnerClasses
 -keepattributes Signature
 -keepattributes SourceFile,LineNumberTable
 -keep class com.huawei.hianalytics.**{*;}
 -keep class com.huawei.updatesdk.**{*;}
 -keep class com.huawei.hms.**{*;}

중요

  • 이 규칙은 ProGuard/R8가 활성화된 경우에만 추가해야 합니다.

2.4.2 Unity

사용자 지정 실행 매니페스트 활성화.

설정 방법:

  • Project Settings > Player > Build로 이동하세요.
  • 사용자 지정 실행 매니페스트를 활성화하세요: Assets/Plugins/Android/LauncherManifest.xml
  • LauncherManifest.xml 업데이트

    앱의 LauncherManifest.xml 내에 다음 항목을 추가하세요:

    <Application>
 <meta-data
     android:name="com.huawei.hms.client.appid"
     android:value="<HUAWEI_APP_ID>">
 </meta-data
 </Application>

참고: HUAWEI_APP_ID는 dev-support@now.gg로 문의하면 받을 수 있습니다.

2.5 삼성 갤럭시 스토어

삼성 갤럭시 스토어용 앱 빌드를 생성하려면 다음 단계를 수행해야 합니다.

2.5.1 AndroidManifest.xml 업데이트

앱의 AndroidManifest.xml 내에 다음 항목을 추가하세요:

<uses-permission android:name="com.samsung.android.iap.permission.BILLING"/>
 <uses-permission android:name="android.permission.INTERNET"/>

3. 최종 APK 제출

최종 APK를 준비한 후 nowStudio에 빌드를 업로드하세요.

진행 방법:

  • 프로덕션 릴리스 생성
  • 운영팀이 앱 제출을 검토하고 수정/요구 사항을 안내합니다.
  • 검증 완료 후, 팀이 다양한 스토어에 앱 빌드를 업로드합니다.
  • 앱이 승인되면 이메일로 통보되며, nowStudio의 릴리스 탭에서 스토어별 링크를 참조할 수 있습니다.
×

Table of Contents

멀티 스토어 결제 설정

Table of Contents

문서 Rev. 1.0

클립보드에 복사된 텍스트
copyLinkText
질문이 있으신가요? 다음 주소로 문의하세요. dev-support@now.gg