当前位置：首页 > news >正文

如何用Termux:Widget在手机主屏幕一键执行命令：完整指南

news 2026/7/13 21:21:36

如何用Termux:Widget在手机主屏幕一键执行命令：完整指南

【免费下载链接】termux-widgetTermux add-on app which adds shortcuts to commands on the home screen.项目地址: https://gitcode.com/gh_mirrors/te/termux-widget

想在手机上快速执行Termux命令却每次都要打开应用？Termux:Widget这款终极插件让你直接在手机主屏幕创建快捷方式和小部件，将命令执行效率提升10倍！无论你是开发者、系统管理员还是Linux爱好者，这款工具都能让你的移动命令行体验焕然一新。

📱 痛点引入：移动命令行的效率瓶颈

在移动设备上使用Termux进行命令行操作时，你是否经常遇到这些问题？

繁琐的操作流程：每次都要打开Termux应用、找到命令行界面、输入命令
重复性工作：每天都要执行相同的命令序列，如检查网络状态、查看系统信息
缺乏快捷方式：常用脚本没有快速访问入口，效率低下
后台任务管理不便：需要保持Termux前台运行才能执行脚本

这些问题不仅浪费时间，还降低了在移动设备上使用命令行的体验。幸运的是，Termux:Widget的出现完美解决了这些痛点！

🚀 解决方案：Termux:Widget核心功能

Termux:Widget是一个专门为Termux设计的插件应用，它允许你在手机主屏幕上直接添加命令快捷方式和小部件。这意味着你可以：

一键执行脚本：无需打开Termux应用，直接在主屏幕点击即可运行
两种执行模式：支持前台终端会话和后台任务执行
个性化定制：为不同脚本设置自定义图标和标签
动态快捷方式：创建动态快捷方式，方便快速访问常用命令

Termux:Widget在手机主屏幕上的实际效果 - 快速访问loc.sh和note.sh脚本

✨ 核心亮点：为什么选择Termux:Widget？

🔧 简单易用的配置流程

只需三个简单步骤即可开始使用：

创建必要的脚本目录
编写你的第一个脚本
添加小部件到主屏幕

🎯 灵活的脚本管理

前台脚本目录：~/.shortcuts/- 在前台终端会话中执行
后台任务目录：~/.shortcuts/tasks/- 在后台执行，显示为运行任务
图标目录：~/.shortcuts/icons/- 为脚本添加个性化图标

🔄 智能刷新机制

脚本创建或修改后，只需点击小部件上的刷新按钮即可立即更新列表，无需重启应用。

📱 兼容性保障

支持Android 7.0及以上版本，针对Android 10+的后台启动限制提供了专门的解决方案。

📝 使用场景：Termux:Widget的实际应用

1. 日常系统监控

创建快速检查脚本，一键查看：

网络连接状态
系统负载情况
存储空间使用
电池状态信息

2. 开发工作流加速

为常用开发命令创建快捷方式：

Git操作（拉取、推送、提交）
构建和部署脚本
数据库操作命令
测试运行脚本

3. 自动化任务管理

设置定时或触发的自动化任务：

文件备份脚本
数据同步任务
系统清理脚本
监控告警脚本

4. 学习与教学工具

为Linux命令学习创建快捷方式：

常用命令示例
语法查询脚本
练习题库
参考手册

Termux:Widget小部件功能列表预览 - 展示check status、ping network等常用功能

🛠️ 快速开始：5分钟上手教程

第一步：安装Termux:Widget

# 从F-Droid或GitHub Releases下载安装 # 确保已安装Termux主应用

第二步：创建脚本目录

# 创建前台脚本目录 mkdir -p ~/.shortcuts chmod 700 -R ~/.shortcuts # 创建后台任务目录 mkdir -p ~/.shortcuts/tasks chmod 700 -R ~/.shortcuts/tasks

第三步：编写你的第一个脚本

