OpenWrt 编译步骤与命令详解

前言

编译 OpenWrt 的过程就像是复读机,除了选择系统组件外,几乎每次编译都是复制粘贴相同的命令。而理解每一条命令的作用、什么时候该去执行,这样才能更好的去解决编译中遇到的问题,更顺利的编译出固件。

首次编译

  • 克隆 OpenWrt 源码

    git clone https://github.com/coolsnowwolf/lede openwrt
    这里以 Lean 大佬的源码仓库为例子,毕竟很多人都在用它。命令末尾加了openwrt是指克隆代码到openwrt目录,目的是为了规范化,因为有时并不是编译这个的源码。
  • 进入源码目录

    cd openwrt
  • 拉取 feeds 源码

    ./scripts/feeds update -a
    feeds 是扩展的软件包,独立于 OpenWrt 源码之外,所以需要单独进行拉取和更新。
  • 安装 feeds 中的软件包

    ./scripts/feeds install -a
  • 调整 OpenWrt 系统组件

    make menuconfig
    首次编译建议只选择架构,其它都不要动,这样编译成功率会更高。如果不打算调整组件则输入make defconfig,它会检测编译环境并生成默认的编译配置文件。
  • 预下载编译所需的软件包

    make download V=s -j8
    -j8是指使用8个线程下载,理论上是数字越大下载越快,但似乎有个上限,实测5线程以上其实速度相差不了多少,在网络好的情况下,基本在5分钟以内能下载完。
  • 检查文件完整性

    find dl -size -1024c -exec ls -l {} \;
    此命令可以列出下载不完整的文件(根据我多次编译的经验得出小于1k的文件属于下载不完整),如果存在这样的文件可以使用find dl -size -1024c -exec rm -f {} \;命令将它们删除,然后重新执行make download下载并反复检查,确认所有文件完整可大大提高编译成功率,避免浪费时间。
  • 开始编译

    make V=s -j1
    V=s:输出详细日志,用于编译失败时找出错误。
    -j1:使用单线程编译(首次编译单线程成功率更高),其实不写也行,会自动选择线程。

再次编译

  • 进入源码目录(如果不在此目录)

    cd openwrt

更新

TIPS: 短期内再次编译可忽略更新这个步骤。
  • 更新系统软件包

    sudo sh -c "apt update && apt upgrade -y"
    主要作用是更新在编译环境搭建时所安装的编译组件
  • 拉取 OpenWrt 源码更新

    git pull
  • 拉取 feeds 源码

    ./scripts/feeds update -a
  • 安装 feeds 中的软件包

    ./scripts/feeds install -a

文件清理

  • 清除旧的编译产物(可选)

    make clean
    在源码有大规模更新或者内核更新后执行,以保证编译质量。此操作会删除/bin/build_dir目录中的文件。
  • 清除旧的编译产物、交叉编译工具及工具链等目录(可选)

    make dirclean
    更换架构编译前必须执行。此操作会删除/bin/build_dir目录的中的文件(make clean)以及/staging_dir/toolchain/tmp/logs中的文件。
  • 清除 OpenWrt 源码以外的文件(可选)

    make distclean
    除非是做开发,并打算 push 到 GitHub 这样的远程仓库,否则几乎用不到。此操作相当于make dirclean外加删除/dl/feeds目录和.config文件。
  • 清除编译缓存

    rm -rf tmp
    此操作据说可防止make menuconfig加载错误,暂时没遇到过,如有错误欢迎大佬指正。
  • 删除配置文件(可选)

    rm -f .config
    可以理解为恢复默认配置,建议切换架构编译前执行。

编译

  • 调整 OpenWrt 系统组件

    make menuconfig
    如果不打算调整组件则输入make defconfig,它会检测编译环境并根据更新自动调整编译配置文件。
  • 预下载编译所需的软件包

    make download V=s -j8
  • 检查文件完整性

    find dl -size -1024c -exec ls -l {} \;
    此命令可以列出下载不完整的文件(根据我多次编译的经验得出小于1k的文件属于下载不完整),如果存在这样的文件可以使用find dl -size -1024c -exec rm -f {} \;命令将它们删除,然后重新执行make download下载并反复检查,确认所有文件完整可大大提高编译成功率,避免浪费时间。
  • 开始编译

     make V=s -j$(nproc)
    -j$(nproc):自动获取CPU线程数,采用多线程编译。成功编译后的再次编译且没有进行make clean操作时使用。

尾巴

很少有人会告诉你为什么要这样做,而是会要求你必须要这样做。


更多 OpenWrt 相关文章点这里

欢迎随手订阅博客的 Telegram 频道,接收最新的文章推送和有趣的内容。你还可以加入博主的 Telegram 群组,和小伙伴们一同交流、学习、成♂长。

添加新评论

已有 2 条评论

前几天尝试编译…然后总会有莫名其妙的错误,十分浪费时间。

我刚开始编译也是一直遇到错误。多多尝试,总会编译成功的。