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 منتقل شد.
- محصولات با همان شناسهها در کنسول تعریف شدند و با آزمایشگر مجوز در سندباکس آزمایش شد.