# 创建简单的问候脚本 echo '#!/data/data/com.termux/files/usr/bin/bash echo "欢迎使用Termux:Widget！" echo "当前时间：$(date)" read -p "按Enter键继续..."' > ~/.shortcuts/welcome.sh # 添加执行权限 chmod +x ~/.shortcuts/welcome.sh

第四步：添加小部件到主屏幕

长按手机主屏幕空白处
选择"小部件"
找到"Termux:Widget"并添加到主屏幕
点击刷新按钮查看脚本列表

第五步：测试运行

点击小部件中的"welcome.sh"脚本，观察Termux自动打开并执行命令！

🚀 进阶技巧：提升使用体验

自定义脚本图标

为你的脚本添加个性化图标，让主屏幕更加美观：

# 创建图标目录 mkdir -p ~/.shortcuts/icons chmod -R a-x,u=rwX,go-rwx ~/.shortcuts/icons # 将PNG图标文件命名为 <脚本名>.png # 例如：welcome.sh.png

创建动态快捷方式

将脚本放入~/.termux/widget/dynamic_shortcuts目录
打开Termux:Widget应用
点击"CREATE SHORTCUTS"按钮
在启动器中长按Termux:Widget图标即可看到快捷方式

解决Android 10+后台启动限制

对于Android 10及以上系统，需要授予Termux"显示在其他应用之上"权限：

进入系统设置 → 应用 → Termux → 高级
启用"显示在其他应用之上"权限

实用脚本示例

网络状态检查脚本

#!/data/data/com.termux/files/usr/bin/bash echo "=== 网络状态检查 ===" echo "IP地址：" ip addr show wlan0 | grep inet echo "" echo "网络连通性：" ping -c 3 google.com echo "=== 检查完成 ===" read -p "按Enter键关闭..."

系统信息查看脚本

#!/data/data/com.termux/files/usr/bin/bash echo "=== 系统信息 ===" echo "系统版本：$(uname -a)" echo "运行时间：$(uptime)" echo "内存使用：" free -m echo "存储空间：" df -h /data/data/com.termux/files echo "=== 信息显示完成 ===" read -p "按Enter键关闭..."

🔧 故障排除与调试

常见问题解决

问题1：脚本不显示在小部件中？

✅ 检查脚本是否在正确的目录（~/.shortcuts/或~/.shortcuts/tasks/）
✅ 确认目录权限是否正确（应为700）
✅ 点击小部件上的刷新按钮更新列表

问题2：脚本执行出错？

✅ 确保脚本有执行权限：chmod +x script.sh
✅ 检查shebang行是否正确：#!/data/data/com.termux/files/usr/bin/bash
✅ 使用termux-fix-shebang命令修复脚本

问题3：如何查看执行日志？

# 在Termux设置中调整日志级别 # 设置 → Termux:Widget → 调试 → 日志级别 → Verbose # 在Termux终端查看日志 logcat | grep Termux

调试模式启用

在Termux应用中设置日志级别为Verbose，可以获取详细的执行信息，帮助诊断问题：

打开Termux应用设置
进入Termux:Widget → 调试
将日志级别设置为Verbose
执行脚本后在Termux终端运行logcat查看日志

📁 项目结构与源码

核心功能源码

项目的核心功能实现位于以下目录：

小部件提供者：app/src/main/java/com/termux/widget/TermuxWidgetProvider.java - 处理小部件更新和刷新
快捷方式管理：app/src/main/java/com/termux/widget/ShortcutUtils.java - 枚举和管理脚本文件
服务控制：app/src/main/java/com/termux/widget/TermuxWidgetService.java - 提供小部件列表视图

主要活动组件

创建快捷方式活动：app/src/main/java/com/termux/widget/TermuxCreateShortcutActivity.java
启动快捷方式活动：app/src/main/java/com/termux/widget/TermuxLaunchShortcutActivity.java
主活动界面：app/src/main/java/com/termux/widget/TermuxWidgetMainActivity.java