Skip to content

如何正确使用 Rootless Store ​

Rootless Store 不是传统意义上的应用商店。它更像一个本地能力入口:你可以添加 Sources,安装 Plugin 和 Environment,执行脚本,也可以用 CodeBrick 保存自己的轻量操作。

第一次使用时,不需要马上理解所有页面和字段。更重要的是先建立一条基本路径:先看设备状态,再准备运行环境,然后安装和执行能力。

第一次打开应该先看什么 ​

第一次打开 Rootless Store,可以先从 Home 页面开始。

Home 页面不是单纯的入口页,而是设备状态看板。它会帮助你理解当前设备大概处在什么执行环境里,例如普通 App Shell、ADB / Shizuku、Root 等。

如果你只是普通使用,不需要一开始就理解所有状态。可以先记住一个原则:权限越高,能执行的能力越多,但风险也越高。

当你准备运行更高权限的插件或脚本时,再回到这里确认当前设备状态是否满足要求。

想安装能力:先理解 Plugin 和 Environment ​

Rootless Store 中有两个很重要的本地模块:Plugin 和 Environment。

Plugin 负责表达“要做什么”。
Environment 负责提供“让它怎么跑”的运行条件。

例如,一个 Plugin 可能只是调用 python3 main.py。真正提供 Python 解释器和相关库的,不一定是 Plugin 自己,而可能是一个已经安装并启用的 Environment。

所以安装插件时,可以先问自己三件事:

  • 这个 Plugin 能不能独立运行?
  • 它是否依赖某个 Environment?
  • 它声明的宿主环境要求,当前设备是否满足?

如果插件运行失败,不一定是插件本身坏了,也可能是缺少 Environment、权限不足,或者当前执行上下文不符合它的要求。

从 Sources 和 Market 获取内容 ​

Sources 是内容来源。

添加 Source 后,可以进入对应 Market,浏览可安装的 Plugin 和 Environment。你可以把 Source 理解成“这个 Market 的入口和身份信息”,把 Market 理解成“这个来源实际展示内容的地方”。

如果你不是从 Market 安装,而是手动导入本地 ZIP,那么这个内容会更接近 Local 来源。Local 内容不代表不好,但你需要更清楚它来自哪里、是否可信、是否适合当前设备。

在使用第三方 Source 或本地 ZIP 前,建议先确认它的来源、说明和权限要求。Rootless Store 能提供管理入口,但不能替你判断每一段外部脚本是否安全。

运行 Plugin ​

Plugin 页面用于查看、启动、停止和删除已经安装的插件。

不同 Plugin 的运行方式可能不同:

  • 一次性插件更像“点击执行一次”。
  • 常驻类插件更像“打开一个开关,让它持续运行”。

如果插件执行失败,优先检查三件事:

  • 当前设备环境是否满足插件要求。
  • 插件依赖的 Environment 是否已经安装并启用。
  • 插件入口和执行权限是否正确。

如果一个插件依赖 ADB、Shizuku 或 Root 能力,而当前设备没有准备好对应环境,那么它很可能无法按预期运行。

用 CodeBrick 保存轻量操作 ​

如果你只是想保存一段 Shell 命令,不一定需要写完整 Plugin。

CodeBrick 适合保存短小、高频、个人化的操作。它可以直接执行,也可以绑定系统快捷磁贴。绑定后,只要点击 Tile,就能触发对应脚本。

你可以把 CodeBrick 理解成“可保存的命令片段”。它比临时 Shell 输入更稳定,比完整 Plugin 更轻量。

当一个 CodeBrick 变得稳定,并且开始需要版本、包结构或分发能力时,再考虑把它转换成 Plugin。

用 Shell 做临时调试 ​

Shell 更适合临时输入命令、验证环境、排查问题。

如果一段命令只是临时尝试,可以先放在 Shell 里执行。
如果一段命令会反复使用,可以保存成 CodeBrick。
如果一段能力需要分享给别人,或者需要长期维护,就更适合做成 Plugin。

Shell、CodeBrick 和 Plugin 不是互相替代的关系,而是不同阶段的工具:

  • Shell 用来临时验证。
  • CodeBrick 用来保存和快速触发。
  • Plugin 用来正式沉淀和分发。

常见问题 ​

插件为什么不能运行? ​

通常是环境不满足、权限不足、入口错误,或者依赖的 Environment 没有安装和启用。

可以先检查插件声明的 requiredEnvironment,再检查当前设备状态和 Environment 状态。

为什么同一条命令在不同地方结果不同? ​

因为 App Shell、ADB Shell、Root Shell 的权限和上下文不同。

同一条命令在普通应用上下文、ADB 上下文和 Root 上下文中,可能访问到不同文件、拥有不同权限,也可能返回不同结果。

什么时候应该用 CodeBrick,什么时候应该用 Plugin? ​

临时、个人、高频的小操作,适合用 CodeBrick。
稳定、可分发、需要版本管理和包结构的能力,适合做成 Plugin。

Environment 一定要安装吗? ​

不一定。

如果插件或脚本只依赖系统自带命令,可能不需要额外 Environment。
如果它依赖 Python、BusyBox、Node.js 或其他工具链,就可能需要先安装并启用对应 Environment。

本地 ZIP 可以直接安装吗? ​

可以,但要谨慎。

本地 ZIP 更依赖你自己判断来源和内容。安装前最好确认它的 Manifest、入口文件、权限要求和实际来源。