FreeBSD 中文社区 2025 第二季度问卷调查
FreeBSD 中文社区(CFC)
VitePress 镜像站QQ 群 787969044视频教程Ⅰ视频教程Ⅱ
  • FreeBSD 从入门到追忆
  • 中文期刊
  • 状态报告
  • 发行说明
  • 手册
  • 网络文章集锦
  • 笔记本支持报告
  • Port 开发者手册
  • 架构手册
  • 开发者手册
  • 中文 man 手册
  • 文章
  • 书籍
  • FreeBSD Port 开发者手册翻译项目
  • 编辑日志
  • 译者说明
  • FreeBSD Port 开发者手册
    • FreeBSD Port 开发者手册
  • 第1章 简介
    • 1.1.简介
  • 第2章 制作新的 port
    • 2.1.制作新的 port
  • 第3章 简单的 port
    • 3.1.编写 Makefile
    • 3.2.编写描述文件
    • 3.3.创建校验和文件
    • 3.4.测试 port
    • 3.5.用 portlint 来检查 port
    • 3.6.提交新的 port
  • 第4章 复杂的 Port
    • 4.1 Port 工作原理
    • 4.2.获取源代码
    • 4.3.修改 port
    • 4.4.打补丁
    • 4.5.配置
    • 4.6.处理用户输入
  • 第5章 配置 Makefile
    • 5.1.原始来源
    • 5.2.命名
    • 5.3.归类
    • 5.4.源代码包文件
    • 5.5.维护者(MAINTAINER)
    • 5.6.一句话说明(COMMENT)
    • 5.7.项目网站
    • 5.8.许可证
    • 5.9.PORTSCOUT
    • 5.10.依赖
    • 5.11.从属 port 和 MASTERDIR
    • 5.12.man 手册
    • 5.13.info 文件
    • 5.14.Makefile 参数
    • 5.15.特殊的工作目录
    • 5.16.解决冲突
    • 5.17.安装文件
    • 5.18. 使用 BINARY_ALIAS 来重命名命令,而不是在编译中打补丁
  • 第6章 特殊情况
    • 第6章 特殊情况
  • 第7章 Flavors
    • 7.1.Flavors 简介
    • 7.2.使用 FLAVORS
    • 7.3.USES=php 和 Flavors
    • 7.4.USES=python 和 Flavors
    • 7.5.USES=lua 和 Flavors
  • 第8章 高级 pkg-plist 实践
    • 8.1.根据 make 变量对 pkg-plist 进行修改
    • 8.2.空目录
    • 8.3.配置文件
    • 8.4.动态与静态软件包列表
    • 8.5.自动创建软件包列表
    • 8.6.用关键词扩展软件包列表
  • 第9章 pkg-*
    • 9.1.pkg-message(安装二进制包时显示的消息文件)
    • 9.2.pkg-install、pkg-pre-install 和 pkg-post-install(安装二进制包时执行的脚本文件)
    • 9.3.pkg-deinstall、pkg-pre-deinstall 和 pkg-post-deinstall(卸载时执行的脚本文件)
    • 9.4.修改 pkg-* 文件的名字
    • 9.5.使用 SUB_FILES 和 SUB_LIST
  • 第10章 测试 port
    • 10.1.运行 make describe
    • 10.2.运行 make test
    • 10.3.Portclippy / Portfmt
    • 10.4.Portlint
    • 10.5.Port 工具
    • 10.6.PREFIX 和 DESTDIR
    • 10.7.Poudriere
    • 10.8.调试 port
  • 第11章 升级 port
    • 11.1.使用 Git 制作补丁
    • 11.2.UPDATING 和 MOVED
  • 第12章 安全
    • 12.1.安全为何如此重要
    • 12.2.修复安全漏洞
    • 12.3.向社区通报情况
  • 第13章 该做什么和不该做什么
    • 第13章 该做什么和不该做什么
  • 第14章 一个简单的 port
    • 第14章 一个简单的 port
  • 第15章 在 Port Makefile 中变量的顺序
    • 第15章 在 Port Makefile 中变量的顺序
  • 第16章 保持更新
    • 第16章 保持更新
  • 第17章 使用 USES 宏
    • 第17章 使用 USES 宏
  • 第18章 __FreeBSD_version 的值
    • 第18章 __FreeBSD_version 的值
