Como corrigir o erro "Falha ao instalar uma dependência" do Kodi

Se o Kodi exibir a mensagem “Falha ao instalar uma dependência”, significa que o complemento escolhido precisa de outro componente do Kodi que o Kodi não conseguiu encontrar, baixar ou instalar. A solução depende do componente ausente: verifique o nome exato dele, confirme se o complemento é compatível com a sua versão do Kodi e, em seguida, repare o repositório ou a conexão confiável que o fornece. Evite baixar um arquivo ZIP aleatório apenas porque ele tem um nome de arquivo semelhante.

O que significa o erro de dependência?

Um complemento do Kodi pode declarar complementos ou módulos necessários em suas informações de pacote. O Kodi resolve esses requisitos durante a instalação e verifica se o componente e a versão necessários estão disponíveis. Um erro pode, portanto, significar que uma dependência está ausente de todos os repositórios habilitados, que seu repositório não pode ser acessado ou que o complemento requer uma versão mais recente do Kodi ou da plataforma do que a instalada. A documentação sobre o formato de complementos do Kodi explica como os componentes necessários e as versões mínimas são declarados.

Use esta ordem para identificar a causa do problema antes de remover complementos ou alterar as configurações do Kodi.

1. Registre o complemento e a dependência ausente.

Tela de registro de eventos do Kodi com uma falha na instalação de um complemento e eventos anteriores de atualização do repositório.
Visualização ilustrativa do registro de eventos do Kodi. Uma entrada de instalação com falha pode ajudar a identificar o problema antes de reiniciar.

Quando o erro aparecer, anote o nome do complemento e o nome da dependência exibidos na caixa de diálogo. Se o nome estiver faltando ou desaparecer, tente instalar novamente e abra o Registro de Eventos do Kodi no menu Configurações imediatamente. As entradas incluem instalações de complementos com falha e o registro é apagado quando o Kodi é reiniciado, portanto, verifique-o antes de reiniciar.

O registro de eventos é uma pista inicial útil, mas pode não explicar por que a instalação falhou. O guia do registro de eventos do Kodi descreve onde encontrá-lo e quais eventos ele registra.

2. Verifique a compatibilidade do Kodi e dos complementos.

Painel de informações do complemento do Kodi mostrando um exemplo de dependência necessária que não está instalada e um aviso de compatibilidade de versão.
Visualização ilustrativa das informações do complemento, mostrando como a ausência de um componente difere de uma incompatibilidade de versão do Kodi.

Abra a página de informações do complemento e verifique a versão, o autor e a lista de dependências. Compare os requisitos do Kodi e do sistema operacional com a versão do Kodi instalada e o dispositivo que você utiliza. Um componente pode estar faltando porque o complemento foi desenvolvido para uma versão, arquitetura ou plataforma diferente do Kodi.

Os complementos no repositório oficial do Kodi são organizados de acordo com as versões compatíveis do Kodi. Para um arquivo ZIP instalado manualmente, a compatibilidade é de responsabilidade do usuário. Consulte a documentação atualizada do desenvolvedor do complemento antes de atualizar, fazer downgrade ou alterar a versão; não instale uma versão de desenvolvimento apenas para verificar se funciona. Se o próprio Kodi precisar de uma atualização, use a página oficial de downloads do Kodi ou a fonte de pacotes confiável do seu sistema operacional.

3. Verifique o repositório que fornece a dependência.

Navegador de complementos do Kodi com a opção "Instalar a partir do repositório" selecionada e o repositório de complementos do Kodi destacado.
Navegador de repositórios ilustrativo. Comece com o repositório incluído no Kodi e, em seguida, verifique qualquer outra fonte com o respectivo mantenedor.

No Kodi, abra Complementos > Instalar do repositório e verifique se o complemento ou a dependência está disponível no repositório de complementos do Kodi. Se um complemento de terceiros precisar de um componente do seu próprio repositório, confirme se o repositório está habilitado e se o responsável pelo complemento ainda o publica lá. O Kodi só pode instalar dependências automaticamente quando um componente adequado estiver disponível em um repositório habilitado.

Se o Kodi informar que não foi possível obter as informações do repositório, verifique a conexão de internet do dispositivo e tente atualizar o repositório. Uma página ausente ou erros 404 repetidos geralmente significam que o endereço ou pacote do repositório foi removido; isso não é motivo para substituí-lo por um repositório com nome semelhante de um guia antigo. Desative ou desinstale apenas os repositórios que você reconhece como obsoletos ou nos quais não confia mais. O Kodi alerta que complementos e repositórios instalados por meio de arquivos ZIP podem acessar dados pessoais no dispositivo, portanto, use apenas uma fonte que você possa verificar. Consulte o guia oficial do gerenciador de complementos e a visão geral oficial do repositório para obter mais detalhes.

4. Use o log de depuração se a causa ainda não estiver clara.

Exemplo de log de depuração do Kodi destacando uma falha na busca de repositório e uma dependência de complemento ausente.
Log de depuração ilustrativo. Procure o primeiro erro de repositório ou dependência próximo à instalação com falha.

