如何在Buildroot中创建使用私有GitHub仓库的自定义包？

1. 准备自定义包目录结构 #

推荐使用BR2_EXTERNAL外部树（避免污染Buildroot主源码），步骤如下：

• 创建外部树根目录，比如~/buildroot-external/
• 在该目录下创建package/my-private-pkg/，用于存放包的配置文件

2. 编写包的Makefile（my-private-pkg.mk） #

在package/my-private-pkg/下新建my-private-pkg.mk，核心配置示例：

MY_PRIVATE_PKG_VERSION := main  # 替换为你的分支、标签或Commit Hash
MY_PRIVATE_PKG_SITE := git@github.com:your-username/your-private-repo.git
MY_PRIVATE_PKG_SITE_METHOD := git

# 按需添加依赖、安装规则
MY_PRIVATE_PKG_DEPENDENCIES := some-dependency  # 若你的包有依赖项
MY_PRIVATE_PKG_INSTALL_TARGET := YES

$(eval $(generic-package))

关键说明：

• MY_PRIVATE_PKG_SITE必须使用GitHub的SSH地址，不能用HTTPS
• MY_PRIVATE_PKG_SITE_METHOD指定为git，Buildroot会自动触发Git克隆逻辑

3. 编写配置菜单文件（Config.in） #

在package/my-private-pkg/下新建Config.in，让包能在Buildroot配置菜单中被选中：

config BR2_PACKAGE_MY_PRIVATE_PKG
	bool "my-private-pkg"
	help
	  你的私有包描述，比如：基于GitHub私有仓库的自定义业务组件

4. 关联外部树与Buildroot #

在外部树根目录下创建两个文件：

• Config.in：

  source "package/my-private-pkg/Config.in"
  

• external.mk：

  include $(sort $(wildcard package/*/*.mk))
  

启动Buildroot配置时指定外部树路径：

make BR2_EXTERNAL=~/buildroot-external menuconfig

在菜单中找到你的包并勾选保存配置。

5. 确保SSH凭证在构建环境中生效 #

因为已配置SSH凭证，需确保构建用户能正常访问私有仓库：

• 先在构建机器上测试克隆：git clone git@github.com:your-username/your-private-repo.git，确认能成功
• 若为CI/容器环境：
  • 将SSH密钥挂载到构建用户的~/.ssh/目录
  • 预先添加GitHub主机密钥到known_hosts（避免首次克隆的交互提示）：

    ssh-keyscan github.com >> ~/.ssh/known_hosts
    

• 如需指定自定义密钥，可设置环境变量：

  export BR2_GIT_SSH_COMMAND="ssh -i /path/to/your/private-key"
  

6. 启动构建 #

执行Buildroot构建命令，系统会自动克隆私有仓库并完成编译：

make

内容的提问来源于stack exchange，提问作者Gsusmt