마감을 넘기는 방법은 두 가지입니다. 둘 다 유효하지만, 이 코드랩은 두 번째를 권장합니다.

단일 상품만 판매했고 앞으로도 페이월, 실험, 크로스 플랫폼 지원을 추가할 계획이 전혀 없다면 직접 패치해도 괜찮습니다. 하지만 대부분의 앱에서는 첫 번째 경로에 매년 드는 비용이 두 번째를 택할 이유가 됩니다.

참고로, 원시 Billing Library가 v8(2025년 6월 30일 출시)에서 삭제한 내용은 다음과 같습니다. 직접 패치한다면 이것이 작업 목록입니다. RevenueCat으로 이전한다면 이 코드는 삭제하면 됩니다.

v9(2026년 5월 19일)은 변경 폭이 더 작지만 여전히 코드에 영향을 줍니다. 차단된 Play Store 오류를 ERROR에서 BILLING_UNAVAILABLE로 바꿨고, 외부 결제 필드를 nullable로 만들었으며, 타깃 SDK를 35로 올렸습니다. (onProductDetailsResponse 리스너 시그니처 변경과 새 청구 하위 응답 코드는 v8에서 이미 도입되었습니다.) 최소 SDK는 v8.1부터 API 23(Android 6.0)으로 올라갔습니다.

RevenueCat Android SDK는 Google Play Billing Library를 대신 번들하고 관리합니다. 현재 SDK는 Billing Library 8.3.0을 전이 의존성으로 함께 제공하므로, com.android.billingclient:billing을 직접 추가하지 않아도 되고, BillingClient를 전혀 호출하지 않습니다.

매년 돌아오는 마감이라는 관점에서 이것이 뜻하는 바는 다음과 같습니다.

• 지금: RevenueCat SDK를 한 번만 도입합니다 (이 코드랩의 나머지 내용).
• 내년, v9이나 v10이 필수가 될 때: RevenueCat SDK 버전만 올리면 됩니다. BillingClient 재작성도, 삭제된 API 찾기도 없습니다.

직접 만들었어야 할 것들도 함께 얻습니다. 단일 진실 공급원인 customerInfo.entitlements, 서버 측 영수증 검증, 웹훅, 그리고 이후 Paywalls, Experiments, Customer Center에 대한 접근까지 포함됩니다.

앱 모듈의 Gradle 파일에 SDK를 추가하세요 (최신 버전 사용):

// app/build.gradle.kts
dependencies {
    implementation("com.revenuecat.purchases:purchases:10.10.0")
    // Optional: paywalls + Customer Center (requires minSdk 24)
    // implementation("com.revenuecat.purchases:purchases-ui:10.10.0")
}
// Remove your old: implementation("com.android.billingclient:billing:...")

SDK는 minSdk 23(Android 6.0)을 요구합니다. Application 클래스에서 한 번만 설정하세요.

// MainApplication.kt
class MainApplication : Application() {
    override fun onCreate() {
        super.onCreate()

        Purchases.logLevel = LogLevel.DEBUG
        Purchases.configure(
            PurchasesConfiguration.Builder(this, "goog_YOUR_PUBLIC_SDK_KEY")
                // .purchasesAreCompletedBy(PurchasesAreCompletedBy.REVENUECAT) // default: full migration
                .build()
        )
    }
}

RevenueCat은 하드코딩된 SKU와 자체 "프리미엄 여부" 로직을 작고 오래가는 모델로 대체합니다. 다음 항목을 대시보드에서 설정하세요.

대시보드에서 기존 Google Play 상품을 가져오고, entitlement(예: pro)를 만든 뒤, 각 상품을 거기에 Attach하세요.

기존 queryProductDetailsAsync / launchBillingFlow / 구매 확인 코드를 삭제하고 두 번의 호출로 대체하세요. 먼저 판매할 대상을 가져옵니다.

// Coroutines: fetch the current offering and its packages
val offerings = Purchases.sharedInstance.awaitOfferings()
val packages = offerings.current?.availablePackages.orEmpty()
// Show `packages` in your UI (each pkg.product carries the localized price)

그런 다음 사용자가 선택한 package로 구매를 진행합니다.

