termux/package-builder

Termux Packages Build 镜像

镜像概述

本镜像是一个基于Ubuntu环境的Docker镜像，专门用于构建 https://github.com/termux/termux-packages 仓库中定义的Termux软件包。它预配置了构建Termux包所需的编译工具链、依赖库及环境设置，旨在简化Termux软件包的本地化构建流程。

主要用途

为Termux（Android终端模拟器）构建软件包，支持基于termux-packages仓库源码编译自定义或官方软件包，满足Termux生态的包维护与开发需求。

核心功能与特性

• 预配置Ubuntu环境：基于Ubuntu系统，集成构建Termux包所需的基础依赖（如GCC、Clang、autotools、dpkg等）。
• 交叉编译支持：内置Termux目标架构（aarch64、arm、i686等）的交叉编译工具链。
• 兼容性优化：环境设置与termux-packages仓库构建流程深度适配，减少手动配置步骤。
• 轻量高效：仅包含必要构建组件，降低资源占用，提升构建效率。

使用场景与适用范围

适用对象

• Termux软件包维护者及开发者
• 需要构建自定义Termux包的用户
• 参与termux-packages项目贡献的开源开发者

典型场景

• 本地调试与构建Termux包
• 自动化CI/CD流程中集成Termux包构建步骤
• 为特定架构（如ARM、x86）交叉构建Termux包

使用方法

前提条件

1. 安装Docker Engine（20.10+版本推荐）
2. 克隆termux-packages仓库：
   git clone https://github.com/termux/termux-packages.git

基础构建命令（docker run）

bash
docker run -it --rm \
  -v /path/to/local/termux-packages:/termux-packages \
  -w /termux-packages \
  termux-build-image \
  ./build-package.sh -a aarch64 <package-name>

参数说明：

• -v /path/to/local/termux-packages:/termux-packages：挂载本地termux-packages仓库目录至容器内
• -w /termux-packages：设置工作目录为仓库根目录
• termux-build-image：镜像名称（需替换为实际镜像标签）
• ./build-package.sh -a aarch64 <package-name>：执行构建脚本，指定架构（aarch64）和目标包名

Docker Compose配置示例

创建docker-compose.yml：

yaml
version: '3'
services:
  termux-builder:
    image: termux-build-image
    volumes:
      - ./termux-packages:/termux-packages  # 本地仓库路径
    working_dir: /termux-packages
    command: ./build-package.sh -a arm <package-name>  # 构建arm架构包

启动构建：
docker-compose up

配置说明

环境变量

通过-e参数传递环境变量自定义构建行为：

构建脚本参数

通过build-package.sh参数调整构建逻辑：

注意事项

1. 目录权限：确保本地termux-packages目录权限允许容器读写（可通过chmod -R 777临时调整，生产环境建议使用UID映射）。
2. 资源需求：构建大型包（如GCC、Node.js）需至少4GB内存+10GB磁盘空间，建议配置Swap分区。
3. 网络依赖：首次构建需下载源码及依赖，建议配置Docker镜像加速或代理。
4. 镜像更新：定期拉取最新镜像以获取工具链更新（docker pull termux-build-image）。

相关链接

• https://github.com/termux/termux-packages
• https://github.com/termux/termux-packages/wiki/Building-packages
• Docker Engine安装文档