4.1 Port 工作原理

好的，看来这并没有那么简单，Port 需要一些修改才能正常工作。在本节中，我们将逐步解释如何修改它，以使其适应 Ports 的使用模式。

---

首先，当用户在 Port 目录下输入 make 时，会发生以下事件。在阅读本节时，在另一个窗口中打开 bsd.port.mk 有助于理解这一过程。

但别担心，并没有多少人完全理解 bsd.port.mk 的工作原理… :-)

1. fetch 目标运行。fetch 目标负责确保 tarball 文件存在于本地的 DISTDIR 中。如果 fetch 在 DISTDIR 找不到所需的文件，它会查找 Makefile 中定义的 MASTER_SITES URL，或者我们将 distfiles 放入的 FTP 镜像站点作为备份。它将尝试使用 FETCH 下载指定的分发文件，假设发起请求的站点可以直接访问互联网。如果下载成功，文件将保存在 DISTDIR 中供将来使用，然后继续进行下一步。

2. extract 目标运行。该目标会在 DISTDIR 中查找 Port 的分发文件（通常是压缩的 tarball 文件），并将其解压到 WRKDIR 指定的临时子目录中（默认是 work）。

3. patch 目标运行。首先，应用在 PATCHFILES 中定义的补丁。其次，如果在 PATCHDIR 中找到任何名为 patch-* 的补丁文件（默认位于 files 子目录中），则按字母顺序在此时应用它们。

4. configure 目标运行。这个目标可以执行许多不同的操作。

   1. 如果存在，则运行 scripts/configure。

   2. 如果设置了 HAS_CONFIGURE 或 GNU_CONFIGURE，则运行 WRKSRC/configure。

5. build 目标运行。该目标负责进入 Port 的私有工作目录（WRKSRC）并进行编译。

6. stage 目标运行。这个目标将最终构建好的文件放入一个临时目录（STAGEDIR，请参见 Staging）。该目录的层级结构与将要安装该包的系统相对应。

7. package 目标运行。这个目标会根据 stage 目标期间创建的临时目录中的文件以及 Port 的 pkg-plist 来创建一个包。

8. install 目标运行。这个目标将通过 package 目标创建的包安装到主机系统中。

以上是默认的操作步骤。此外，可以定义 pre-something 或 post-something 目标，或在 scripts 子目录中放置相应的脚本，它们将在默认操作前后执行。

例如，如果 Makefile 中定义了 post-extract 目标，并且 scripts 子目录中有一个 pre-build 文件，那么 post-extract 目标将在常规的解压操作之后被调用，而 pre-build 文件则会在默认的构建规则之前执行。建议在操作较简单时使用 Makefile 目标，因为这样更容易让其他人理解 Port 需要什么样的非默认操作。

默认的操作由 bsd.port.mk 中的 do-something 目标完成。例如，解压 Port 的命令位于 do-extract 目标中。如果默认目标没有正确执行某个操作，可以重新定义 Makefile 中的 do-something 目标。

注意

“主要”目标（例如 extract、configure 等）只不过是确保所有前置阶段都已完成，然后调用真正的目标或脚本，它们不应该被修改。要修复解压问题，就修改 do-extract，但绝不能改变 extract 的操作！另外，post-deinstall 目标无效，Port 基础设施不会运行它。

了解了用户输入 make install 时的操作流程之后，接下来我们将逐步介绍如何创建完美的 Port。