Tutorial: 将端口添加到 kmpkg 开源注册表
本教程演示如何使用自定义 overlay 将库打包为 kmpkg 端口。建议在开始前阅读 打包库 教程。
前提条件
- 终端
- Git
1 - Fork kmpkg 仓库
- 打开 kmpkg GitHub 仓库。
- 点击页面右上角的 “Fork” 按钮。
- 选择你的 GitHub 账户作为 fork 目标。
2 - 将 fork 添加为远程仓库
在克隆的原 kmpkg 仓库目录中,添加 fork 为远程仓库,替换 <Your-GitHub-Username> 为你的用户名:
git remote add myfork https://github.com/<Your-GitHub-Username>/kmpkg.git
检查远程是否添加成功:
git remote -v
你应该能看到 myfork 列在远程列表中。
3 - 创建主题分支
在修改前,创建一个新分支:
git checkout -b <topic-branch-name>
4 - 将 overlay 端口复制到 ports 目录
将在 打包库 教程中创建的 kmpkg-sample-library 端口复制到 kmpkg\ports 目录:
- bash
- cmd
- powershell
cp -R <path/to/kmpkg-sample-library> <ports/kmpkg-sample-library>
xcopy <path/to/kmpkg-sample-library> <ports/kmpkg-sample-library> /E
Copy-Item -Path <path/to/kmpkg-sample-library> -Destination <ports/kmpkg-sample-library> -Recurse
5 - 提交并推送更改
- 提交修改:
git add ports/<library-name>
git commit -m "Add kmpkg-sample-library to kmpkg"
- 添加版本信息:
kmpkg x-add-version kmpkg-sample-library
- 提交版本更改:
git commit -m "version database"
- 将更改推送到 fork:
git push myfork <topic-branch-name>
6 - 创建 Pull Request
-
打开你 fork 的 GitHub 仓库。
-
点击 “Compare & pull request”。
- 核对修改内容
- 添加描述性标题和评论
- 完成 PR 审核清单
-
点击 “Create pull request”。
至此,你已成功将端口添加到 kmpkg 的 curated 注册表。
下一步
更多信息参考: