Manejo de errores en Android

Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

Kotlin no admite excepciones verificadas. Esto simplifica y optimiza la administración de errores, ya que puedes controlar solo aquellas excepciones que sean potencialmente recuperables. Y como no tienes que controlar de forma explícita todas las excepciones posibles, tu código es menos desordenado y, en consecuencia, se mantiene más enfocado en su propósito principal.

Los errores recuperables son problemas que un desarrollador puede abordar desde su extremo. Por ejemplo, si un ID que se usa en una llamada no es válido, la API arroja un HomeException con un mensaje invalid data. Luego, el desarrollador de la app puede quitar ese ID de su caché o mostrarle al usuario un mensaje como "No se encontró la estructura".

Este es un ejemplo de cómo se puede controlar una falla recuperable:

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

Cualquier método de las APIs de Home puede generar una HomeException, por lo que te recomendamos que uses un bloque try-catch para capturar HomeException en todas las llamadas.

Cuando controles HomeException, revisa sus campos code y message para saber qué salió mal.

Cualquier excepción no controlada hará que falle la app.

En la siguiente tabla, se proporcionan los significados de los códigos HomeException que podrías encontrar:

Tabla: HomeException códigos

Código	Significado
ABORTED	La operación se anuló, por lo general, debido a un problema de simultaneidad, como una falla en la verificación del secuenciador o la anulación de la transacción.
ALREADY_EXISTS	Ya existe la entidad que un cliente intentó crear, por ejemplo, un archivo o directorio.
API_NOT_CONNECTED	El cliente intentó llamar a un método de una API que no pudo conectarse. Esto puede suceder cuando el dispositivo está sin conexión o no es compatible con la API a la que el cliente intentó llamar.
CANCELLED	La operación se canceló (por lo general, la cancela el emisor).
DATA_LOSS	Se produjo una pérdida o corrupción de datos irrecuperable.
DEADLINE_EXCEEDED	El plazo venció antes de que la operación se pudiera completar. En el caso de las operaciones que cambian el estado del sistema, es probable que se muestre este error incluso si la operación se completó correctamente.
FAILED_PRECONDITION	La operación se rechazó debido a que el sistema no se encuentra en un estado necesario para la ejecución de la operación. Por ejemplo, es posible que recibas este mensaje si se llamó al comando stop de la OvenCavityOperationalStateTrait en un horno que ya se detuvo o si intentaste ejecutar una operación rmdir en un elemento que no es un directorio.
INTERNAL	Errores internos. Esto significa que algunos invariantes que espera el sistema subyacente están rotos. Este código de error está reservado para errores graves.
INVALID_ARGUMENT	El cliente proporcionó un argumento que está fuera del rango esperado de valores.
NOT_FOUND	No se encontró una entidad solicitada, como un archivo o un directorio. Si se niega una solicitud a una clase completa de usuarios, como el lanzamiento gradual de funciones o una lista de entidades permitidas no documentada, se puede usar NOT_FOUND. Si se rechaza una solicitud para algunos usuarios dentro de una clase de usuarios, como el control de acceso basado en usuarios, se debe usar PERMISSION_DENIED.
OUT_OF_RANGE	La operación se intentó más allá del rango válido, como buscar o leer más allá de end-of-file. A diferencia de INVALID_ARGUMENT, este error indica un problema que se puede solucionar si cambia el estado del sistema.
PERMISSION_DENIED	El llamador no tiene permiso para ejecutar la operación especificada. No se debe usar PERMISSION_DENIED para los rechazos causados por el agotamiento de algún recurso (en su lugar, usa RESOURCE_EXHAUSTED para esos errores). No se debe usar PERMISSION_DENIED si no se puede identificar al emisor (en su lugar, usa UNAUTHENTICATED para esos errores). Este código de error no sugiere que la solicitud sea válida o que la entidad solicitada exista o satisfaga otras condiciones previas.
RESOURCE_EXHAUSTED	Se agotó algún recurso, tal vez debido a que se alcanzó una cuota por usuario o a que se acabó el espacio en todo el sistema de archivos. Por ejemplo, este error podría producirse si se llama al comando dispense de DispenseTrait en un dispositivo de alimentación para mascotas, pero no queda comida en la unidad.
SDK_INITIALIZATION_MISSING_INFO	El SDK se inicializó sin toda la información requerida. Por ejemplo, este error se genera si el cliente intenta obtener un TraitFactory para un ID de rasgo determinado, pero el rasgo no se incluyó cuando se inicializó el SDK. Consulta Cómo inicializar la pantalla principal en Android.
UNAUTHENTICATED	No se puede identificar al llamador o la solicitud no tiene credenciales de autenticación válidas.
UNAVAILABLE	El servicio no está disponible. Lo más probable es que esta sea una condición transitoria y que se pueda corregir si vuelves a intentar una retirada. Ten en cuenta que no siempre es seguro reintentar operaciones no idempotentes.
UNIMPLEMENTED	La operación solicitada no se implementó, no se admite o no está habilitada en este servicio.
UNKNOWN	Error desconocido. UNKNOWN aparece cuando se produce una condición de error que no se puede clasificar con ninguno de los otros códigos de error. Por ejemplo, este error puede mostrarse cuando un valor de estado recibido de una API externa no tiene suficiente información sobre la causa raíz.