Ative o registro de depuração em Configurações > Sistema > Registro , reinicie o Kodi usando o menu de energia e repita a instalação com falha. Em seguida, inspecione kodi.logou use special://logpatho local do arquivo de log do Kodi. O caminho do log varia de acordo com a plataforma; por exemplo, o Windows geralmente usa `/var/log` %APPDATA%\Kodi\kodi.log, o macOS usa `/var/log` ~/Library/Logs/kodi.loge o Linux usa ` /var/log`. Os caminhos no Android variam de acordo com o dispositivo. O guia de arquivos de log~/.kodi/temp/kodi.log do Kodi lista mais locais e explica como capturar um log de depuração.

Procure, no período em que a instalação falhou, pelo ID da dependência, erros como "falha ao buscar", "404", "tempo limite excedido" ou um requisito de versão. Um tempo limite excedido indica um problema de conexão; um erro 404 ou a ausência de uma entrada no repositório indicam um pacote indisponível; um requisito de versão indica um problema de compatibilidade com o complemento/Kodi. Desative o registro de depuração após coletar as informações necessárias. Antes de compartilhar um registro, verifique se há informações pessoais, como nomes de contas, caminhos de arquivos ou detalhes do repositório.

Quando a dependência não estiver mais disponível

Se o responsável pela manutenção do complemento parou de publicar o componente necessário ou se o complemento não é compatível com a sua versão do Kodi, pode não haver uma solução segura para a sua configuração atual. Escolha uma alternativa com suporte no repositório oficial ou em uma fonte de desenvolvedor que você possa verificar. Não instale um arquivo ZIP não verificado, não restaure um repositório descontinuado e não desative as verificações de segurança para forçar a instalação. Se precisar de ajuda, inclua a versão do Kodi, a plataforma do dispositivo, o nome do complemento, o ID exato da dependência e um trecho do log de instalação.

Deixar um comentário

Como desinstalar repositórios do Kodi corretamente

Como desinstalar repositórios do Kodi corretamente

Aprenda como desinstalar um repositório do Kodi com segurança, remover separadamente o URL de origem salvo e verificar quais complementos ou dependências instalados você ainda precisa.

Tênis ao vivo no Kodi: os melhores complementos e maneiras legais de assistir

Tênis ao vivo no Kodi: os melhores complementos e maneiras legais de assistir

Descubra a maneira mais segura de assistir tênis ao vivo com o Kodi: saiba o que o iPlayer WWW pode transmitir, como encontrar transmissões licenciadas e quais complementos evitar.

Como assistir filmes no Kodi: um tutorial completo para iniciantes

Como assistir filmes no Kodi: um tutorial completo para iniciantes

Aprenda como assistir a filmes no Kodi a partir do seu computador, unidade USB ou NAS, adicionar serviços de vídeo online e corrigir títulos ausentes com etapas de configuração claras.

Como assistir a transmissões de boxe pay-per-view no Kodi — de forma legal e confiável

Como assistir a transmissões de boxe pay-per-view no Kodi — de forma legal e confiável

Encontre a transmissão autorizada para o seu país, verifique se o provedor é compatível com o Kodi e assista a uma luta de boxe pay-per-view na sua TV sem depender de complementos desatualizados.

5 Melhores Temas para Kodi e Como Mudar a Aparência do Kodi em Minutos

5 Melhores Temas para Kodi e Como Mudar a Aparência do Kodi em Minutos

Compare cinco temas do Kodi no catálogo oficial da Omega e, em seguida, siga o caminho de Configurações atual para instalar um, personalizá-lo ou voltar ao tema anterior.

Como ativar o controle parental do Kodi e bloquear o perfil de uma criança

Como ativar o controle parental do Kodi e bloquear o perfil de uma criança

Defina um PIN de bloqueio principal do Kodi, proteja menus selecionados e crie um perfil infantil separado com as fontes de mídia de sua escolha.

Add-on 1Channel para Kodi: ainda é possível instalá-lo para assistir a filmes e séries?

Add-on 1Channel para Kodi: ainda é possível instalá-lo para assistir a filmes e séries?

Procurando o complemento 1Channel para Kodi? Descubra por que os antigos guias de instalação do PrimeWire não são confiáveis ​​e como instalar um complemento de vídeo compatível com segurança.

Como controlar o Kodi pela interface web, em casa ou fora dela.

Como controlar o Kodi pela interface web, em casa ou fora dela.

Ative a interface web Chorus2 do Kodi, controle sua mídia a partir de qualquer navegador e aprenda como se conectar remotamente sem expor o Kodi à internet.

Complemento Nemesis para Kodi: Como instalar e verificar a disponibilidade

Complemento Nemesis para Kodi: Como instalar e verificar a disponibilidade

Siga o processo original de instalação do Nemesis no Kodi, aprenda o que mudou com o Stream Army e evite instruções desatualizadas sobre repositórios e PINs.

Como baixar e configurar o Kodi no Windows

Como baixar e configurar o Kodi no Windows

Baixe o Kodi com segurança no Windows usando o instalador oficial ou a Microsoft Store, depois adicione sua biblioteca de mídia e configure complementos confiáveis.