由 GitBook 提供支持
LogoLogo

FreeBSD 中文社区(CFC) 2025

在本页
在GitHub上编辑
导出为 PDF
  1. 第8章 高级 pkg-plist 实践

8.1.根据 make 变量对 pkg-plist 进行修改

一些ports,特别是 p5- ports,需要根据它们配置的选项(或 p5- ports的版本)更改它们的 pkg-plist。为了简化此过程,pkg-plist 中的任何 %%OSREL%% , %%PERL_VER%% 和 %%PERL_VERSION%% 的实例将被适当替换。 %%OSREL%% 的值是操作系统的数字修订版(例如, 4.9 )。 %%PERL_VERSION%% 和 %%PERL_VER%% 是 perl 的完整版本号(例如, 5.8.9 )。有关port文档文件的其他几个 %%VARS%% 描述在相关部分中。

要进行其他替换,请使用 PLIST_SUB 设置一个 VAR=VALUE 对列表,并将 %%VAR%% 的实例替换为 pkg-plist 中的 VALUE。

例如,如果port在特定版本子目录中安装了许多文件,请使用版本的占位符,这样每次更新port时就不必重新生成 pkg-plist。例如,设置:

OCTAVE_VERSION=	${PORTREVISION}
PLIST_SUB=	OCTAVE_VERSION=${OCTAVE_VERSION}

在 Makefile 中使用 %%OCTAVE_VERSION%% ,在 pkg-plist 中显示版本的地方都使用 %%OCTAVE_VERSION%% 。当port升级时,无需编辑 pkg-plist 中的数十行(或在某些情况下,数百行)。

如果文件是根据port中设置的选项条件性安装的,则处理的通常方法是在需要时,为启用选项的行在 pkg-plist 行的前面加上 %%OPT%% ,或者在禁用选项时加上 %%NO_OPT%% ,并且在 Makefile 中添加 OPTIONS_SUB=yes 。有关更多信息,请参见 OPTIONS_SUB 。

例如,如果只有在启用 X11 选项时才安装文件,并且 Makefile 中包含:

OPTIONS_DEFINE=	X11
OPTIONS_SUB=	yes

在 pkg-plist 中,像这样,在仅在选项启用时被安装的行前面加上 %%X11%% :

%%X11%%bin/foo-gui

在读取 PLIST 并写入 TMPPLIST(默认:WRKDIR/.PLIST.mktmp)之间,将在 pre-install 和 do-install 目标之间进行替换。因此,如果 port 在生成 PLIST 时,应在 pre-install 之前或之中这样做。另外,如果 port 需要编辑生成的文件,则应在 post-install 中将其编辑为名为 TMPPLIST 的文件。

另一种修改 port 打包清单的方法是基于设置变量 PLIST_FILES 和 PLIST_DIRS 。每个变量的值被视为要写入 TMPPLIST 的路径名列表,以及 PLIST 内容。虽然 PLIST_FILES 和 PLIST_DIRS 中列出的名称将按照上述描述进行 %%VAR%% 替换,但最好直接使用 ${VAR} 。除此之外, PLIST_FILES 中的名称将不经修改地出现在最终的打包清单中,而 @dir 将被添加到 PLIST_DIRS 中的名称之前。要生效,必须在写入 TMPPLIST 之前设置 PLIST_FILES 和 PLIST_DIRS ,也就是在 pre-install 或更早的时候。

有时候,仅使用 OPTIONS_SUB 是不够的。在这些情况下,在 Makefile 中添加特定的 TAG 到 PLIST_SUB ,并赋予特殊值 @comment ,使得软件包工具忽略该行。例如,如果仅当 X11 选项打开且架构为 i386 时才安装某些文件:

.include <bsd.port.pre.mk>

.if ${PORT_OPTIONS:MX11} && ${ARCH} == "i386"
PLIST_SUB+=	X11I386=""
.else
PLIST_SUB+=	X11I386="@comment "
.endif
上一页7.5.USES=lua 和 Flavors下一页8.2.空目录

最后更新于10个月前