如何修復 Kodi 的「安裝依賴項失敗」錯誤

如果 Kodi 顯示“安裝依賴項失敗”,則表示您選擇的插件需要另一個 Kodi 元件,但 Kodi 無法找到、下載或安裝該元件。解決方法取決於缺少的元件:檢查其確切名稱,確認該外掛程式支援您的 Kodi 版本,然後修復提供該元件的受信任儲存庫或連接。切勿僅因檔案名稱匹配就隨意下載 ZIP 檔案。

依賴項錯誤是什麼意思

Kodi插件可以在其軟體包資訊中聲明所需的插件或模組。 Kodi會在安裝過程中解析這些需求,並檢查所需的元件及其版本是否可用。因此,錯誤可能意味著某個依賴項在所有已啟用的儲存庫中都不存在,或無法存取該儲存庫,又或該外掛程式需要比已安裝的版本更新的Kodi或平台版本。 Kodi插件格式文件解釋瞭如何聲明所需的元件和最低版本。

請依此順序縮小故障原因範圍,然後再移除外掛程式或變更 Kodi 設定。

1. 記錄附加元件和缺少的依賴項

Kodi 事件日誌畫面顯示插件安裝失敗和先前的儲存庫更新事件
Kodi 事件日誌範例。安裝失敗的條目可以幫助您在重新啟動前發現問題。

出現錯誤時,請記下對話方塊中顯示的插件名稱和相依性名稱。如果名稱缺失或消失,請再次嘗試安裝,並立即從「設定」功能表開啟 Kodi 的「事件日誌」。日誌中包含插件安裝失敗的記錄,並且會在 Kodi 重新啟動後清除,因此請在重新啟動前檢查日誌。

事件日誌是重要的初步線索,但它可能無法解釋安裝失敗的原因。 Kodi事件日誌指南介紹如何找到它以及它會記錄哪些事件。

2. 檢查 Kodi 和插件的兼容性

Kodi插件資訊面板顯示了一個未安裝的必需相依性範例以及版本相容性警告
插件資訊範例視圖,展示了缺少元件與 Kodi 版本不匹配之間的差異。

開啟插件的資訊頁面,查看其版本、作者和相依性清單。將其列出的 Kodi 和作業系統要求與您已安裝的 Kodi 版本和裝置進行比較。某些元件可能缺失,因為該插件是為不同的 Kodi 版本、架構或平台建構的。

Kodi官方軟體庫中的插件是按相容的Kodi版本分類的。對於手動安裝的ZIP文件,相容性由使用者自行負責。在更新、降級或更改版本之前,請務必查看插件維護者的最新文件;切勿為了測試是否有效而安裝開發版本。如果Kodi本身需要更新,請使用Kodi官方下載頁面或作業系統提供的可信任軟體套件來源。

3. 檢查提供依賴項的儲存庫

Kodi插件瀏覽器已選取“從儲存庫安裝”,且Kodi插件儲存庫已高亮顯示。
範例庫瀏覽器。首先使用 Kodi 自帶的函式庫,然後向函式庫維護者驗證任何其他來源。

在 Kodi 中,開啟「插件」>「從庫安裝」,檢查該插件或其依賴項是否可在 Kodi 插件庫中找到。如果第三方外掛程式需要來自其自身庫的元件,請確認該程式庫已啟用,且外掛程式的維護者仍在其中發布該元件。只有當已啟用的庫中存在適當的元件時,Kodi 才能自動安裝依賴項。

如果 Kodi 報告無法取得儲存庫訊息,請檢查裝置的網路連線並嘗試刷新儲存庫。頁面缺失或重複出現 404 錯誤通常表示儲存庫位址或軟體包已被移除;這並非使用舊指南中名稱相似的儲存庫進行替換的理由。僅停用或卸載您確認已過時或不再信任的儲存庫。 Kodi 警告稱,透過 ZIP 檔案安裝的插件和儲存庫可以存取裝置上的個人數據,因此請僅使用您可以驗證的來源。有關詳細信息,請參閱官方插件管理器指南和官方存儲庫概述。

4. 如果原因仍然不明確,請使用偵錯日誌。

Kodi調試日誌範例,突出顯示了儲存庫獲取失敗和缺少插件依賴項的問題。
範例調試日誌。請尋找安裝失敗附近出現的第一個儲存庫或相依性錯誤。

在「設定」>「系統」>「日誌記錄」中啟用調試日誌記錄,使用 Kodi 的電源選單重新啟動 Kodi,然後重複失敗的安裝步驟一次。之後檢查kodi.log或使用 Kodi 的日誌檔案special://logpath位置。日誌路徑因平台而異;例如,Windows 通常使用 `/usr/local/bin` , %APPDATA%\Kodi\kodi.logmacOS 使用 `/usr/local/bin` ~/Library/Logs/kodi.log,Linux 使用 `/usr/local/bin`。 Android的日誌~/.kodi/temp/kodi.log檔案路徑因裝置而異。 Kodi 的日誌檔案指南列出了更多日誌檔案位置,並解釋如何擷取偵錯日誌。

