跳到主要内容

kmpkg 术语表

本文档中部分术语在社区讨论中可能存在相近含义，为避免混淆和歧义，特此明确各术语的具体定义。

A​

资产（Asset）​

通常需从互联网下载并在本地可用的制品，常作为构建过程的输入。资产包括源代码归档包、预构建二进制文件或其他构建包所需的文件。

B​

二进制包（Binary package）​

kmpkg 生成的安装输出，打包为可恢复格式。二进制包包含包的构建产物（二进制文件、构建系统集成文件、使用文档、许可证及其他相关文件）。

构建制品（Build artifact）​

构建过程中生成的文件，即构建流程的输出。制品包括库文件、可执行文件、头文件、日志及其他通过编译源代码生成的文件。

C​

经典模式（Classic Mode）​

将包安装到共享目录树的操作模式。

详见 经典模式文档。

L​

库（Library）​

旨在被其他软件复用的软件组件（源代码、二进制文件、文档、许可证等）。kmpkg 注册表 中的大多数端口用于安装 C/C++ 库。

M​

清单（Manifest）​

名为 kmpkg.json 的文件，描述端口或项目的元数据（如依赖项）。

详见 清单模式文档。

O​

覆盖端口/三元组（Overlay port/triplet）​

本地可用的端口或三元组。通常用于提供注册表中未包含的端口/三元组，或覆盖注册表中已有的端口/三元组名称。

详见 覆盖机制文档。

P​

包（Package）​

可包含库、库集合、构建脚本、软件工具或其他使用所需组件。kmpkg 的目标是在项目构建过程中安装这些包。

包管理器（Package manager）​

用于管理项目依赖项的工具，提供安装、升级和集成软件库及工具的功能。包管理器帮助用户查找、安装和更新项目所需的库和工具，并处理可能出现的兼容性和配置问题。

补丁（Patch）​

构建前应用于源代码项目的一组代码变更/差异文件。这些变更通常未集成到上游最新版本中，用于修复漏洞、添加功能或自定义包的行为。

端口（Port）​

kmpkg 专用术语，端口包含：

  • 包的元数据：名称、版本、依赖项、支持的功能等；
  • 获取、（必要时）构建和安装包的指令。

详见 端口文档。

R​

注册表（Registry）​

kmpkg 专用术语，指可在 kmpkg 中安装的端口集合。注册表需遵循特定结构，详见 注册表文档。

kmpkg 提供官方维护的注册表（地址：https://github.com/kumose/kmpkg），用户也可创建自定义注册表以托管自己的端口集合。

S​

系统包管理器（System Package Manager）​

针对特定平台设计的包管理器，例如 Linux 系统的 apt-get 或 macOS 系统的 brew。系统包管理器通常在系统范围内安装包和库，而非针对单个项目。

T​

三元组（Triplet）​

用于描述目标或宿主环境的一组属性或脚本，影响 kmpkg 构建库的方式。三元组指定链接类型、构建标志及其他影响包构建和安装的选项。

详见 三元组文档。

U​

上游（Upstream）​

指项目源代码变更的原始仓库。上游通常是项目的官方源头，主要开发工作在此进行。也可指项目的维护者或作者。