Android Setup

For complete Android setup instructions including Google Play Console configuration, app setup, and testing guidelines, please visit:

👉 Android Setup Guide - openiap.dev

The guide covers:

• Google Play Console configuration
• App bundle setup and signing
• Testing with internal testing tracks
• Common troubleshooting steps

Code Implementation

Basic Setup

import io.github.hyochan.kmpiap.kmpIapInstance
import io.github.hyochan.kmpiap.openiap.*
import kotlinx.coroutines.*

class IAPManager {
    private val scope = CoroutineScope(Dispatchers.Main)

    fun initialize() {
        scope.launch {
            try {
                // Initialize connection
                kmpIapInstance.initConnection()
                println("Billing client connected")

                // Set up purchase listeners
                setupPurchaseListeners()

                // Load products
                loadProducts()
            } catch (e: Exception) {
                println("Failed to initialize: ${e.message}")
            }
        }
    }
    
    private fun setupPurchaseListeners() {
        scope.launch {
            // Listen for purchase updates
            kmpIapInstance.purchaseUpdatedListener.collect { purchase ->
                handlePurchaseUpdate(purchase)
            }
        }
        
        scope.launch {
            // Listen for purchase errors
            kmpIapInstance.purchaseErrorListener.collect { error ->
                handlePurchaseError(error)
            }
        }
    }
    
    private suspend fun loadProducts() {
        try {
            val products = kmpIapInstance.fetchProducts {
                skus = listOf("premium_upgrade", "remove_ads")
                type = ProductQueryType.InApp
            }
            println("Found ${products.size} products")
        } catch (e: Exception) {
            println("Failed to load products: ${e.message}")
        }
    }
    
    private suspend fun handlePurchaseUpdate(purchase: Purchase) {
        // Verify purchase with your backend
        val isValid = verifyPurchaseWithBackend(purchase)
        
        if (isValid) {
            // Grant entitlement
            grantEntitlement(purchase.productId)
            
            // Finish transaction
            kmpIapInstance.finishTransaction(
                purchase.toPurchaseInput(),
                isConsumable = isConsumableProduct(purchase.productId)
            )
        }
    }
    
    private fun handlePurchaseError(error: PurchaseError) {
        when (error.code) {
            ErrorCode.UserCancelled -> {
                // User cancelled, no action needed
            }
            ErrorCode.AlreadyOwned -> {
                // Item already owned, restore it
                restorePurchases()
            }
            else -> {
                // Show error to user
                showError(error.message)
            }
        }
    }
    
    suspend fun purchaseProduct(productId: String) {
        kmpIapInstance.requestPurchase {
            ios {
                sku = productId
                quantity = 1
            }
            android {
                skus = listOf(productId)
            }
        }
    }
    
    suspend fun restorePurchases() {
        val purchases = kmpIapInstance.getAvailablePurchases()
        purchases.forEach { purchase ->
            grantEntitlement(purchase.productId)
        }
    }
    
    private suspend fun verifyPurchaseWithBackend(purchase: Purchase): Boolean {
        // TODO: Implement your backend verification
        return true
    }
    
    private fun grantEntitlement(productId: String) {
        // Grant the appropriate entitlement based on productId
        when (productId) {
            "remove_ads" -> UserSettings.adsRemoved = true
            "premium_upgrade" -> UserSettings.isPremium = true
            // Handle other products
        }
    }
    
    private fun isConsumableProduct(productId: String): Boolean {
        return when (productId) {
            "coins_100", "coins_500" -> true
            else -> false
        }
    }
    
    private fun showError(message: String) {
        // Show error message to user
    }
    
    fun cleanup() {
        scope.cancel()
        runBlocking {
            kmpIapInstance.endConnection()
        }
    }
}

// Simple user settings example
object UserSettings {
    var adsRemoved: Boolean = false
    var isPremium: Boolean = false
}

Android-specific Features

// Use obfuscated account IDs for enhanced security
kmpIapInstance.requestPurchase {
    ios {
        sku = "premium_upgrade"
        quantity = 1
    }
    android {
        skus = listOf("premium_upgrade")
        obfuscatedAccountIdAndroid = "user_account_123"
        obfuscatedProfileIdAndroid = "profile_456"
    }
}

// Acknowledge a purchase (for non-consumables)
kmpIapInstance.acknowledgePurchaseAndroid(purchase.purchaseToken)

// Consume a purchase (for consumables)
kmpIapInstance.consumePurchaseAndroid(purchase.purchaseToken)

// Deep link to subscription management
kmpIapInstance.deepLinkToSubscriptions(
    DeepLinkOptions(skuAndroid = "subscription_id")
)

Error Handling

scope.launch {
    kmpIapInstance.purchaseErrorListener.collect { error ->
        when (error.code) {
            ErrorCode.ServiceUnavailable -> {
                // Google Play services unavailable
                showDialog("Please update Google Play services")
            }
            ErrorCode.BillingUnavailable -> {
                // Billing API version not supported
                showDialog("In-app purchases not supported on this device")
            }
            ErrorCode.ItemUnavailable -> {
                // Product not found or not available for purchase
                showDialog("This item is currently unavailable")
            }
            ErrorCode.DeveloperError -> {
                // Invalid arguments provided to the API
                println("Developer error: Check product configuration")
            }
            else -> {
                showDialog("Purchase failed: ${error.message}")
            }
        }
    }
}

Next Steps

• iOS Setup - Configure for iOS platform
• Basic Implementation - Start implementing purchases
• Troubleshooting - Common issues and solutions

---

For detailed platform configuration, product setup, and testing instructions, visit the Android Setup Guide at openiap.dev.