kmpkg x-add-version
本节介绍的是 kmpkg 的实验性功能，该功能可能随时发生变更或被移除。
命令概要
kmpkg x-add-version [port-name] [options] [--all] [--overwrite-version] [--skip-formatting-check] [--skip-version-format-check] [--verbose]
命令描述
x-add-version 命令用于更新 kmpkg 端口的版本数据库。默认情况下，该命令针对指定端口生效；通过添加相应参数，用户可选择处理所有端口，或修改格式化检查、版本更新相关的默认行为。
使用该命令的步骤：
- 修改端口文件后，导航至 kmpkg 目录；
- 运行
kmpkg x-add-version <port-name>，将<port-name>替换为你编辑的端口名称。
执行后，该端口的版本条目会被添加或更新至版本数据库中。
信息
版本数据库中使用的哈希值由端口的完整文件内容计算得出。端口目录中任何未被追踪的文件都会影响最终生成的哈希值。用户在执行该命令前，应确保移除所有不打算追踪的文件。
命令选项
所有 kmpkg 命令均支持一组通用选项。
[port-name]
指定待更新的端口名称。若未提供该参数，用户需使用 --all 选项来处理所有端口。
--all
处理内置注册表 ports 目录下的所有端口。
--overwrite-version
允许覆盖数据库中已存在的版本条目。
若未添加此参数，kmpkg 会拒绝覆盖现有版本。
信息
该选项适用于将版本纳入注册表前的持续开发场景。例如：修复
foo端口的问题后执行kmpkg x-add-version foo；若后续对该端口进行了修改，可使用kmpkg x-add-version foo --overwrite-version在纳入注册表前刷新版本条目。
--skip-formatting-check
跳过对端口清单文件（kmpkg.json）格式规范性的检查。默认情况下，该检查会强制执行，确保文件格式符合要求。
--skip-version-format-check
跳过版本格式检查。默认情况下，会验证版本号是否符合指定的格式规范。
--verbose
输出详细日志，展示当前执行操作的更多细节。