安裝失敗前後,搜尋依賴項 ID、「取得失敗」、「404」、「逾時」或版本要求等錯誤訊息。逾時通常表示連接問題;404 錯誤或缺少儲存庫條目表示軟體包不可用;版本要求表示插件/Kodi 相容性問題。收集所需資訊後,請關閉調試日誌記錄。分享日誌前,請檢查是否包含個人信息,例如帳戶名稱、文件路徑或儲存庫詳細資訊。

當依賴項不再可用時

如果外掛程式維護者已停止發布所需元件,或者該外掛程式不支援您的 Kodi 版本,則可能無法安全地修復您目前的設定。請從官方倉庫或您可以驗證的開發者來源中選擇一個維護良好的替代方案。切勿安裝未經驗證的 ZIP 檔案、恢復已停用的倉庫或停用安全檢查以強制安裝。如果您需要協助,請提供 Kodi 版本、裝置平台、外掛程式名稱、確切的依賴項 ID 以及已審核的日誌摘錄。

留下評論

Crackle Kodi 附加组件:如何在 Kodi 上观看索尼电影

Crackle Kodi 附加组件:如何在 Kodi 上观看索尼电影

了解 Crackle Kodi 附加组件的安装入口、版本兼容与常见故障排查,并核实 Sony 官方关于 Crackle 服务结束的说明。本文解释插件仍可见为何不代表影片仍能播放,以及安全检查步骤,并区分服务终止、地区限制与版本不兼容,避免误把旧教程当作当前可行方案,并确认安全来源。

如何使用 Kodi 全局搜索插件查找媒体内容

如何使用 Kodi 全局搜索插件查找媒体内容

了解如何在 Kodi 中安装并使用 Global Search 全局搜索插件,快速查找电影、电视剧、剧集、音乐视频、艺人、专辑和歌曲。本文说明官方仓库安装路径、搜索步骤,以及资料库未扫描、类别未启用或插件异常时的排查方法,并解释它与在线服务搜索的区别,帮助你核对结果并安全更新插件。

如何正確解除安裝 Kodi 軟體來源

如何正確解除安裝 Kodi 軟體來源

了解如何安全地卸載 Kodi 儲存庫,單獨刪除其儲存的來源 URL,並檢查您仍需要哪些已安裝的外掛程式或相依性。

在 Kodi 上觀看網球直播:最佳插件和合法觀看方式

在 Kodi 上觀看網球直播:最佳插件和合法觀看方式

找到使用 Kodi 觀看網球直播的最安全方法:了解 iPlayer WWW 可以播放哪些內容、如何找到授權的轉播以及應該避免使用哪些插件。

如何在 Kodi 上觀看電影:完整新手教程

如何在 Kodi 上觀看電影:完整新手教程

學習如何透過 Kodi 從電腦、USB或 NAS 觀看電影,添加線上視訊服務,並透過清晰的設定步驟修復缺少的影片。

如何在 Kodi 上合法可靠地觀看拳擊付費直播

如何在 Kodi 上合法可靠地觀看拳擊付費直播

找到您所在國家/地區的授權串流媒體,檢查其提供者是否支援 Kodi,然後在您的電視上觀看拳擊付費直播,而無需依賴過時的插件。

5款最佳Kodi皮膚以及如何在幾分鐘內改變Kodi的外觀

5款最佳Kodi皮膚以及如何在幾分鐘內改變Kodi的外觀

在官方 Omega 目錄中比較五款 Kodi 皮膚,然後按照當前設定路徑安裝其中一款、自訂它或切換回去。

如何開啟 Kodi 家長監護功能並鎖定兒童帳戶

如何開啟 Kodi 家長監護功能並鎖定兒童帳戶

設定 Kodi 主鎖 PIN 碼,保護選定的選單,並建立單獨的兒童個人資料,其中包含您選擇的媒體來源。

1Channel Kodi插件:現在還能安裝它來觀看電影和電視節目嗎?

1Channel Kodi插件:現在還能安裝它來觀看電影和電視節目嗎?

正在尋找 1Channel Kodi 插件?了解為什麼舊的 PrimeWire 安裝指南不可靠,以及如何安全地安裝受支援的視訊外掛程式。

如何在家或外出時透過網頁介面控制 Kodi

如何在家或外出時透過網頁介面控制 Kodi

啟用 Kodi 的 Chorus2 網路介面,透過任何瀏覽器控制您的媒體,並學習如何在不將 Kodi 暴露於網路的情況下進行遠端連線。