Обработка ошибок в Kotlin Multiplatform SDK

На этой странице описана обработка ошибок в Adapty Kotlin Multiplatform SDK.

Основы обработки ошибок

Все методы Adapty SDK возвращают результат, который может быть либо успешным, либо содержать ошибку. Всегда обрабатывайте оба случая:

Adapty.getProfile { result ->
    when (result) {
        is AdaptyResult.Success -> {
            val profile = result.value
            // Handle success
        }
        is AdaptyResult.Error -> {
            val error = result.error
            // Handle error
            Log.e("Adapty", "Error: ${error.message}")
        }
    }
}

Adapty.getProfile(result -> {
    if (result instanceof AdaptyResult.Success) {
        AdaptyProfile profile = ((AdaptyResult.Success<AdaptyProfile>) result).getValue();
        // Handle success
    } else if (result instanceof AdaptyResult.Error) {
        AdaptyError error = ((AdaptyResult.Error) result).getError();
        // Handle error
        Log.e("Adapty", "Error: " + error.getMessage());
    }
});

Распространённые коды ошибок

AdaptyError.code — это значение перечисления AdaptyErrorCode, а не число. Сравнивайте его с константой перечисления, а не с числовым кодом. Числа ниже приведены лишь потому, что именно они фигурируют в строках логов и тикетах поддержки.

Код ошибки	Номер	Описание	Решение
`AdaptyErrorCode.NO_PRODUCT_IDS_FOUND`	1000	Ни один из продуктов пейвола недоступен в сторе.	См. Исправление ошибки Code-1000 noProductIDsFound.
`AdaptyErrorCode.CANT_MAKE_PAYMENTS`	1003	Встроенные покупки запрещены на этом устройстве.	См. Исправление ошибки Code-1003 cantMakePayments.
`AdaptyErrorCode.PRODUCT_NOT_FOUND`	22	Запрошенный для покупки продукт недоступен в сторе.	Убедитесь, что продукт настроен в сторе и в дашборде Adapty.
`AdaptyErrorCode.NETWORK_FAILED`	2005	Сетевой запрос завершился с ошибкой.	Попросите пользователя проверить подключение или повторите запрос.
`AdaptyErrorCode.ADAPTY_NOT_INITIALIZED`	20	SDK не был активирован перед вызовом.	Дождитесь завершения `Adapty.activate` перед любым другим вызовом SDK.

Полный список кодов см. в AdaptyErrorCode в справочнике моделей SDK.

Обработка конкретных ошибок

Ошибки сети

Adapty.getPaywall("main") { result ->
    when (result) {
        is AdaptyResult.Success -> {
            val paywall = result.value
            // Use paywall
        }
        is AdaptyResult.Error -> {
            val error = result.error
            when (error.code) {
                AdaptyErrorCode.NETWORK_FAILED -> {
                    // Network error - show offline message
                    showOfflineMessage()
                }
                else -> {
                    // Other errors
                    showErrorMessage(error.message)
                }
            }
        }
    }
}

Adapty.getPaywall("main", result -> {
    if (result instanceof AdaptyResult.Success) {
        AdaptyPaywall paywall = ((AdaptyResult.Success<AdaptyPaywall>) result).getValue();
        // Use paywall
    } else if (result instanceof AdaptyResult.Error) {
        AdaptyError error = ((AdaptyResult.Error) result).getError();
        switch (error.getCode()) {
            case NETWORK_FAILED:
                // Network error - show offline message
                showOfflineMessage();
                break;
            default:
                // Other errors
                showErrorMessage(error.getMessage());
                break;
        }
    }
});

Ошибки покупки

product.makePurchase { result ->
    when (result) {
        is AdaptyResult.Success -> {
            val purchase = result.value
            // Purchase successful
            showSuccessMessage()
        }
        is AdaptyResult.Error -> {
            val error = result.error
            when (error.code) {
                AdaptyErrorCode.CANT_MAKE_PAYMENTS -> {
                    // Can't make payments
                    showPaymentNotAvailableMessage()
                }
                AdaptyErrorCode.PRODUCT_NOT_FOUND -> {
                    // Product not available
                    showProductNotAvailableMessage()
                }
                else -> {
                    // Other purchase errors
                    showPurchaseErrorMessage(error.message)
                }
            }
        }
    }
}

