Início
» KODI
»
Como corrigir o erro "Falha ao instalar uma dependência" do Kodi
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.
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.
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 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.
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.