title: "مهاجرت از myket-billing-client (مایکت)" order: 9 description: "مقایسهٔ کد IabHelper مایکت و SDK بله‌استور برای راه‌اندازی، خرید، فهرست خریدها، مصرف و اشتراک"

مهاجرت از myket-billing-client (مایکت)

کتابخانهٔ پرداخت مایکت از الگوی قدیمی IabHelper گوگل پیروی می‌کند (راه‌اندازی با startSetup، خرید با launchPurchaseFlow و onActivityResult، موجودی با queryInventoryAsync). SDK بله‌استور مدل مدرن‌تری دارد (DSL کال‌بک، ActivityResultRegistry، کوروتین) و بدون onActivityResult کار می‌کند.

کدهای مایکت در این صفحه نمونهٔ معمول الگوی IabHelper هستند. امضای دقیق متدها ممکن است در نسخه‌های مختلف myket-billing-client کمی فرق کند؛ آن را با نسخهٔ خودتان تطبیق دهید.

خلاصهٔ تفاوت‌ها

موضوع مایکت (IabHelper) بله‌استور
ساخت IabHelper(context, base64PublicKey) BaleStorePayment(context, PaymentConfiguration(SecurityCheck.Enable(publicKeyPem)))
راه‌اندازی startSetup(OnIabSetupFinishedListener) connect { connectionSucceed {}; connectionFailed {}; disconnected {} }
خرید launchPurchaseFlow(activity, sku, requestCode, listener, payload) + handleActivityResult purchaseProduct(activityResultRegistry, PurchaseRequest(sku, payload)) { … }
موجودی queryInventoryAsync(…) ← Inventory getPurchasedProducts {} و getInAppSkuDetails(skus) {}
مصرف consumeAsync(purchase, listener) consumeProduct(purchaseToken) {}
تأیید (acknowledge) ندارد الزامی برای غیرمصرفی و اشتراک
پایان کار dispose() connection.disconnect()
کلید RSA (base64) ECDSA P-256 / ES256 (PEM)
فیلدهای خرید getSku()، getToken()، getDeveloperPayload()، getSignature() productId، purchaseToken، payload، dataSignature

۱. وابستگی و manifest

مایکت (نمونهٔ معمول):

android {
    defaultConfig {
        def marketApplicationId = "ir.mservices.market"
        def marketBindAddress = "ir.mservices.market.InAppBillingService.BIND"
        manifestPlaceholders += [marketApplicationId: "${marketApplicationId}",
                                 marketBindAddress  : "${marketBindAddress}",
                                 marketPermission   : "${marketApplicationId}.BILLING"]
    }
}
dependencies {
    implementation "com.github.myketstore:myket-billing-client:<version>"
}

بله‌استور:

dependencies {
    implementation("ir.bale.balestore:billing-sdk:1.0.0")
}
<queries>
    <package android:name="ir.nasim" />
    <package android:name="ir.bale.balestore.installer" />
    <intent><action android:name="ir.bale.balestore.billing.BIND" /></intent>
</queries>

اگر فقط به بله‌استور مهاجرت می‌کنید، manifestPlaceholders مایکت، مجوز …BILLING و وابستگی آن را حذف کنید.

۲. ساخت و راه‌اندازی

مایکت:

iabHelper = IabHelper(this, MYKET_BASE64_RSA_KEY)
iabHelper.startSetup { result ->
    if (!result.isSuccess) {
        showError(result.message)
        return@startSetup
    }
    iabHelper.queryInventoryAsync(true, listOf("coins_100", "remove_ads"), gotInventoryListener)
}

override fun onDestroy() {
    iabHelper.dispose()
    super.onDestroy()
}

بله‌استور:

payment = BaleStorePayment(this, PaymentConfiguration(SecurityCheck.Enable(publicKeyPem = BALE_PUBLIC_KEY_PEM)))
connection = payment.connect {
    connectionSucceed {
        loadSkuDetails()
        processPendingPurchases()
    }
    connectionFailed { t -> showError(t.message) } // BaleStoreNotFoundException when Bale is missing
    disconnected { }
}

