安装与更新

我该下载哪个 APK？

无脑选 arm64-v8a——99% 的现代设备都是它。完整对照：

ABI	适用设备	推荐度
arm64-v8a	绝大多数现代手机 / 平板	⭐⭐⭐⭐⭐
armeabi-v7a	2015 年前的老旧 32 位 ARM 设备	⭐⭐
x86_64	Intel 平板、Android 模拟器	⭐
x86	极少数 32 位 Intel 设备	⭐

不确定时安装 CPU-Z 查看「ABI」一栏，或看 ro.product.cpu.abi 属性：

adb shell getprop ro.product.cpu.abi

提示「未知来源」/ 禁止安装

APK 未上架应用商店，系统会拦截侧载。在安装确认弹窗中选择 允许本次安装；若被跳转系统设置，请为浏览器 / 文件管理器开启「安装未知应用」。

解析包时出现问题

按概率排序：

1. ABI 不匹配：64 位设备装了 32 位包通常能装，反之则解析失败。换 arm64-v8a 重试；

2. 系统版本过低：最低要求 Android 10（API 29），Android 9 及以下无法安装，也没有支持计划；

3. 下载不完整：核对同版本 Release 中的 .sha256 校验文件：

   certutil -hashfile SFA-release-x.x.x-arm64-v8a.apk SHA256   # Windows
   sha256sum SFA-release-x.x.x-arm64-v8a.apk                   # Linux / macOS

4. 传输损坏：避免经微信 / QQ 传包（可能被改名或截断），改用直连下载或 adb 安装：

   adb install SFA-release-x.x.x-arm64-v8a.apk

覆盖安装失败：签名不一致

Release 包使用 CI 签名，本地自编译包使用 debug 签名，两者互不兼容。请先导出设置备份，卸载旧版后再安装（本地数据会清除）。

安装后首次启动闪退

• 确认系统 WebView / Chrome 组件不是过旧版本，系统设置中更新 Android System WebView；

• 确认设备剩余存储充足（内嵌 Node 运行时会解压资源）；

• 抓取崩溃日志后提交 Issue：

  adb logcat -b crash > crash.log

更新后想保留设置

升级到同签名版本会保留全部设置与缓存。跨签名迁移请使用 设置 → 常规设置 → 备份与恢复 → 导出设置，安装新版后导入。

能在电脑上运行吗？

不能。本仓库已剥离 Electron 桌面端打包链路，仅保留 Android 构建。需要桌面版请前往 原版 SPlayer。