Gestion des erreurs sur Android

Kotlin n'est pas compatible avec les exceptions vérifiées. Cela simplifie et rationalise la gestion des erreurs, car vous pouvez choisir de ne gérer que les exceptions potentiellement récupérables. Comme vous n'avez pas à gérer explicitement chaque exception possible, votre code est moins encombré et reste donc plus axé sur son objectif principal.

Les échecs récupérables sont des problèmes qu'un développeur peut résoudre de son côté. Par exemple, si un ID utilisé dans un appel n'est pas valide, l'API génère un HomeException avec un message invalid data. Le développeur de l'application peut alors choisir de supprimer cet ID de son cache ou d'afficher un message à l'utilisateur, par exemple "Structure introuvable".

Voici un exemple de gestion d'un échec récupérable :

val result =
   try {
     homeManager.requestPermissions()
   } catch (e: HomeException) {
     PermissionsResult(
       PermissionsResultStatus.ERROR,
       "Got HomeException with error: ${e.message}",
     )
   }

Toute méthode des API Home peut générer une HomeException. Nous vous recommandons donc d'utiliser un bloc try-catch pour intercepter HomeException sur tous les appels.

Lorsque vous gérez HomeException, vérifiez ses champs code et message pour savoir ce qui s'est mal passé.

Toute exception non gérée entraînera le plantage de votre application.

Le tableau suivant indique la signification des codes HomeException que vous pouvez rencontrer :

Table : HomeException codes

Code	Signification
ABORTED	L'opération a été abandonnée, généralement en raison d'un problème de simultanéité, tel qu'un échec de vérification du séquenceur ou un abandon de transaction.
ALREADY_EXISTS	L'entité qu'un client a tenté de créer (par exemple, un fichier ou un répertoire) existe déjà.
API_NOT_CONNECTED	Le client a tenté d'appeler une méthode à partir d'une API qui n'a pas pu se connecter. Cela peut se produire lorsque l'appareil est hors connexion ou ne prend pas en charge l'API que le client a tenté d'appeler.
CANCELLED	L'opération a été annulée, généralement par l'appelant.
DATA_LOSS	Une perte ou une corruption de données irrécupérable s'est produite.
DEADLINE_EXCEEDED	Le délai a expiré avant que l'opération puisse se terminer. Pour les opérations qui modifient l'état du système, cette erreur peut être renvoyée même si l'opération s'est terminée avec succès.
FAILED_PRECONDITION	L'opération a été rejetée car le système n'est pas dans un état requis pour exécuter l'opération. Par exemple, ce message peut s'afficher si la commande stop de OvenCavityOperationalStateTrait a été appelée sur un four déjà arrêté ou si vous avez tenté d'exécuter une opération rmdir sur un élément qui n'est pas un répertoire.
INTERNAL	Erreurs internes. Cela signifie que certains invariants attendus par le système sous-jacent n'ont pas été respectés. Ce code d'erreur est réservé aux erreurs graves.
INVALID_ARGUMENT	Le client a fourni un argument qui ne se trouve pas dans la plage de valeurs attendue.
NOT_FOUND	Une entité demandée (par exemple, un fichier ou un répertoire) est introuvable. Si une requête est refusée pour toute une classe d'utilisateurs, telle que le déploiement progressif des fonctionnalités ou la liste d'autorisation non documentée, NOT_FOUND peut être utilisé. Si une requête est refusée pour certains utilisateurs appartenant à une classe d'utilisateurs, telle que le contrôle des accès basé sur l'utilisateur, PERMISSION_DENIED doit être utilisé.
OUT_OF_RANGE	L'opération a été tentée au-delà de la plage valide (par exemple, rechercher ou lire après end-of-file). Contrairement à INVALID_ARGUMENT, cette erreur indique un problème pouvant être résolu si l'état du système change.
PERMISSION_DENIED	L'appelant n'a pas l'autorisation d'exécuter l'opération spécifiée. PERMISSION_DENIED ne doit pas être utilisé pour les refus causés par l'épuisement d'une ressource (utilisez plutôt RESOURCE_EXHAUSTED pour ces erreurs). PERMISSION_DENIED ne doit pas être utilisé si l'appelant ne peut pas être identifié (utilisez plutôt UNAUTHENTICATED pour ces erreurs). Ce code d'erreur n'implique pas que la requête soit valide ni que l'entité demandée existe ou qu'elle répond à d'autres conditions préalables.
RESOURCE_EXHAUSTED	Certaines ressources ont été épuisées, peut-être en raison d'un quota par utilisateur atteint ou d'un manque d'espace dans le système de fichiers. Par exemple, cette erreur peut se produire si la commande dispense de DispenseTrait est appelée sur un distributeur d'aliments pour animaux de compagnie, mais qu'il n'y a plus de nourriture dans l'appareil.
SDK_INITIALIZATION_MISSING_INFO	Le SDK a été initialisé sans toutes les informations requises. Par exemple, cette erreur est générée si le client tente d'obtenir un TraitFactory pour un ID de caractéristique donné, mais que la caractéristique n'a pas été incluse lors de l'initialisation du SDK. Consultez Initialiser la maison sur Android.
UNAUTHENTICATED	L'appelant ne peut pas être identifié ou la requête ne dispose pas d'identifiants d'authentification valides.
UNAVAILABLE	Le service est indisponible. Il s'agit probablement d'une condition temporaire qui peut être corrigée en réessayant après avoir laissé passer un intervalle entre les tentatives. Notez qu'il n'est pas toujours sûr de relancer des opérations non idempotentes.
UNIMPLEMENTED	L'opération demandée n'est pas implémentée, prise en charge ni activée dans ce service.
UNKNOWN	Erreur inconnue. UNKNOWN s'affiche lorsqu'une condition d'erreur se produit et ne peut pas être classée à l'aide des autres codes d'erreur. Par exemple, cette erreur peut s'afficher lorsqu'une valeur d'état reçue d'une API externe ne fournit pas suffisamment d'informations sur la cause première.