override fun onDestroy() {
    connection.disconnect()
    super.onDestroy()
}

۳. موجودی: جزئیات محصول و خریدهای قبلی

مایکت: یک فراخوانی هر دو را برمی‌گرداند.

val gotInventoryListener = IabHelper.QueryInventoryFinishedListener { result, inventory ->
    if (result.isFailure) return@QueryInventoryFinishedListener
    showPrice(inventory.getSkuDetails("coins_100")?.price)
    inventory.getPurchase("coins_100")?.let { consume(it) }        // unfinished consumable
    adsRemoved = inventory.hasPurchase("remove_ads")
}

بله‌استور: دو فراخوانی جدا.

fun loadSkuDetails() = payment.getInAppSkuDetails(listOf("coins_100", "remove_ads")) {
    getSkuDetailsSucceed { list -> list.forEach { showPrice(it.sku, it.priceText) } }
    getSkuDetailsFailed { t -> showError(t.message) }
}

fun processPendingPurchases() = payment.getPurchasedProducts {
    querySucceed { purchases ->
        purchases.forEach { p ->
            when {
                p.productId == "coins_100" && p.purchaseState == PurchaseState.PURCHASED -> consume(p)
                p.productId == "remove_ads" -> {
                    adsRemoved = true
                    if (p.purchaseState == PurchaseState.PURCHASED) acknowledge(p)
                }
            }
        }
    }
    queryFailed { t -> showError(t.message) }
}

۴. خرید

مایکت:

iabHelper.launchPurchaseFlow(this, "coins_100", RC_REQUEST, { result, purchase ->
    if (result.isFailure) { showError(result.message); return@launchPurchaseFlow }
    if (purchase.developerPayload != expectedPayload) return@launchPurchaseFlow
    consume(purchase)
}, "order-42")

// required: forward activity results to the helper
override fun onActivityResult(requestCode: Int, resultCode: Int, data: Intent?) {
    if (!iabHelper.handleActivityResult(requestCode, resultCode, data)) {
        super.onActivityResult(requestCode, resultCode, data)
    }
}

بله‌استور: بدون onActivityResult و requestCode.

payment.purchaseProduct(activityResultRegistry, PurchaseRequest(productId = "coins_100", payload = "order-42")) {
    purchaseFlowBegan { }
    failedToBeginFlow { t -> showError(t.message) }
    purchaseSucceed { purchase ->
        // verify purchase.purchaseToken on your server, then:
        consume(purchase)
    }
    purchaseCanceled { }
    purchaseFailed { t -> showError(t.message) }
}

۵. مصرف و تأیید

مایکت:

fun consume(purchase: Purchase) = iabHelper.consumeAsync(purchase) { p, result ->
    if (result.isSuccess) addCoins(100)
}

بله‌استور:

fun consume(p: PurchaseInfo) = payment.consumeProduct(p.purchaseToken) {
    consumeSucceed { addCoins(100) }
    consumeFailed { t -> /* retry on next start */ }
}

fun acknowledge(p: PurchaseInfo) = payment.acknowledge(p.purchaseToken) { // non-consumables & subscriptions
    acknowledgeSucceed { }
    acknowledgeFailed { t -> /* retry on next start */ }
}

⚠️ در بله‌استور، خرید غیرمصرفی و اشتراک باید acknowledge شود. خریدی که تا مهلت (پیش‌فرض ۳ روز، قابل تنظیم) نه مصرف شود و نه تأیید، خودکار بازپرداخت می‌شود (AUTO_REFUNDED).

۶. اشتراک

مایکت (نمونهٔ معمول):

iabHelper.launchSubscriptionPurchaseFlow(this, "vip_monthly", RC_REQUEST, { result, purchase ->
    if (result.isSuccess) activateVip(purchase)
}, "sub-42")

بله‌استور:

