Termux Styling 终端美化工具完全指南

项目架构解析

核心目录功能矩阵

Termux Styling 采用模块化架构设计，主要功能模块通过清晰的目录结构实现：

• app/src/main/assets/ 🎨
  存储终端美化核心资源，包含：

  • colors/：80+种预定义颜色主题（如Catppuccin、Nord、Solarized系列）
  • fonts/：20+款等宽字体（含Fira Code、JetBrains Mono等编程专用字体）

• app/src/main/java/com/termux/styling/ 🛠️
  应用核心逻辑实现，包含：

  • TermuxStyleActivity：主界面控制器，处理用户主题选择交互
  • Selectable：主题与字体选择器基类

• 根目录工具脚本 ⚙️

  • setup-fonts.sh：字体资源部署脚本
  • setup-nerd-fonts.sh：Nerd Fonts图标支持安装工具

[!TIP] 所有主题文件采用.properties格式存储，可通过简单文本编辑自定义颜色值，无需重新编译应用。

技术栈选型解析

项目基于Android原生开发框架构建，关键技术组件包括：

• Kotlin语言：主要业务逻辑实现，提供简洁的语法和空安全特性
• Gradle构建系统：自动化依赖管理与打包流程
• AndroidX组件：确保在不同Android版本上的兼容性
• 资源分离架构：主题/字体等可配置资源与代码逻辑解耦

核心功能模块

主题管理系统

当需要为终端更换配色方案时，系统通过三级机制实现主题应用：

1. 主题资源加载
   应用启动时扫描assets/colors/目录下所有.properties文件，解析格式如下：

   color_background=#000000
   color_foreground=#FFFFFF
   color_cursor=#FF0000
   

2. 用户选择流程
   TermuxStyleActivity通过Selectable抽象类实现主题列表展示，核心交互逻辑包括：

   • 主题预览卡片生成
   • 选择状态持久化
   • 实时预览功能

3. 系统应用通道
   选择的主题配置通过Termux API传递到终端环境，生效于所有会话窗口。

字体渲染引擎

字体系统支持TrueType字体格式，提供多维度定制能力：

• 字体资源管理
  字体文件存储于assets/fonts/目录，支持常规、粗体、斜体等变体

• 字体补丁工具
  通过fontpatcher-py3.patch脚本可对现有字体添加Powerline符号支持，适用于：

  • 自定义提示符美化
  • 图标字体整合
  • 特殊符号显示优化

[!TIP] 推荐使用setup-nerd-fonts.sh脚本一键安装完整Nerd Fonts支持，获得超过3000个额外图标。

配置持久化机制

用户选择的主题与字体配置通过两种方式持久化：

1. SharedPreferences存储
   保存用户界面的选择状态，路径：/data/data/com.termux.styling/shared_prefs/

2. Termux配置文件
   生成终端环境变量配置，写入~/.termux/colors.properties和~/.termux/font.ttf

快速上手指南

环境部署流程

在本地构建并运行项目需完成以下步骤：

1. 获取源码

   git clone https://gitcode.com/gh_mirrors/te/termux-styling
   cd termux-styling
   

2. 配置构建环境
   确保系统已安装：

   • JDK 11+
   • Android SDK 24+
   • Gradle 7.0+

3. 构建应用

   ./gradlew assembleDebug
   

4. 安装到设备

   adb install app/build/outputs/apk/debug/app-debug.apk
   

主题定制实战

创建自定义主题的步骤：

1. 复制基础模板

   cp app/src/main/assets/colors/base16-default-dark.properties app/src/main/assets/colors/my-theme.properties
   

2. 修改颜色值
   使用十六进制颜色码调整关键元素：

   color_background=#1E1E1E  # 深灰色背景
   color_foreground=#E0E0E0  # 浅灰色文字
   color_black=#2D2D2D       # 自定义黑色
   

3. 添加主题元数据
   在文件头部添加主题信息：

   # Name: My Custom Theme
   # Author: Your Name
   # Description: A dark theme with high contrast
   

4. 重新构建应用

   ./gradlew assembleDebug
   

关键配置项速查表

build.gradle核心配置：

配置项	作用	示例
minSdkVersion	最低支持Android版本	minSdkVersion 24
targetSdkVersion	目标Android版本	targetSdkVersion 33
versionCode	内部版本号	versionCode 28
versionName	显示版本号	versionName "0.14.0"

字体添加方法：

1. 将字体文件放入app/src/main/assets/fonts/
2. 在res/values/arrays.xml添加字体条目：

   <string-array name="font_entries">
       <item>My Custom Font</item>
   </string-array>
   <string-array name="font_values">
       <item>My-Custom-Font.ttf</item>
   </string-array>
   

常见配置错误排查

字体无法应用

症状：选择字体后终端无变化
排查路径：

1. 检查字体文件是否为TrueType格式（.ttf）
2. 验证res/values/arrays.xml中字体名称与文件名一致
3. 清除应用数据：Settings > Apps > Termux Styling > Storage > Clear Data

主题颜色异常

症状：主题颜色显示错乱或缺失
排查路径：

1. 检查.properties文件格式是否正确
2. 确保所有颜色值使用#RRGGBB格式
3. 确认文件编码为UTF-8且无BOM头

应用崩溃

症状：选择主题/字体时应用闪退
排查路径：

1. 通过adb logcat查看错误日志
2. 检查是否存在重复的主题/字体名称
3. 验证资源文件权限是否正确

[!TIP] 开发过程中可使用./gradlew lint命令检查常见配置问题，提前发现潜在错误。

通过本指南，你已掌握Termux Styling的核心架构与使用方法。无论是简单更换主题，还是深度定制终端外观，该工具都能提供灵活而强大的支持。建议从官方提供的主题和字体开始尝试，逐步创建符合个人审美的终端环境。