Canta 无法安装的常见原因与解决

报错类型

排查顺序

一、签名不一致

表现：你从 APK Mirror / 某第三方下的 Canta 装不上，但从 F-Droid 能装。

原因：设备上已经有一个同包名（io.github.samolego.canta）但不同签名的版本——F-Droid 重新签名、GitHub Releases 用 samolego 原签名、第三方 mirror 可能用了另一份。

解决：

1. 先把设备上的旧版 Canta 卸载干净（设置 → 应用管理 → Canta → 卸载）
2. 重启手机（确保应用数据分区清干净）
3. 再装你想要的那版
4. 装不上就反过来——先装 F-Droid 版，再卸载装其他版

二、APK 损坏 / 下载不全

表现：解析错误、安装进度条中途跳回、Android 弹「无效包」。

原因：下载中断、传输损坏、浏览器下载缓存问题。

解决：

1. 删掉 APK 文件，重新下载
2. 用电脑下载后 adb install 传输（比手机浏览器直接下稳定）
3. 换一个下载源（F-Droid / GitHub Releases / IzzyOnDroid 换着来）

三、minSdk 不兼容

表现：Android 8.0 或更老的设备尝试装 Canta。

原因：当前 Canta 最低支持 Android 9.0（API 28）——Android 8.0 装不上是正常的。

解决：

• 升级设备系统（如果厂商有 9.0+ 更新）
• 用 Canta 的旧版本（但 Shizuku 对旧系统支持也不好）
• 换方案：用传统 ADB + 手动 pm uninstall

四、来源没开

表现：Android 7+ 默认不允许从非 Google Play 来源安装，需手动开。

解决：

1. 设置 → 安全 → 允许安装未知应用（不同厂商入口不同）
2. 某些厂商需要针对每个文件管理器单独授权——比如你用的是哪个文件管理器下载的 APK，就单独给它开「允许未知来源」

Canta 支持哪些 Android 版本

多版本共存

Canta 包名固定为 io.github.samolego.canta，所以同包名只能装一个版本。想同时装两个（比如官方版和 F-Droid 版对比）做不到。