Gérer les erreurs dans le SDK Kotlin Multiplatform

Cette page couvre la gestion des erreurs dans le SDK Adapty Kotlin Multiplatform.

Principes de base de la gestion des erreurs

Toutes les méthodes du SDK Adapty renvoient des résultats qui peuvent être soit un succès, soit une erreur. Gérez toujours les deux cas :

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());
    }
});

Codes d’erreur courants

AdaptyError.code est une valeur de l’enum AdaptyErrorCode, pas un nombre — comparez-la avec la constante de l’enum, pas avec le code numérique. Les numéros ci-dessous sont indiqués uniquement parce qu’ils apparaissent généralement dans les lignes de log ou les tickets de support.

Code d’erreur	Numéro	Description	Solution
`AdaptyErrorCode.NO_PRODUCT_IDS_FOUND`	1000	Aucun des produits du paywall n’est disponible dans le store.	Voir Correction de l’erreur Code-1000 noProductIDsFound.
`AdaptyErrorCode.CANT_MAKE_PAYMENTS`	1003	Les achats intégrés ne sont pas autorisés sur cet appareil.	Voir Correction de l’erreur Code-1003 cantMakePayments.
`AdaptyErrorCode.PRODUCT_NOT_FOUND`	22	Le produit demandé pour l’achat n’est pas disponible dans le store.	Vérifiez que le produit est configuré dans le store et dans l’Adapty Dashboard.
`AdaptyErrorCode.NETWORK_FAILED`	2005	La requête réseau a échoué.	Demandez à l’utilisateur de vérifier sa connexion, ou réessayez l’appel.
`AdaptyErrorCode.ADAPTY_NOT_INITIALIZED`	20	Le SDK n’a pas été activé avant l’appel.	Attendez que `Adapty.activate` soit terminé avant tout autre appel SDK.

Pour la liste complète des codes, voir AdaptyErrorCode dans la référence des modèles SDK.

Gérer des erreurs spécifiques

Erreurs réseau

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;
        }
    }
});

Erreurs d’achat

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;
        }
    }
});

Stratégies de récupération d’erreurs

Réessayer en cas d’erreurs réseau

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();
}

Retour aux données en cache

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) {
                    // Erreur réseau - utiliser le paywall en cache
                    showPaywall(cachedPaywall);
                    showOfflineIndicator();
                } else {
                    // Pas de cache disponible ou autre erreur
                    showErrorMessage(error.getMessage());
                }
            }
        });
    }
}

Étapes suivantes

Correction de l’erreur Code-1000 noProductIDsFound
Correction de l’erreur Code-1003 cantMakePayments
Référence API complète - Documentation complète du SDK