leaf/README.md at cc364c9323c3fc1d9df99fe36a4d8471d20bc94c

wyj/leaf

Fork 0

Files

Yingjie Wang cc364c9323 update: update readme on hooks

2025-03-28 21:31:29 -04:00

6.4 KiB

Raw Blame History

Leaf: A Simple Package Manager

介绍

Leaf是一个不处理软件依赖关系, 用于定制化Linux From Scratch的半自动软件构建工具。它具有发行版无关性, 在满足依赖(见第7小节)的条件下在任何发行版、任何架构下都能够运行。

安装Leaf

Leaf的配置文件位于/etc/leaf.conf(默认)。

配置文件说明:

DIST_DIR               - 源码目录
BUILD_DIR              - 编译目录
PKGBUILD_DIR           - PKGBUILD目录
TRACE_DIR              - 安装文件跟踪目录
INSTALL_HOOK_DIR       - 安装软件包时触发的钩子目录
REMOVE_HOOK_DIR        - 移除软件包时触发的钩子目录
BINARY_DIR             - 二进制包存放目录
TEMP_DIR               - 二进制包解包临时目录
INSTALLED_PACKAGES     - 已安装软件包数据库
PARALLEL_JOBS          - 构建并行数
DEFAULT_BUILD_OPTIONS  - 默认构建选项
COMPRESS_PROG          - 二进制包压缩程序
BINARY_EXT             - 二进制包文件拓展名
ENABLE_DEBUG_TREE      - 尝试使用tree命令列出编译产物

安装并初始化:

# root
bash INSTALL.sh

使用Leaf

Leaf的命令格式:

leaf [option] [packages]
option:   prepare    准备软件但不编译或安装
          build      编译软件但不安装
          install    安装软件
          remove     删除已安装的程序
          clean      清理编译目录
          list       列出已安装的软件
          search     搜索软件, 支持模糊查询
          show       输出软件详细信息
          pack       构建并封装二进制包
          unpack     安装二进制包

提示: 软件升级需要先移除旧版本再安装新版本, 否则可能会造成旧版本文件残留。

Leaf的运行原理

读取PKGBUILD文件来设置变量, 进行软件构建, 通过DESTDIR安装方式和find命令记录软件包提供的文件、目录和链接。PKGBUILD的各项变量含义如下:

- pkgname        字符串, 软件名称
- pkgver         字符串, 软件版本号
- pkgdesc        字符串, 软件描述
- pkgurl         字符串, 软件主页/上游地址
- license        数组, 软件许可证
- sources        数组, 构建过程使用到的所有源码包和补丁
- urls           数组, `sources` 各项对应的地址, 当前仅限使用 `wget` 获取
- md5sums        数组, `sources` 各项对应的 md5 checksum
- options        数组, 构建选项, 详见第4小节
- srcdir         字符串, 构建路径(在leaf主程序中定义)
- pkgdir         字符串, 虚拟根目录(在leaf主程序中定义)

PKGBUILD定义的6个函数(*表示该函数必须定义, 其他函数默认为空实现):

- src_prepare            * 构建软件的准备阶段, 如解压源码、执行补丁
- src_build              * 构建软件的编译阶段
- src_check              构建软件的测试阶段
- src_install            * 构建软件的安装阶段, 以 DESTDIR 方式安装到 $pkgdir
- src_preinstall         安装软件前置操作
- src_postinstall        安装软件后置操作
- src_preremove          移除软件前置操作
- src_postremove         移除软件后置操作

编写PKGBUILD的一般原则: 模块见template.PKGBUILD, 语法必须符合BASH, 可以定义额外的函数(尽量不要在头部定义全局变量, 这会导致构建环境的污染, 需要手动unset, 推荐在函数中用local定义局部变量); src_build函数只负责编译软件, 并将其安装到$pkgdir, 而src_[pre|post][install|remove]函数只负责操作根文件系统; Systemd单元一般由用户手动开启或关闭。

另外, 某些软件包需要生成缓存或更改文件属性才能正常使用(见HOOKS.md), 需要定义特定操作的钩子文件, 模板见template.HOOK, 语法必须符合BASH。

构建选项

在PKGBUILD中定义的options可以是以下字段:
- strip: 剥离二进制文件和库文件中的调试符号, 它可以让文件变得更小, 若您需要调试该程序, 则禁用该选项。
- libtool: 保留.la文件, 通常来说不需要这种文件, 可以设置成!strip来移除所有的.la文件。
- zipman: 对man手册进行gzip压缩。
特性支持
- 软件包匹配。Leaf以最短前缀匹配查找PKGBUILD, 接受4种格式的软件包名, 一种是不带版本号的软件名(例如gcc), 二是带版本号的软件名(例如gcc-<version>), 三是加上前缀但不带版本号(如sys-devel/gcc), 四是完全体(如sys-devel/gcc-<version>)。当不能唯一确定软件包时, 将要求用户输入目标软件的前缀或版本。
- 消息记录。在软件安装完成后需要提示一段用户信息, 可在PKGBUILD调用leaf_record_message函数, 参数类型为字符串, 参数个数为一个或多个, 各参数将以换行形式输出到终端。
- 前后置钩子。当软件安装前后和移除前后自动完成一些操作, 如安装desktop-file-utils后, 后续添加或移除了/usr/share/applications目录中的.desktop文件, 则自动执行update-desktop-database。
系统管理

请不要卸载系统的核心组件。Leaf并不负责软件的更新升级, 若您必须要这样做的话, 请先手动卸载再安装。
Leaf的依赖组件

强依赖:
- Bash
- Binutils
- Coreutils
- File
- Findutils
- Gawk
- Grep
- Sed
- Gzip
运行时依赖:
- Bzip2
- Tar
- Patch
- Xz
- Zstd
- UnZip
- Tree
- ...

6.4 KiB Raw Blame History

Leaf: A Simple Package Manager

6.4 KiB

Raw Blame History