build

<a href="#build-framework"> <img src="https://yellow-cdn.veclightyear.com/0a4dffa0/cd50a878-a735-4513-a08c-cc0b92550853.png" alt="Armbian徽标" width="144"> </a> Armbian Linux构建框架 <a href=https://github.com/armbian/build/graphs/contributors><img alt="GitHub贡献者" src="https://img.shields.io/github/contributors-anon/armbian/build?logo=stackexchange&label=贡献者&style=for-the-badge&branch=main&logoColor=white"></a> <a href=https://github.com/armbian/os><img alt="构建生成" src="https://img.shields.io/github/actions/workflow/status/armbian/os/complete-artifact-matrix-all.yml?logo=dependabot&label=CI%20构建&style=for-the-badge&branch=main&logoColor=white"></a> <a href=https://github.com/armbian/build/commits/main><img alt="GitHub最后提交（分支）" src="https://img.shields.io/github/last-commit/armbian/build/main?logo=github&label=最后提交&style=for-the-badge&branch=main&logoColor=white"></a>

这个项目做什么？

构建针对低资源硬件优化的自定义内核、镜像或发行版，
包括文件系统生成、低级控制软件、内核镜像和引导加载程序编译，
通过在不同平台上保持系统标准，提供一致的用户体验。

入门指南

自托管要求

x86_64 / aarch64 机器
至少2GB内存和约35GB磁盘空间用于虚拟机、容器或裸机安装
用于本地构建的Armbian / Ubuntu Jammy 22.04.x，或任何支持Docker的Linux用于容器化构建
运行Ubuntu Jammy 22.04.x的Windows 10/11 WSL2子系统
超级用户权限（配置的sudo或root访问权限）
确保您的系统是最新的！例如，过时的Docker二进制文件可能会引起问题。

对于稳定分支，使用 --branch=v24.08

apt-get -y install git
git clone --depth=1 --branch=main https://github.com/armbian/build
cd build
./compile.sh

交互式图形界面。
通过安装必要的依赖项和源代码来准备工作空间。
指导整个过程并创建内核包或可直接使用的SD卡镜像。

构建参数示例

在交互模式下显示进行中的区域：

./compile.sh EXPERT="yes"

为Bananapi M5构建最小CLI Armbian Jammy，使用LTS内核：

./compile.sh \
BOARD=bananapim5 \
BRANCH=current \
RELEASE=jammy \
BUILD_MINIMAL=yes \
BUILD_DESKTOP=no \
KERNEL_CONFIGURE=no

使用GitHub Actions构建：（高级版本）

name: "构建Armbian"
on:
  workflow_dispatch:
jobs:
  build-armbian:
    runs-on: ubuntu-latest
    steps:
      - uses: armbian/build@main
        with:
          armbian_token:     "${{ secrets.GITHUB_TOKEN }}"  # GitHub令牌
          armbian_release:   "jammy"                        # 用户空间
          armbian_target:    "build"                        # build=镜像，kernel=内核
          armbian_board:     "bananapim5"                   # 构建目标

生成的镜像将上传到您的仓库发布。注意：GitHub上传文件限制为2GB。

下载预构建镜像发布

固定版本

手动发布的标准支持构建（每季度）

滚动发布

自动发布的预发布和标准支持构建（每日）
自动发布的社区维护构建（每周）

与行业标准比较

<details><summary>展开</summary> 查看与领先行业标准构建软件的相似之处、优势和劣势。

功能	Armbian	Yocto	Buildroot
目标	通用目的	嵌入式	嵌入式 / 物联网
U-boot和内核	从源代码编译	从源代码编译	从源代码编译
板卡支持维护	完整	外部	外部
根文件系统	基于Debian或Ubuntu	自定义	自定义
包管理器	APT	任意	无
可配置性	有限	大	大
Initramfs支持	是	是	是
入门	快速	非常慢	慢
交叉编译	是	是	是

</details>

项目结构

<details><summary>展开</summary> ```text ├── cache 工作/缓存目录 │ ├── aptcache 软件包 │ ├── ccache C/C++编译器 │ ├── docker Docker最后拉取 │ ├── git-bare 最小Git │ ├── git-bundles 完整Git │ ├── initrd 内存盘 │ ├── memoize Git状态 │ ├── patch 内核驱动补丁 │ ├── pip Python │ ├── rootfs 压缩用户空间 │ ├── sources 内核、u-boot和其他源码 │ ├── tools 额外工具如ORAS │ └── utility ├── config 软件包仓库配置 │ ├── targets.conf 板卡构建目标配置 │ ├── boards 板卡配置 │ ├── bootenv 每个系列的初始引导加载程序环境 │ ├── bootscripts 每个系列的初始引导加载程序脚本 │ ├── cli 每个发行版的CLI软件包配置 │ ├── desktop 每个发行版的桌面软件包配置 │ ├── distributions 发行版设置 │ ├── kernel 每个系列的内核构建配置 │ ├── sources 内核和u-boot源码位置和脚本 │ ├── templates 填充userpatches的用户配置模板 │ └── torrents 外部编译器和rootfs缓存种子 ├── extensions 使用特定功能扩展构建系统 ├── lib 主要构建框架库 │ ├── functions │ │ ├── artifacts │ │ ├── bsp │ │ ├── cli │ │ ├── compilation │ │ ├── configuration │ │ ├── general │ │ ├── host │ │ ├── image │ │ ├── logging │ │ ├── main │ │ └── rootfs │ └── tools ├── output 构建产物 │ └── deb Deb软件包 │ └── images 可引导镜像 - 原始或压缩 │ └── debug 补丁和构建日志 │ └── config 内核配置导出位置 │ └── patch 创建的补丁位置 ├── packages 支持脚本、二进制blob、软件包 │ ├── blobs 壁纸、各种配置、闭源引导加载程序 │ ├── bsp-cli 自动添加到armbian-bsp-cli软件包 │ ├── bsp-desktop 自动添加到armbian-bsp-desktop软件包 │ ├── bsp rootfs的脚本和配置覆盖 │ └── extras-buildpkgs 可选编译和打包引擎 ├── patch 补丁集合 │ ├── atf ARM可信固件 │ ├── kernel Linux内核补丁 | | └── family-branch 每个内核系列和分支 │ ├── misc Linux内核打包补丁 │ └── u-boot 通用引导加载程序补丁 | ├── u-boot-board 特定板卡 | └── u-boot-family 整个内核系列 ├── tools 处理内核补丁和配置的工具 └── userpatches 用户：配置修补区域 ├── lib.config 用户：框架通用配置/覆盖文件 ├── config-default.conf 用户：默认用户配置文件 ├── customize-image.sh 用户：在关闭镜像之前执行的脚本 ├── atf 用户：ARM可信固件 ├── kernel 用户：每个内核系列的Linux内核 ├── misc 用户：各种 └── u-boot 用户：通用引导加载程序补丁 ```