Tratamento de erros no Android

O Kotlin não é compatível com exceções verificadas. Isso simplifica e agiliza o tratamento de erros, porque você pode escolher tratar apenas as exceções que podem ser recuperadas. Como você não precisa processar explicitamente todas as exceções possíveis, seu código fica menos confuso e, consequentemente, mais focado no objetivo principal.

Falhas recuperáveis são problemas que um desenvolvedor pode resolver. Por exemplo, se um ID usado em uma chamada não for válido, a API vai gerar um HomeException com uma mensagem invalid data. O desenvolvedor do app pode remover esse ID do cache ou mostrar ao usuário uma mensagem como "Estrutura não encontrada".

Exemplo de como lidar com uma falha recuperável:

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

Qualquer método nas APIs Home pode gerar um HomeException. Por isso, recomendamos usar um bloco try-catch para capturar HomeException em todas as chamadas.

Ao processar HomeException, verifique os campos code e message para saber o que deu errado.

Qualquer exceção não processada vai resultar em falha no app.

A tabela a seguir mostra os significados dos códigos HomeException que você pode encontrar:

Tabela: HomeException codes

Código	Significado
ABORTED	A operação foi cancelada, normalmente devido a um problema de simultaneidade, como falha na verificação do sequenciador ou cancelamento da transação.
ALREADY_EXISTS	A entidade que um cliente tentou criar, por exemplo, um arquivo ou diretório, já existe.
API_NOT_CONNECTED	O cliente tentou chamar um método de uma API que não conseguiu se conectar. Isso pode acontecer quando o dispositivo está off-line ou não é compatível com a API que o cliente tentou chamar.
CANCELLED	A operação foi cancelada, geralmente pelo chamador
DATA_LOSS	Ocorreu perda ou corrupção de dados irrecuperável.
DEADLINE_EXCEEDED	O prazo expirou antes do término da operação. Para operações que mudam o estado do sistema, esse erro pode ser retornado mesmo que a operação tenha sido concluída com sucesso.
FAILED_PRECONDITION	A operação foi rejeitada porque o estado do sistema não é o necessário para a execução dela. Por exemplo, essa mensagem pode aparecer se o comando stop do OvenCavityOperationalStateTrait foi chamado em um forno já desligado ou se você tentou executar uma operação rmdir em um elemento que não é um diretório.
INTERNAL	Erros internos. Isso significa que algumas invariantes esperadas pelo sistema subjacente foram corrompidas. Este código do erro é reservado para erros graves.
INVALID_ARGUMENT	O cliente forneceu um argumento que está fora do intervalo esperado de valores.
NOT_FOUND	Uma entidade solicitada, como um arquivo ou diretório, não foi encontrada. Se uma solicitação for negada para uma classe inteira de usuários, como uma implementação gradual de recursos ou uma lista de permissões não documentada, NOT_FOUND poderá ser usado. Se uma solicitação for negada para alguns usuários de uma classe, como o controle de acesso baseado em usuário, PERMISSION_DENIED precisará ser usado.
OUT_OF_RANGE	Houve uma tentativa da operação depois do intervalo válido, como a busca ou a leitura após end-of-file. Ao contrário de INVALID_ARGUMENT, esse erro indica um problema que pode ser corrigido se o estado do sistema mudar.
PERMISSION_DENIED	O autor da chamada não tem permissão para executar a operação especificada. PERMISSION_DENIED não pode ser usado para rejeições causadas pelo esgotamento de algum recurso. Em vez dele, use RESOURCE_EXHAUSTED para esses erros. PERMISSION_DENIED não poderá ser usado se o autor da chamada não for identificado. Em vez dele, use UNAUTHENTICATED para esses erros. Esse código do erro não indica que a solicitação seja válida nem que a entidade solicitada exista ou satisfaça outras condições prévias.
RESOURCE_EXHAUSTED	Algum recurso foi esgotado, talvez devido ao atingimento de uma cota por usuário ou à falta de espaço em todo o sistema de arquivos. Por exemplo, esse erro pode ser gerado se o comando dispense do DispenseTrait for chamado em um dispositivo de alimentação de animais de estimação, mas não houver mais comida na unidade.
SDK_INITIALIZATION_MISSING_INFO	O SDK foi inicializado sem todas as informações necessárias. Por exemplo, esse erro é gerado se o cliente tentar receber um TraitFactory para um determinado ID de traço, mas o traço não foi incluído ao inicializar o SDK. Consulte Inicializar a casa no Android.
UNAUTHENTICATED	Não foi possível identificar o autor da chamada ou a solicitação não tem credenciais de autenticação válidas.
UNAVAILABLE	O serviço está indisponível. Muito provavelmente, trata-se de uma condição temporária, que pode ser corrigida ao tentar novamente com uma retirada. Nem sempre é seguro repetir operações não idempotentes.
UNIMPLEMENTED	A operação solicitada não foi implementada, permitida ou ativada neste serviço.
UNKNOWN	Erro desconhecido. UNKNOWN aparece quando ocorre uma condição de erro que não pode ser classificada usando nenhum dos outros códigos de erro. Por exemplo, esse erro pode ser retornado quando um valor de status recebido de uma API externa não tem informações suficientes sobre a causa raiz.