阅前必看

如果你是个小白，建议直接去提issues，查看这里了解如何提交包请求。

一般要求

• 没有需要root的操作
• 没有添加/删除/修改等操作$TERMUX_PREFIX目录之外的文件
• 脚本必须按照编码指南来编写

编写一个新的包脚本

包脚本(aka build.sh)是一个Bash脚本，其中包含元数据定义（如果有）和Termux 构建系统如何构建包的说明。这个脚本由内部使用./build-package.sh并且不是独立的：https://github.com/termux/termux-packages/wiki/Building-packages#understanding-build-process

一个简单的栗子：

# 软件包主页，最好用https
TERMUX_PKG_HOMEPAGE=https://www.gnu.org/software/bc/

# 一行（最好），简短的描述，不需要末尾的  .(英文句号)
TERMUX_PKG_DESCRIPTION="Arbitrary precision numeric processing language"

# 开源许可证
TERMUX_PKG_LICENSE="GPL-3.0"

# 谁维护这个包
# 如果您想维护包裹，修复其错误等，清指定自己 (Github昵称, 或 你的名字 + 你的邮箱) ，否则就用默认的 "@termux".
# 请注意，不允许非官方存储库将@termux作为其维护者！
TERMUX_PKG_MAINTAINER="@termux"

# 包最新版本
TERMUX_PKG_VERSION=1.07.1

# 源代码的下载URL
TERMUX_PKG_SRCURL=https://mirrors.kernel.org/gnu/bc/bc-${TERMUX_PKG_VERSION}.tar.gz

# 源代码压缩包的SHA256
# Windows：certutil -hashfile 压缩包位置 SHA256
# Linux： sha256sum 压缩包位置
TERMUX_PKG_SHA256=62adfca89b0a1c0164c2cdca59ca210c1d44c3ffc46daf9931cf4942664cb02a

在提交PR的时候要把注释删掉！

请注意，上面显示的字段顺序是首选的。在上面的示例中，也没有预期的构建步骤覆盖，内部的步骤足以成功构建包。

./build-package.sh可以自动检测以下构建系统：

• Autotools
• CMake
• Meson
• Haskell(或cabal)

如果你要打包Haskell编写的包，看这里：https://github.com/termux/termux-packages/wiki/Haskell-package-guidelines

如果您需要传递一些额外的参数，请使用TERMUX_PKG_EXTRA_CONFIGURE_ARGS。

另外，请参考这个启用这个软件包的自动更新：https://github.com/termux/termux-packages/wiki/Auto-updating-packages

可用包的控制字段表

可用的构建步骤覆盖表

所有构建步骤的完整参考可在Building packages中找到。

编写子包脚本

子包定义通常用于将安装的可选部分移动到一个单独的包。例如，一些库附带的实用程序可能一些用户不需要使用。因此，我们可以将这些实用程序移动到一个单独的包中。并且在lib包作为依赖项安装的情况下减小安装尺寸。

最小的子包脚本由以下字段组成：

TERMUX_SUBPKG_DESCRIPTION= # 描述
TERMUX_SUBPKG_INCLUDE="" # 要包含在子包中的文件列表（空格或换行符分隔）

由于包含列表可能很长，因此优选上述顺序。

子包脚本必须与build.sh和文件位于同一目录中。
名称的格式如下：

{子包名称}.subpackage.sh

请注意，其名称不能与父包的名称相同。

关于子包的其他说明：

• 子包的版本跟父包一样。
• 静态库的子包是自动创建的。

子包控制字段表

子包依赖

默认情况下，子包仅取决于当前版本的父包。通过设置TERMUX_SUBPKG_DEPEND_ON_PARENT变量来改变这种行为。

允许的值为：

• deps - 子包将取决于父包的依赖项。
• unversioned - 子包将取决于没有指定版本的父包。

包脚本中的保留变量

在上面列出的变量（即控制字段）中，某些变量具有特殊用途，由./build-package.sh内部使用。它们不应该这样做，除非有充分的理由，否则不能在运行时修改。

• TERMUX_ON_DEVICE_BUILD - 如果设置了，则假设构建在设备上。
• TERMUX_BUILD_IGNORE_LOCK - 如果设置为true，则忽略生成进程锁。
• TERMUX_BUILD_LOCK_FILE - 生成进程锁文件的路径。
• TERMUX_HOST_PLATFORM - 主机平台定义。通常是 $TERMUX_ARCH-linux-android。
• TERMUX_PKG_BUILDDIR - 当前包的生成目录的路径。
• TERMUX_PKG_BUILDER_DIR - 当前包指向build.sh所在目录的路径。
• TERMUX_PKG_BUILDER_SCRIPT - 当前包build.sh所在的路径。
• TERMUX_PKG_CACHEDIR - 当前包的源代码缓存目录的路径。
• TERMUX_PKG_MASSAGEDIR - 从$TERMUX_PREFIX中提取包内容的目录路径
• TERMUX_PKG_PACKAGEDIR - 指向将在其中创建当前包的*.deb存档组件的目录的路径。
• TERMUX_PKG_SRCDIR - 当前包的源代码目录的路径。
• TERMUX_PKG_TMPDIR - 特定于当前包的临时目录的路径。
• TERMUX_COMMON_CACHEDIR - 存储生成工具的全局缓存目录的路径。
• TERMUX_SCRIPTDIR - 带有实用程序脚本的目录路径。
• TERMUX_PKG_NAME - 当前包的名称。
• TERMUX_REPO_URL - 如果 ./build-package.sh 有选项 -i 或 -I，则将从中下载依赖项的APT存储库URL。
• TERMUX_REPO_DISTRIBUTION - 分布名称数组，除了 TERMUX_REPO_URL。
• TERMUX_REPO_COMPONENT - TERMUX_REPO_URL存储库组件名称数组。
• TERMUX_PACKAGE_FORMAT - 包输出格式

例子

在termux-packages中搜索。