termux/termux-api
效率与系统工具将 Android 设备的相机、短信、传感器、剪贴板、通知等能力开放为 Termux 命令行与脚本可调用的接口。
项目用途
Termux:API 是一个 Android 附加应用,把设备功能开放给 Termux 命令行。脚本不必用 Java 或 Kotlin 编写完整 Android 工程,只要调用辅助命令,就能访问摄像头、短信、传感器、剪贴板、通知等系统能力,适合用 shell 脚本自动化操作手机、根据通知或传感器数据触发逻辑,以及为 Termux 扩展新设备接口的开发者。
调用通过本地 socket 完成:termux-api 包中的客户端二进制创建两个 Linux 匿名命名空间 socket,把地址以广播形式传给 TermuxApiReceiver,再由 socket 把 stdin 转发给对应 API 类,并把输出送回客户端 stdout(调用机制)。负责解析命令行参数、再调用该二进制的脚本位于独立的 termux-api 包。
安装与使用
应用可从 F-Droid 获取,文档中的最新版本为 v0.53.0。除应用外,还需在 Termux 内安装 termux-api 客户端包,辅助命令才能使用。
每次提交的调试构建会发布在 GitHub Actions,可用于试用新功能或测试 PR。各分发渠道的签名密钥不同,切换安装源前必须先卸载 Termux 主应用及所有已安装插件,参见 Termux 安装说明。
两者安装完成后,在 Termux shell 中调用客户端命令即可访问设备接口。README 未给出完整命令示例,具体命令名与参数请查阅 termux-api 包。
使用约束
只有 Termux 主应用可以调用这些 API,实现方式是要求附加应用与主应用使用同一签名密钥。自行构建或签名不一致的包无法正常调用,除非对齐签名。项目以 GPLv3 发布。
README 中的 Wi-Fi 搜索与连接、应用管理权限等只是早期设想(ideas),不能视为已经提供的能力。
HotRepo 点评
2026-11-01 的 GitHub Java 日榜中,该项目位列第 14,当日新增 6 Star,总计 4,566 Star。这条快照说明,一个 2015 年创建的老工具在语言榜上仍有位置;它的价值更多来自作为 Termux 调用 Android API 的唯一受支持桥梁,而不是功能迭代速度。现有记录中没有该项目全部语言日榜的名次。
本文由 AI 根据项目 README 生成,更新于 ,以项目官方文档为准。