try {
    val result = Purchases.sharedInstance.awaitPurchase(
        PurchaseParams.Builder(activity, selectedPackage).build()
    )
    val customerInfo = result.customerInfo
    if (customerInfo.entitlements["pro"]?.isActive == true) {
        // Unlock pro. RevenueCat already acknowledged the purchase with Google.
    }
} catch (e: PurchasesTransactionException) {
    if (!e.userCancelled) {
        // Show a real error; userCancelled just means the user backed out.
    }
}

코루틴을 사용하지 않는다면 콜백 방식의 등가 API(getOfferingsWith, purchaseWith)도 있습니다.

이쪽 SDK가 처음이라면 Android 코드랩과 상품과 가격 가져오기 가이드에서 더 깊이 다룹니다.

이 부분이 가장 중요합니다. 현재 결제 중인 사용자가 접근 권한을 잃어서는 안 됩니다. 두 가지 요소가 있고, 두 가지 모두 필요합니다.

1. 새 구매: 자동으로 추적하기

Google Play 계정이 이미 연결된 상태에서( Google Play 연동 코드랩 참고), Google Play 서버 알림을 설정하고 Track new purchases from server-to-server notifications를 켜세요. 그러면 RevenueCat이 모든 새 구매를 기록합니다. 아직 SDK가 포함되지 않은 앱 버전에서 발생한 구매도 기록됩니다.

2. 기존 구매: 한 번만 동기화하기

기존 BillingClient 코드로 이미 구독한 사용자에 대해서는, RevenueCat이 적용된 빌드를 처음 실행할 때 syncPurchases()를 한 번 호출하세요. OS 로그인 프롬프트 없이 사용자의 기존 Google Play 구매를 RevenueCat에 전송합니다. 6단계의 상품-entitlement attach와 결합하면 사용자의 pro 접근 권한이 자동으로 복원됩니다.

// Run ONCE per subscriber, the first time they open the RevenueCat build.
if (!prefs.getBoolean("rc_migrated", false)) {
    Purchases.sharedInstance.syncPurchasesWith(
        onError = { /* retry later */ },
        onSuccess = { _ -> prefs.edit().putBoolean("rc_migrated", true).apply() }
    )
}

출시하기 전에, 실제 기기에서 요금이 청구되지 않는 상태로 이전을 검증하세요.

1. Play Console에서 Setup > License testing 아래에 테스터를 추가하고, 빌드를 internal 또는 closed testing 트랙에 게시합니다.
2. 기존 구독이 있는 테스터로 새 RevenueCat 빌드를 설치하고, 일회성 syncPurchases가 실행되어 pro entitlement가 활성화되는지 확인합니다.
3. 새 테스터로 새 흐름을 통해 구매를 완료하고, entitlement가 잠금 해제되며 트랜잭션이 RevenueCat에 나타나는지 확인합니다.
4. RevenueCat 대시보드에서 해당 고객을 열어 구매와 entitlement가 기록되었는지 살펴봅니다.

단계적 롤아웃을 원하나요? observer mode를 사용하세요

한 번의 릴리스로 청구 코드를 제거할 준비가 되지 않았다면, RevenueCat을 PurchasesAreCompletedBy.MY_APP으로 설정하세요. 그러면 기존 코드가 여전히 구매를 완료(확인)하는 동안 RevenueCat은 구매와 entitlement를 기록합니다. 기존 구매 코드를 제거한 뒤에는 기본값인 PurchasesAreCompletedBy.REVENUECAT으로 전환하세요.

Android 앱을 원시 Billing Library에서 RevenueCat으로 이전했습니다.

• BillingClient(그리고 v8에서 삭제된 API로 인한 모든 소동)를 getOfferings + purchase로 교체했습니다.
• 직접 짜맞춘 SKU 로직 대신 단일 pro entitlement로 접근 권한을 모델링했습니다.
• 일회성 syncPurchases와 상품-entitlement attach로 기존 구독자를 옮겼고, Historical Import로 이력을 채웠습니다.

얻는 것: 2026년 8월 31일 마감을 넘겼고, v9, v10, 그 이후가 필수가 되더라도 RevenueCat SDK만 올리면 됩니다. 더 이상 매년 Billing Library를 이전할 일이 없습니다.

계속하기

• Android 인앱 구매 & Paywalls: RevenueCat Android 연동 전체.
• 앱 수익 높이기와 상품과 가격 가져오기: 청구가 처리된 지금 무엇을 할지.
• RevenueCat: 기존 구독 이전하기와 Google: Billing Library 8로 이전하기.