product.makePurchase(result -> {
    if (result instanceof AdaptyResult.Success) {
        AdaptyPurchase purchase = ((AdaptyResult.Success<AdaptyPurchase>) result).getValue();
        // Purchase successful
        showSuccessMessage();
    } else if (result instanceof AdaptyResult.Error) {
        AdaptyError error = ((AdaptyResult.Error) result).getError();
        switch (error.getCode()) {
            case CANT_MAKE_PAYMENTS:
                // Can't make payments
                showPaymentNotAvailableMessage();
                break;
            case PRODUCT_NOT_FOUND:
                // Product not available
                showProductNotAvailableMessage();
                break;
            default:
                // Other purchase errors
                showPurchaseErrorMessage(error.getMessage());
                break;
        }
    }
});

Стратегии восстановления после ошибок

Повтор запроса при ошибках сети

fun getPaywallWithRetry(placementId: String, maxRetries: Int = 3) {
    var retryCount = 0
    
    fun attemptGetPaywall() {
        Adapty.getPaywall(placementId) { result ->
            when (result) {
                is AdaptyResult.Success -> {
                    val paywall = result.value
                    // Use paywall
                }
                is AdaptyResult.Error -> {
                    val error = result.error
                    if (error.code == AdaptyErrorCode.NETWORK_FAILED && retryCount < maxRetries) {
                        // Network error - retry
                        retryCount++
                        Handler(Looper.getMainLooper()).postDelayed({
                            attemptGetPaywall()
                        }, 1000 * retryCount) // Exponential backoff
                    } else {
                        // Max retries reached or other error
                        showErrorMessage(error.message)
                    }
                }
            }
        }
    }
    
    attemptGetPaywall()
}

public void getPaywallWithRetry(String placementId, int maxRetries) {
    AtomicInteger retryCount = new AtomicInteger(0);
    
    Runnable attemptGetPaywall = new Runnable() {
        @Override
        public void run() {
            Adapty.getPaywall(placementId, result -> {
                if (result instanceof AdaptyResult.Success) {
                    AdaptyPaywall paywall = ((AdaptyResult.Success<AdaptyPaywall>) result).getValue();
                    // Use paywall
                } else if (result instanceof AdaptyResult.Error) {
                    AdaptyError error = ((AdaptyResult.Error) result).getError();
                    if (error.getCode() == AdaptyErrorCode.NETWORK_FAILED && retryCount.get() < maxRetries) {
                        // Network error - retry
                        retryCount.incrementAndGet();
                        new Handler(Looper.getMainLooper()).postDelayed(this, 1000 * retryCount.get());
                    } else {
                        // Max retries reached or other error
                        showErrorMessage(error.getMessage());
                    }
                }
            });
        }
    };
    
    attemptGetPaywall.run();
}

Использование кешированных данных как запасного варианта

class PaywallManager {
    private var cachedPaywall: AdaptyPaywall? = null
    
    fun getPaywall(placementId: String) {
        Adapty.getPaywall(placementId) { result ->
            when (result) {
                is AdaptyResult.Success -> {
                    val paywall = result.value
                    cachedPaywall = paywall
                    showPaywall(paywall)
                }
                is AdaptyResult.Error -> {
                    val error = result.error
                    if (error.code == AdaptyErrorCode.NETWORK_FAILED && cachedPaywall != null) {
                        // Network error - use cached paywall
                        showPaywall(cachedPaywall!!)
                        showOfflineIndicator()
                    } else {
                        // No cache available or other error
                        showErrorMessage(error.message)
                    }
                }
            }
        }
    }
}

public class PaywallManager {
    private AdaptyPaywall cachedPaywall;
    
    public void getPaywall(String placementId) {
        Adapty.getPaywall(placementId, result -> {
            if (result instanceof AdaptyResult.Success) {
                AdaptyPaywall paywall = ((AdaptyResult.Success<AdaptyPaywall>) result).getValue();
                cachedPaywall = paywall;
                showPaywall(paywall);
            } else if (result instanceof AdaptyResult.Error) {
                AdaptyError error = ((AdaptyResult.Error) result).getError();
                if (error.getCode() == AdaptyErrorCode.NETWORK_FAILED && cachedPaywall != null) {
                    // Network error - use cached paywall
                    showPaywall(cachedPaywall);
                    showOfflineIndicator();
                } else {
                    // No cache available or other error
                    showErrorMessage(error.getMessage());
                }
            }
        });
    }
}

Следующие шаги

Исправление ошибки Code-1000 noProductIDsFound
Исправление ошибки Code-1003 cantMakePayments
Полный справочник API — полная документация по SDK