payment.subscribeProduct(activityResultRegistry, PurchaseRequest("vip_monthly", payload = "sub-42")) {
    purchaseSucceed { purchase -> activateVip(purchase); acknowledge(purchase) }
    purchaseCanceled { }
    purchaseFailed { t -> }
    purchaseFlowBegan { }
    failedToBeginFlow { t -> }
}
payment.getSubscribedProducts { querySucceed { subs -> }; queryFailed { t -> } }

۷. نگاشت فیلدهای خرید

مایکت (Purchase) بله‌استور (PurchaseInfo)
getOrderId() orderId
getSku() productId
getToken() purchaseToken (یک JWS ES256)
getDeveloperPayload() payload
getPurchaseTime() purchaseTime (میلی‌ثانیهٔ epoch)
getPurchaseState() purchaseState (enum: PENDING، PURCHASED، ACKNOWLEDGED، CONSUMED، REFUNDED، AUTO_REFUNDED)
getOriginalJson() originalJson
getSignature() dataSignature
getPackageName() packageName
مایکت (SkuDetails) بله‌استور (SkuDetails)
getSku() sku
getPrice() (رشته) priceText (رشتهٔ تومان) + priceRials (عدد ریال)
getTitle() / getDescription() title / description
getType() type ("inapp" یا "subs")

۸. کلید: از RSA به ES256

در مایکت، IabHelper امضای RSA روی originalJson را با کلید base64 بررسی می‌کند. در بله‌استور، خود purchaseToken یک JWS امضاشده با ES256 است و SDK آن را با کلید PEM برنامه (از کنسول یا GET /console/v1/billing/apps/{appId}/keys) بررسی می‌کند. کد بررسی RSA در سرور را با تأیید توکن خرید یا بهتر با API سرور به سرور جایگزین کنید.

۹. پشتیبانی هم‌زمان از مایکت و بله‌استور

با StoreRouter از لایهٔ متن‌باز ir.bale.balestore.sdk.store (SDK اندروید) یک آداپتر BillingBackend برای مایکت بنویسید و بگذارید منبع نصب انتخاب کند:

val backend = StoreRouter(
    context,
    baleStore = BaleStoreBackend(payment),
    myket = MyketBackend(activity, MYKET_BASE64_RSA_KEY), // your adapter around IabHelper
).select() // installed from Myket → Myket; otherwise → Bale Store

چون IabHelper نتیجهٔ خرید را از onActivityResult می‌گیرد، آداپتر مایکت باید:

  • در connect()، startSetup را در suspendCancellableCoroutine بپیچد؛
  • در purchase()، launchPurchaseFlow را صدا بزند و اکتیویتی شما onActivityResult را به iabHelper.handleActivityResult بدهد؛
  • Purchase مایکت را مطابق جدول بالا به PurchaseInfo تبدیل کند (priceRials را صفر بگذارید، چون مایکت فقط رشتهٔ قیمت می‌دهد)؛
  • در acknowledge() کاری نکند (مایکت این مرحله را ندارد) و در disconnect()، dispose() را صدا بزند.

چون بله‌استور APK را دوباره امضا نمی‌کند، همان بیلد امضاشده با کلید شما در هر دو فروشگاه منتشر می‌شود. سرور شما باید بداند هر خرید از کدام فروشگاه آمده (backend.store) تا با API همان فروشگاه بررسی کند.

چک‌لیست مهاجرت

  • IabHelper ← BaleStorePayment؛ startSetup ← connect؛ dispose ← disconnect.
  • launchPurchaseFlow + onActivityResult ← purchaseProduct(activityResultRegistry, …).
  • queryInventoryAsync ← getInAppSkuDetails + getPurchasedProducts.
  • برای غیرمصرفی‌ها و اشتراک‌ها acknowledge اضافه شد.
  • کلید RSA ← کلید PEM از کنسول بله‌استور؛ بررسی سرور به S2S منتقل شد.
  • محصولات با همان شناسه‌ها در کنسول تعریف شدند و با آزمایشگر مجوز در سندباکس آزمایش شد.